Créer des rapports sur le streaming à l'aide de GoogleAdsService

Pour récupérer les entités de l'API Google Ads et les données de rapport, vous pouvez utiliser l'une des méthodes suivantes:

Voici les principales différences entre les deux méthodes:

GoogleAdsService.SearchStream GoogleAdsService.Search
Convient au code de production Oui Oui
Service GoogleAdsService GoogleAdsService
Scénario Récupérer des objets et des rapports Récupérer des objets et des rapports
Réponse Flux d'objets GoogleAdsRow Pages d'objets GoogleAdsRow
Champs de la réponse Uniquement celles spécifiées dans la requête Uniquement celles spécifiées dans la requête
Limites quotidiennes Limites quotidiennes en fonction des niveaux d'accès Limites quotidiennes en fonction des niveaux d'accès

Bien que Search puisse envoyer plusieurs demandes paginées pour télécharger l'intégralité du rapport, SearchStream n'envoie qu'une seule demande et initie une connexion persistante avec l'API Google Ads, quelle que soit la taille du rapport.

Pour SearchStream, le téléchargement des paquets de données commence immédiatement, avec l'intégralité du résultat mis en cache dans un tampon de données. Votre code peut commencer à lire les données mises en mémoire tampon sans avoir à attendre la fin de l'intégralité du flux.

En éliminant le temps réseau aller-retour nécessaire pour demander chaque page individuelle d'une réponse Search, en fonction de votre application, SearchStream peut offrir de meilleures performances par rapport à la pagination, en particulier pour les rapports volumineux.

Exemple

Prenons l'exemple d'un rapport composé de 100,000 lignes. Le tableau suivant détaille les différences comptables entre les deux méthodes.

SearchStream Rechercher
Format de page Non applicable 10 000 lignes par page
Nombre de requêtes API 1 requête 10 requêtes
Nombre de réponses de l'API 1 flux continu 10 réponses

Facteurs de performances

Dans la plupart des cas d'utilisation, nous recommandons SearchStream plutôt que Search pour les raisons suivantes:

  • Pour les rapports sur une seule page (moins de 10 000 lignes): aucune différence importante en termes de performances entre les deux méthodes.

  • Pour les rapports comportant plusieurs pages: SearchStream est généralement plus rapide, car les allers-retours multiples sont évités, et la lecture ou l'écriture à partir du cache disque est moins importante.

Limites de débit

Les limites quotidiennes pour les deux méthodes respectent les limites standards et les niveaux d'accès de votre jeton de développeur. Une seule requête ou un seul rapport est comptabilisé comme une seule opération, quel que soit le résultat paginé ou diffusé en streaming.