Geral
Qual é a versão mais recente da API?
A versão mais recente da API que este documento aborda é v1beta2
.
Esta é uma versão Beta particular disponível para trusted testers.
Quem pode acessar a API?
O acesso v1beta2
só está disponível para os projetos do Console de APIs do Google listados. O acesso à documentação da API é controlado por uma lista de permissões de usuário separada.
Como posso saber se meu projeto do console foi incluído na lista de permissões?
Selecione uma chave de API do seu projeto clicando no elemento API_KEY
no URL abaixo. Se não houver uma chave de API para o projeto selecionado, você vai receber uma solicitação para 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 aparecer uma descrição em JSON da API, significa que seu projeto está na lista de permissões. Se ocorrer um erro, isso significa que o projeto não está na lista de permissões.
Como 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. 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 das 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.
Instalar o google-api-python-client
pip install --upgrade google-api-python-client
Consiga um objeto
credentials
autorizado. Consulte o guia Configurar o aplicativo para ver um exemplo.Criar 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)