A API Google Ads impõe limites às operações de API, como o número de operações que podem ser enviadas em uma única solicitação de mutação. A tabela a seguir resume alguns dos limites e cotas importantes que você precisa conhecer.
| Tipo de solicitação, limitação e código de erro | ||
|---|---|---|
| Operações com o nível de 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 | Uma operação por solicitação de mutação |
TOO_MANY_MUTATE_OPERATIONS
|
Limites diários de operações da API
Os limites diários de uso da API são baseados no número de operações de API feitas por token de desenvolvedor. As operações de API são a soma total de solicitações de recebimento e operações de mutação. Os limites para operações diárias da API dependem do nível de acesso do token de desenvolvedor. O guia de níveis de acesso e uso permitido descreve os limites específicos de operação da API 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 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 geram um
erro 429 Resource Exhausted do gRPC. Consulte a lista de códigos e mensagens de erro do gRPC.
Solicitações de mutação
Além de contar na cota de operação diária do usuário, uma solicitação mutate 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.
Outros limites e considerações para serviços e tipos de solicitação específicos são descritos a seguir.
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, independente do número de lotes.
Solicitações paginadas
As solicitações paginadas (por exemplo, as 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 diária de operações.
Para mais detalhes sobre paginação, consulte Como fazer paginação de resultados.
Outros tipos de solicitações
Uma solicitação que não seja Get, Mutate, Search ou SearchStream
conta como uma operação na cota diária de operações do usuário.
Alguns exemplos dessas solicitações incluem:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Solicitações que retornam exceções de API
As solicitações rejeitadas com um
GoogleAdsFailure ainda são contabilizadas na
cota diária de operações do usuário.
As solicitações que falham, mas não retornam um
GoogleAdsFailure, como um erro no nível
da rede, não são contabilizadas na cota de operação diária do usuário
porque nunca chegam ao serviço. Um exemplo disso é uma falha de conectividade de rede.
Serviço de planejamento de palavras-chave
Devido ao custo e à complexidade, os seguintes métodos do serviço de Planejamento de palavras-chave estão sujeitos a limites separados de outros tipos de solicitações.
Limitado a 1 solicitação por segundo por CID:
KeywordPlanIdeaService.GenerateKeywordIdeasKeywordPlanIdeaService.GenerateKeywordHistoricalMetricsKeywordPlanIdeaService.GenerateKeywordForecastMetrics
As solicitações que violarem essas limitações serão rejeitadas com o erro:
RESOURCE_EXHAUSTED.Uma QPS é calculada como 60 solicitações por 60 segundos.
Limitado a 2 solicitações por segundo por CID:
Lembre-se desses limites ao criar um plano de palavras-chave.
| Objeto de 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 insights sobre público-alvo
Os métodos a seguir em
AudienceInsightsService (link em inglês)
estão sujeitos a limites de cota específicos.
Limitado a aproximadamente 200 solicitações por dia por CID:
Limitado a 2 solicitações por segundo por token de desenvolvedor:
Serviço de upload de conversões
Limitado a 2.000 conversões de chamada ou clique 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 orçamento da conta e faturamento
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.Apenas uma operação é permitida para solicitações de mutaçã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 mudanças de pedido 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 esse recurso envia convites por e-mail para outros usuários, ele pode ser usado de forma indevida. Por isso, há limitações no comportamento dele:
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á tem 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 uma solicitação for enviada e fizer 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 o
UserDataService e o
OfflineUserDataJobService.
Em uma determinada operação de criação ou 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 será retornado quando houver mais de 20 user_identifiers em um conjunto UserData.
Você pode usar até 100.000 identificadores de usuários,não importa o número de operações.
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 ser causada por 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 mutaçã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.