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 ci-dessous résume certaines les limites et quotas importants à connaître.

Type de requête, limitation et code d'erreur
Requêtes paginées 10 000 lignes par page INVALID_PAGE_SIZE
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. À éviter cette limite, vous pouvez réduire le nombre de champs sélectionnés, réduire ou utilisez le streaming. Pour les opérations mutate, en envoyer moins 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 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 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.

Les requêtes paginées, telles que les requêtes de recherche, sont également soumises au Page size cannot exceed 10,000 rows limite et sont refusés en cas de non-respect cette limite, avec l'erreur suivante: INVALID_PAGE_SIZE.

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 de 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 car 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 du service Planning listées ci-dessous sont soumis à des limites distinctes de celles des autres types de requêtes.

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

Service d'importation des ajustements de conversions

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, elle a le potentiel à l'usage abusif, et son comportement présente donc des limites:

Données utilisateur

Les données utilisateur sont gérées UserDataService et les OfflineUserDataJobService. Dans une opération de création/suppression de 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 est renvoyée.

Précédent
Vue d'ensemble
Suivant
Limites du système