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 de requêtes
Les limites suivantes s'appliquent aux opérations de requête effectuées à l'aide des 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 d'opérations d'API
Les limites d'utilisation quotidienne d'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 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 compte comme une opération dans le quota d'opérations quotidien de l'utilisateur. Une requête SearchStream compte comme une opération d'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 des requêtes et des réponses. Par défaut, gRPC dispose d'une taille de message de 4 Mo.
Le nombre de réponses ne doit pas dépasser cette limite. Par exemple, une requête de recherche qui inclut 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, réduire la taille de la page ou utiliser le streaming.
Les requêtes qui ne respectent pas cette limite ne génèrent pas d'erreur SearchAds360Error, mais une erreur gRPC 429 Resource Exhausted. Reportez-vous à 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 expiré ou non valide généreront une exception et seront 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 refusées si elles ne respectent pas cette limite, avec l'erreur suivante : INVALID_PAGE_SIZE.
Pour en savoir plus sur la pagination, consultez Parcourir les résultats.
Requêtes renvoyant des exceptions d'API
Les requêtes refusées avec un SearchAds360Failure sont toujours comptabilisées dans le quota d'opérations quotidien de l'utilisateur.
Les requêtes qui échouent, mais ne renvoient pas de SearchAds360Failure (erreur au niveau du réseau, par exemple) ne sont pas prises en compte dans le quota d'opérations quotidien de l'utilisateur, car les requêtes n'atteignent jamais le service. Une défaillance de connectivité réseau en est un exemple.
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 suivante : REQUEST_SIZE_LIMIT_EXCEEDED.
Ce même message d'erreur peut également être dû à d'autres problèmes.
Lorsque vous effectuez une requête en 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.