Perguntas frequentes

Geral

Qual é a versão mais recente da API?

A versão mais recente da API que este documento aborda é v3.

Posso recuperar dados de desempenho usando essa API?

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

Usar a API

Que URL devo usar para acessar a API?

https://displayvideo.googleapis.com

Quais métodos de autenticação são compatíveis?

O OAuth 2.0 é o único método de autenticação compatível.

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 bibliotecas de cliente?

Consulte o guia da biblioteca 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 envolvidos, como advertisers.assets.upload e media.upload, são mais difíceis de converter diretamente em solicitações HTTP. Veja exemplos de solicitações HTTP para esses métodos usando cURL nos nossos guias sobre Criativos e Lances personalizados.

Quais permissões do Display & Video 360 são necessárias?

Para usar a API Display & Video 360, a Conta do Google de 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 para que os parceiros ou anunciantes relevantes realizem as seguintes ações:

• Somente leitura: recupere recursos usando chamadas get ou list, exceto recursos user.
• Padrão: recupera, cria e atualiza recursos. Recuperar recursos user com permissões para os mesmos parceiros ou anunciantes.
• Administrador: recupere, crie e atualize recursos. Recupere, crie e conceda acesso aos recursos do user para os parceiros ou anunciantes que você administra.

Como atualizo os recursos do YouTube e parceiros usando a API?

A API Display & Video 360 não oferece suporte à criação ou atualização de recursos do YouTube e parceiros. Para criar ou atualizar recursos do YouTube e parceiros em massa, faça o upload de arquivos de dados estruturados (SDF, na sigla em inglês) na interface do Display & Video 360. Para mais detalhes sobre como usar o upload de SDF, leia nossa página do guia sobre os recursos do YouTube e parceiros.

Como segmentar localizações geográficas?

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

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Recupere os IDs de opção de segmentação para os três primeiros tipos usando targetingTypes.targetingOptions.search. Recupere e gerencie recursos da 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 de TARGETING_TYPE_POI para segmentar diretamente um raio de proximidade em torno de coordenadas específicas de latitude e longitude.

Vejo que posso fazer o download de arquivos de dados estruturados (SDFs, na sigla em inglês) usando a API, mas como faço o upload deles?

A API Display & Video 360 não é compatível com o upload de SDF. Recomendamos gerenciar recursos pelos 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 problemas ou limitações conhecidos?

O número de solicitações que o projeto pode fazer por segundo tem limites definidos no nosso guia de limites de uso.