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.
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 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 et 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 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 : RESOURCE_EXHAUSTED.
Requêtes de recherche
Une requête Search ou SearchStream compte comme une opération dans le quota d'opérations quotidiennes 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 incluant de nombreux champs peut générer une réponse de plus de 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 de 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 qui contiennent un next_page_token valide) ne sont pas comptabilisées dans le quota d'opérations quotidiennes d'un utilisateur.
Toutefois, les requêtes 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 Page size cannot exceed 10,000 rows et sont rejetées si elles ne respectent pas cette limite, avec l'erreur : INVALID_PAGE_SIZE.
Pour en savoir plus sur la pagination, consultez la section Parcourir les résultats.
Requêtes renvoyant 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. Par exemple, un échec de la connectivité réseau.
Autres types de limites
Un champ répété, tel qu'une liste d'opérations, qui contient 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 créez 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.