Parcourir les résultats

Compatibilité avec GoogleAdsService.Search la pagination dans des tailles de page fixes de 10 000 lignes. L'ensemble de résultats de la requête est divisé en plusieurs réponses, contenant chacune 10 000 objets.

Par exemple, pour la requête suivante:

SELECT
  ad_group.id,
  ad_group_criterion.type,
  ad_group_criterion.criterion_id,
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD

Si votre compte contient 50 000 mots clés, l'ensemble de résultats contiendra 10 000 mots clés des objets GoogleAdsRow dans la première réponse, ainsi qu'un next_page_token.

Pour récupérer les 10 000 lignes suivantes, renvoyez la requête, mais mettez à jour le l'page_token de la requête à l'objet next_page_token Notez que next_page_token n'est pas renseignée dans la réponse contenant le dernier lot de lignes.

Nos bibliothèques clientes gèrent la pagination automatiquement. Il suffit d’itérer dans les lignes de la réponse. Lorsque toutes les lignes de la page actuelle ont ait été renvoyée, la bibliothèque cliente extrait automatiquement une nouvelle page de lignes votre nom jusqu'à ce que l'intégralité du jeu de données soit récupérée. Si vous utilisez REST de gRPC, vous devez explicitement envoyer une requête pour chaque nouvelle page.

L'API Google Ads met en cache l'ensemble de données complet en interne. Les demandes ultérieures sont donc plus vite que la première.

Votre requête doit rester exactement la même dans les requêtes suivantes pour que vous puissiez en bénéficier des données mises en cache. les requêtes ne sont pas prises en compte dans votre quota. en particulier pour l'accès de base. Si le diffère et est envoyée avec le même jeton de page, une erreur est renvoyée.