Pour récupérer des entités et des données de rapport de l'API Google Ads, utilisez 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ération d'objets et de rapports | Récupération d'objets et de 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 basées sur les niveaux d'accès | Limites quotidiennes basées sur les niveaux d'accès |
SearchStream et Search
Alors que Search peut envoyer plusieurs
requêtes paginées pour télécharger l'intégralité du rapport, SearchStream envoie une seule requête 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, et l'intégralité du résultat est mise 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 du flux.
En éliminant le temps d'aller-retour réseau nécessaire pour demander chaque page individuelle
d'une réponse Search, SearchStream peut offrir
de meilleures performances que la pagination, en particulier pour les rapports plus volumineux, en fonction de votre application.
Exemple
Cet exemple examine un rapport comportant 100,000 lignes. Le tableau suivant présente les différences de comptabilisation entre les deux méthodes.
| SearchStream | Search | |
|---|---|---|
| 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 API | 1 flux continu | 10 réponses |
Facteurs de performance
Dans la plupart des cas d'utilisation, nous recommandons SearchStream plutôt que Search pour les raisons suivantes
:
Pour les rapports d'une seule page (moins de 10 000 lignes) : aucune différence significative de performances 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 du disque est moins un facteur.
Limites de débit
Les limites quotidiennes des 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, que le résultat soit paginé ou diffusé.