La risorsa liveCuepoint
e il metodo liveCuepoints.insert
sono stati deprecati e sostituiti dal metodo
liveBroadcasts.cuepoint
.
Una risorsa liveCuepoint
inserisce un cue point nel video stream trasmesso, cosa che potrebbe attivare un'interruzione pubblicitaria.
Nota: questo comando API fa parte dell'API YouTube Content ID e ha requisiti di autorizzazione diversi rispetto alle richieste di gestione delle risorse liveBroadcast
e liveStream
.
Metodi
L'API supporta i seguenti metodi per le risorse di liveCuepoints
:
- inserire
- Inserisce un cue point in una trasmissione dal vivo. Attualmente, le richieste a questo metodo devono essere autorizzate da un account associato a un proprietario dei contenuti di YouTube. Prova subito.
Rappresentazione delle risorse
La seguente struttura JSON mostra il formato di una risorsa liveCuepoints
:
{ "id": string, "kind": "youtubePartner#liveCuepoint", "broadcastId": string, "settings": { "offsetTimeMs": long, "walltime": datetime, "cueType": string, "durationSecs": unsigned integer } }
Proprietà
La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:
Proprietà | |
---|---|
id |
string Un valore assegnato da YouTube per identificare in modo univoco il cue point. |
kind |
string Il tipo della risorsa API. Per le risorse liveCuepoint , il valore è youtubePartner#liveCuepoint . |
broadcastId |
string L'ID assegnato da YouTube per identificare in modo univoco la trasmissione in cui viene inserito il cue point. |
settings |
object L'oggetto settings definisce le impostazioni del cue point. |
settings.offsetTimeMs |
long Questo valore specifica un momento specifico del video in cui gli spettatori devono visualizzare un annuncio o uno slate in-stream. Il valore della proprietà identifica un offset temporale, in millisecondi, dall'inizio del flusso di monitoraggio. Anche se misurato in millisecondi, il valore è in realtà un'approssimazione e YouTube inserirà il cue point il più vicino possibile a quel momento. Non specificare un valore per questo parametro se la trasmissione non ha un flusso di monitoraggio. Il valore predefinito di questa proprietà è 0 , che indica che il cue point deve essere inserito il prima possibile. Se il tuo stream non viene ritardato, anche 0 è l'unico valore valido. Tuttavia, se lo stream di trasmissione è in ritardo, il valore della proprietà può specificare l'ora in cui inserire il cue point. Per ulteriori dettagli, consulta la Guida introduttiva.Nota: se la trasmissione ha avuto una fase di test, l'offset viene misurato dal momento in cui è iniziata la fase di test. |
settings.walltime |
datetime Questo valore specifica l'ora dell'orologio in cui inserire il cue point. Il valore è specificato nel formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ).L'API restituisce un errore se una richiesta tenta di inserire un cue point che specifica un valore per questa proprietà e per la proprietà settings.offsetTimeMs . |
settings.cueType |
string Il tipo di cue point. Consulta la guida Guida introduttiva per una spiegazione dei diversi tipi di cue point. Consulta anche il documento Durata di una trasmissione per conoscere le best practice su come inserire i cue point durante la trasmissione. I valori validi per questa proprietà sono:
|
settings.durationSecs |
unsigned integer La durata del cue point, in secondi. Questo valore deve essere specificato se cueType è ad e, in caso contrario, viene ignorato. |