L'API Search Ads 360 Reporting applique des limites aux opérations d'API pour garantir des performances système optimales pour tous les utilisateurs.
Tarifs
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 aucun frais supplémentaire.
Limites des 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 des opérations d'API
Les limites d'utilisation quotidienne des API sont basées sur le nombre d'opérations d'API effectuées par projet Google Cloud.
Une requête ou un rapport uniques sont comptabilisés comme une opération, que les résultats soient diffusés en flux continu 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 et renvoient l'erreur suivante : RESOURCE_EXHAUSTED.
Rechercher des requêtes
Une requête Search ou SearchStream est comptabilisée comme une opération dans le quota d'opérations quotidiennes de l'utilisateur. Une requête SearchStream est comptabilisée 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 a une taille de message de 4 Mo.
Les réponses ne doivent pas dépasser cette limite. Par exemple, une requête de recherche qui inclut de nombreux champs peut générer une réponse dont la taille dépasse 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 limite ne génèrent pas de SearchAds360Error, mais génèrent une erreur gRPC 429 Resource Exhausted. Consultez la liste des codes et messages d'erreur gRPC.
Requêtes paginées
Les requêtes paginées (par exemple, celles qui contiennent un next_page_token valide) ne sont pas comptabilisées dans le quota d'opérations quotidiennes d'un utilisateur.
Toutefois, les demandes de pagination contenant un jeton de page expiré ou non valide génèrent une exception et sont comptabilisées dans le quota d'opérations quotidiennes.
Les requêtes paginées, telles que les requêtes de recherche, sont également soumises à la limite de Page size cannot exceed 10,000 rows et sont rejetées si elles la dépassent, avec l'erreur INVALID_PAGE_SIZE.
Pour en savoir plus sur la pagination, consultez Parcourir les résultats.
Requêtes qui renvoient des exceptions d'API
Les requêtes refusées avec un SearchAds360Failure sont toujours comptabilisées dans le quota d'opérations quotidiennes de l'utilisateur.
Les requêtes qui échouent, mais ne renvoient pas de SearchAds360Failure (par exemple, en cas d'erreur au niveau du réseau) ne sont pas comptabilisées dans le quota d'opérations quotidiennes de l'utilisateur, car elles n'atteignent jamais le service. Par exemple, une défaillance de la connectivité réseau.
Autres types de limites
Une requête contenant un champ répété (par exemple, une liste d'opérations) avec un trop grand nombre d'éléments peut générer 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 Search Ads 360 Query Language, 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.