API YouTube Live Streaming - Cronologia delle revisioni

In questa pagina sono elencate le modifiche all'API YouTube Live Streaming e gli aggiornamenti della documentazione.

12 ottobre 2026

Questo aggiornamento contiene le seguenti modifiche:

18 agosto 2026

Questo aggiornamento contiene le seguenti modifiche:

  • La documentazione relativa al metodo liveBroadcasts.update è stata aggiornata per includere nuovi errori relativi alla monetizzazione: preconditionFailed (412) (motivo: videoNotEligibleForAdsMonetization) e backendError (503) (motivo: backendError).

17 agosto 2026

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova proprietà snippet.categoryId della risorsa liveBroadcast ti consente di impostare, aggiornare e recuperare la categoria del video associata a una trasmissione live.

20 luglio 2026

Questo aggiornamento contiene le seguenti modifiche:

9 luglio 2026

Questo aggiornamento contiene le seguenti modifiche:

1° giugno 2026

Questo aggiornamento contiene le seguenti modifiche:

  • La proprietà contentDetails.availabilityConfig della risorsa liveBroadcast ti consente di specificare limitazioni geografiche per una trasmissione live, in modo da poter gestire la disponibilità regionale degli eventi live.

26 marzo 2026

Questo aggiornamento contiene le seguenti modifiche:

  • La proprietà snippet.type ora supporta il nuovo valore giftEvent.

  • La nuova proprietà snippet.giftEventDetails della risorsa liveChatMessage e i relativi elementi secondari contengono informazioni sull'evento regalo.

12 gennaio 2026

L'API ora supporta l'attivazione dei mid-roll e l'inserimento automatico dei mid-roll per le trasmissioni live.

Il proprietario della trasmissione può scegliere di attivare i mid-roll per una trasmissione, a condizione che questa sia idonea per i mid-roll. Il proprietario può anche disattivare i mid-roll per una trasmissione in qualsiasi momento.

Se una trasmissione è abilitata per i mid-roll, il proprietario della trasmissione può scegliere di attivare l'inserimento automatico dei mid-roll. Possono anche disattivare gli annunci automatici per una trasmissione in qualsiasi momento.

Quando l'autore della trasmissione attiva gli annunci automatici, può scegliere una delle seguenti opzioni:

  • Lascia che YouTube ottimizzi l'inserimento dei mid-roll. Questa opzione supporta tre modalità:
    • Bassa: meno utili potenziali, meno interruzioni all'esperienza di visione degli spettatori
    • Media: utili potenziali nella media, esperienza più bilanciata per gli spettatori
    • Alta: più utili potenziali, più interruzioni all'esperienza di visione degli spettatori
  • Configura manualmente la strategia e l'intervallo per l'inserimento di mid-roll. In questo caso, il proprietario deve impostare due parametri:
    1. La strategia di pianificazione per i cuepoint degli annunci. I cuepoint possono essere inseriti contemporaneamente per tutti gli spettatori oppure la loro tempistica può variare da spettatore a spettatore. Quest'ultima strategia consente a YouTube di programmare i cuepoint con una frequenza maggiore, in modo che gli spettatori possano riceverli quando sono idonei.
    2. La durata dell'intervallo tra le interruzioni pubblicitarie mid-roll.

La documentazione riflette le seguenti modifiche all'API per supportare questa funzionalità:

  • L'oggetto monetizationDetails della risorsa liveBroadcast contiene campi per l'attivazione dei mid-roll e le configurazioni degli annunci automatici.
  • Il metodo update può essere utilizzato per attivare o disattivare gli annunci mid-roll. Questo metodo può essere utilizzato anche per configurare gli annunci automatici per una trasmissione live. La documentazione identifica diversi nuovi errori che possono verificarsi durante l'aggiornamento delle impostazioni di monetizzazione e degli annunci automatici per una trasmissione live.

14 luglio 2025

La descrizione del metodo liveChatMessages.streamList è stata aggiornata per fornire indicazioni sugli utilizzi dell'API streamList.

9 ottobre 2023

Solo a titolo di riferimento, puoi trovare gli ID degli sticker correlati ai Super Sticker in questo file CSV. Le definizioni della proprietà snippet.superStickerDetails.superStickerMetadata.stickerId della risorsa liveChatMessage e della proprietà snippet.superStickerMetadata.stickerId della risorsa superChatEvent sono state aggiornate per riflettere queste informazioni.

15 settembre 2023

L'API ora supporta un nuovo modo di inserire annunci nelle trasmissioni live. Oltre a liveCuepoints, che ti consente di inserire manualmente le interruzioni pubblicitarie in una trasmissione, YouTube ora supporta una funzionalità per inserire automaticamente le interruzioni pubblicitarie mid-roll in una trasmissione a intervalli fissi.

Se il proprietario della trasmissione attiva gli annunci automatici, può visualizzare i seguenti aspetti del comportamento degli annunci:

  • la durata dell'intervallo tra le interruzioni pubblicitarie mid-roll.
  • la strategia di pianificazione per i cuepoint degli annunci. I cuepoint possono essere inseriti contemporaneamente per tutti gli spettatori oppure la loro tempistica può variare da spettatore a spettatore. Quest'ultima strategia consente a YouTube di pianificare i cuepoint con una frequenza maggiore, in modo che gli spettatori possano riceverli quando sono idonei.
  • Un periodo durante il quale gli annunci mid-roll non vengono mostrati. Per questa funzionalità, il proprietario della trasmissione specifica che l'inserimento degli annunci mid-roll è in pausa fino a un determinato momento.

La documentazione riflette le seguenti modifiche all'API per supportare questa funzionalità:

  • La risorsa liveBroadcast ora contiene un oggetto monetizationDetails. I campi dell'oggetto indicano se l'inserimento automatico degli annunci è attivato per la trasmissione e specificano informazioni aggiuntive per la pianificazione dei cuepoint.
  • Il parametro part del metodo liveBroadcast.list supporta il valore monetizationDetails.
  • Il metodo update può essere utilizzato per mettere in pausa l'inserimento di annunci mid-roll per un determinato periodo di tempo per una trasmissione live. La documentazione ora identifica anche diversi errori che possono verificarsi durante l'aggiornamento dei dettagli di monetizzazione per una trasmissione live.

1° agosto 2023

Questo aggiornamento contiene le seguenti modifiche:

  • Il metodo liveBroadcasts.update non richiede più di specificare i valori per questi campi:

    • snippet.title
    • status.privacyStatus

    Se ometti questi campi dalla richiesta, rimarranno invariati.

