Pour récupérer des entités et des données de rapport dans l'API Google Ads, vous pouvez utiliser l'une des méthodes suivantes:
Voici les principales distinctions entre les deux méthodes:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Convient au code de production | Yes | Yes |
| 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 ceux spécifiés dans la requête | Uniquement ceux spécifiés dans la requête |
| Limites quotidiennes | Limites quotidiennes en fonction des niveaux d'accès | Limites quotidiennes en fonction des niveaux d'accès |
SearchStream et Réseau de Recherche
Bien que Search puisse envoyer plusieurs requêtes paginées pour télécharger l'intégralité du rapport, SearchStream envoie une seule demande et établit une connexion persistante avec l'API Google Ads, quelle que soit la taille du rapport.
Pour SearchStream, les paquets de données commencent à être téléchargés immédiatement, l'intégralité du résultat étant mise en cache dans un tampon de données. Votre code peut commencer à lire les données en mémoire tampon sans avoir à attendre la fin de l'ensemble du flux.
En éliminant le temps réseau aller-retour nécessaire pour demander chaque page d'une réponse Search, en fonction de votre application, SearchStream peut offrir de meilleures performances que 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 de comptabilisation 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 d'utiliser SearchStream plutôt que Search pour les raisons suivantes:
Pour les rapports sur une seule page (moins de 10 000 lignes): aucune différence de performances significative entre les deux méthodes.
Pour les rapports de plusieurs pages:
SearchStreamest généralement plus rapide, car plusieurs allers-retours 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 et les niveaux d'accès standards de votre jeton de développeur. Une seule requête ou un seul rapport est comptabilisé comme une opération, quel que soit le résultat paginé ou diffusé en streaming.