Domande frequenti

Generale

Qual è la versione più recente dell'API?

La versione più recente dell'API a cui sono indirizzi questo documento è v1beta2. Questa versione è una versione beta privata disponibile per i trusted tester.

Chi può accedere all'API?

L'accesso a v1beta2 è disponibile solo per consentire i progetti della console API di Google elencati. L'accesso alla documentazione dell'API è controllato da una lista di autorizzazioni utente separata.

Come faccio a capire se il mio progetto della console è stato inserito nella lista consentita?

Seleziona una chiave API dal tuo progetto facendo clic sull'elemento API_KEY nell'URL di seguito. Se non esiste una chiave API per il progetto selezionato, ti verrà chiesto di crearne una. Al termine, copia e incolla nel browser l'URL risultante.

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

Se vedi una descrizione JSON dell'API, significa che il tuo progetto è stato inserito nella lista consentita. Se viene visualizzato un messaggio di errore, significa che il tuo progetto non è incluso nella lista consentita.

Utilizzo dell'API

Quale URL devo utilizzare per accedere all'API?

https://displayvideo.googleapis.com

Quali sono i metodi di autenticazione supportati?

OAuth 2.0 è l'unico metodo di autenticazione supportato. Tutte le richieste devono essere autorizzate per il seguente ambito:

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

Voglio scrivere del codice. Dove posso trovare le librerie client?

Python

Per accedere a questa API è possibile utilizzare la libreria client dell'API di Google per Python disponibile pubblicamente. Per installare la libreria e creare un oggetto di servizio autorizzato, segui questi passaggi.

  1. Installa google-api-python-client

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

  2. Ottieni un oggetto credentials autorizzato. Per un esempio, consulta la guida Configurare la richiesta di iscrizione.

  3. Crea un oggetto di servizio autorizzato utilizzando il servizio di rilevamento.

    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)