Passer au contenu principal
Pour gérer un nombre maximal plus important de campagnes et récupérer efficacement toutes les entités associées à un compte, l’API Advertiser prend désormais en charge la pagination sur de nombreux endpoints GET. Le mécanisme de pagination est simple à utiliser et très proche de la pagination basée sur un curseur de l’API REST, comme décrit dans Utiliser des curseurs pour naviguer dans des collections.

​
Bien démarrer

Pour certaines requêtes GET, nous acceptons désormais les paramètres de query cursor et count, tous deux facultatifs. Si une réponse contient plus d’entités que count, ces endpoints renverront les count premières entités ainsi qu’une clé next_cursor dans le JSON de réponse. GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50 
{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}
Pour obtenir la série suivante de réponses, ajoutez cursor à vos paramètres de query : GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50 
{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​
Approfondir

Pour la plupart des endpoints, la valeur maximale de count est 1 000, la valeur minimale est 1 et la valeur par défaut est 200. La valeur fournie par next_cursor est toujours une chaîne de caractères et doit être considérée comme opaque ; l’implémentation est susceptible d’évoluer. Si la page actuelle de l’ensemble de résultats contient moins de count entités, la valeur de next_cursor sera null. Remarque : les endpoints d’analytics ne prennent pas en charge ce mode de pagination. La pagination sur les endpoints de statistiques s’effectue en spécifiant des périodes. Consultez la documentation de ces endpoints individuels pour plus d’informations.
⌘I