L'API Google Ads applique des limites aux opérations d'API, comme le nombre d'opérations pouvant être envoyées dans une seule requête mutate. Le tableau suivant récapitule certaines des limites et quotas importants à connaître.
| Type de requête, limite et code d'erreur | ||
|---|---|---|
| Opérations avec le niveau d'accès de base | 15 000 opérations d'API par jour |
RESOURCE_EXHAUSTED
|
| Requêtes de mutation | 10 000 opérations par requête |
TOO_MANY_MUTATE_OPERATIONS
|
| Demandes concernant le service de planification | 1 RPS |
RESOURCE_EXHAUSTED
|
| Demandes concernant le service d'importation de conversions | 2 000 conversions par requête |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
| Demandes concernant la facturation et le budget du compte | 1 opération par requête de mutation |
TOO_MANY_MUTATE_OPERATIONS
|
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 jeton de développeur. Les opérations d'API correspondent à la somme totale des requêtes GET et des opérations de mutation. Les limites des opérations d'API quotidiennes dépendent du niveau d'accès du jeton de développeur. Le guide sur les niveaux d'accès et l'utilisation autorisée décrit les limites spécifiques des opérations d'API pour chaque niveau d'accès.
Les requêtes qui ne respectent pas ces limites sont rejetées et renvoient l'erreur suivante : RESOURCE_EXHAUSTED.
Limites de gRPC
Toutes les bibliothèques clientes de l'API Google Ads 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, mais nos bibliothèques clientes définissent la taille maximale des messages sur 64 Mo afin d'accroître l'efficacité.
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 64 Mo. Pour éviter cette limite, vous pouvez réduire le nombre de champs sélectionnés ou utiliser le streaming. Pour les mutations, envoyez moins d'opérations par requête.
Les requêtes qui ne respectent pas cette limite ne génèrent pas de GoogleAdsError, mais génèrent une erreur gRPC 429 Resource Exhausted. Consultez la liste des codes et messages d'erreur gRPC.
Requêtes de mutation
En plus d'être comptabilisée dans le quota d'opérations quotidiennes de l'utilisateur, une requête mutate ne peut pas contenir plus de 10 000 opérations par requête.
Les requêtes qui ne respectent pas cette limite sont rejetées et renvoient l'erreur TOO_MANY_MUTATE_OPERATIONS.
Vous trouverez ci-dessous des limites et des points à prendre en compte supplémentaires pour certains services et types de demandes.
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.
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.
Pour en savoir plus sur la pagination, consultez Parcourir les résultats.
Autres types de demandes
Une requête qui n'est pas une requête Get, Mutate, Search ou SearchStream est comptabilisée comme une opération dans le quota d'opérations quotidiennes de l'utilisateur.
Voici quelques exemples de demandes de ce type :
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Requêtes qui renvoient des exceptions d'API
Les requêtes refusées avec un GoogleAdsFailure sont toujours comptabilisées dans le quota d'opérations quotidiennes de l'utilisateur.
Les requêtes qui échouent, mais ne renvoient pas de GoogleAdsFailure (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.
Service de planification des mots clés
En raison de leur coût et de leur complexité, les méthodes de service de planification des mots clés suivantes sont soumises à des limites distinctes des autres types de requêtes.
Limité à une demande par seconde et par numéro client :
KeywordPlanIdeaService.GenerateKeywordIdeasKeywordPlanIdeaService.GenerateKeywordHistoricalMetricsKeywordPlanIdeaService.GenerateKeywordForecastMetrics
Les requêtes qui ne respectent pas ces limites sont rejetées et renvoient l'erreur
RESOURCE_EXHAUSTED.1 RPS correspond à 60 requêtes par période de 60 secondes.
Limité à 2 requêtes par seconde et par numéro client :
Gardez ces limites à l'esprit lorsque vous créez un plan de mots clés.
| Objet KeywordPlan | Nombre maximal |
|---|---|
KeywordPlan par compte |
10 000 |
KeywordPlanAdGroup par KeywordPlan |
200 |
KeywordPlanAdGroupKeyword par KeywordPlan |
10 000 |
KeywordPlanCampaignKeyword (mots clés à exclure) |
1 000 |
KeywordPlanCampaign par KeywordPlan |
1 |
Service Insights sur l'audience
Les méthodes suivantes dans les méthodes AudienceInsightsService sont soumises à des limites de quota spécifiques.
Limité à environ 200 requêtes par jour et par numéro client :
Limité à 2 requêtes par seconde et par jeton de développeur :
Service d'importation des conversions
Limité à 2 000 conversions par appel ou par clic par demande :
Les requêtes qui ne respectent pas ces limites sont rejetées et renvoient l'erreur suivante :
TOO_MANY_CONVERSIONS_IN_REQUEST.
Service d'importation des ajustements de conversions
Limité à 2 000 ajustements de conversions par requête :
Les requêtes qui ne respectent pas ces limites sont rejetées et renvoient l'erreur suivante :
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Services de facturation et de budget de compte
Les mutations ne peuvent être effectuées que sur des comptes configurés pour la facturation mensuelle.
Les requêtes qui ne respectent pas cette limite sont rejetées et renvoient l'erreur
MUTATE_NOT_ALLOWED.Seule une opération est autorisée pour les requêtes de mutation.
Les requêtes qui ne respectent pas cette limite sont rejetées et renvoient l'erreur
TOO_MANY_MUTATE_OPERATIONS.Vous devez attendre au moins 12 heures entre chaque modification de bon de commande de budget pour le même compte. Si vous apportez des modifications avant que 12 heures ne se soient écoulées, cela peut entraîner des échecs irrécupérables qui ne peuvent être résolus que par votre représentant de compte Google Ads.
Invitations à des comptes client
Vous pouvez inviter de nouveaux utilisateurs à rejoindre des comptes client existants avec CustomerUserAccessService. Étant donné que cette fonctionnalité envoie des e-mails d'invitation à d'autres utilisateurs, elle peut être utilisée de manière abusive. Son comportement est donc limité :
Les utilisateurs ne peuvent pas recevoir plusieurs invitations en attente pour le même compte client. Si une demande ultérieure est effectuée pour envoyer une invitation à un utilisateur qui a déjà une invitation en attente, cette erreur est renvoyée :
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.Les comptes client ne peuvent pas avoir plus de 70 invitations en attente à la fois. Si une requête est envoyée et que cette valeur est dépassée, l'erreur suivante est renvoyée :
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.
Données utilisateur
Les données utilisateur sont gérées avec UserDataService et OfflineUserDataJobService.
Dans une opération UserData de création ou de suppression donnée, chaque ensemble de user_identifiers doit être spécifique à un seul utilisateur.
Pour appliquer cette règle, une erreur OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS ou UserDataError.TOO_MANY_USER_IDENTIFIERS est renvoyée lorsqu'un ensemble UserData contient plus de 20 user_identifiers.
Vous pouvez utiliser jusqu'à 100 000 identifiants utilisateur,quel que soit le nombre d'opérations.
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.
Si vous rencontrez cette limitation et que vous effectuez des requêtes qui utilisent un champ répété, essayez de réduire le nombre d'éléments dans le champ répété en déployant une liste d'opérations dans une requête mutate.
Lorsque vous effectuez une requête GAQL, 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.