Riferimento API

Questo riferimento API spiega come programmare trasmissioni live e stream video su YouTube utilizzando l'API YouTube Live Streaming.

Tipi di risorse

LiveBroadcasts

Una risorsa liveBroadcast rappresenta un evento che verrà trasmesso in streaming, tramite video live, su YouTube.

Per saperne di più su questa risorsa, consulta la relativa rappresentazione della risorsa e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Collega una trasmissione di YouTube a uno stream o rimuove un collegamento esistente tra una trasmissione e uno stream. Una trasmissione può essere associata a un solo stream video, mentre uno stream video può essere associato a più trasmissioni.
delete DELETE /liveBroadcasts Elimina una trasmissione.
insert POST /liveBroadcasts Crea una trasmissione.
list GET /liveBroadcasts Restituisce un elenco di trasmissioni di YouTube che corrispondono ai parametri della richiesta API.
transition POST /liveBroadcasts/transition Modifica lo stato di una trasmissione live di YouTube e avvia tutti i processi associati al nuovo stato. Ad esempio, quando imposti lo stato di una trasmissione su testing, YouTube inizia a trasmettere il video allo stream di monitoraggio della trasmissione. Prima di chiamare questo metodo, devi verificare che il valore della proprietà status.streamStatus per lo stream associato alla trasmissione sia active.
update PUT /liveBroadcasts Aggiorna una trasmissione. Ad esempio, puoi modificare le impostazioni di trasmissione definite nell'oggetto contentDetails della risorsa liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint Inserisce un cue point in una trasmissione live. Il cue point potrebbe attivare un'interruzione pubblicitaria.

LiveChatBans

Una risorsa liveChatBan identifica un utente di YouTube e una chat live di YouTube a cui l'utente non può partecipare.

Per saperne di più su questa risorsa, consulta la relativa rappresentazione della risorsa e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Rimuove un ban che impedisce a un utente specifico di partecipare a una chat live, consentendogli di rientrare nella chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban.
insert POST /liveChat/bans Impedisce a un utente specifico di partecipare alla chat live. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban.

LiveChatMessages

Una risorsa liveChatMessage rappresenta un messaggio della chat in una chat live di YouTube. La risorsa può contenere dettagli su diversi tipi di messaggi, tra cui un messaggio di testo appena pubblicato o un evento di finanziamento dei fan.

La funzionalità di chat live è attivata per impostazione predefinita per le trasmissioni live ed è disponibile mentre l'evento live è attivo. Al termine dell'evento, la chat live non è più disponibile.

Per saperne di più su questa risorsa, consulta la relativa rappresentazione della risorsa e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Elimina un messaggio di chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban.
insert POST /liveChat/messages Aggiunge un messaggio a una chat live.
list GET /liveChat/messages Elenca i messaggi della chat live per una chat specifica.
streamList Consente una connessione di streaming lato server per ricevere messaggi della chat live per una chat specifica a bassa latenza.

LiveChatModerators

Una risorsa liveChatModerator rappresenta un moderatore per una chat live di YouTube. Un moderatore della chat ha la possibilità di bannare o riammettere gli utenti in una chat, rimuovere i messaggi ed eseguire altre azioni amministrative per la chat live.

Per saperne di più su questa risorsa, consulta la relativa rappresentazione della risorsa e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Rimuove un moderatore della chat. La richiesta deve essere autorizzata dal proprietario del canale della trasmissione live.
insert POST /liveChat/moderators Aggiunge un nuovo moderatore per la chat. La richiesta deve essere autorizzata dal proprietario del canale della trasmissione live.
list GET /liveChat/moderators Elenca i moderatori di una chat live. La richiesta deve essere autorizzata dal proprietario del canale della trasmissione live.

LiveStreams

Una risorsa liveStream contiene informazioni sul flusso video che stai trasmettendo a YouTube. Lo stream fornisce i contenuti che verranno trasmessi agli utenti di YouTube. Una volta creata, una risorsa liveStream può essere associata a una o più risorse liveBroadcast.

Per saperne di più su questa risorsa, consulta la relativa rappresentazione della risorsa e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Elimina uno stream video.
insert POST /liveStreams Crea uno stream video. Lo stream ti consente di inviare il video a YouTube, che a sua volta può trasmetterlo al tuo pubblico.
list GET /liveStreams Restituisce un elenco di stream video che corrispondono ai parametri della richiesta API.
update PUT /liveStreams Aggiorna uno stream video. Se le proprietà che vuoi modificare non possono essere aggiornate, devi creare un nuovo stream con le impostazioni corrette.

SuperChatEvents

Una risorsa superChatEvent rappresenta un messaggio Superchat acquistato da un fan durante un live streaming di YouTube. Nello stream della chat live di YouTube, i messaggi Superchat si distinguono dagli altri in due modi:

  • I messaggi Superchat sono evidenziati con un colore.
  • I messaggi Superchat rimangono nel riquadro di aggiornamento per un periodo di tempo stabilito.

Il colore della Superchat, il periodo di tempo in cui rimane nel riquadro di aggiornamento e la lunghezza massima del messaggio sono tutti determinati dall'importo dell'acquisto. Consulta il Centro assistenza YouTube per scoprire di più sulle Superchat.

Per saperne di più su questa risorsa, consulta la relativa rappresentazione della risorsa e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
list GET /superChatEvents Elenca gli eventi Superchat dei live streaming di un canale negli ultimi 30 giorni.