1 novembre 2022

  • Il nuovo metodo liveBroadcasts.cuepoint consente a qualsiasi proprietario di canale che trasmette in diretta su YouTube di inserire cuepoint nella trasmissione live, che possono attivare interruzioni pubblicitarie. Questo metodo sostituisce il metodo liveCuepoints.insert, che consentiva solo ai partner di contenuti di YouTube di inserire cuepoint nelle trasmissioni live.

    Diverse guide sono state aggiornate per riflettere la disponibilità di questo nuovo metodo.

  • Nota: questo è un annuncio di ritiro.

    Il metodo liveCuepoints.insert è ora deprecato. Il supporto per il metodo liveCuepoints.insert verrà rimosso a partire dal 1° maggio 2023. Gli utenti dell'API devono aggiornare le proprie applicazioni per chiamare il metodo liveBroadcasts.cuepoint.

  • La documentazione relativa al metodo liveBroadcasts.control è stata rimossa. Un avviso di ritiro per questo metodo è stato pubblicato a settembre 2020.

1 ottobre 2022

Questo aggiornamento contiene le seguenti modifiche:

  • Il metodo liveBroadcasts.update non richiede più di specificare i valori per questi campi:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    Se ometti questi campi dalla richiesta, rimarranno invariati.

  • Rimossa la documentazione per i campi liveBroadcast obsoleti:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1° aprile 2022

Questo aggiornamento contiene le seguenti modifiche:

  • La proprietà snippet.type ora supporta due nuovi valori:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • La nuova proprietà snippet.membershipGiftingDetails della risorsa liveChatMessage e le relative proprietà secondarie contengono informazioni sull'evento Regala un abbonamento. Analogamente, la nuova proprietà snippet.giftMembershipReceivedDetails e le relative proprietà secondarie contengono informazioni sull'evento Abbonamento regalo ricevuto.

15 settembre 2021

Questo aggiornamento contiene le seguenti modifiche:

  • La proprietà snippet.type ora supporta due nuovi valori:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • La nuova proprietà snippet.memberMilestoneChatDetails della risorsa liveChatMessage e i relativi elementi secondari contengono informazioni sull'evento di messaggio di fedeltà al canale. Analogamente, la nuova proprietà snippet.newSponsorDetails e i relativi elementi secondari contengono informazioni sull'evento Nuovo sponsor.

1 dicembre 2020

Il metodo liveBroadcasts.transition dell'API supporta un nuovo errore 403 (Forbidden), che indica che l'utente ha inviato troppe richieste in un determinato periodo di tempo. Il motivo dell'errore è userRequestsExceedRateLimit.

21 settembre 2020

  • La definizione della proprietà status.madeForKids della risorsa liveBroadcast è stata aggiornata per chiarire che la proprietà è di sola lettura. Ciò non riflette una modifica della funzionalità dell'API.

    Per indicare che una trasmissione live è destinata ai minori, imposta la proprietà status.selfDeclaredMadeForKids su true quando chiami il metodo liveBroadcasts.insert per creare la trasmissione.

  • Nota: questa modifica include un annuncio di ritiro e un aggiornamento di un annuncio di ritiro precedente.

    Il metodo liveBroadcasts.control verrà ritirato a partire dal 1° ottobre 2020. Dopo questa data, tutte le chiamate a questo metodo restituiranno un errore di accesso non consentito (403) e il metodo verrà rimosso completamente in un secondo momento. I client possono comunque implementare il proprio slating aggiungendo un overlay al video inviato ai server di importazione di YouTube.

    La data di ritiro per l'annuncio di ritiro fatto il 16 aprile 2020, originariamente programmato per il 1° settembre 2020, è stata posticipata e ora avverrà il 1° ottobre 2020 o in una data successiva. Pertanto, le funzionalità incluse in questo annuncio di ritiro e il metodo liveBroadcasts.control verranno ritirati contemporaneamente.

17 luglio 2020

Nota: questo è un aggiornamento di un annuncio di ritiro precedente.

Il campo cdn.format della risorsa liveStream, deprecato ad aprile 2016, non sarà più supportato a partire dal 17 agosto 2020. A partire da questa data, le richieste che utilizzano ancora questo campo non andranno a buon fine.

Se il tuo codice utilizza ancora il campo cdn.format, deve essere aggiornato per specificare la frequenza fotogrammi e la risoluzione separatamente, utilizzando le proprietà cdn.frameRate e cdn.resolution.

6 luglio 2020

La guida Pubblicazione di contenuti live di YouTube tramite HLS è stata aggiornata con alcune modifiche:

  • La durata consigliata per un segmento multimediale è stata aggiornata a un intervallo compreso tra uno e quattro secondi.
  • Una nuova sezione spiega come ottenere un URL di importazione HLS da YouTube Creator Studio.
  • Le istruzioni per la formattazione del valore del parametro file sono state spostate nella nuova sezione Completamento dell'URL di importazione HLS. Queste istruzioni si applicano indipendentemente dal fatto che l'URL di importazione HLS venga ottenuto dall'API di YouTube o da YouTube Creator Studio.

Inoltre, il nuovo confronto dei protocolli di importazione elenca i protocolli di importazione supportati da YouTube, i codec supportati per ogni protocollo e ulteriori informazioni sui casi d'uso appropriati per ogni protocollo.

16 aprile 2020

