Cette page a été traduite par l'API Cloud Translation.

Limites et quotas d'API

L'API Google Ads impose des limites aux opérations de l'API, comme le nombre d'opérations qui peut être envoyé dans une seule demande mutate. Le tableau suivant récapitule certaines limites et quotas importants à connaître.

Type de requête, limitation et code d'erreur
Opérations avec 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 du service de planification	1 RPS	`RESOURCE_EXHAUSTED`
Requêtes du service d'importation des conversions	2 000 conversions par demande	`TOO_MANY_CONVERSIONS_IN_REQUEST`
Requêtes de service de facturation et de budget de compte	1 opération par demande de mutation	`TOO_MANY_MUTATE_OPERATIONS`

Limites quotidiennes des opérations de l'API

Les limites d'utilisation quotidiennes de l'API sont basées sur le nombre d'API opérations effectuées par jeton de développeur. API correspond à la somme totale des requêtes get et des opérations mutate. Limites pour les opérations quotidiennes de l'API dépend du niveau d'accès du jeton de développeur. La Le guide sur les niveaux d'accès et les utilisations autorisées présente les des limites spécifiques aux opérations d'API pour 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, gRPC dispose d'un de message de 4 Mo, mais nos bibliothèques clientes définissent la taille maximale des messages sur 64 Mo.

Les réponses ne doivent pas dépasser cette limite. Par exemple, une requête de recherche inclut de nombreux champs peut générer une réponse dont la taille dépasse 64 Mo. À contourner cette limite, vous pouvez réduire le nombre de champs sélectionnés ou utiliser streaming. Envoyer moins d'opérations pour les opérations mutate par requête.

Les demandes qui ne respectent pas cette limite ne génèrent pas de GoogleAdsError, mais cette méthode Erreur gRPC 429 Resource Exhausted. Consultez la liste des codes d'erreur gRPC et messages.

Requêtes de mutation

En plus d'être comptabilisée dans le quota d'opérations quotidien de l'utilisateur, une opération mutate ne peut pas contenir plus de 10 000 opérations par requête.

Les requêtes qui ne respectent pas cette limite sont refusées avec l'erreur suivante: TOO_MANY_MUTATE_OPERATIONS

D'autres limites et éléments à prendre en compte pour des services et des types de requêtes spécifiques sont décrits ci-dessous.

Requêtes de recherche

Une requête Search ou SearchStream est comptabilisée comme une opération quota d'opérations quotidien. Une requête SearchStream compte 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 contenant un code next_page_token) ne sont pas comptabilisés 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ère une exception et est comptabilisée dans le quota d'opérations quotidien.

Pour en savoir plus sur la pagination, reportez-vous à la section Paging in 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.

En voici quelques exemples:

Requêtes qui renvoient des exceptions d'API

Les requêtes refusées avec une Les GoogleAdsFailure sont toujours comptabilisées le quota d'opérations quotidien de l'utilisateur.

Les requêtes qui échouent, mais ne renvoient pas GoogleAdsFailure, par exemple en cas d'erreur à l'emplacement au niveau du réseau, n'est pas comptabilisée dans le quota d'opérations quotidien de l'utilisateur puisque les requêtes n'atteignent jamais le service. En voici un exemple : d'échec de connexion réseau.

Services de planification

En raison de leur coût et de leur complexité, les méthodes suivantes du service Planning sont soumis à des limites distinctes de celles des autres types de requêtes.

Limite de 1 requête par seconde et par numéro client:
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur suivante: RESOURCE_EXHAUSTED
1 RPS correspond à 60 requêtes toutes les 60 secondes.
Limite de 2 requêtes par seconde et par numéro client:
- KeywordPlanIdeaService.GenerateAdGroupTheme

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 par clic par demande:
- ConversionUploadService.UploadCallConversions
- ConversionUploadService.UploadClickConversions
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur suivante: TOO_MANY_CONVERSIONS_IN_REQUEST

Service d'importation des ajustements de conversions

Limite de 2 000 ajustements de conversion par demande:
- ConversionAdjustmentUploadService.UploadConversionAdjustments
Les requêtes qui ne respectent pas ces limites sont rejetées avec l'erreur suivante: TOO_MANY_ADJUSTMENTS_IN_REQUEST

Services de facturation et de budget de compte

Les modifications 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 refusées avec l'erreur suivante: MUTATE_NOT_ALLOWED
Seule 1 opération est autorisée pour les demandes de mutation.

Les requêtes qui ne respectent pas cette limite sont refusées avec l'erreur suivante: TOO_MANY_MUTATE_OPERATIONS
Vous devez attendre au moins 12 heures entre chaque modification d'une commande budgétée sur le même compte. Si vous effectuez des modifications avant ce délai, les échecs irrécupérables qui ne peuvent être résolus que par votre compte Google Ads. commercial.

Invitations pour les comptes client

Les nouveaux utilisateurs peuvent être invités dans des comptes clients existants via le CustomerUserAccessService En effet, cette fonctionnalité envoie des e-mails d'invitation à d'autres utilisateurs, à l'usage abusif, et son comportement présente donc des limites:

Les utilisateurs ne peuvent pas recevoir plusieurs invitations en attente pour un même client. de service. Si une nouvelle demande d'envoi d'invitation à un utilisateur est effectuée dispose déjà d'une invitation en attente, l'erreur suivante s'affiche: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
Les comptes client ne peuvent pas comporter plus de 70 invitations en attente simultanées. Si une requête envoyée entraînant le dépassement de cette valeur est envoyée, cette erreur est renvoyé: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED

Données utilisateur

Les données utilisateur sont gérées UserDataService et les OfflineUserDataJobService Dans une opération de création ou de suppression UserData donnée, chaque ensemble de user_identifiers doit être spécifique à un seul utilisateur.

Pour appliquer cela, un OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS ou UserDataError.TOO_MANY_USER_IDENTIFIERS est renvoyée lorsqu'il y a plus de 20 user_identifiers dans une UserData défini.

Autres types de limites

Un champ répété, tel qu'une liste d'opérations, comportant trop d'éléments dans un peut entraîner l'erreur suivante: 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 envoyez des requêtes qui utilisent un essayez de réduire le nombre d'éléments dans le champ répété en déployant liste des opérations dans une requête mutate.

Lors d'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 FILTER_HAS_TOO_MANY_VALUES s'affiche.

Vue d'ensemble

Limites du système