A API Search Ads 360 Reporting impõe limites às operações de API para garantir a performance ideal 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 extras 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 por projeto por usuário
- 3.000 consultas por minuto por projeto
- 150.000 consultas por dia por projeto
Limites diários de operação da API
Os limites de uso diário da API são baseados no número de operações de API feitas por projeto do Google Cloud.
Uma única consulta ou relatório é contabilizado como uma operação, independentemente de os resultados
serem transmitidos por streaming com
SearchAds360Service.SearchStream
ou paginados de uma
SearchAds360Service.Search
chamada. 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: SearchAds360Service
|
1 |
Operação: SearchStream
Contagem: 45 campanhas Serviço: SearchAds360Service
|
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ção diária do usuário. Uma solicitação SearchStream é contabilizada 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 inclui muitos campos pode gerar uma resposta que excede 4 MB. Para evitar esse limite, reduza o número de campos selecionados, o tamanho da página ou use o streaming.
As solicitações que violam essa limitação não geram um
SearchAds360Error,
mas geram um erro 429 Resource Exhausted do gRPC. Consulte a
lista de códigos e mensagens de erro do gRPC.
Solicitações paginadas
As solicitações paginadas (por exemplo, solicitações 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.
As solicitações paginadas, como as de pesquisa, também estão sujeitas à
Page size cannot exceed 10,000 rows limitação e são rejeitadas se violarem
esse limite, com o erro:
INVALID_PAGE_SIZE.
Para mais detalhes sobre a paginação, consulte Paginação de 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 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 da 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
FILTER_HAS_TOO_MANY_VALUES
erro será retornado.