Questo aggiornamento include una nuova proprietà e un annuncio di ritiro:

  • La risorsa liveBroadcast ora supporta la proprietà contentDetails.enableAutoStop. La proprietà indica se una trasmissione deve interrompersi automaticamente circa un minuto dopo che il proprietario del canale interrompe lo streaming video sullo stream video associato.

    Il documento Ciclo di vita di una trasmissione è stato aggiornato per spiegare come cambia la procedura passo passo per la creazione e la gestione di un evento live di YouTube se imposti le proprietà contentDetails.enableAutoStart o contentDetails.enableAutoStop su true.

  • Nota: questo è un annuncio di ritiro. Queste modifiche entreranno in vigore a partire dal 1° settembre 2020. La data effettiva in cui le modifiche entrano in vigore è indicata di seguito come data di ritiro.

    Questo aggiornamento spiega una modifica che potrebbe provocare un errore. Interessa le applicazioni client API che utilizzano le risorse liveStream e liveBroadcast predefinite dei canali per trasmettere contenuti live su YouTube. In particolare, l'ID trasmissione e l'ID stream associati alla trasmissione e allo stream persistenti non funzioneranno più per avviare nuove trasmissioni.

    La tua applicazione sarà interessata se si verifica una delle seguenti condizioni:

    • Controlla il valore della proprietà isDefaultBroadcast della risorsa liveBroadcast. Questa proprietà non verrà restituita dopo la data di ritiro.
    • Controlla il valore della proprietà isDefaultStream della risorsa liveStream. Questa proprietà non verrà restituita dopo la data di ritiro.
    • Chiama il metodo liveBroadcasts.list e imposta il valore parametro broadcastType su persistent o all. Questo parametro verrà ritirato nell'ambito di queste modifiche. A partire dalla data di ritiro:
      • Se il valore del parametro broadcastType è persistent, il metodo liveBroadcasts.list non restituirà alcun risultato.
      • Se il valore del parametro broadcastType è all, il metodo liveBroadcasts.list non restituirà le trasmissioni persistenti esistenti prima di quel momento.

    Per darti un po' di contesto, negli ultimi anni YouTube ha creato automaticamente uno stream predefinito e una trasmissione predefinita per un canale quando questo veniva abilitato per il live streaming. Lo stream predefinito esisteva a tempo indeterminato, non aveva un'ora di inizio o di fine associata e non poteva essere eliminato. Analogamente, la trasmissione predefinita è stata considerata persistente. È sempre esistito e non era legato a un evento particolare.

    A partire dalla data di ritiro:

    • YouTube non creerà più stream e trasmissioni predefiniti. Anziché fare affidamento sulle risorse predefinite, i client API devono essere in grado di creare e gestire le risorse liveBroadcast e liveStream e di associarle tra loro.
    • Se la trasmissione predefinita e lo stream predefinito di un canale sono attivi, ovvero il canale li sta utilizzando per una trasmissione live al momento dell'entrata in vigore del ritiro, la trasmissione in corso non sarà interessata. Tuttavia, al termine della trasmissione, il canale non potrà più utilizzare la trasmissione e lo stream predefiniti.
    • Se la trasmissione predefinita e lo stream predefinito di un canale non sono attivi, dopo l'entrata in vigore del ritiro, YouTube ignorerà i tentativi di utilizzare queste risorse per trasmettere video.

    Se la tua applicazione è interessata, consulta i seguenti documenti, che ti aiuteranno ad aggiornarla in modo che continui a funzionare come previsto dopo questa modifica:

    • Una nuova guida alla migrazione cerca di spiegare i passaggi che gli sviluppatori potrebbero dover seguire nei client API che attualmente utilizzano trasmissioni e stream predefiniti.
    • La guida Ciclo di vita di una trasmissione ti illustra passo passo come creare e gestire un evento live su YouTube. Ogni passaggio spiega le chiamate API o altre operazioni che devi eseguire per completare un'azione specifica. La tua applicazione dovrà seguire questa procedura quando YouTube interromperà il supporto degli stream e delle trasmissioni predefiniti.

31 marzo 2020

Nota: questo è un annuncio di ritiro.

La risorsa sponsor e il metodo sponsors.list sono stati deprecati e sostituiti dalla risorsa member e dal metodo members.list.

Il metodo sponsors.list non sarà più supportato a partire dal 30 settembre 2020. I client API devono aggiornare le chiamate al metodo sponsors.list per utilizzare invece il metodo members.list. Per ulteriori informazioni sulla nuova risorsa, consulta la cronologia delle revisioni dell'API YouTube Data.

11 marzo 2020

La sezione Ingestion endpoint della guida Delivering Live YouTube Content via HLS è stata aggiornata per chiarire la procedura che un codificatore deve utilizzare per completare il valore del parametro file= durante la formazione degli URL di importazione principale e di backup.

4 febbraio 2020

La guida Pubblicazione di contenuti di YouTube in diretta tramite HLS è stata aggiornata per indicare che le richieste DELETE sono facoltative e che l'endpoint HLS di YouTube le ignora. Per motivi di rendimento, YouTube consiglia ai client di non inviare richieste DELETE.

10 gennaio 2020

L'API ora supporta la possibilità di identificare i contenuti rivolti ai minori, che YouTube chiama "destinati ai bambini". Scopri di più sui contenuti "destinati ai bambini" nel Centro assistenza YouTube.

  • La risorsa liveBroadcast supporta due nuove proprietà per consentire ai creator di contenuti e agli spettatori di identificare i contenuti "destinati ai bambini":
    • La proprietà selfDeclaredMadeForKids consente ai creator di contenuti di specificare se una trasmissione live è un contenuto destinato ai minori. Questa proprietà può essere impostata durante la creazione di una trasmissione tramite il metodo liveBroadcasts.insert. Tieni presente che questa proprietà è inclusa nelle risposte dell'API che contengono risorse liveBroadcast solo se il proprietario del canale ha autorizzato la richiesta API.
    • La proprietà madeForKids consente a qualsiasi utente dell'API di recuperare lo stato "destinato ai bambini" di una trasmissione. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Per saperne di più sull'impostazione del pubblico per il tuo canale, i tuoi video o le tue trasmissioni, consulta il Centro assistenza YouTube.
  • Nell'API YouTube Data, la risorsa channel supporta anche le nuove proprietà selfDeclaredMadeForKids e madeForKids.

Abbiamo anche aggiornato i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta la cronologia delle revisioni dei Termini di servizio dei servizi API di YouTube. Le modifiche ai Termini di servizio dei servizi API di YouTube e alle Norme per gli sviluppatori entreranno in vigore il 10 gennaio 2020 (fuso orario del Pacifico).

20 agosto 2019

La sezione Requisiti della guida Pubblicazione di contenuti live di YouTube tramite HLS è stata aggiornata con due modifiche:

  • Spiega che è una best practice includere sia i segmenti riconosciuti sia quelli in sospeso in ogni playlist multimediale. Questa pratica riduce la probabilità che un segmento venga saltato se una playlist multimediale viene persa sul lato server. Ad esempio, puoi includere fino a due segmenti confermati e fino a cinque segmenti in sospeso in ogni playlist multimediale.
  • Ora è obbligatorio inviare una playlist multimediale per ogni segmento multimediale. In questo modo, il server può eseguire rapidamente il recupero se una playlist multimediale viene persa. Questa pratica era precedentemente elencata come suggerimento.

28 giugno 2019

YouTube ora supporta l'importazione HLS. Di conseguenza, la proprietà ingestionType della risorsa liveStream supporta il nuovo valore hls per identificare gli stream importati su YouTube utilizzando HLS.

La nuova guida Pubblicazione di contenuti live di YouTube tramite HLS fornisce linee guida per l'utilizzo di HLS per trasmettere contenuti live su YouTube da un codificatore. La guida ha lo scopo di aiutare i fornitori di codificatori ad aggiungere il supporto per la pubblicazione HLS ai loro prodotti.

4 aprile 2019

