分页

为了支持更大的最大广告活动数量和对与账号关联的所有实体的有效检索,广告商 API 现在支持在多个 GET 端点上进行分页。分页机制易于使用,与 REST API 基于光标的分页十分相似,后者在使用光标来导航集合中有所描述。

入门指南

对于指定的 GET 请求,我们现在接受 cursorcount 查询参数,这两个参数都是可选参数。如果响应有 count 个以上的实体,则这些端点将在响应 JSON 中返回前 count 个实体和 next_cursor 键。

GET https://ads-api.twitter.com/5/accounts/abc1/campaigns?count=50
{
  "data": [...],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}

要获得随后序列的响应,你需要将 cursor 添加至查询参数:

GET https://ads-api.twitter.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50
{
  "data": [...],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

深入了解

对于大部分端点,count 值为 1,000,最小值为 1,默认值为 200

next_cursor 提供的值始终为字符串,应视为不透明;实现可能随时有变更。如果当前结果集页面返回的实体少于 count 个,则next_cursor 值将为 null

注意:分析端点不支持这种分页。在统计端点上分页支持指定时间段。参阅这些各个端点的文档,了解更多信息。

Was this document helpful?

感谢

谢谢你的反馈。我们真的很高兴能帮上忙!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.