Questa pagina descrive come gestire le configurazioni VOD. Le configurazioni VOD vengono utilizzate per configurare le sessioni VOD. Per ulteriori dettagli, consulta la documentazione relativa a REST.
Prima di iniziare
Per creare una sessione VOD, devi prima configurare un codificatore che generi un manifest HLS o DASH di origine per l'asset VOD. Questi file manifest contengono determinati indicatori di annunci in corrispondenza dei margini delle interruzioni pubblicitarie, identificati dall'API Video Stitcher per lo stitching degli annunci. Puoi utilizzare l'API Transcoder per creare un job di transcodifica in modo da generare i file manifest da tipi di file multimediali come MP4 o MOV.
Per ulteriori dettagli sugli indicatori di annunci HLS e DASH supportati, consulta la documentazione sugli indicatori di annunci.
Definisci una configurazione VOD
Quando definisci una configurazione VOD, i seguenti campi sono obbligatori:
sourceUri
adTagUri
sourceUri
specifica l'URL al file manifest HLS o DASH
dell'asset VOD di origine in cui inserire gli annunci. L'API Video Stitcher restituisce un URL di riproduzione HLS
se l'URL fornito fa riferimento a un manifest HLS e a un URL di riproduzione DASH se
l'URL fornito fa riferimento a un manifest DASH. Puoi utilizzare un file manifest esistente o creare i tuoi file di origine VOD.
adTagUri
specifica l'URL dell'ad server che restituisce i metadati dell'annuncio.
Registra una configurazione VOD
Per registrare una configurazione VOD, usa il metodo projects.locations.vodConfigs.create
.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAMLOCATION
: la località in cui creare la configurazione VOD; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: un identificatore definito dall'utente per la configurazione VOD. Questo ID può contenere solo lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera, l'ultimo deve essere una lettera o un numero e l'intero ID ha un massimo di 63 caratteri.VOD_URI
: l'URI dei contenuti multimediali da unire. Questo URI deve fare riferimento a un file manifest MPEG-DASH (MPD) o a un file manifest HLS (M3U8). Utilizza un URI pubblico o un URI non firmato per il quale hai registrato una chiave CDN.AD_TAG_URI
: l'URI pubblico del tag annuncio. Se non ne hai uno, puoi utilizzare un esempio di pre-roll VMAP
Corpo JSON della richiesta:
{ "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI" }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "create", "cancelRequested": false, "apiVersion": "v1" }, "done": false }
name
, da utilizzare nella sezione successiva.
Controlla il risultato
Per verificare se la configurazione VOD è stata creata, utilizza il metodo projects.locations.operations.get
. Se la risposta contiene "done: false"
, ripeti il comando finché la risposta non contiene "done: true"
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud. Si trova nel campo Numero di progetto della pagina Impostazioni IAM.LOCATION
: la località dei dati; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
OPERATION_ID
: l'identificatore dell'operazione
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "create" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig", "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "state": "READY" } }
Recupera una configurazione VOD
Per ottenere i dettagli di una configurazione VOD specifica, utilizza il metodo projects.locations.vodConfigs.get
.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAMLOCATION
: la posizione della configurazione VOD; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: l'identificatore definito dall'utente per la configurazione VOD
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "state": "READY" }
Aggiorna una configurazione VOD
Per aggiornare una configurazione VOD, utilizza il metodo projects.locations.vodConfigs.patch
. L'esempio seguente aggiorna il campo sourceUri
.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAMLOCATION
: la posizione della configurazione VOD; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: l'identificatore definito dall'utente per la configurazione VODVOD_URI
: l'URI aggiornato dei contenuti multimediali da unire
Corpo JSON della richiesta:
{ "sourceUri": "VOD_URI" }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "update" }, "done": false }
Elenca tutte le configurazioni VOD registrate
Per elencare tutte le configurazioni VOD registrate per una determinata località in un progetto,
utilizza il
metodo
projects.locations.vodConfigs.list
.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAMLOCATION
: la località delle configurazioni VOD; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "vodConfigs": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "state": "READY" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/my-other-vod-config", "sourceUri": "my-other-vod-stream-uri", "adTagUri": "my-other-ad-tag-uri", "state": "READY" } }
Risultati aggiuntivi
La risposta curl
può includere un nextPageToken
, che puoi utilizzare per recuperare
risultati aggiuntivi:
{ "vodConfigs": [ ... ], "nextPageToken": "NEXT_PAGE_TOKEN" }
Puoi inviare un'altra richiesta curl
, incluso il valore di
NEXT_PAGE_TOKEN, per elencare le configurazioni aggiuntive. Aggiungi quanto segue all'URL nella precedente chiamata API:
?pageToken=NEXT_PAGE_TOKEN
Per ulteriori informazioni sull'utilizzo di questo token, consulta la libreria client pertinente.
Elimina una configurazione VOD
Se una configurazione VOD registrata non è più necessaria, eliminala utilizzando il metodo projects.locations.vodConfigs.delete
.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAMLOCATION
: la posizione della configurazione VOD; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: l'identificatore definito dall'utente per la configurazione VOD
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "delete" }, "done": false }