Questo aggiornamento contiene le seguenti modifiche:

  • La documentazione di riferimento dell'API è stata aggiornata per spiegare meglio i casi d'uso comuni di ogni metodo e per fornire esempi di codice dinamici e di alta qualità tramite il widget Explorer API. Per un esempio, consulta la documentazione del metodo liveBroadcasts.list. Ora sono presenti due nuovi elementi nelle pagine che descrivono i metodi API:

    • Il widget Explorer API ti consente di selezionare gli ambiti di autorizzazione, inserire valori di esempio per parametri e proprietà, quindi inviare richieste API effettive e visualizzare le risposte API effettive. Il widget offre anche una visualizzazione a schermo intero che mostra esempi di codice completi, che si aggiornano dinamicamente per utilizzare gli ambiti e i valori che hai inserito.

    • La sezione Casi d'uso comuni descrive uno o più casi d'uso comuni per il metodo spiegato nella pagina. Ad esempio, puoi chiamare il metodo liveBroadcasts.list per recuperare i dati relativi a una trasmissione specifica o alle trasmissioni dell'utente corrente.

      Puoi utilizzare i link in questa sezione per compilare Explorer API con valori di esempio per il tuo caso d'uso o per aprire Explorer API a schermo intero con i valori già compilati. Queste modifiche hanno lo scopo di semplificare la visualizzazione di esempi di codice direttamente applicabili al caso d'uso che stai cercando di implementare nella tua applicazione.

    Al momento gli esempi di codice sono supportati per Java, JavaScript, PHP, Python e curl.

  • Anche la pagina degli esempi di codice ha una nuova UI che offre tutte le stesse funzionalità descritte sopra. Utilizzando questo strumento, puoi esplorare i casi d'uso per diversi metodi, caricare i valori in Explorer API e aprire Explorer API a schermo intero per ottenere esempi di codice in Java, JavaScript, PHP e Python.

    In concomitanza con questa modifica, sono state rimosse le pagine che in precedenza elencavano gli esempi di codice disponibili per Java, PHP e Python.

25 febbraio 2019

La documentazione delle risorse liveChatMessage e superChatEvent è stata aggiornata per riflettere il fatto che entrambe le risorse ora possono contenere informazioni sui Super Sticker. I Super Sticker sono un tipo di messaggio di Superchat che mostra un'immagine. Come per gli altri messaggi di Super Chat, un messaggio di Super Sticker viene acquistato da un fan durante un live streaming di YouTube.

  • In una risorsa liveChatMessage, la proprietà snippet.type è ora impostata su superStickerEvent per indicare che la risorsa contiene informazioni su un Super Sticker. In questo caso, la risorsa contiene anche l'oggetto snippet.superStickerDetails, che contiene informazioni aggiuntive sul Supersticker.
  • In una risorsa superChatEvent, il valore booleano snippet.isSuperStickerEvent indica se il messaggio Super Chat è anche un Super Sticker. In questo caso, l'oggetto snippet.superStickerMetadata contiene ulteriori dettagli sul Super Sticker.

5 aprile 2018

La descrizione del metodo superChatEvents.list è stata aggiornata per riflettere il fatto che la risposta dell'API non contiene più fanFundingEvents, che sono stati ritirati all'inizio del 2017.

3 aprile 2017

Sono stati aggiunti nuovi esempi di codice Java che mostrano come elencare, inserire ed eliminare i messaggi della chat live. Gli esempi chiamano i seguenti metodi:

13 febbraio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • Il metodo liveCuepoints.insert è stato aggiornato per riflettere il fatto che il parametro onBehalfOfContentOwner è attualmente obbligatorio. Inoltre, la descrizione del metodo è stata aggiornata per indicare che le chiamate a questo metodo devono essere autorizzate da un account associato a un proprietario dei contenuti di YouTube.

9 febbraio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • Il nuovo parametro hl del metodo superChatEvents.list consente di specificare che il valore della proprietà snippet.displayString deve essere formattato in base alle convenzioni di una determinata lingua. Anche la definizione di questa proprietà è stata aggiornata di conseguenza.

      Il valore del parametro deve essere un codice lingua incluso nell'elenco restituito dal metodo i18nLanguages.list. Il valore predefinito è en, il che significa che il comportamento predefinito è formattare le stringhe di visualizzazione come se fossero utilizzate in inglese. Ad esempio, per impostazione predefinita, una stringa viene formattata come $1.00 anziché come $1,00.

1 febbraio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e metodi

    • La nuova 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 messaggi in due modi:

      • I messaggi di Super Chat sono messi in evidenza con un colore.
      • I messaggi di Super Chat rimangono fissati nel ticker per un determinato periodo di tempo.

      Il colore della Super Chat, il periodo di tempo in cui rimane in primo piano nel ticker e la lunghezza massima del messaggio sono determinati dall'importo di acquisto. Il Centro assistenza YouTube contiene ulteriori informazioni sulle Super Chat.

      L'API supporta un metodo per elencare gli eventi Superchat per i live streaming di un canale negli ultimi 30 giorni. Questo metodo restituisce anche i dati sugli eventi di finanziamenti dei fan (fanFundingEvents) dell'ultimo live streaming del canale.

  • Aggiornamenti a risorse e metodi esistenti

    • La proprietà snippet.type ora supporta il valore superChatEvent, che indica che la risorsa descrive una Super Chat.

      Inoltre, la nuova proprietà snippet.superChatDetails della risorsa liveChatMessage e i relativi elementi secondari contengono informazioni sull'evento Super Chat.

    • La proprietà cdn.resolution della risorsa liveStream ora supporta il valore 2160p.

  • Errori nuovi e aggiornati

    • L'API supporta i seguenti nuovi errori:

      Dettagli errore
      liveBroadcasts.insert, liveBroadcasts.update I metodi liveBroadcasts.insert e liveBroadcasts.update restituiscono errori 400 (Bad Request) per indicare che la risorsa liveBroadcast inserita o aggiornata contiene un valore non valido per la proprietà contentDetails.enableEmbed o contentDetails.projection. I motivi dei due nuovi errori sono rispettivamente invalidEmbedSetting e invalidProjection.

12 gennaio 2017

Nota: questo è un annuncio di ritiro.

In concomitanza con il rilascio della nuova funzionalità Super Chat, YouTube ha ritirato la funzionalità di finanziamento dei fan e l'API di finanziamento dei fan verrà disattivata il 28 febbraio 2017. A partire da questa data:

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

  • I Termini di servizio dei servizi API di YouTube appena pubblicati ("i Termini aggiornati"), discussi in dettaglio nel blog di YouTube Engineering and Developers, forniscono un ricco insieme di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto che spiegano le norme che gli sviluppatori devono seguire.

    L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti di supporto verranno spiegate anche nella cronologia delle revisioni.

20 maggio 2016

YouTube ora supporta l'importazione DASH. Di conseguenza, la proprietà ingestionType della risorsa liveStream supporta il nuovo valore dash per identificare gli stream importati su YouTube utilizzando DASH.

La nuova guida Pubblicazione di contenuti live di YouTube tramite DASH fornisce linee guida per l'utilizzo del formato di pubblicazione DASH per trasmettere in streaming dati in diretta su YouTube da un codificatore. È destinata ad aiutare i fornitori di codificatori ad aggiungere il supporto per la pubblicazione DASH ai loro prodotti.

