A Google Ads API aplica limites a operações da API, como o número de operações que podem ser enviadas em uma única solicitação de modificação. Veja na tabela abaixo alguns dos limites e cotas importantes que você precisa conhecer.
| Tipo de solicitação, limitação e código de erro | |||
|---|---|---|---|
| Solicitações paginadas | 10.000 linhas por página |
INVALID_PAGE_SIZE
|
|
| Operações com acesso básico | 15.000 operações de API por dia |
RESOURCE_EXHAUSTED
|
|
| Solicitações de mutação | 10.000 operações por solicitação |
TOO_MANY_MUTATE_OPERATIONS
|
|
| Solicitações do serviço de planejamento | 1 QPS |
RESOURCE_EXHAUSTED
|
|
| Solicitações do serviço de upload de conversões | 2.000 conversões por solicitação |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
| Solicitações de serviço de faturamento e orçamento da conta | 1 operação por solicitação de mutação |
TOO_MANY_MUTATE_OPERATIONS
|
|
Limites de operação diária da API
Os limites de uso diário da API são baseados no número de operações da API feitas por token de desenvolvedor. As operações da API são a soma total das solicitações de recebimento e operações de mutação. Os limites de operações diárias da API dependem do nível de acesso do token de desenvolvedor. O guia Níveis de acesso e uso permitido descreve os limites de operação da API específicos para cada nível de acesso.
As solicitações que violam esses limites são rejeitadas com o erro:
RESOURCE_EXHAUSTED.
Limitações do gRPC
Todas as bibliotecas de cliente da API Google Ads usam o gRPC para gerar solicitações e respostas. Por padrão, o gRPC tem um tamanho de mensagem de 4 MB, mas nossas bibliotecas de cliente definem o tamanho máximo da mensagem como 64 MB para aumentar a eficiência.
As respostas não podem exceder esse limite. Por exemplo, uma solicitação de pesquisa que inclui muitos campos pode gerar uma resposta com mais de 64 MB. Para evitar esse limite, reduza o número de campos selecionados, o tamanho da página ou use streaming. Para mutações, envie menos operações por solicitação.
As solicitações que violam essa limitação não geram um GoogleAdsError, mas sim um erro gRPC 429 Resource Exhausted. Consulte a lista de mensagens e códigos de erro do gRPC.
Solicitações de mutação
Além de ser contabilizada na cota diária de operações do usuário, uma solicitação de mutação não pode conter mais de 10.000 operações por solicitação.
As solicitações que violam essa limitação são rejeitadas com o erro:
TOO_MANY_MUTATE_OPERATIONS.
Veja abaixo outros limites e considerações para serviços e tipos de solicitação específicos.
Solicitações de pesquisa
Uma solicitação Search ou SearchStream conta como uma operação na cota diária de operações do usuário. Uma solicitação SearchStream conta como uma operação de API,
independentemente do número de lotes.
Solicitações paginadas
As solicitações paginadas (por exemplo, aquelas que contêm um
next_page_token válido) não são contabilizadas na cota de operação diária de um usuário.
No entanto, as solicitações de paginação que contêm um token de página expirado ou inválido geram uma exceção e são contabilizadas na cota de operação diária.
Solicitações que são paginadas, como solicitações de pesquisa, também estão sujeitas à limitação
Page size cannot exceed 10,000 rows e são rejeitadas se violarem
esse limite com o erro:
INVALID_PAGE_SIZE.
Para mais detalhes sobre paginação, consulte Como percorrer os resultados.
Outros tipos de solicitações
Uma solicitação que não é Get, Mutate, Search ou SearchStream conta como uma operação na cota diária de operações do usuário.
Veja alguns exemplos dessas solicitações:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Solicitações que retornam exceções de API
As solicitações rejeitadas com uma
GoogleAdsFailure ainda são consideradas na
cota de operações diárias do usuário.
As solicitações que falham, mas não retornam um
GoogleAdsFailure, como de um erro no
nível da rede, não serão contabilizadas na cota de operação diária do usuário,
já que elas nunca alcançariam o serviço. Um exemplo disso é uma
falha na conectividade de rede.
Serviços de planejamento
Devido ao custo e à complexidade, os métodos de serviço do Planning listados abaixo estão sujeitos a limites separados de outros tipos de solicitações.
Limitado a 1 solicitação por segundo por CID ou token de desenvolvedor:
KeywordPlanService.GetKeywordPlanKeywordPlanService.GenerateHistoricalMetricsKeywordPlanService.GenerateForecastMetrics
As solicitações que violam essas limitações são rejeitadas com o erro:
RESOURCE_EXHAUSTED.1 QPS é calculado como 60 solicitações a cada 60 segundos.
Lembre-se desses limites ao criar um plano de palavras-chave.
| Objeto do plano de palavras-chave | Número máximo |
|---|---|
KeywordPlan por conta |
10.000 |
KeywordPlanAdGroup por KeywordPlan |
200 |
KeywordPlanAdGroupKeyword por KeywordPlan |
10.000 |
KeywordPlanCampaignKeyword (palavras-chave negativas) |
1.000 |
KeywordPlanCampaign por KeywordPlan |
1 |
Serviço de upload de conversões
Limitado a 2.000 conversões de chamadas ou cliques por solicitação:
As solicitações que violam esses limites são rejeitadas com o erro:
TOO_MANY_CONVERSIONS_IN_REQUEST.
Serviço de upload de ajuste de conversão
Limitado a 2.000 ajustes de conversão por solicitação:
As solicitações que violam esses limites são rejeitadas com o erro:
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Serviços de faturamento e orçamento de contas
As mutações só podem ser feitas em contas configuradas para faturamento mensal.
As solicitações que violam essa limitação são rejeitadas com o erro:
MUTATE_NOT_ALLOWED.Somente 1 operação é permitida para solicitações de modificação.
As solicitações que violam essa limitação são rejeitadas com o erro:
TOO_MANY_MUTATE_OPERATIONS.Aguarde pelo menos 12 horas entre as alterações no pedido com limite de orçamento na mesma conta. Fazer mudanças antes de 12 horas pode resultar em falhas irrecuperáveis que só podem ser resolvidas pelo representante da sua conta do Google Ads.
Convites para contas de clientes
Novos usuários podem ser convidados para contas de cliente atuais com o CustomerUserAccessService. Como
essa funcionalidade envia e-mails de convite para outros usuários, ela tem o potencial
de ser mal utilizada e, portanto, há limitações no comportamento:
Os usuários não podem receber mais de um convite pendente para a mesma conta de cliente. Se uma solicitação subsequente for feita para enviar um convite a um usuário que já tenha um convite pendente, este erro será retornado:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.As contas de cliente não podem ter mais de 70 convites pendentes por vez. Se for enviada uma solicitação que faz com que esse valor seja excedido, este erro será retornado:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.
Dados do usuário
Os dados do usuário são gerenciados com
UserDataService e
OfflineUserDataJobService.
Em uma determinada operação de criação/remoção de UserData, cada
conjunto de user_identifiers
precisa ser específico para um único usuário.
Para aplicar isso,
um erro OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
ou
UserDataError.TOO_MANY_USER_IDENTIFIERS
é retornado quando há mais de 20 user_identifiers em um
conjunto UserData.
Outros tipos de limites
Um campo repetido, como uma lista de operações, que tem muitos itens em uma solicitação pode gerar o erro REQUEST_SIZE_LIMIT_EXCEEDED.
Essa mesma mensagem de erro também pode ocorrer devido a outros problemas.
Se você encontrar essa limitação e estiver fazendo solicitações que usam um campo repetido, tente reduzir o número de itens no campo repetido implantando uma lista de operações em uma solicitação de modificação.
Ao fazer uma consulta GAQL, o número máximo de itens
em uma cláusula IN é 20.000. Se você exceder esse limite, um erro
FILTER_HAS_TOO_MANY_VALUES
será retornado.