跳转到主要内容
为了支持更高的广告系列数量上限，并高效检索与账户关联的所有实体，Advertiser API 现已在多个 GET endpoint 上支持分页。该分页机制易于使用，与 REST API 的基于游标的分页非常相似，详见使用游标导航集合。

​
入门

对于特定的 GET 请求，我们现已支持可选的 cursor 和 count query（查询）参数。如果响应中包含的实体数量超过 count，这些 endpoint 将返回前 count 个实体，并在响应 JSON 中包含一个 next_cursor 键。 GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50 
{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}
要获取下一批响应，需要在 query 参数中添加 cursor： GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50 
{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​
深入了解

对于大多数 endpoint，count 的最大值为 1,000，最小值为 1，默认值为 200。 next_cursor 提供的值始终为字符串，应视为不透明值；其实现可能会发生变化。如果当前结果集页面返回的实体少于 count，则 next_cursor 的值为 null。 注意： analytics endpoint 不支持这种分页方式。stats endpoint 的分页通过指定时间区间来实现。有关更多信息，请参阅各个 endpoint 的文档。
⌘I