18 aprile 2016

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • Aggiornamenti delle risorse liveStream

      • YouTube ora supporta gli stream con risoluzione 1440p a 30 o 60 frame al secondo.

        Inoltre, la risorsa liveStream contiene nuove proprietà per specificare la frequenza fotogrammi e la risoluzione dei dati video in entrata:

        Proprietà
        cdn.frameRate La frequenza fotogrammi dei dati video in entrata. I valori validi sono 30fps e 60fps.
        cdn.resolution La risoluzione dei dati video in entrata. I valori validi della proprietà sono: 1440p, 1080p, 720p, 480p, 360p e 240p.

      • In conformità con l'introduzione delle proprietà cdn.frameRate e cdn.resolution della risorsa liveStream, la proprietà cdn.format della risorsa è ora deprecata. La proprietà cdn.format specifica la risoluzione e la frequenza fotogrammi in un unico valore.

        Ti invitiamo a passare ai campi appena supportati. Nel frattempo, cdn.format continua a funzionare. Inoltre, le richieste di inserimento di live streaming attualmente vanno a buon fine se specifichi i valori per la proprietà cdn.format o per le proprietà cdn.frameRate e cdn.resolution. Se fornisci valori per tutte e tre le proprietà, l'API potrebbe restituire un errore se i valori non corrispondono.

        Tieni presente che, anche se la proprietà cdn.format è deprecata, ora supporta due nuovi valori, 1440p e 1440p_hfr, per riflettere il supporto dell'API per gli stream a 1440p a 30 o 60 frame al secondo.

    • Aggiornamenti delle risorse liveBroadcast

      • La risorsa liveBroadcast contiene le seguenti nuove proprietà:

        Proprietà
        contentDetails.boundStreamLastUpdateTimeMs La data e l'ora dell'ultimo aggiornamento del live streaming a cui fa riferimento la proprietà contentDetails.boundStreamId della trasmissione.
        contentDetails.projection Il formato di proiezione della trasmissione. Il valore predefinito della proprietà è rectangular. I valori validi per la proprietà sono 360 e rectangular.

      • La definizione della proprietà statistics.totalChatCount della risorsa liveBroadcast è stata aggiornata per indicare che il valore della proprietà viene visualizzato solo se la trasmissione ha almeno un messaggio chat.

    • Aggiornamenti delle risorse liveChatMessage

      • La proprietà snippet.type supporta due nuovi valori, messageDeletedEvent e userBannedEvent, che corrispondono alle nuove proprietà descritte nel punto elenco seguente. Anche la definizione della proprietà snippet.authorChannelId è stata aggiornata per spiegare cosa identifica il valore della proprietà per questi nuovi tipi di messaggi.

      • La risorsa liveChatMessage contiene le seguenti nuove proprietà:

        Proprietà
        snippet.messageDeletedDetails Questo oggetto contiene informazioni su un messaggio eliminato da un moderatore della chat. L'oggetto è presente solo se il valore della proprietà snippet.type è messageDeletedEvent.
        snippet.userBannedDetails Questo oggetto contiene informazioni su un utente a cui è stato vietato di partecipare alla chat. L'oggetto contiene anche informazioni sul ban stesso, ovvero se è permanente o temporaneo. Se il ban è temporaneo, una delle proprietà dell'oggetto specifica la durata del ban.

        Questo oggetto è presente solo se il valore della proprietà snippet.type è userBannedEvent.

  • Errori nuovi e aggiornati

    • L'API supporta i seguenti nuovi errori:

      Dettagli errore
      liveBroadcasts.bind Il metodo liveBroadcasts.bind restituisce un errore 403 (Forbidden) per indicare che l'utente ha inviato troppe richieste entro un determinato periodo di tempo. Il motivo dell'errore è userRequestsExceedRateLimit.

      I metodi liveBroadcasts.insert e liveBroadcasts.update supportano già lo stesso errore.
      liveStreams.insert Il metodo liveStreams.insert supporta quattro nuovi errori 400 (Bad Request) che identificano un valore della proprietà non valido nella risorsa liveStream che la richiesta ha tentato di inserire. Il seguente elenco identifica i motivi dell'errore e le proprietà a cui sono associati:
      liveStreams.insert Il metodo liveStreams.insert supporta due nuovi errori 400 (Bad Request), ognuno dei quali indica che un valore obbligatorio non è presente nella risorsa liveStream che la richiesta ha tentato di inserire. Il seguente elenco identifica i motivi dell'errore e le proprietà a cui sono associati:
      Più nello specifico, quando inserisci una risorsa liveStream, devi specificare un valore per la proprietà cdn.format o per le proprietà cdn.frameRate e cdn.resolution.
      • L'API restituisce un errore formatRequired se non specifichi un valore per una delle tre proprietà.
      • L'API restituisce un errore frameRateRequired se specifichi un valore per cdn.resolution, ma non per cdn.frameRate.
      • L'API restituisce un errore resolutionRequired se specifichi un valore per cdn.frameRate, ma non per cdn.resolution.
      liveStreams.update Il metodo liveStreams.update restituisce un errore 403 (Forbidden) se la richiesta tenta di modificare il valore di una delle seguenti proprietà non modificabili: Il valore reason nella risposta di errore è liveStreamModificationNotAllowed.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) impongono che vengano fornite determinate informative agli utenti finali nell'UE e che venga ottenuto il loro consenso. Pertanto, per gli utenti finali nell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una nota relativa a questo requisito nei nostri Termini di servizio delle API di YouTube.

