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 live streaming:

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 località (LOCATION) in cui è registrata la configurazione attiva.
liveConfigId	L'ID configurazione in tempo reale utilizzato per registrare l'evento di live streaming con l'API Video Stitcher. Le seguenti mostra il formato del nome completo della risorsa di configurazione: projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID L'ID configurazione è l'ultima parte del nome completo (LIVE_CONFIG_ID). Tieni presente che la posizione della configurazione deve essere la stessa in cui crei la sessione.
customAssetKey	La chiave asset personalizzata (CUSTOM_ASSET_KEY) creata durante la registrazione della configurazione in tempo reale. L'SDK IMA necessita di questo valore per creare lo stream.
networkCode	L'identificatore numerico (NETWORK_CODE) per della tua rete Ad Manager.
oAuthToken	Un token OAuth di breve durata per account di servizio con il ruolo Utente stitching video. Consulta: Generare token OAuth di breve durata.

Tabella 1. Informazioni richieste per le sessioni di live streaming abilitate per Ad Manager

Genera token OAuth di breve durata per i test

Per generare un token OAuth di breve durata associati ai account di servizio con il ruolo Utente stitching video, 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 seguente.

Importante: la rigenerazione di un token OAuth è un'operazione dispendiosa in termini di tempo. Prova a riutilizzare il più possibile un token OAuth 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 live streaming, il servizio deve restituire le informazioni descritte in Tabella 1.

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

• Account di servizio 1: si tratta dell'account di servizio dell'utente che chiama. Questo account ha Autorizzazione Creatore token di servizio per l'account di servizio 2 e imitazioni l'account di servizio 2 alle applicazioni client.
• Account di servizio 2: si tratta dell'account di servizio con privilegi che dispone Ruolo Utente stitching video 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.