A API Search Ads 360 Reporting aplica limites às operações da API para garantir o melhor desempenho do sistema para todos os usuários.
Preços
O uso da API Search Ads 360 Reporting está incluído no preço geral do Search Ads 360. Não há taxas adicionais para usar a API.
Limites de consulta
Os limites a seguir se aplicam a operações de consulta realizadas pelos métodos Search ou SearchStream.
- 3.000 consultas por minuto,projeto e usuário
- 3.000 consultas por minuto em cada projeto
- 150.000 consultas por dia em cada projeto
Limites diários de operações de API
Os limites diários de uso da API são baseados no número de operações feitas por projeto do Google Cloud.
Uma única consulta ou relatório é contado como uma operação, independentemente dos resultados
transmitidos por
SearchAds360Service.SearchStream
ou paginados de uma
chamada de
SearchAds360Service.Search
.
Saiba mais.
A tabela a seguir mostra alguns exemplos de contabilização:
Solicitação da API | Operações contabilizadas para o limite diário |
---|---|
Operação: Search
Contagem: 53 grupos de anúncios
Serviço: |
1 |
Operação: SearchStream
Contagem: 45 campanhas
Serviço: |
1 |
As solicitações que violam esses limites são rejeitadas com o erro:
RESOURCE_EXHAUSTED
.
Solicitações de pesquisa
Uma solicitação Search
ou SearchStream
é contabilizada como uma operação na cota de operações diárias do usuário. Uma solicitação SearchStream
conta como uma operação de API, independentemente do número de lotes.
Limitações do gRPC
Todas as bibliotecas de cliente da API Search Ads 360 Reporting usam o gRPC para gerar solicitações e respostas. Por padrão, o gRPC tem um tamanho de mensagem de 4 MB.
As respostas não podem exceder esse limite. Por exemplo, uma solicitação de pesquisa que inclua muitos campos pode gerar uma resposta com mais de 4 MB. Para evitar esse limite, reduza o número de campos selecionados, o tamanho da página ou use streaming.
As solicitações que violam essa limitação não geram um
SearchAds360Error
, mas um
erro gRPC 429 Resource Exhausted
. Consulte a lista de mensagens e códigos de erro do gRPC.
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ções diárias de um usuário.
No entanto, as solicitações de paginação com um token de página expirado ou inválido geram uma exceção e são contabilizadas na cota de operações diárias.
As solicitações paginadas, como as de pesquisa, também estão sujeitas à limitação de Page size cannot exceed 10,000 rows
e serão rejeitadas se violarem esse limite, com o erro: INVALID_PAGE_SIZE
.
Para mais detalhes sobre paginação, consulte Como percorrer resultados.
Solicitações que retornam exceções de API
As solicitações rejeitadas com um
SearchAds360Failure
ainda são contabilizadas na
cota de operação diária do usuário.
As solicitações que falham, mas não retornam um
SearchAds360Failure
, como de um erro no
nível da rede, não são contabilizadas na cota de operação diária do usuário,
já que as solicitações nunca chegam ao serviço. Um exemplo disso é uma
falha de conectividade de rede.
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.
Ao fazer uma consulta na Linguagem de consulta do Search Ads 360, 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.