17 dicembre 2015

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e metodi

    • L'API supporta diverse nuove risorse per supportare la funzionalità di chat per le trasmissioni live. YouTube supporta la funzionalità di chat live durante le trasmissioni live attive. Queste risorse e i relativi metodi supportano il recupero dei messaggi chat e le funzioni amministrative della chat.

      Risorse
      liveChatMessage Questa risorsa rappresenta un messaggio in una chat live di YouTube. YouTube supporta diversi tipi di messaggi, tra cui messaggi e messaggi di finanziamenti dei fan. Alcuni tipi di messaggi identificano una fase particolare della chat, ad esempio l'inizio di un periodo riservato agli abbonati o la fine della chat. L'API supporta metodi per elencare, inserire ed eliminare i messaggi chat live.
      liveChatModerators Questa risorsa identifica un moderatore della chat. I moderatori possono eseguire alcune funzioni amministrative, come bloccare gli utenti dalla chat o rimuovere i messaggi. L'API supporta metodi per elencare, inserire ed eliminare i moderatori della chat live.
      liveChatBans Questa risorsa identifica un utente a cui è stato vietato di pubblicare messaggi in una determinata chat live. I ban possono essere temporanei o permanenti. L'API supporta i metodi per inserire ed eliminare i ban dalla chat live.
      fanFundingEvents Questa risorsa rappresenta un evento di finanziamenti dei fan su un canale YouTube. I finanziamenti dei fan offrono agli spettatori un modo per sostenere volontariamente i creator di YouTube con un supporto monetario una tantum.

      Il metodo fanFundingEvents.list dell'API elenca gli eventi di finanziamento dei fan di un canale. Gli eventi di finanziamenti dei fan avviati tramite una chat live durante una trasmissione live di proprietà del canale attivano anche un messaggio fanFundingEvent nella chat live della trasmissione.

      Scopri di più sui finanziamenti dei fan nel Centro assistenza YouTube.
      sponsors La risorsa sponsor identifica uno sponsor di un canale YouTube. Uno sponsor paga una quota mensile a un canale. Accanto ai messaggi degli sponsor nelle chat live del canale viene visualizzato un badge. Inoltre, gli sponsor possono partecipare alle chat live riservate agli sponsor del canale, se presenti.

      Il metodo sponsors.list dell'API elenca gli sponsor di un canale. Quando gli utenti si registrano per sponsorizzare un canale durante una trasmissione live di proprietà di quel canale, l'API aggiunge anche un messaggio newSponsorEvent alla chat live della trasmissione.

      Scopri di più sulle sponsorizzazioni nel Centro assistenza YouTube.

  • Aggiornamenti a risorse e metodi esistenti

    • La risorsa liveBroadcast contiene le seguenti nuove proprietà:

      Proprietà
      snippet.liveChatId L'ID della chat live di YouTube della trasmissione. Con questo ID, puoi utilizzare i metodi della risorsa liveChatMessage per recuperare, inserire o eliminare i messaggi chat. Puoi anche aggiungere o rimuovere moderatori della chat, impedire agli utenti di partecipare alle chat live o rimuovere i divieti esistenti.
      contentDetails.closedCaptionsType Nota: questa proprietà sostituisce la proprietà contentDetails.enableClosedCaptions.

      Questa proprietà indica se il sottotitolaggio codificato è abilitato per la trasmissione e, in caso affermativo, il tipo di sottotitoli codificati che stai fornendo:
      • closedCaptionsDisabled: i sottotitoli codificati sono disattivati per la trasmissione live.
      • closedCaptionsHttpPost: invierai i sottotitoli codificati, tramite HTTP POST, a un URL di importazione associato al tuo live streaming.
      • closedCaptionsEmbedded: i sottotitoli codificati verranno codificati nello stream video utilizzando i formati EIA-608 e/o CEA-708.
      contentDetails.enableClosedCaptions Questa proprietà è stata ritirata il 17 dicembre 2015. Utilizza la proprietà contentDetails.closedCaptionsType a questo scopo. Per i client API che utilizzano già questa proprietà:
      • L'impostazione del valore della proprietà su true equivale all'impostazione della proprietà contentDetails.closedCaptionsType su closedCaptionsHttpPost.
      • L'impostazione del valore della proprietà su false equivale all'impostazione della proprietà contentDetails.closedCaptionsType su closedCaptionsDisabled.

    • Il nuovo parametro broadcastType del metodo liveBroadcasts.list ti consente di filtrare una risposta dell'API in modo da includere le trasmissioni di eventi, le trasmissioni permanenti o tutte le trasmissioni.

      Una trasmissione persistente è una trasmissione che esiste sempre e non è legata a un evento particolare. In particolare, la trasmissione predefinita di un canale è una trasmissione persistente ed è accessibile tramite la dashboard live in YouTube Creator Studio. Le altre trasmissioni del canale sono trasmissioni di eventi.

  • Il campo status.healthStatus.configurationIssues[].type della risorsa liveStream segnala i seguenti nuovi errori relativi allo stato di integrità:

    Errori
    audioTooManyChannels L'audio ha più di 2 canali, ma ne sono supportati solo 1 (mono) o 2 (stereo). Correggi il numero di canali audio.
    frameRateHigh L'attuale frequenza fotogrammi è troppo elevata. Imposta la frequenza fotogrammi su un valore pari a %(framerate)s f/s o inferiore.

  • La data di pubblicazione dell'aggiornamento della documentazione precedente è stata corretta.

  • Errori nuovi e aggiornati

    • Oltre agli errori definiti per le nuove risorse elencate sopra, l'API supporta i seguenti nuovi errori:

      Dettagli errore
      liveBroadcasts.update
      Codice di risposta HTTPforbidden (403)
      MotivoclosedCaptionsTypeModificationNotAllowed
      DescrizioneIl valore contentDetails.closedCaptionsType può essere modificato solo quando la trasmissione è nello stato created o ready.
      liveBroadcasts.update
      Codice di risposta HTTPinvalidValue (400)
      MotivoinvalidEnableClosedCaptions
      DescrizioneNella risorsa liveBroadcast, il valore della proprietà contentDetails.enableClosedCaptions non è compatibile con il valore dell'impostazione contentDetails.closedCaptionType. Modifica la risorsa in modo che includa solo una delle due proprietà, quindi invia nuovamente la richiesta.

