L'API Search Ads 360 Reporting impose des limites aux opérations de l'API afin d'optimiser les performances système pour tous les utilisateurs.
Tarification
L'utilisation de l'API Search Ads 360 Reporting est incluse dans la tarification globale de Search Ads 360. L'utilisation de l'API n'entraîne aucuns frais supplémentaires.
Limites des requêtes
Les limites suivantes s'appliquent aux opérations de requête effectuées via les méthodes Search ou SearchStream.
- 3 000 requêtes par minute,par projet et par utilisateur
- 3 000 requêtes par minute et par projet
- 150 000 requêtes par jour et par projet
Limites quotidiennes des opérations de l'API
Les limites d'utilisation quotidiennes des API sont basées sur le nombre d'opérations d'API effectuées par projet Google Cloud.
Une seule requête ou un seul rapport est comptabilisé comme une seule opération, quels que soient les résultats diffusés via SearchAds360Service.SearchStream ou paginés à partir d'un appel SearchAds360Service.Search.
En savoir plus
Vous trouverez dans le tableau suivant quelques exemples de comptabilisation :
| Demande d'API | Opérations comptabilisées dans le quota journalier |
|---|---|
Opération: Search
Nombre : 53 groupes d'annonces
Service : |
1 |
Opération: SearchStream
Nombre: 45 campagnes
Service : |
1 |
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur suivante : RESOURCE_EXHAUSTED.
Requêtes de recherche
Une requête Search ou SearchStream est comptabilisée comme une opération dans le quota d'opérations quotidien de l'utilisateur. Une requête SearchStream compte comme une opération API, quel que soit le nombre de lots.
Limites de gRPC
Toutes les bibliothèques clientes de l'API Search Ads 360 Reporting utilisent gRPC pour générer les requêtes et les réponses. Par défaut, la taille des messages de gRPC est de 4 Mo.
Les réponses ne doivent pas dépasser cette limite. Par exemple, une requête de recherche comprenant de nombreux champs peut générer une réponse d'une taille supérieure à 4 Mo. Pour éviter cette limite, vous pouvez réduire le nombre de champs sélectionnés, la taille de la page ou utiliser le streaming.
Les requêtes qui ne respectent pas cette limitation ne génèrent pas d'erreur SearchAds360Error, mais génèrent une erreur gRPC 429 Resource Exhausted. Consultez la liste des codes et des messages d'erreur gRPC.
Requêtes paginées
Les requêtes paginées (par exemple, celles contenant un next_page_token valide) ne sont pas comptabilisées dans le quota d'opérations quotidien d'un utilisateur.
Toutefois, les requêtes de pagination contenant un jeton de page arrivé à expiration ou non valide génèrent une exception et sont comptabilisées dans le quota d'opérations quotidien.
Les requêtes paginées, telles que les requêtes de recherche, sont également soumises à la limite Page size cannot exceed 10,000 rows et sont rejetées si elles ne respectent pas cette limite, avec l'erreur suivante : INVALID_PAGE_SIZE.
Pour en savoir plus sur la pagination, consultez la section Parcourir les résultats.
Requêtes qui renvoient des exceptions d'API
Les requêtes rejetées avec un SearchAds360Failure sont toujours comptabilisées dans le quota d'opérations quotidien de l'utilisateur.
Les requêtes qui échouent, mais qui ne renvoient pas de message SearchAds360Failure (par exemple, en raison d'une erreur au niveau du réseau) ne sont pas comptabilisées dans le quota d'opérations quotidien de l'utilisateur, car elles n'atteignent jamais le service. Un exemple de ceci est un échec
de connectivité réseau.
Autres types de limites
Un champ répété, tel qu'une liste d'opérations, comportant trop d'éléments dans une requête peut entraîner l'erreur REQUEST_SIZE_LIMIT_EXCEEDED.
Ce même message d'erreur peut également être dû à d'autres problèmes.
Lorsque vous effectuez une requête dans le langage de requête Search Ads 360, le nombre maximal d'éléments dans une clause IN est de 20 000. Si vous dépassez cette limite, une erreur FILTER_HAS_TOO_MANY_VALUES est renvoyée.