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 présentation des rapports avec l'API Google Ads, consultez le guide sur les rapports.
Les résultats sont renvoyés sur des 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 quand même utilisée.
Prenons l'exemple de 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. Lorsque toutes les lignes de la page actuelle ont été renvoyées, la bibliothèque cliente récupère 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 effectuer explicitement une requête pour chaque nouvelle page.
L'API Google Ads met en cache en interne l'ensemble de données. Les requêtes suivantes sont donc plus rapides que la première.
Votre requête doit rester exactement la même dans les demandes ultérieures pour profiter des données mises en cache. Les requêtes ne sont pas comptabilisées dans votre quota, en particulier pour les niveaux d'accès Explorateur et Basique. Si la requête diffère et est envoyée avec le même jeton de page, une erreur est renvoyée.