GoogleAdsService.Search est compatible avec la pagination en tailles de page fixes de 10 000 lignes. L'ensemble de résultats de la requête est divisé en plusieurs réponses, chacune contenant 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 objets GoogleAdsRow dans la première réponse, ainsi qu'un champ 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 sur les lignes de la réponse. Une fois toutes les lignes de la page actuelle renvoyées, la bibliothèque cliente extrait automatiquement une nouvelle page de lignes en votre nom jusqu'à ce que l'ensemble de données complet 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 l'ensemble de données complet en interne. Les requêtes suivantes sont donc plus rapides que la première.
Votre requête doit rester exactement la même dans les requêtes ultérieures pour profiter des données mises en cache. Les requêtes ne seront pas comptabilisées dans votre quota, en particulier pour l'accès de base. Si la requête est différente et envoyée avec le même jeton de page, une erreur est renvoyée.