Limites de uso

Os limites de uso protegem a infraestrutura do Google contra processos automatizados que usam a API Display & Video 360 de maneira inadequada. Eles garantem que as ações de um desenvolvedor não possam afetar negativamente a comunidade como um todo.

Limites de cota de solicitações de API

A API Display & Video 360 usa dois tipos de limites:

  • Limites de cota total, que são contabilizados em todas as solicitações relevantes.
  • Limites de cota de gravação, que são contabilizados em todas as solicitações relevantes feitas para gravar métodos. Os métodos de gravação são definidos como métodos, como create, patch, delete ou bulkEdit, que modificam recursos. Observe que alguns métodos consomem mais cota de gravação do que outros.

Se o projeto exceder qualquer um desses limites, poderá ocorrer uma limitação.

Limite de cota para todo o projeto

Os seguintes limites de cota padrão são compartilhados por todos os recursos e métodos da API Display & Video 360:

  • Total de solicitações por minuto e por projeto: 1500
  • Solicitações de gravação por minuto e projeto:700

Limites de cota de solicitações específicas do anunciante

Métodos que especificam um ID de anunciante no URL de solicitação são descontados dos limites adicionais de cota "por anunciante por projeto".

Todas as solicitações com um ID do anunciante especificado no caminho do URL, como as solicitações para os serviços advertisers.lineItems, advertisers.creatives ou advertisers.channels, vão ser contabilizadas nos seguintes limites de cota:

  • Total de solicitações por minuto, anunciante e projeto: 300
  • Solicitações de gravação por minuto, anunciante e projeto: 150

Métodos de gravação intensiva

Os métodos de API a seguir consomem muita gravação, o que significa que eles usam uma quantidade significativa de recursos de produto e, como resultado, consomem mais cota de solicitações de gravação do que outras solicitações de gravação.

As solicitações feitas para métodos de gravação intensa são contabilizadas como cinco consultas de gravação ao calcular o consumo da cota de solicitações de gravação. Por exemplo, 100 solicitações de gravação padrão e 21 solicitações de gravação intensiva (nenhuma das quais especifica um anunciante) feitas em um minuto seriam contadas como 205 consultas de gravação (100 + (21 * 5) = 205) e excederiam o limite de cota de solicitação geral existente de 200 consultas de gravação por minuto.

Os métodos a seguir são considerados com uso intensivo de gravação:

Limites de cota excedentes

No caso improvável de falha da solicitação por exceder um limite de solicitações de API, a API retornará um código de status HTTP e o motivo do erro. Além disso, o corpo da resposta contém uma descrição detalhada do que causou o erro.

A lista a seguir mostra os possíveis erros e ações recomendadas para falhas de solicitação causadas por exceder os limites de solicitação de API.

Programar RPC A mensagem Ação recomendada
429 RESOURCE_EXHAUSTED O recurso foi esgotado (por exemplo, verificar cota). Analise seu uso do Console de APIs do Google e modifique seu fluxo de trabalho para paralelizar melhor as solicitações feitas em diferentes anunciantes ou, de modo geral, desacelere a taxa de envio das solicitações.

Não é possível solicitar aumentos de cotas da API Display & Video 360.