Domande frequenti

Generale

Qual è la versione più recente dell'API?

La versione più recente dell'API a cui si riferisce questo documento è v1beta2. Questa versione è una release beta privata disponibile per i tester di fiducia.

Chi può accedere all'API?

L'accesso a v1beta2 è disponibile solo per i progetti della console API di Google inclusi nella lista consentita. L'accesso alla documentazione dell'API è controllato da una lista consentita di utenti separata.

Come faccio a sapere se il mio progetto della console è incluso nella lista consentita?

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

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

Se vedi una descrizione JSON dell'API, il tuo progetto è incluso nella lista consentita. Se visualizzi un errore, il tuo progetto non è incluso nella lista consentita.

Utilizzo dell'API

Quale URL devo utilizzare per accedere all'API?

https://displayvideo.googleapis.com

Quali metodi di autenticazione sono 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 codice. Dove posso trovare le librerie client?

Python

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

  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 l'applicazione.

  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)