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 adicionais pelo uso da 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 por projeto
- 150.000 consultas por dia por projeto
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 de API realizadas por projeto do Google Cloud.
Uma única consulta ou relatório é contabilizado como uma operação, independentemente dos resultados transmitidos por meio de 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
conta 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, a mensagem do gRPC tem 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 exceda 4 MB de tamanho. 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, 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 que contêm um token de página expirado ou inválido vão gerar uma exceção e serão contabilizadas na cota de operações diárias.
Solicitações paginadas, como solicitações 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 os resultados.
Solicitações que retornam exceções da API
As solicitações rejeitadas com uma
SearchAds360Failure
ainda são contabilizadas na
cota de operações diárias 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ções diárias do usuário,
porque elas 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.