Limites de uso

Os limites de uso protegem a infraestrutura do Google de processos automatizados que usam a API Display & Video 360 de maneira inadequada. Elas garantem que as ações de um desenvolvedor não afetem negativamente a comunidade de modo mais amplo.

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 usados para todas as solicitações relevantes.
  • Limites de cota de gravação, que são contados 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. Alguns métodos consomem mais cota de gravação do que outros.

Se o projeto exceder qualquer um desses limites, pode ocorrer um limite de taxa.

Limite de cota do projeto

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

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

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

Os métodos que especificam um ID de anunciante no URL da solicitação são contabilizados em relação aos limites de cota "por anunciante e por projeto".

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

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

Métodos de gravação intensa

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

As solicitações feitas para métodos com gravação intensiva são contadas como cinco consultas de gravação ao calcular o consumo de cota de solicitação de gravação. Por exemplo, 100 solicitações de gravação padrão e 21 solicitações com gravação intensa (nenhuma delas 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ções gerais de 200 consultas de gravação por minuto.

Os seguintes métodos são considerados de gravação intensa:

Limites de cota excedentes

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

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

Código RPC Mensagem Ação recomendada
429 RESOURCE_EXHAUSTED O recurso foi esgotado (por exemplo, verifique a cota). Analise o uso no Console de APIs do Google e modifique seu fluxo de trabalho para paralelizar melhor as solicitações feitas com diferentes anunciantes ou, de forma mais geral, diminua a taxa de envio de solicitações.

Não é possível solicitar aumentos para os limites de cota da API Display & Video 360.