Perguntas frequentes

Geral

Qual é a versão mais recente da API?

A versão mais recente da API abordada neste documento é v1beta2. Esta versão é uma versão Beta privada disponível para trusted testers.

Quem pode acessar a API?

O acesso ao v1beta2 só está disponível para projetos na lista de permissões do console de APIs do Google. O acesso à documentação da API é controlado por uma lista de permissão de usuários separada.

Como posso saber se meu projeto do console foi adicionado à lista de permissões?

Clique no elemento API_KEY no URL abaixo para selecionar uma chave de API do seu projeto. Se não houver uma chave de API para o projeto selecionado, você vai precisar criar uma. Quando terminar, copie e cole o URL resultante no navegador.

https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY

Se você encontrar uma descrição JSON da API, seu projeto foi adicionado à lista de permissões. Se você encontrar um erro, isso significa que o projeto não está na lista de permissões.

Como usar a API

Qual URL uso 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. Todas as solicitações precisam ser autorizadas para o seguinte escopo:

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

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

Python

A biblioteca de cliente de APIs do Google para Python, disponível publicamente, pode ser usada para acessar essa API. Para instalar a biblioteca e criar um objeto de serviço autorizado, siga as etapas abaixo.

  1. Instalar o google-api-python-client

    pip install --upgrade google-api-python-client

  2. Consiga um objeto credentials autorizado. Consulte o guia de configuração do aplicativo para ver um exemplo.

  3. Crie um objeto de serviço autorizado usando o serviço de descoberta.

    api_key = 'API_KEY'
api_name = 'displayvideo'
api_url = 'https://%s.googleapis.com/' % api_name
api_version = 'v1beta2'

discovery_url = (
    '%s/$discovery/rest?key=%s&version=%s&labels=%s'
    % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
)

service = discovery.build(api_name, api_version,
                          discoveryServiceUrl=discovery_url,
                          http=credentials)