19 agosto 2015

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e metodi

    • Nota: la documentazione relativa alla risorsa liveChat e ai suoi metodi è riservata e visibile solo ai partner di YouTube selezionati.

      La nuova risorsa liveChat contiene un commento pubblicato durante una trasmissione live su YouTube. L'API supporta due metodi per questa risorsa:

      Metodi
      liveChats.list Elenca i messaggi chat della chat live per una trasmissione.
      liveChats.insert Crea un nuovo messaggio chat.

      I messaggi chat live possono essere recuperati e pubblicati solo durante una trasmissione dal vivo.

  • Aggiornamenti a risorse e metodi esistenti

    • La risorsa liveStream contiene le seguenti nuove proprietà:

      Proprietà
      snippet.isDefaultStream Indica se questo stream è quello predefinito per il canale. Lo stream predefinito di un canale esiste a tempo indeterminato, non ha un'ora di inizio o di fine associata e non può essere eliminato. Per saperne di più sul funzionamento degli stream predefiniti, consulta la definizione della proprietà.
      status.healthStatus Questo oggetto contiene informazioni che potrebbero essere utilizzate per identificare, diagnosticare e risolvere i problemi di streaming. L'oggetto contiene una serie di proprietà secondarie che ti aiutano a valutare l'integrità di uno stream video in diretta.

      In particolare, l'oggetto status.healthStatus.configurationIssues[] elenca i problemi che interessano uno stream video. Un nuovo documento, Problemi di configurazione per le risorse LiveStream, elenca tutti i problemi segnalati dall'API.
      contentDetails.isReusable Indica se lo stream è riutilizzabile, ovvero se può essere associato a più trasmissioni. È comune per le emittenti riutilizzare lo stesso stream per molte trasmissioni diverse se queste vengono trasmesse in orari diversi.

    • La risorsa liveBroadcast contiene le seguenti nuove proprietà:

      Proprietà
      snippet.isDefaultBroadcast Indica se questa trasmissione è quella predefinita per il canale. Quando un canale YouTube è abilitato per il live streaming, YouTube crea uno stream predefinito e una trasmissione predefinita per il canale. Lo stream definisce il modo in cui il proprietario del canale invia il video in diretta a YouTube, mentre la trasmissione è il modo in cui gli spettatori possono vedere lo stream predefinito. Per ulteriori informazioni sul funzionamento delle trasmissioni predefinite, consulta la definizione della proprietà.
      contentDetails.enableLowLatency Indica se questa trasmissione deve essere codificata per lo streaming a bassa latenza. Uno stream a bassa latenza può ridurre il tempo necessario per rendere visibile il video agli utenti che guardano una trasmissione, anche se può influire sulla risoluzione per gli spettatori dello stream.
      statistics.totalChatCount Il numero totale di messaggi chat live associati alla trasmissione. La proprietà e il relativo valore sono presenti se la trasmissione è visibile all'utente e la funzionalità di chat live è attiva. Tieni presente che questa proprietà non specificherà un valore dopo la fine della trasmissione. Pertanto, questa proprietà non identifica il numero di messaggi chat per un video archiviato di una trasmissione live completata.

  • Errori nuovi e aggiornati

    • Oltre agli errori definiti per la nuova risorsa liveChat, l'API supporta il seguente nuovo errore:

      Dettagli errore
      liveStreams.update
      Codice di risposta HTTPforbidden (403)
      MotivoliveStreamModificationNotAllowed
      DescrizioneL'API non consente di modificare uno stream riutilizzabile in modo che non sia riutilizzabile o viceversa. Per saperne di più, consulta Informazioni su trasmissioni e stream

21 maggio 2015

Questo aggiornamento contiene le seguenti modifiche:

  • YouTube ora supporta lo stream video in diretta a 60 frame al secondo (fps), il che significa una riproduzione più fluida per i video di giochi e altri video con azioni rapide. Quando avvii un live streaming su YouTube a 60 fps, YouTube lo rende disponibile anche a 30 fps sui dispositivi su cui la visualizzazione con frequenza fotogrammi elevata non è ancora disponibile.

    La proprietà cdn.format della risorsa liveStream supporta due nuovi valori per questa funzionalità: 720p_hfr e 1080p_hfr.

    Per saperne di più su questa funzionalità, consulta il YouTube Creator Blog.

21 agosto 2014

Questo aggiornamento contiene le seguenti modifiche:

  • La definizione del parametro walltime del metodo liveBroadcasts.control è stata aggiornata per indicare che il valore della proprietà è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

  • L'API ora supporta i seguenti errori:

    Tipo di errore Dettagli errore Descrizione
    insufficientPermissions liveStreamingNotEnabled Tutti i metodi per le risorse liveBroadcast e liveStream restituiscono questo errore se l'utente che ha autorizzato la richiesta API non è stato abilitato a trasmettere video in diretta su YouTube. I dettagli che spiegano perché l'utente non può trasmettere video in diretta potrebbero essere disponibili nelle impostazioni del canale dell'utente all'indirizzo https://www.youtube.com/features.
    rateLimitExceeded userRequestsExceedRateLimit I metodi liveBroadcasts.insert e liveStreams.insert restituiscono entrambi questo errore per indicare che l'utente ha inviato troppe richieste entro un determinato periodo di tempo.

2 maggio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Le descrizioni della risorsa liveStream e del metodo liveBroadcasts.bind sono state aggiornate per indicare che una trasmissione può essere associata a un solo stream video, ma uno stream video può essere associato a più di una trasmissione. Questa modifica è esclusivamente una correzione alla documentazione; la funzionalità dell'API sottostante non è cambiata.

  • La proprietà contentDetails.monitorStream.enableMonitorStream della risorsa liveBroadcast è stata aggiornata per spiegare che se il valore della proprietà è true, devi eseguire la transizione della trasmissione allo stato testing prima di poterla eseguire allo stato live. Se il valore della proprietà è false, la trasmissione non può avere una fase testing, quindi puoi passare direttamente allo stato live.

  • La proprietà settings.offsetTimeMs della risorsa liveCuepoint è stata aggiornata per indicare che non devi specificare un valore per la proprietà se la trasmissione non ha uno stream di monitoraggio.

  • Tutti i metodi per le risorse liveBroadcast e liveStream ora supportano i parametri onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Questi parametri ti consentono di utilizzare le stesse credenziali di autorizzazione per completare le richieste API per canali diversi associati allo stesso proprietario dei contenuti.

  • La documentazione del metodo liveCuepoints.insert è stata aggiornata per indicare che puoi impostare un valore per la proprietà settings.walltime quando chiami questo metodo.

  • La documentazione sugli errori ora specifica il codice di risposta HTTP per ogni tipo di errore.

  • L'API ora supporta il seguente errore:

    Tipo di errore Dettagli errore Descrizione
    insufficientPermissions livePermissionBlocked I metodi liveBroadcasts.insert, liveBroadcasts.transition e liveStreams.insert restituiscono questo errore se l'utente che ha autorizzato la richiesta non è in grado di trasmettere video in diretta su YouTube. I dettagli che spiegano perché l'utente non può trasmettere video in diretta potrebbero essere disponibili nelle impostazioni del canale dell'utente all'indirizzo https://www.youtube.com/features.

  • L'errore invalidScheduledStartTime del metodo liveBroadcasts.insert è stato aggiornato per chiarire che l'ora di inizio programmata deve essere abbastanza vicina alla data corrente da consentire la programmazione affidabile di una trasmissione in quel momento.

