Con l'API Video Stitcher, puoi creare una sessione live ogni volta che avvii la riproduzione di un live streaming in cui gli annunci pubblicati da Google Ad Manager vengono uniti dinamicamente durante le interruzioni pubblicitarie. La risposta specifica l'URL di riproduzione e la configurazione della sessione dal vivo.
Questo documento descrive come creare e gestire una sessione dal vivo. Per ulteriori dettagli, consulta la documentazione relativa a REST.
Prima di iniziare
- Crea una configurazione pubblicata. Per l'integrazione con
Google Ad Manager, assicurati che l'oggetto
gamLiveConfig
sia impostato. - Se stai specificando uno slate, assicurati che l'oggetto
gamSlate
sia impostato sullo slate che registri.
Creare una sessione dal vivo
Per creare una sessione dal vivo utilizzando direttamente l'API, utilizza il metodo projects.locations.liveSessions.create
.
Il campo liveConfig
è l'unico campo obbligatorio nel corpo JSON. Puoi impostare
o eseguire l'override dei seguenti parametri facoltativi per ogni sessione live (come mostrato
nel seguente esempio REST):
manifestOptions
: specifica le versioni video generate nel file manifest del video unito e l'ordine delle versioni; consulta la documentazione sulle opzioni del file manifestadTracking
: seleziona il monitoraggio degli annunci lato client o il monitoraggio degli annunci lato server. Questa opzione sostituisce il valore nella configurazione live della sessionetargetingParameters
: un tag annuncio Google Ad Manager può contenere parametri di targeting aggiornabili per sessione; fornisci una mappatura in questo campo (ad esempio, per sostituire la macro[my_key]
con la stringamy_value
, consulta l'esempio REST)
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud che si trova nel campo Numero 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
: identificatore definito dall'utente per la configurazione live
Per inviare la richiesta, espandi una delle seguenti 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 per la configurazione di C# nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Prima di provare questo esempio, segui le istruzioni per la configurazione di PHP nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Prima di provare questo esempio, segui le istruzioni per la configurazione di Ruby nella guida rapida dell'API Video Stitcher utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Video Stitcher.
Per autenticarti all'API Video Stitcher, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'API Video Stitcher genera un ID sessione univoco per ogni richiesta. Una
sessione scade se l'playUri
non è stata richiesta negli ultimi 5 minuti.
Puoi utilizzare l'oggetto STREAM_ID
restituito per
esaminare la sessione dal vivo.
Controllare le sessioni dal vivo attivate da Google Ad Manager
Per visualizzare i dettagli dei tag annuncio relativi alle sessioni, utilizza il Monitoraggio attività di streaming in Ad Manager per visualizzare i dettagli sulle richieste di annunci. Puoi utilizzare STREAM_ID
per eseguire il debug della sessione di streaming. Per trovare il STREAM_ID
per
una sessione dal vivo, consulta Una sessione.