Perguntas frequentes

Geral

Qual é a versão mais recente da API?

A versão mais recente da API que este documento aborda é a 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 permitir projetos listados do Console de APIs do Google. O acesso à documentação da API é controlado por uma lista de permissões separada do usuário.

Como posso saber se meu projeto de console está 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ê receberá uma solicitação para criar uma. Quando terminar, copie e cole o URL no navegador.

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

Se uma descrição JSON da API for exibida, isso significa que seu projeto está na lista de permissões. Se você encontrar um erro, 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?

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

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

Python

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

  1. Instale 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. 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)