Perguntas frequentes

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.

  1. Instalar o google-api-python-client

    pip install --upgrade google-api-python-client
    
  2. Consiga um objeto credentials autorizado. Consulte o guia Configurar o 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)