Perguntas frequentes

Geral

Qual é a versão mais recente da API?

A versão mais recente da API abordada neste documento é v4.

Posso recuperar dados de desempenho usando essa API?

Não. Use a API Bid Manager para criar, extrair e executar relatórios off-line do Display & Video 360.

Usar a API

Qual URL devo usar para acessar a API?

https://displayvideo.googleapis.com

Quais métodos de autenticação são aceitos?

O OAuth 2.0 é o único método de autenticação aceito.

As solicitações da API Display & Video 360 precisam ser autorizadas para o seguinte escopo:

  • https://www.googleapis.com/auth/display-video

As solicitações para o serviço users também precisam ser autorizadas para o seguinte escopo adicional:

  • https://www.googleapis.com/auth/display-video-user-management

Quero escrever código. Onde posso encontrar as bibliotecas de cliente?

Consulte o guia da biblioteca de cliente.

E se eu não quiser usar uma biblioteca de cliente?

Recomendamos que você use uma das nossas bibliotecas de cliente, mas também é possível interagir com a API Display & Video 360 usando solicitações HTTP diretas.

Alguns métodos mais complexos, como advertisers.assets.upload e media.upload, são mais difíceis de traduzir diretamente para solicitações HTTP. Confira exemplos de solicitações HTTP para esses métodos usando o cURL nos nossos guias de criação e Lances personalizados.

Quais permissões do Display & Video 360 eu preciso?

Para usar a API Display & Video 360, a Conta do Google que está fazendo a autenticação precisa ser um usuário do Display & Video 360 com acesso a parceiros ou anunciantes relevantes.

O usuário do Display & Video 360 precisa ter uma das seguintes funções de usuário para que os parceiros ou anunciantes relevantes realizem as seguintes ações:

  • Somente leitura: recupere recursos usando chamadas get ou list, excluindo recursos user.
  • Padrão: extrai, cria e atualiza recursos. Extrair recursos user com permissões para os mesmos parceiros ou anunciantes.
  • Administrador: extrai, cria e atualiza recursos. Extrair, criar e conceder acesso a recursos user para os parceiros ou anunciantes que você administra.

Como atualizar os recursos do YouTube & Partners usando a API?

A API Display & Video 360 não é compatível com a criação ou atualização de recursos do YouTube & Partners. Crie ou atualize recursos do YouTube & Partners em massa fazendo upload de arquivos de dados estruturados (SDF) na interface do Display & Video 360. Para mais detalhes sobre como usar o upload de SDF, leia nossa página de guias sobre os recursos do YouTube e dos parceiros.

Como segmentar locais geográficos?

A segmentação geográfica pode ser atribuída a itens de linha usando os seguintes tipos de segmentação:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Extraia os IDs das opções de segmentação dos três primeiros tipos usando targetingTypes.targetingOptions.search. Extraia e gerencie recursos de lista de locais usando o serviço advertisers.locationLists.

Além disso, você também pode criar um ID de opção de segmentação TARGETING_TYPE_POI para segmentar diretamente um raio de proximidade em torno de coordenadas de latitude e longitude específicas.

Posso fazer o download de arquivos de dados estruturados (SDFs) usando a API, mas como faço o upload deles?

A API Display & Video 360 não oferece suporte a uploads de SDF. Recomendamos gerenciar recursos usando os métodos CREATE, PATCH e DELETE fornecidos pela API. Se você ainda quiser gerenciar recursos usando SDFs, esses arquivos podem ser atualizados na interface do Display & Video 360.

Suporte

A API tem algum problema ou limitação conhecido?

Há limites para o número de solicitações que seu projeto pode fazer por segundo, que são descritos no nosso guia de limites de uso.