Fluxos de trabalho de API

Este guia descreve fluxos de trabalho comuns da API para criar, recuperar e atualizar pacotes de leilão no Display &Video 360.

Receber uma lista de pacotes de leilão

Chame a LIST API. Oferece suporte à filtragem por external_deal_id.

Criar um pacote de leilão

  1. external_deal_id precisa ser exclusivo. Chame LIST com external_deal_id para saber se o ID já foi usado.
  2. Chame a Create API. Um nome exclusivo será atribuído e poderá ser usado para receber o pacote criado.
  3. Chame a Get API para conferir os detalhes do pacote de leilão criado.
  4. Opcional: faça upload de um logotipo para o pacote criado.

Atualizar o pacote de leilão

  1. Se você não armazenar o nome do pacote de leilão criado, chame a LIST API filtrada por external_deal_id para receber o pacote que você quer atualizar.
  2. Atualize os campos com base nos resultados da API LIST.
  3. Chame a API Patch para atualizar o pacote de leilão. O updateMask é obrigatório. Ele indica a quais campos você quer aplicar a atualização. Somente os campos que podem ser atualizados podem ser definidos no updateMask.

Processo Beta

A única diferença entre o Beta e o GA é que, durante o Beta, os pacotes de leilão criados precisam ter o status definido como DISCOVERY_OBJECT_STATUS_PAUSED, e o status não pode ser atualizado. Os pacotes PAUSED não aparecem na interface do DV360. Isso oferece às exchanges uma maneira de testar a integração da API sem mostrar pacotes de teste.

É comum criar todos os pacotes "reais" no Beta como PAUSED e ativá-los no GA.

Quota

2.000 pacotes ativos por exchange.

2.000 pacotes pausados por exchange.