Riferimento API

Questo riferimento API spiega come programmare trasmissioni dal vivo 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 su YouTube tramite video in diretta.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Associa una trasmissione di YouTube a uno stream o rimuove un'associazione esistente tra una trasmissione e uno stream. Una trasmissione può essere associata a un solo stream video, sebbene uno stream video possa essere associato a più di una trasmissione.
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 dal vivo su YouTube e avvia tutte le procedure associate al nuovo stato. Ad esempio, quando passi a testing lo stato di una trasmissione, YouTube inizia a trasmettere il video allo stream di monitoraggio di quella trasmissione. Prima di chiamare questo metodo, devi confermare che il valore della proprietà status.streamStatus per lo stream associato alla tua 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 dal vivo. 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 è stato escluso dalla partecipazione.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Rimuove un'esclusione che impedisce a un utente specifico di contribuire a una chat live, consentendogli di partecipare nuovamente alla chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata all'esclusione.
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 all'esclusione.

LiveChatMessages

Una risorsa liveChatMessage rappresenta un messaggio di chat in una chat dal vivo di YouTube. La risorsa può contenere dettagli su diversi tipi di messaggi, tra cui un SMS appena pubblicato o un evento relativo ai finanziamenti dei fan.

La funzionalità di chat dal vivo è abilitata per impostazione predefinita per le trasmissioni dal vivo ed è disponibile quando l'evento dal vivo è attivo. Al termine dell'evento, la chat live non è più disponibile per quell'evento.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse 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 all'esclusione.
insert POST /liveChat/messages Aggiunge un messaggio a una chat live.
list GET /liveChat/messages Elenca i messaggi della chat live relativi a una chat specifica.

LiveChatModerators

Una risorsa liveChatModerator rappresenta un moderatore di una chat dal vivo di YouTube. Un moderatore della chat ha la possibilità di escludere o annullare l'esclusione degli utenti da una chat, di rimuovere messaggi ed eseguire altre azioni amministrative per la chat live.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse 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 dal vivo.
insert POST /liveChat/moderators Aggiunge un nuovo moderatore per la chat. La richiesta deve essere autorizzata dal proprietario del canale della trasmissione dal vivo.
list GET /liveChat/moderators Elenca i moderatori di una chat live. La richiesta deve essere autorizzata dal proprietario del canale della trasmissione dal vivo.

LiveStreams

Una risorsa liveStream contiene informazioni sul video stream 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 ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse 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 un video stream. Lo stream ti consente di inviare il tuo video a YouTube, che potrà poi trasmetterlo al 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 appropriate.

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 prestabilito.

Il colore del messaggio 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. Per scoprire di più su Superchat, consulta il Centro assistenza YouTube.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse e l'elenco delle proprietà.

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

Tipi di risorse deprecati

FanFundingEvents

Una risorsa fanFundingEvent rappresenta un evento di finanziamenti dei fan su un canale YouTube. I finanziamenti dei fan consentono di sostenere monetariamente i creator di YouTube. Un evento di finanziamenti dei fan si verifica quando un utente effettua un pagamento volontario una tantum a un canale. Per scoprire di più su Finanziamenti dei fan, visita il Centro assistenza YouTube.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Elenca gli eventi relativi ai finanziamenti dei fan associati a un canale. La richiesta API deve essere autorizzata dal proprietario del canale.

LiveCuepoints

Una risorsa liveCuepoint avvia un'interruzione pubblicitaria nello stream video della trasmissione.

Nota: il comando API per controllare i cue point fa effettivamente parte dell'API YouTube Content ID e ha requisiti di autorizzazione diversi rispetto alle richieste di gestione delle risorse liveBroadcast e liveStream.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/
insert POST /liveCuepoints Inserisce un cue point in una trasmissione dal vivo. Attualmente, le richieste relative a questo metodo devono essere autorizzate da un account associato a un proprietario dei contenuti di YouTube.

Sponsor

Una risorsa sponsor rappresenta lo sponsor di un canale YouTube. Uno sponsor fornisce a un creator un sostegno monetario ricorrente, ad esempio un abbonamento o una quota di abbonamento, e riceve vantaggi speciali. Ad esempio, gli sponsor possono chattare quando il creator attiva la modalità solo sponsor per una chat.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione delle risorse e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
list GET /sponsors Elenca gli sponsor di un canale. La richiesta API deve essere autorizzata dal proprietario del canale.