Pour récupérer les entités de l'API Google Ads et les données de reporting, utilisez l'une des méthodes suivantes:
Voici les grandes 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 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 |
SearchStream et Search
Bien que Search puisse envoyer plusieurs requêtes paginées pour télécharger l'intégralité du rapport, SearchStream n'envoie qu'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 le résultat complet est 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'ensemble du flux.
En éliminant le temps de réseau aller-retour requis pour demander chaque page individuelle d'une réponse Search, selon votre application, SearchStream peut offrir de meilleures performances que la pagination, en particulier pour les rapports plus volumineux.
Exemple
Cet exemple examine 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 performance
Dans la plupart des cas d'utilisation, nous vous 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 multipages:
SearchStreamest généralement plus rapide, car les aller-retours multiples sont évités, et la lecture ou l'écriture à partir du cache de disque est moins importante.
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é en continu.