Parcourir les résultats

Le langage de requête Google Ads accepte la pagination en spécifiant page_size dans votre requête. L'ensemble de résultats de la requête sera ainsi divisé en plusieurs réponses contenant chacune jusqu'à des objets page_size. Si page_size n'est pas spécifié, il est automatiquement défini sur la taille de page maximale de 10 000 lignes.

Par exemple, avec 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 et que page_size est défini sur 1,000, l'ensemble de résultats contiendra 1 000 objets GoogleAdsRow dans la première réponse, ainsi qu'un élément next_page_token. Pour récupérer les 1 000 lignes suivantes, il vous suffit de renvoyer la requête avec la même taille de page, mais de mettre à jour la valeur page_token de la requête avec la valeur next_page_token de la réponse. La valeur de page_size dans les requêtes suivantes peut être différente à chaque fois.

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

L'API Google Ads met en cache en interne l'ensemble de données complet, de sorte que les requêtes ultérieures sont plus rapides que la première. Selon votre cas d'utilisation, vous pouvez définir page_size sur une valeur comprise entre 1 et 10 000. En général, pour des performances globales plus rapides, vous devez utiliser une valeur page_size plus élevée, car vos réponses contiennent moins d'allers-retours.

Votre requête doit rester exactement la même dans les requêtes ultérieures pour pouvoir 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 la requête diffère et qu'elle est envoyée avec le jeton de page, une erreur est renvoyée.