Riferimento API

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

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione 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 Consente di eliminare 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 in diretta di YouTube e avvia le eventuali procedure associate 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 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 l'utente non può partecipare.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione 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 contribuire a una chat live, consentendogli così 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 appena pubblicato o un evento di finanziamento dei fan.

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

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione 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.

LiveChatModerators

Una risorsa liveChatModerator rappresenta un moderatore per una chat live di YouTube. Un moderatore della chat ha la possibilità di bandire o annullare il ban di utenti da una chat, rimuovere messaggi ed eseguire altre azioni amministrative per la chat live.

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

LiveStreams

Una risorsa liveStream contiene informazioni sullo stream 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 ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione e l'elenco delle proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Consente di eliminare uno stream video.
insert POST /liveStreams Crea uno stream video. Lo stream ti consente di inviare il video a YouTube, che può poi trasmetterlo al tuo pubblico.
list GET /liveStreams Restituisce un elenco di stream video corrispondenti 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:

  • Le Superchat sono evidenziate 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 resta nel riquadro di aggiornamento e la lunghezza massima del messaggio sono determinati dall'importo dell'acquisto. Per scoprire di più sui Superchat, visita il Centro assistenza YouTube.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione 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.

Tipi di risorse deprecati

FanFundingEvents

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

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

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Elenca gli eventi di finanziamento dei fan per un canale. La richiesta all'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 il controllo dei cue point fa parte dell'API YouTube Content ID e ha requisiti di autorizzazione diversi rispetto alle richieste per gestire le risorse liveBroadcast e liveStream.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione 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. Al momento, le richieste di questo metodo devono essere autorizzate da un account associato a un proprietario di contenuti di YouTube.

Sponsor

Una risorsa sponsor rappresenta uno sponsor di un canale YouTube. Uno sponsor fornisce un sostegno finanziario ricorrente, ad esempio una quota di abbonamento, a un creator 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 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 all'API deve essere autorizzata dal proprietario del canale.