Utilizzando l'API Video Stitcher, crei una sessione live ogni volta che avvii la riproduzione di un live streaming in cui gli annunci pubblicati da Google Ad Manager vengono inseriti dinamicamente durante le interruzioni pubblicitarie. La risposta specifica l'URL di riproduzione e la configurazione della sessione live.
Questo documento descrive come creare e gestire una sessione live. Per maggiori dettagli, consulta la documentazione REST.
Prima di iniziare
- Crea una configurazione live. Per l'integrazione con
Google Ad Manager, assicurati che l'oggetto
gamLiveConfig
sia impostato. - Se stai specificando una lavagna, assicurati che l'oggetto
gamSlate
sia impostato sulla lavagna che registri.
Creare una sessione dal vivo
Per creare una sessione live utilizzando direttamente l'API, utilizza il metodo
projects.locations.liveSessions.create
.
Il campo liveConfig
è l'unico campo obbligatorio nel corpo JSON. Puoi impostare
o sostituire i seguenti parametri facoltativi per sessione live (come mostrato
nel seguente esempio REST):
manifestOptions
: specifica quali rendering video vengono generati nel manifest video unito e l'ordine dei rendering; consulta la documentazione sulle opzioni del manifestadTracking
: seleziona il monitoraggio degli annunci lato client o lato server; questo valore sostituisce quello nella configurazione live per la sessionetargetingParameters
: un tag annuncio Google Ad Manager può contenere parametri di targeting che possono essere aggiornati per sessione; fornisci una mappatura in questo campo (ad esempio, per sostituire la macro[my_key]
con la stringamy_value
, vedi l'esempio REST)
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_NUMBER
: il numero di Google Cloud progetto che si trova nel campo Numero di progetto della pagina Impostazioni IAMLOCATION
: la località in cui creare la sessione; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
LIVE_CONFIG_ID
: l'identificatore definito dall'utente per la configurazione attiva
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", "playUri": "PLAY_URI", "manifestOptions": { "includeRenditions": [ { "bitrateBps": 150000, "codecs": "hvc1.1.4.L126.B0" }, { "bitrateBps": 440000, "codecs": "hvc1.1.4.L126.B0" } ], "bitrateOrder": "DESCENDING" }, "gamSettings": { "streamId": "STREAM_ID" }, "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", "adTracking": "SERVER" }
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per C#.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per Go.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per Java.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per Node.js.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione di PHP nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per PHP.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per Python.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida dell'API Video Stitcher per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Video Stitcher per Ruby.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
L'API Video Stitcher genera un ID sessione univoco per ogni richiesta. Una
sessione scade se il playUri
non viene richiesto negli ultimi 5 minuti.
Puoi utilizzare il STREAM_ID
restituito per
ispezionare la sessione dal vivo.
Ispezionare le sessioni live attivate da Google Ad Manager
Per visualizzare i dettagli dei tag annuncio per le sessioni, utilizza lo strumento
Monitoraggio attività di streaming in Ad Manager per
visualizzare i dettagli delle richieste di annunci. Puoi utilizzare STREAM_ID
per eseguire il debug della sessione di streaming. Per trovare l'STREAM_ID
per
una sessione live, vedi Ottenere una sessione.