卖家对Yandex市场API的请求分页
有些查询不会完整返回结果,而是逐页返回结果。 要获得完整结果,请运行多个连续查询。 在每个新查询中,将参数与下一页结果一起传递。
根据需要传递哪个参数,分页可以有两种类型:
- 与页面ID,参数
page_token
; - 与页码-参数
page
.
如果方法中两种类型的分页都可用,请使用page ID(page_token
),而不是她的号码。
使用页面ID进行分页
方法的例子:
- POST v2/businesses/{businessId}/offer-cards
- POST v2/campaigns/{campaignId}/offer-prices
- GET v2/campaigns/{campaignId}/returns
要获得完整的结果:
-
在哪里提出要求:
- 不要把它传递出去
page_token
. - 如果需要,发送
limit
. 然后这个参数将需要在每个后续请求中传递。
响应将返回参数
paging
. - 不要把它传递出去
-
如果在
paging
返回的参数nextPageToken
所以,有结果的下一页。 重复请求,其中传递值nextPageToken
在参数中page_token
.参数值
nextPageToken
这不是页码,而是需要在请求中传递的字符串。
如果没有参数,则返回最后一页。 提出更多要求 不需要.
-
继续执行请求,直到它返回
nextPageToken
.
参数中的一些方法 paging
他们回来了 prevPageToken
这是上一个结果页面的ID。
要获取上一页,请在参数中传递其ID page_token
. 对于第一页 prevPageToken
它不会再回来了。
用页码分页
这种分页的一些方法已经过时了
其余的将在未来被标记为过时。
方法的例子:
要获得完整的结果:
-
在哪里提出要求:
- 不要把它传递出去
page
. - 如果需要,发送
pageSize
. 然后这个参数将需要在每个后续请求中传递。
响应将返回参数
pager
与结果页数pagesCount
. - 不要把它传递出去
-
如果在
pagesCount
返回多个页面,重复请求-在参数中page
发送页码(2
,3
到最后一个)。