A API Search Ads 360 Reporting aplica limites às operações da API para garantir o desempenho 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 e 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 diários de uso 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 é contada como uma operação, independentemente dos resultados
que estão sendo transmitidos por
SearchAds360Service.SearchStream
ou paginados de uma
chamada 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 é contabilizada como uma operação de API, independente do número de lotes.
Limitações do gRPC
Todas as bibliotecas de cliente da API Search Ads 360 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 com mais de 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 gRPC 429 Resource Exhausted. Consulte a lista de códigos e
mensagens de erro do gRPC.
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 vão
gerar uma exceção e contar para a cota de operação diária.
As solicitações paginadas, como as 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.
Solicitações que retornam exceções de API
As solicitações rejeitadas com um
SearchAds360Failure ainda contam para a
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 na 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 erro
FILTER_HAS_TOO_MANY_VALUES
será retornado.