Preparare l'applicazione client per il funzionamento con Google Ad Manager

Raccogliere le informazioni richieste per le applicazioni client

Devi disporre delle seguenti informazioni necessarie per consentire a Google Ad Manager di creare una sessione di asset VOD:

Campo	Descrizione
projectNumber	Il numero del progetto Google Cloud (PROJECT_NUMBER) utilizzato per creare sessioni abilitate per Ad Manager. In alternativa, puoi utilizzare l'ID progetto.
region	La posizione (LOCATION) che vuoi che l'SDK IMA utilizzi per creare la sessione VOD.
vodConfigId	L'ID configurazione VOD utilizzato per registrare lo stream VOD con l'API Video Stitcher. Di seguito viene mostrato il formato del nome completo della risorsa di configurazione: projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID L'ID configurazione VOD è l'ultima parte del nome completo (VOD_CONFIG_ID). Tieni presente che la posizione della configurazione deve essere la stessa in cui crei la sessione VOD.
networkCode	L'identificatore numerico (NETWORK_CODE) per la tua rete Ad Manager.
oAuthToken	Un token OAuth di breve durata per l'account di servizio con il ruolo Utente Video Stitcher. Consulta Generare token OAuth di breve durata.

Tabella 1. Informazioni richieste per le sessioni degli asset VOD abilitati per Ad Manager

Generare token OAuth di breve durata per i test

Per generare un token OAuth di breve durata associato all'account di servizio con il ruolo Utente Video Stitcher, segui questi passaggi:

1. Sostituisci PATH_TO_YOUR_SERVICE_KEY con il percorso del file JSON che hai scaricato nella tua macchina locale.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY

2. Recupera il token bearer OAuth 2.0 dall'account di servizio:

   gcloud auth print-access-token

Poiché si tratta di un token di breve durata, devi generarlo di nuovo periodicamente con il comando gcloud auth print-access-token e inviare i nuovi token alle tue applicazioni client. Per ulteriori informazioni sulla creazione di un servizio di produzione per fornire token di breve durata, consulta la sezione che segue.

Importante: la rigenerazione di un token OAuth è un'operazione che richiede tempo. Prova a riutilizzare un token OAuth il più possibile durante la creazione delle sessioni. Puoi estendere la durata di un token utilizzando il flag --lifetime.

Crea un servizio per fornire informazioni alle applicazioni client

Crea un servizio in grado di fornire le informazioni richieste da passare al client. Quando l'applicazione richiede al tuo servizio informazioni su come riprodurre un asset VOD, il servizio deve restituire le informazioni descritte nella Tabella 1.

In particolare, il servizio deve essere in grado di fornire token OAuth alle applicazioni client in modo sicuro. Configura questo servizio utilizzando due account servizio, uno dei quali finge di essere l'altro. Un account di servizio dispone del ruolo Creatore token di servizio e crea un token OAuth per l'account di servizio che dispone del ruolo Utente Video Stitcher. Ad esempio:

• Account di servizio 1: si tratta dell'account di servizio dell'utente che chiama. Questo account dispone dell'autorizzazione Creatore token di servizio per l'account di servizio 2 e sostituisce l'account di servizio 2 per le applicazioni client.
• Account di servizio 2: si tratta dell'account di servizio con privilegi che dispone del ruolo Utente Video Stitcher per creare sessioni.

Per informazioni su come fornire un token OAuth dal tuo servizio, inclusi esempi di codice della libreria client, consulta Creare un token di accesso di breve durata.