Pular para o conteúdo principal
Para dar suporte a um número maior de campanhas e à recuperação eficiente de todas as entidades associadas a uma conta, a Advertiser API agora oferece paginação em muitos endpoints GET. O mecanismo de paginação é fácil de usar e muito semelhante à paginação baseada em cursor da API REST, conforme descrito em Using cursors to navigate collections.

​
Introdução

Para determinadas solicitações GET, agora aceitamos os parâmetros de query cursor e count, ambos opcionais. Se uma resposta contiver mais de count entidades, esses endpoints retornarão as primeiras count entidades e a chave next_cursor no JSON de resposta. GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50 
{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}
Para obter a próxima série de respostas, adicione cursor aos parâmetros de query: GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50 
{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​
Aprofundando

Para a maioria dos endpoints, o valor máximo de count é 1.000, o mínimo é 1 e o padrão é 200. O valor retornado por next_cursor é sempre uma string e deve ser considerado opaco; a implementação pode mudar. Se menos de count entidades forem retornadas na página atual do conjunto de resultados, o valor de next_cursor será null. Observação: os endpoints de analytics não oferecem suporte a esse estilo de paginação. A paginação nos endpoints de stats é feita especificando períodos de tempo. Consulte a documentação desses endpoints individuais para mais informações.
⌘I