Vous pouvez parcourir les résultats récupérés avec GoogleAdsService.Search
au lieu de télécharger l'ensemble des résultats en une seule fois. Pour obtenir une vue d'ensemble des
rapports avec l'API Google Ads, consultez le
guide sur les rapports.
Les résultats sont renvoyés par pages de 10 000 lignes maximum. Si page_size n'est pas défini dans la requête, la valeur par défaut est 10 000. Si page_size est défini sur une valeur supérieure à 10 000, la valeur 10 000 est toujours utilisée.
Par exemple, examinez 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
GoogleAdsRow objets 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
page_token de la requête avec le next_page_token de la réponse. Notez que
next_page_token n'est pas renseigné dans la réponse contenant le
dernier lot de lignes.
Nos bibliothèques clientes gèrent automatiquement la pagination. Il vous suffit d'itérer les lignes de la réponse. Une fois toutes les lignes de la page actuelle renvoyées, la bibliothèque cliente récupère automatiquement une nouvelle page de lignes en votre nom jusqu'à ce que l'ensemble du jeu de données soit récupéré. Si vous utilisez REST au lieu de gRPC, vous devez envoyer explicitement une requête pour chaque nouvelle page.
L'API Google Ads met en cache en interne l'ensemble du jeu de données. Les requêtes suivantes sont donc plus rapides que la requête initiale.
Votre requête doit rester exactement la même dans les requêtes suivantes pour profiter des données mises en cache. Les requêtes ne seront pas prises en compte dans votre quota, en particulier pour les niveaux d'accès Explorateur et de base. Si la requête diffère et est envoyée avec le même jeton de page, une erreur est renvoyée.