LiveCuepoints

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:
  • ad
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.