13 dicembre 2013

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova proprietà status.recordingStatus della risorsa liveBroadcast identifica lo stato corrente della trasmissione.

  • La nuova proprietà contentDetails.enableClosedCaptions della risorsa liveBroadcast indica se è possibile importare i sottotitoli codificati per la trasmissione. Il valore della proprietà può essere impostato quando inserisci o aggiorni una trasmissione, ma non può essere aggiornato una volta che la trasmissione è nello stato testing o live. Se imposti questa proprietà su true, la risorsa liveStream associata alla trasmissione specificherà l'URL di importazione da utilizzare per i sottotitoli codificati della trasmissione.

  • La proprietà snippet.scheduledEndTime della risorsa liveBroadcast ora supporta le trasmissioni programmate per continuare a tempo indeterminato. Con questa modifica, la proprietà non è più obbligatoria nelle richieste liveBroadcasts.insert e liveBroadcasts.update.

    Se recuperi una risorsa liveBroadcast che non specifica un valore per questa proprietà, la trasmissione è programmata per continuare a tempo indeterminato. Analogamente, se chiami il metodo liveBroadcasts.insert o liveBroadcasts.update e non specifichi un valore per questa proprietà, la trasmissione verrà pianificata per continuare a tempo indeterminato.

  • La proprietà contentDetails.recordFromStart della risorsa liveBroadcast, che aveva già un valore predefinito di true, ora può essere impostata su false solo se il canale di trasmissione è autorizzato a disattivare le registrazioni per le trasmissioni live.

    Se il tuo canale non dispone dell'autorizzazione per disattivare le registrazioni e tenti di inserire una trasmissione con la proprietà recordFromStart impostata su false, l'API restituirà un errore Forbidden. Inoltre, se il tuo canale non dispone di questa autorizzazione e tenti di aggiornare una trasmissione per impostare la proprietà recordFromStart su false, l'API restituirà un errore modificationNotAllowed.

  • La risorsa liveBroadcast non contiene più una proprietà enableArchive, che era stata menzionata nelle descrizioni delle proprietà contentDetails.enableDvr e contentDetails.enableEmbed.

  • L'elenco dei valori validi per la proprietà status.lifeCycleStatus della risorsa liveBroadcast è stato aggiornato per includere una descrizione di ogni stato.

  • La nuova proprietà settings.walltime della risorsa liveCuepoint specifica la data e l'ora in cui deve essere inserito il cuepoint. L'API restituisce un errore se una richiesta tenta di inserire un cuepoint che specifica un valore per questa proprietà e per la proprietà settings.offsetTimeMs.

  • Il nuovo oggetto contentDetails in una risorsa liveStream contiene informazioni sullo stream. Al momento, l'unica proprietà dell'oggetto è contentDetails.closedCaptionsIngestionUrl, che specifica l'URL di importazione per i sottotitoli codificati associati allo stream video.

  • L'elenco dei valori validi per la proprietà status.streamStatus della risorsa liveStream è stato aggiornato per includere una descrizione di ogni stato.

  • Il nuovo parametro walltime del metodo liveBroadcasts.control consente di specificare la data e l'ora in cui verrà apportata una modifica allo slate. L'API restituisce un errore se una richiesta specifica un valore per questo parametro e per il parametro offsetTimeMs.

  • Nella risposta dell'API a una richiesta liveBroadcasts.list, il valore della proprietà kind è cambiato da youtube#liveBroadcastList a youtube#liveBroadcastListResponse.

  • Nella risposta dell'API a una richiesta liveStreams.list, il valore della proprietà kind è cambiato da youtube#liveStreamList a youtube#liveStreamListResponse.

  • La proprietà eventId è stata ritirata sia da liveBroadcastListResponse che da liveStreamListResponse.

  • L'API supporta i seguenti nuovi errori:

    Tipo di errore Dettagli errore Descrizione
    invalidValue conflictingTimeFields Il metodo liveBroadcasts.control restituisce questo errore se la richiesta specifica i valori per i parametri offsetTimeMs e walltime. Una richiesta può omettere entrambi i parametri o specificare un valore per uno dei due parametri.
    invalidValue invalidWalltime Il metodo liveBroadcasts.control restituisce questo errore se il valore del parametro walltime non è valido.
    forbidden enableClosedCaptionsModificationNotAllowed Il metodo liveBroadcasts.update restituisce questo errore se provi ad aggiornare il valore contentDetails.enableClosedCaptions e lo stato della trasmissione non è created o ready.
    invalidValue conflictingTimeFields Il metodo liveCuepoints.insert restituisce questo errore se la richiesta specifica i valori per le proprietà settings.offsetTimeMs e settings.walltime. Una richiesta può omettere entrambe le proprietà o specificare un valore per una delle due proprietà.

    Inoltre, il metodo liveStreams.update non supporta più un errore cdnRequired simile a quello supportato dal metodo liveStreams.insert.

10 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

2 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

27 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Le seguenti proprietà sono cambiate nella risorsa liveBroadcast:

    • La proprietà startWithSlateCuepoint è stata rinominata in startWithSlate.
    • La proprietà enableArchive è stata rinominata in recordFromStart.
    • L'oggetto slateSettings è stato ritirato e rimosso dalla documentazione. Sono stati rimossi anche i messaggi di errore relativi all'oggetto slateSettings o alle sue proprietà. Infine, la sezione "Visualizzazione degli slate" della guida Inizia è stata rimossa.

  • L'API non supporta più la possibilità di inserire slate in-stream utilizzando il metodo liveCuepoints.insert. I seguenti documenti sono stati aggiornati di conseguenza:

    • La pagina di indice, la guida Inizia e il tutorial Ciclo di vita di una trasmissione non menzionano più questa funzionalità.

    • La proprietà settings.cueType della risorsa liveCuepoint non supporta più slate come valore della proprietà. (L'unico valore supportato è ad.

    • La proprietà settings.eventState della risorsa liveCuepoint è stata ritirata e rimossa dalla documentazione.

18 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Tutti i messaggi di errore dell'API sono stati aggiornati per spiegare più chiaramente i possibili errori e, se possibile, offrire indicazioni su come risolvere il problema.

  • L'API potrebbe ora restituire diversi nuovi errori. L'elenco seguente identifica l'errore e il metodo API che potrebbe restituirlo:

    • liveBroadcasts.insert: l'ora di fine programmata di una trasmissione deve essere successiva all'ora di inizio programmata.
    • liveBroadcasts.insert: la trasmissione specifica uno stato della privacy non valido.
    • liveBroadcasts.update: la risorsa non contiene o non imposta un valore per la proprietà contentDetails.enableArchive.
    • liveBroadcasts.update: la risorsa non contiene o non imposta un valore per la proprietà contentDetails.enableContentEncryption.
    • liveBroadcasts.update: la risorsa non contiene o non imposta un valore per la proprietà contentDetails.enableDvr.
    • liveStreams.insert: il titolo dello snippet deve avere una lunghezza compresa tra 1 e 128 caratteri.
    • liveStreams.update: la risorsa non contiene o non imposta un valore per la proprietà snippet.title.

  • La documentazione della risorsa liveStream è stata aggiornata per indicare che multicast e WebM non sono metodi di importazione supportati, come indicato in precedenza. L'elenco dei formati per la proprietà cdn.format è stato aggiornato di conseguenza e l'oggetto cdn.multicastIngestionInfo e le relative proprietà secondarie sono stati rimossi dalla documentazione della risorsa. Inoltre, http è stato rimosso dall'elenco dei valori cdn.ingestionType supportati.