A API Google Ads impõe limites sobre as operações da API, como o número de operações que podem ser enviadas em uma única solicitação de mutação. A tabela abaixo resume alguns dos conhecer os limites e as cotas importantes.
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 Modificar | 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ços de faturamento e de orçamento da conta | Uma operação por solicitação de mutação |
TOO_MANY_MUTATE_OPERATIONS
|
Limites diários de operação de API
Os limites diários de uso da API são baseados no número de operações feitas por token de desenvolvedor. API operações são a soma total de solicitações get e operações mutate. Limites para operações diárias da API depende do nível de acesso do token de desenvolvedor. O Guia de níveis de acesso e uso permitido descreve os limites de operação de 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 gRPC para gerar solicitações e respostas. Por padrão, o gRPC tem de 4 MB, mas nossas bibliotecas de cliente definem o tamanho máximo da mensagem para 64 MB para aumentar a eficiência.
As respostas não podem exceder esse limite. Por exemplo, uma solicitação de pesquisa que incluir muitos campos pode gerar uma resposta com mais de 64 MB de tamanho. Para evitar esse limite, você pode reduzir o número de campos selecionados, reduzir o tamanho ou use streaming. Para mutates, envie menos operações por solicitação.
As solicitações que violarem essa limitação não vão gerar uma
GoogleAdsError
, mas gera
Erro gRPC 429 Resource Exhausted
. Consulte a lista de códigos de erro do gRPC
.
Solicitações de modificação
Além de ser descontado da cota de operações diárias do usuário, um objeto 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 seguinte erro:
TOO_MANY_MUTATE_OPERATIONS
.
Confira outros limites e considerações para serviços e tipos de solicitação específicos descritos abaixo.
Solicitações de pesquisa
Uma solicitação Search
ou SearchStream
conta como uma operação na
a cota de operações diárias. Uma solicitação SearchStream
é contabilizada como uma operação de API
independentemente do número de lotes.
Solicitações paginadas
Solicitações paginadas (por exemplo, solicitações que contêm um endereço
next_page_token
) não são contabilizadas na cota de operações diárias de um usuário.
No entanto, as solicitações de paginação que tiverem um token de página expirado ou inválido
gerar uma exceção e serão contabilizados na cota de operações diárias.
Solicitações paginadas, como solicitações de pesquisa, também estão sujeitas à
Page size cannot exceed 10,000 rows
limitação e será rejeitada se violar
esse limite, com o erro:
INVALID_PAGE_SIZE
.
Para mais detalhes sobre paginação, consulte Como percorrer resultados.
Outros tipos de solicitações
Uma solicitação que não é Get
, Mutate
, Search
ou SearchStream
conta como uma operação na cota de operações diárias do usuário.
Alguns exemplos dessas solicitações incluem:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Solicitações que retornam exceções da API
As solicitações rejeitadas com um
GoogleAdsFailure
ainda são contabilizados nos
a cota de operações diárias do usuário.
Solicitações que falham, mas não retornam uma
GoogleAdsFailure
, como de um erro em
nível da rede, não serão contabilizados na cota de operações diárias do usuário
já que as solicitações nunca chegariam ao serviço. Um exemplo disso é uma
falha de conectividade de rede.
Serviços de planejamento
Devido ao custo e à complexidade, os métodos de serviço do Planning listados abaixo são sujeitos a limites separados de outros tipos de solicitações.
Limitado a 1 solicitação por segundo por CID:
KeywordPlanIdeaService.GenerateKeywordIdeas
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
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.
Limitado a 2 solicitações por segundo por CID:
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 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 faturamento e orçamento da conta
As mudanças só podem ser feitas em contas configuradas para faturamento mensal.
As solicitações que violam essa limitação são rejeitadas com o seguinte erro:
MUTATE_NOT_ALLOWED
.Somente a operação 1 é permitida para solicitações de mutação.
As solicitações que violam essa limitação são rejeitadas com o seguinte erro:
TOO_MANY_MUTATE_OPERATIONS
.Aguarde pelo menos 12 horas entre as alterações do pedido com limite de orçamento e na mesma conta. Fazer alterações antes de 12 horas pode resultar em falhas irrecuperáveis que só podem ser resolvidas pela sua conta do Google Ads representante de vendas.
Convites para contas de clientes
Novos usuários podem ser convidados para contas de clientes existentes com o
CustomerUserAccessService
. Devido ao
essa funcionalidade envia e-mails de convite para outros usuários, tem o potencial
ser usado indevidamente e, portanto, há limitações para seu comportamento:
Os usuários não podem receber mais de um convite pendente para o mesmo cliente do Compute Engine. 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 de uma só vez. Se for enviada uma solicitação que faça 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 as
OfflineUserDataJobService
.
Em uma determinada operação de criação/remoção UserData
, cada
conjunto de user_identifiers
deve ser específico para um único usuário.
Para aplicar isso,
um OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
ou
UserDataError.TOO_MANY_USER_IDENTIFIERS
é retornado quando há mais de 20 user_identifiers
em um
UserData
definido.
Outros tipos de limites
Um campo repetido, como uma lista de operações, que possui muitos itens em um
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 fizer solicitações que usam um parâmetro tente reduzir o número de itens no campo repetido implantando uma lista de operações em uma solicitação de mutação.
Em uma consulta GAQL, o número máximo de itens
em uma cláusula IN
é 20.000. Se você exceder esse limite, uma
FILTER_HAS_TOO_MANY_VALUES
será retornado.