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