Cota

A cota da API Display & Video 360 limita a taxa em que um projeto pode fazer solicitações à API.

Siga estas práticas recomendadas para usar melhor sua cota da API Display & Video 360.

Fazer solicitações de vários anunciantes ao mesmo tempo

A cota da API Display & Video 360 é definida por projeto e por anunciante. Os limites de cota do projeto restringem as solicitações feitas por um projeto. A cota do anunciante limita as solicitações feitas por um projeto a um anunciante.

Para usar toda a cota do projeto, faça solicitações de vários anunciantes ao mesmo tempo.

Usar parâmetros de consulta list

Use parâmetros de consulta do método list para incluir apenas os recursos desejados. Menos recursos precisam de menos solicitações para serem listados.

Os métodos list oferecem três parâmetros principais:

  • pageSize define o número de recursos que podem ser retornados pela solicitação. O tamanho de página padrão depende do método. Defina o valor mais alto para listar mais recursos por solicitação.
  • filter limita os recursos listados pelos critérios fornecidos. Defina como para listar apenas um subconjunto de recursos. Consulte Solicitações de lista de filtros para mais informações.
  • orderBy ordena os recursos listados pela propriedade especificada. Defina isso para recuperar o teto ou o piso da lista de recursos com menos solicitações.

Usar funções em massa e em todos os recursos

As funções em massa e em todo o recurso realizam tarefas complexas. Uma única solicitação para esses métodos pode substituir várias solicitações para outros.

Para mais informações sobre esses métodos, consulte Solicitações em massa.

IDs de cache

Muitas ações da API Display & Video 360 exigem IDs recuperados usando a API. Por exemplo, IDs de opções de segmentação e IDs de público-alvo do Google. Armazene IDs localmente para não precisar recuperá-los sempre.

Usar IDs de recursos descontinuados ou excluídos pode retornar um erro. Recupere os IDs armazenados em cache semanalmente para confirmar o status deles.

Usar a espera exponencial

A espera exponencial é uma estratégia de tratamento de erros. Ele tenta novamente as solicitações em um período de tempo cada vez maior.

Ao fazer polling de uma tarefa de longa duração, como um download de SDF, uma estratégia de espera exponencial pode reduzir o número de solicitações enviadas.

Nossos exemplos de código de download do SDF usam espera exponencial com nossas bibliotecas de cliente. Confira a seguir um exemplo de fluxo de espera exponencial:

  • Recupere o objeto Operation com a solicitação get.
    • Se done não for verdadeiro, a tarefa ainda estará em execução.
    • Aguarde 5 segundos mais um número aleatório de segundos e envie novamente a solicitação.
  • Recupere a operação.
    • Se done não for verdadeiro, a tarefa ainda estará em execução.
    • Aguarde 10 segundos mais um número aleatório de segundos e envie a solicitação novamente.
  • Recupere a operação.
    • Se done não for verdadeiro, a tarefa ainda estará em execução.
    • Aguarde 20 segundos mais um número aleatório de segundos e envie a solicitação de novo.
  • Recupere a operação.
    • Se done não for verdadeiro, a tarefa ainda estará em execução.
    • Aguarde 40 segundos mais um número aleatório de segundos e envie a solicitação de novo.
  • Recupere a operação.
    • Se done não for verdadeiro, a tarefa ainda estará em execução.
    • Aguarde 80 segundos mais um número aleatório de segundos e envie a solicitação novamente.
  • Continue esse padrão até que done seja verdadeiro ou que um tempo máximo decorrido seja atingido.