L'API Google Ads applique des limites aux opérations de l'API, comme le nombre d'opérations pouvant être envoyées dans une seule requête de modification. Le tableau suivant récapitule quelques-unes des limites et des quotas importants à connaître.
| Type de requête, limite et code d'erreur | ||
|---|---|---|
| Opérations avec accès de base | 15 000 opérations API par jour |
RESOURCE_EXHAUSTED
|
| Requêtes de modification | 10 000 opérations par requête |
TOO_MANY_MUTATE_OPERATIONS
|
| Demandes de planification de services | 1 RPS |
RESOURCE_EXHAUSTED
|
| Requêtes du service d'importation des conversions | 2 000 conversions par demande |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
| Demandes de service de facturation et de budget de compte | 1 opération par requête de modification |
TOO_MANY_MUTATE_OPERATIONS
|
Limites quotidiennes des opérations d'API
Les limites d'utilisation quotidiennes de l'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 mutate. Les limites des opérations quotidiennes d'API dépendent du niveau d'accès du jeton de développeur. Le guide sur les niveaux d'accès et les utilisations autorisées décrit les limites d'opérations d'API spécifiques à chaque niveau d'accès.
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur suivante : RESOURCE_EXHAUSTED.
Limites de gRPC
Toutes les bibliothèques clientes de l'API Google Ads 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, mais nos bibliothèques clientes définissent la taille maximale des messages sur 64 Mo afin d'améliorer 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 de plus de 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 limitation ne génèrent pas d'erreur GoogleAdsError, mais génèrent une erreur gRPC 429 Resource Exhausted. Consultez la liste des codes et messages d'erreur gRPC.
Requêtes de modification
En plus d'être comptabilisée dans le quota d'opérations quotidiennes de l'utilisateur, une requête de modification 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 avec l'erreur suivante : TOO_MANY_MUTATE_OPERATIONS.
Vous trouverez ci-dessous des limites et des considérations supplémentaires concernant des services et des types de requêtes spécifiques.
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.
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.
Pour en savoir plus sur la pagination, consultez la section Parcourir les résultats.
Autres types de requêtes
Une requête qui n'est pas une requête Get, Mutate, Search ou SearchStream compte comme une opération dans le quota d'opérations quotidien de l'utilisateur.
Voici quelques exemples de ces demandes:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Requêtes renvoyant des exceptions d'API
Les requêtes rejetées avec un GoogleAdsFailure 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 GoogleAdsFailure, par exemple en raison d'une erreur au niveau du réseau, ne sont pas comptabilisées dans le quota d'opérations quotidiennes de l'utilisateur, car elles n'atteindront jamais le service. Par exemple, un échec de la connectivité réseau.
Services de planification
En raison des coûts et de la complexité, les méthodes de service de planification suivantes sont soumises à des limites distinctes des autres types de requêtes.
Limité à 1 requête par seconde et par numéro client:
KeywordPlanIdeaService.GenerateKeywordIdeasKeywordPlanIdeaService.GenerateKeywordHistoricalMetricsKeywordPlanIdeaService.GenerateKeywordForecastMetrics
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur :
RESOURCE_EXHAUSTED.1 RPS correspond à 60 requêtes par 60 secondes.
Limité à 2 requêtes par seconde et par numéro client:
Tenez compte de ces limites lorsque vous créez un plan de mots clés.
| Objet de plan de mots clés | 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 d'importation des conversions
Limité à 2 000 conversions par appel ou clic par requête:
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur :
TOO_MANY_CONVERSIONS_IN_REQUEST.
Service d'importation des ajustements de conversions
Limite de 2 000 ajustements de conversion par demande:
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur :
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Services de facturation et de budget du compte
Les mutations ne peuvent être effectuées que sur les comptes configurés pour la facturation mensuelle.
Les requêtes qui ne respectent pas cette limite sont rejetées avec l'erreur suivante :
MUTATE_NOT_ALLOWED.Seule 1 opération est autorisée pour les requêtes mutate.
Les requêtes qui ne respectent pas cette limite sont rejetées avec l'erreur :
TOO_MANY_MUTATE_OPERATIONS.Vous devez attendre au moins 12 heures entre chaque modification de l'ordre des budgets dans le même compte. Si vous effectuez des modifications avant ce délai, cela peut entraîner des échecs irrécupérables, qui ne peuvent être résolus que par votre responsable de compte Google Ads.
Invitations aux 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 plus d'une invitation en attente pour le même compte client. Si une requête ultérieure est envoyée pour envoyer une invitation à un utilisateur qui dispose déjà d'une invitation en attente, l'erreur suivante 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 les UserDataService et OfflineUserDataJobService.
Dans une opération de création ou de suppression de UserData 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.
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.
Si vous rencontrez cette limitation et 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.