Questa pagina è stata tradotta dall'API Cloud Translation.

API YouTube Live Streaming - Cronologia delle revisioni

Questa pagina elenca le modifiche all'API YouTube Live Streaming e gli aggiornamenti della documentazione. Abbonati a questo log delle modifiche.

9 ottobre 2023

Solo come riferimento, puoi trovare gli ID degli adesivi associati 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 entrambe aggiornate per riflettere queste informazioni.

15 settembre 2023

L'API ora supporta un nuovo modo di inserire gli annunci nelle trasmissioni in diretta. Oltre a liveCuepoints, che consente di inserire manualmente le interruzioni pubblicitarie in una trasmissione, YouTube ora supporta una funzionalità che consente di 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 cue point degli annunci. I cue point possono essere inseriti contemporaneamente per tutti gli spettatori oppure la loro temporizzazione può variare da spettatore a spettatore. La seconda strategia consente a YouTube di pianificare i cue point a 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 di annunci mid-roll viene messo in pausa fino a un'ora specifica.

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

La risorsa liveBroadcast ora contiene un monetizationDetails oggetto. I campi dell'oggetto indicano se l'inserimento automatico degli annunci è abilitato per la trasmissione e specificano informazioni aggiuntive per la pianificazione dei cue point.
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 per una trasmissione in diretta. Ora la documentazione identifica anche diversi errori che possono verificarsi durante l'aggiornamento dei dettagli di monetizzazione di una trasmissione dal vivo.

1° agosto 2023

Questo aggiornamento contiene le seguenti modifiche:

Il metodo liveBroadcasts.update non richiede più la specifica di valori per questi campi:
- snippet.title
- status.privacyStatus
Se li ometti dalla richiesta, rimarranno invariati.

1 novembre 2022

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

Diverse guide sono state aggiornate per riflettere la disponibilità di questo nuovo metodo.
Nota:questo è un annuncio relativo al ritiro.

Il metodo liveCuepoints.insert è stato 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 invece il metodo liveBroadcasts.cuepoint.
La documentazione del metodo liveBroadcasts.control è stata rimossa. A settembre 2020 è stato pubblicato un avviso di ritiro per questo metodo.

1 ottobre 2022

Questo aggiornamento contiene le seguenti modifiche:

Il metodo liveBroadcasts.update non richiede più la specifica di valori per questi campi:
- contentDetails.enableContentEncryption
- contentDetails.enableDvr
- contentDetails.enableEmbed
- contentDetails.recordFromStart
- contentDetails.startWithSlate
Se li ometti dalla richiesta, rimarranno invariati.
È stata 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 i relativi elementi secondari contengono informazioni sull'evento Abbonamento regalo. Analogamente, la nuova proprietà snippet.giftMembershipReceivedDetails e i relativi elementi secondari 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 le relative proprietà secondarie 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 lasso 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 designare una trasmissione in diretta come 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à successivamente rimosso completamente. I clienti possono comunque implementare la propria slating aggiungendo un overlay al video inviato ai server di importazione di YouTube.

La data di ritiro relativa all'annuncio del ritiro reso il 16 aprile 2020, inizialmente programmata per il 1° settembre 2020, è stata posticipata e ora avverrà a partire dal 1° ottobre 2020. Pertanto, le funzionalità incluse nell'annuncio di ritiro e il metodo liveBroadcasts.control verranno ritirate contemporaneamente.

17 luglio 2020

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

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

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

6 luglio 2020

La guida Caricare contenuti di YouTube Live tramite HLS è stata aggiornata con alcune modifiche:

La durata consigliata per un segmento multimediale è stata aggiornata da 1 a 4 secondi.
Una nuova sezione spiega come ottenere un URL di importazione HLS da YouTube Studio.
Le istruzioni per la formattazione del valore del parametro file sono state spostate nella nuova sezione Completare l'URL di importazione HLS. Queste istruzioni si applicano indipendentemente dal fatto che l'URL di importazione HLS sia ottenuto dall'API di YouTube o da YouTube Studio.

Inoltre, il nuovo confronto tra i protocolli di importazione elenca i protocolli di importazione supportati da YouTube, i codec supportati per ciascun protocollo e ulteriori informazioni sui casi d'uso appropriati per ciascun 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 ha interrotto lo streaming video sullo stream video associato.

Il documento relativo al ciclo di vita di una trasmissione è stato aggiornato per spiegare in che modo la procedura dettagliata per la creazione e la gestione di un evento dal vivo su YouTube cambia se imposti le proprietà contentDetails.enableAutoStart o contentDetails.enableAutoStop su true.
Nota:questo è un annuncio relativo al ritiro. Queste modifiche entreranno in vigore a partire dal 1° settembre 2020. La data effettiva di applicazione delle modifiche è indicata di seguito come data di ritiro.

Questo aggiornamento spiega una modifica potenzialmente che provoca un errore. Riguarda le applicazioni client API che utilizzano le risorse liveStream e liveBroadcast predefinite dei canali per trasmettere in streaming contenuti dal vivo su YouTube. Nello specifico, l'ID trasmissione e l'ID stream associati alla trasmissione e allo stream permanenti non funzioneranno più per avviare nuove trasmissioni.

La tua applicazione sarà interessata se una delle seguenti condizioni è vera:
- 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 del 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à risultati.
  - Se il valore del parametro broadcastType è all, il metodo liveBroadcasts.list non restituirà le trasmissioni permanenti esistenti prima di questo momento.
Per fare un po' di chiarezza, negli ultimi anni YouTube ha creato automaticamente uno stream e una trasmissione predefiniti per i canali che avevano attivato 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. Esisteva sempre e non era vincolato a un evento specifico.

A partire dalla data di ritiro:
- YouTube non creerà più stream e trasmissioni predefiniti. Invece di 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 e lo stream predefiniti di un canale sono attivi, ovvero se il canale li sta utilizzando per una trasmissione in diretta 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 e lo stream predefiniti di un canale non sono attivi, dopo l'implementazione 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 a aggiornarla in modo che funzioni sempre come previsto dopo questa modifica:
- Una nuova guida alla migrazione tenta di spiegare i passaggi che gli sviluppatori potrebbero dover affrontare nei client API che attualmente utilizzano trasmissioni e stream predefiniti.
- La guida Il ciclo di vita di una trasmissione illustra la procedura dettagliata per creare e gestire un evento dal vivo su YouTube. Ogni passaggio spiega le chiamate API o altre azioni che devi svolgere per completare un'azione specifica. La tua applicazione dovrà seguire questa procedura quando YouTube non supporterà più gli stream e le trasmissioni predefinite.

31 marzo 2020

Nota:questo è un annuncio relativo al ritiro.

La risorsa sponsor e il metodo sponsors.list sono stati ritirati 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 Endpoint di importazione della guida Caricare contenuti di YouTube Live tramite HLS è stata aggiornata per chiarire la procedura che un codificatore deve utilizzare per completare il valore del parametro file= quando crea gli URL di importazione principali e di riserva.

4 febbraio 2020

La guida Caricare contenuti di YouTube Live 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 destinati ai bambini, che YouTube definisce "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 in diretta è costituita da contenuti destinati ai bambini. Questa proprietà può essere impostata durante la creazione di una trasmissione tramite il metodo liveBroadcasts.insert. Tieni presente che questa proprietà è inclusa solo nelle risposte dell'API che contengono risorse liveBroadcast se il proprietario del canale ha autorizzato la richiesta dell'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 ulteriori informazioni 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 inoltre aggiornato i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta la sezione Termini di servizio dei servizi API di YouTube - Cronologia delle revisioni. Le modifiche ai Termini di servizio del servizio API di YouTube e alle Norme per gli sviluppatori entreranno in vigore il 10 gennaio 2020 (ora del Pacifico USA).

20 agosto 2019

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

Spiega che è buona norma includere sia i segmenti confermati sia quelli in sospeso in ogni playlist multimediale. Questa pratica riduce la probabilità che un segmento venga saltato se una playlist multimediale viene persa lato server. Ad esempio, in ogni playlist multimediale puoi includere fino a due segmenti confermati e fino a cinque segmenti in sospeso.
Ora è obbligatorio inviare una playlist multimediale per ogni segmento multimediale. In questo modo il server può recuperare rapidamente se una playlist multimediale viene persa. In precedenza, questa pratica era elencata come consiglio.

28 giugno 2019

YouTube ora supporta l'importazione di 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 Caricare contenuti di YouTube Live tramite HLS fornisce linee guida per l'utilizzo di HLS per trasmettere in streaming contenuti dal vivo su YouTube da un codificatore. Lo scopo della guida è aiutare i fornitori di codificatori ad aggiungere il supporto del caricamento HLS ai propri 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 per ciascun metodo e per fornire esempi di codice dinamici e di alta qualità tramite il widget di Explorer API. Per un esempio, consulta la documentazione del metodo liveBroadcasts.list. Ora nelle pagine che descrivono i metodi dell'API sono presenti due nuovi elementi:
- Il widget Explorer API ti consente di selezionare gli ambiti di autorizzazione, inserire valori di parametro e proprietà di esempio, 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 per recuperare i dati relativi alle trasmissioni dell'utente corrente.
  
  Puoi utilizzare i link in quella sezione per compilare lo Strumento di esplorazione API con valori di esempio per il tuo caso d'uso o per aprire lo Strumento di esplorazione API a schermo intero con questi valori già inseriti. Queste modifiche mirano a semplificare la visualizzazione di esempi di codice direttamente applicabili al caso d'uso che stai tentando di implementare nella tua applicazione.
Al momento gli esempi di codice sono supportati per Java, JavaScript, PHP, Python e curl.
La pagina degli esempi di codice presenta anche una nuova UI che offre tutte le funzionalità descritte sopra. Con questo strumento, puoi esplorare casi d'uso per diversi metodi, caricare 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, le pagine che in precedenza elencavano gli esempi di codice disponibili per Java, PHP e Python sono state rimosse.

25 febbraio 2019

La documentazione delle risorse liveChatMessage e superChatEvent è stata aggiornata per riflettere il fatto che ora entrambe le risorse possono contenere informazioni sui Super Sticker. I Super Sticker sono un tipo di messaggio Superchat che mostra un'immagine. Come per gli altri Superchat, un messaggio 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 Super Sticker.
In una risorsa superChatEvent, il valore booleano snippet.isSuperStickerEvent indica se il messaggio Superchat è 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 di 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 ti 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 verrebbero utilizzate in inglese. Ad esempio, per impostazione predefinita, una stringa è formattata come $1.00 anziché $1,00.

1 febbraio 2017

Questo aggiornamento contiene le seguenti modifiche:

Nuove risorse e nuovi 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 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. Nel Centro assistenza YouTube puoi trovare ulteriori informazioni sui Superchat.
  
  L'API supporta un metodo per elencare gli eventi Superchat per i live streaming di un canale nei 30 giorni precedenti. Questo metodo restituisce anche i dati sugli eventi di finanziamento 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 Superchat.
  
  Inoltre, la nuova proprietà snippet.superChatDetails della risorsa liveChatMessage e le relative proprietà secondarie contengono informazioni sull'evento Superchat.
- 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 degli errori per i due nuovi errori sono rispettivamente `invalidEmbedSetting` e `invalidProjection`.

12 gennaio 2017

Nota:questo è un annuncio relativo al ritiro.

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

Il metodo liveChatMessages.list non restituirà più messaggi con un snippet.type pari a fanFundingEvent. Analogamente, le risorse liveChatMessage non conterranno più l'oggetto snippet.fanFundingEventDetails.
Il metodo fanFundingEvents.list non restituirà più dati.

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

I Termini di servizio dei servizi API di YouTube appena pubblicati ("i Termini aggiornati"), descritti in dettaglio nel blog di YouTube dedicato a ingegneri e sviluppatori, forniscono una serie completa 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 aiutano a spiegare 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 a supporto verranno spiegate anche nella cronologia delle revisioni. Puoi iscriverti a un feed RSS che elenca le modifiche nella cronologia delle revisioni da un link nel documento.

20 maggio 2016

YouTube ora supporta l'importazione di 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 Caricare contenuti di YouTube in live streaming tramite DASH fornisce linee guida per l'utilizzo del formato di caricamento DASH per trasmettere in streaming dati in tempo reale su YouTube da un codificatore. Il suo scopo è aiutare i fornitori di codificatori ad aggiungere il supporto per il caricamento 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, cdn.format della risorsa è ora deprecato. La proprietà cdn.format specifica la risoluzione e la frequenza fotogrammi in un unico valore.

Ti invitiamo a eseguire la transizione ai campi di nuova introduzione. Nel frattempo, cdn.format continua a funzionare. Inoltre, al momento le richieste di inserimento di live streaming vanno a buon fine a condizione che tu 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 sono in accordo.

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 contiene almeno un messaggio della chat.

Aggiornamenti delle risorse liveChatMessage

La proprietà snippet.type supporta due nuovi valori, messageDeletedEvent e userBannedEvent, che corrispondono alle nuove proprietà descritte nel seguente punto elenco. È stata aggiornata anche la definizione della proprietà snippet.authorChannelId 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, ad esempio se è permanente o temporaneo. Se il divieto è temporaneo, una delle proprietà dell'oggetto specifica la durata del divieto. 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 in 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 provato a inserire. Il seguente elenco identifica i motivi degli errori e le proprietà a cui sono associati: `invalidFormat`: `cdn.format` `invalidFrameRate`: `cdn.frameRate` `invalidIngestionType`: `cdn.ingestionType` `invalidResolution`: `cdn.resolution`
`liveStreams.insert`	Il metodo `liveStreams.insert` supporta due nuovi errori `400` (`Bad Request`), ciascuno dei quali indica che un valore richiesto non è presente nella risorsa `liveStream` che la richiesta ha provato a inserire. Il seguente elenco identifica i motivi degli errori e le proprietà a cui sono associati: `frameRateRequired`: `cdn.frameRate` `resolutionRequired`: `cdn.resolution` In particolare, 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 nessuna 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 mutabili: `cdn.format` `cdn.frameRate` `cdn.ingestionType` `cdn.resolution` `reason` nella risposta di errore è `liveStreamModificationNotAllowed`.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) richiedono che determinate informative vengano fornite agli utenti finali e che vengano ottenuti i loro consensi nell'UE. Pertanto, per gli utenti finali nell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una notifica di questo requisito nei nostri Termini di servizio dell'API YouTube.

17 dicembre 2015

Questo aggiornamento contiene le seguenti modifiche:

Nuove risorse e nuovi metodi

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

Risorse
`liveChatMessage`	Questa risorsa rappresenta un messaggio in una chat live di YouTube. YouTube supporta diversi tipi di messaggi, tra cui messaggi e eventi di finanziamento dei fan. Alcuni tipi di messaggi identificano una determinata fase della chat, ad esempio l'inizio di un periodo riservato agli sponsor o la fine della chat. L'API supporta metodi per elencare, inserire ed eliminare i messaggi della chat dal vivo.
`liveChatModerators`	Questa risorsa identifica un moderatore della chat. I moderatori possono eseguire alcune funzioni amministrative, ad esempio bandire 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 pubblicare messaggi in una determinata chat live. I ban possono essere temporanei o permanenti. L'API supporta metodi per inserire ed eliminare i ban della chat dal vivo.
`fanFundingEvents`	Questa risorsa rappresenta un evento di finanziamento dei fan su un canale YouTube. I finanziamenti dei fan consentono agli spettatori di sostenere volontariamente i creator di YouTube con un contributo finanziario una tantum. Il metodo `fanFundingEvents.list` dell'API elenca gli eventi di finanziamento dei fan di un canale. Gli eventi di finanziamento dei fan avviati tramite una chat live durante una trasmissione in diretta di proprietà del canale attivano anche un messaggio `fanFundingEvent` nella chat live della trasmissione. Per scoprire di più sul finanziamento dei fan, visita il Centro assistenza YouTube.
`sponsors`	La risorsa `sponsor` identifica uno sponsor di un canale YouTube. Uno sponsor paga una tariffa mensile a un canale. Accanto ai messaggi degli sponsor nelle chat live del canale viene visualizzato un badge e, se presenti, gli sponsor possono anche partecipare a chat live riservate agli sponsor del canale. Il metodo `sponsors.list` dell'API elenca gli sponsor di un canale. Quando gli utenti si registrano per sponsorizzare un canale durante una trasmissione in diretta di proprietà del canale, l'API aggiunge anche un messaggio `newSponsorEvent` alla chat live della trasmissione. Scopri di più sulle sponsorizzazioni nel Centro assistenza YouTube.

Aggiornamenti a metodi e risorse 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 della chat. Puoi anche aggiungere o rimuovere moderatori della chat, vietare 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 i sottotitoli codificati sono attivati per la trasmissione e, in caso affermativo, quale tipo di sottotitoli codificati fornisci: `closedCaptionsDisabled`: i sottotitoli codificati sono disattivati per la trasmissione in diretta. `closedCaptionsHttpPost`: invierai i sottotitoli codificati tramite HTTP POST a un URL di importazione associato al tuo live streaming. `closedCaptionsEmbedded`: i sottotitoli codificati verranno inseriti nello stream video utilizzando i formati EIA-608 e/o CEA-708.
`contentDetails.enableClosedCaptions`	Questa proprietà è stata ritirata a partire dal 17 dicembre 2015. Utilizza la proprietà `contentDetails.closedCaptionsType` a questo scopo. Per i client API che utilizzano già questa proprietà: Impostare il valore della proprietà su `true` è equivalente a impostare la proprietà `contentDetails.closedCaptionsType` su `closedCaptionsHttpPost`. Impostare il valore della proprietà su `false` è equivalente a impostare la 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 specifico. Nello specifico, la trasmissione predefinita di un canale è una trasmissione permanente ed è accessibile tramite la dashboard live di YouTube 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 salute:

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`	La frequenza fotogrammi corrente è troppo elevata. Imposta la frequenza fotogrammi su `%(framerate)s` fps o un valore 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 HTTP	`forbidden (403)`
Motivo	`closedCaptionsTypeModificationNotAllowed`
Descrizione	Il valore `contentDetails.closedCaptionsType` può essere modificato solo quando la trasmissione è nello stato `created` o `ready`.

liveBroadcasts.update

Codice di risposta HTTP	`invalidValue (400)`
Motivo	`invalidEnableClosedCaptions`
Descrizione	Nella risorsa liveBroadcast, il valore della proprietà `contentDetails.enableClosedCaptions` non è compatibile con il valore dell'impostazione `contentDetails.closedCaptionType`. Modifica la risorsa in modo da includere solo una delle due proprietà, quindi invia di nuovo la richiesta.

19 agosto 2015

Questo aggiornamento contiene le seguenti modifiche:

Nuove risorse e nuovi metodi

Nota:la documentazione della risorsa liveChat e dei relativi metodi è riservata e visibile solo a partner YouTube selezionati.

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

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

I messaggi della chat live possono essere recuperati e pubblicati solo durante la trasmissione in diretta.

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 ulteriori informazioni 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 lo stato di salute 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, il che significa che può essere associato a più trasmissioni. È normale che le emittenti riutilizzino lo stesso stream per molte trasmissioni diverse se queste si verificano in momenti 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 è attivato per il live streaming, YouTube crea uno stream e una trasmissione predefiniti per il canale. Lo stream definisce il modo in cui il proprietario del canale invia il video in diretta a YouTube, mentre la trasmissione indica in che modo gli spettatori possono vedere lo stream predefinito. Per saperne di più 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 la visualizzazione del video da parte degli utenti che guardano una trasmissione, ma può anche influire sulla risoluzione per gli spettatori dello stream.
`statistics.totalChatCount`	Il numero totale di messaggi della chat dal vivo associati alla trasmissione. La proprietà e il relativo valore sono presenti se la trasmissione è visibile all'utente e la funzionalità di chat live è attivata. Tieni presente che questa proprietà non specifica un valore al termine della trasmissione. Pertanto, questa proprietà non identifica il numero di messaggi della chat per un video archiviato di una trasmissione dal vivo 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 HTTP	`forbidden (403)`
Motivo	`liveStreamModificationNotAllowed`
Descrizione	L'API non consente di modificare uno stream riutilizzabile in modo che non sia riutilizzabile o viceversa. Per ulteriori informazioni, consulta Informazioni su trasmissioni e stream

21 maggio 2015

Questo aggiornamento contiene le seguenti modifiche:

YouTube ora supporta lo streaming video in live streaming a 60 frame al secondo (fps), il che significa una riproduzione più fluida per i giochi e altri video con azione rapida. Quando avvii un live streaming su YouTube a 60 fps, YouTube rende lo stream disponibile anche a 30 fps sui dispositivi su cui la visualizzazione ad alta frequenza fotogrammi 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à, visita 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	Dettaglio 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 è autorizzato a trasmettere in streaming video dal vivo su YouTube. I dettagli che spiegano perché l'utente non può trasmettere in streaming video dal vivo potrebbero essere disponibili nelle impostazioni del canale all'indirizzo https://www.youtube.com/features.
`rateLimitExceeded`	`userRequestsExceedRateLimit`	Entrambi i metodi `liveBroadcasts.insert` e `liveStreams.insert` restituiscono questo errore per indicare che l'utente ha inviato troppe richieste in 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ù trasmissioni. Questa modifica riguarda solo una correzione della 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 passare la trasmissione allo stato testing prima di poterla passare 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 il metodo.
La documentazione relativa agli errori ora specifica il codice di risposta HTTP per ogni tipo di errore.

L'API ora supporta il seguente errore:

Tipo di errore	Dettaglio 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 in streaming video dal vivo su YouTube. I dettagli che spiegano perché l'utente non può trasmettere in streaming video dal vivo potrebbero essere disponibili nelle impostazioni del canale 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 al canale di trasmissione è consentito disattivare le registrazioni per le trasmissioni in diretta.

Se il tuo canale non dispone dell'autorizzazione per disattivare le registrazioni e provi a 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 provi ad aggiornare una trasmissione impostando la proprietà recordFromStart su false, l'API restituirà un errore modificationNotAllowed.
La risorsa liveBroadcast non contiene più una proprietà enableArchive, 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 in modo da 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 cue point. L'API restituisce un errore se una richiesta tenta di inserire un cue point 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 in modo da 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à eseguita una modifica alla scheda. 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 è passato da youtube#liveBroadcastList a youtube#liveBroadcastListResponse.
Nella risposta dell'API a una richiesta liveStreams.list, il valore della proprietà kind è passato 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	Dettaglio errore	Descrizione
`invalidValue`	`conflictingTimeFields`	Il metodo `liveBroadcasts.control` restituisce questo errore se la richiesta specifica valori per i parametri `offsetTimeMs` e `walltime`. Una richiesta può omettere entrambi i parametri o specificare un valore per uno dei due.
`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 si tenta di 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 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:

YouTube non identifica più servizi e funzionalità API sperimentali. Ora forniamo un elenco delle API di YouTube soggette alle norme relative al ritiro.

2 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

Il nuovo metodo liveBroadcasts.control ti consente di attivare/disattivare le impostazioni di visualizzazione di una scheda visualizzata nello stream di una trasmissione già in corso. Se lo stream della trasmissione è in ritardo, puoi utilizzare questo metodo anche per specificare un offset di tempo in cui verrà eseguita la modifica della scheda richiesta.
Le definizioni delle seguenti proprietà sono state aggiornate per spiegare che i valori delle proprietà devono essere impostati se aggiorni la parte contentDetails di una risorsa liveBroadcast:
status.streamStatus della risorsa liveStream non supporta più il valore deleted come possibile stato dello stream.
Le informazioni restituite dall'API per molti messaggi di errore sono state riviste per spiegare meglio il motivo della comparsa di determinati errori. L'API supporta anche diversi nuovi errori.

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 delle schede" della guida Introduzione è stata rimossa.
L'API non supporta più la possibilità di inserire schede in-stream utilizzando il metodo liveCuepoints.insert. I seguenti documenti sono stati aggiornati di conseguenza:
- La pagina di indice, la guida Guida introduttiva e il tutorial 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 correggerli.
Ora l'API potrebbe restituire diversi nuovi errori. L'elenco seguente identifica l'errore e il metodo API che potrebbe restituirlo:
- liveBroadcasts.insert: l'ora di fine pianificata di una trasmissione deve essere successiva all'ora di inizio pianificata.
- 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 delle risorse liveStream è stata aggiornata per indicare che i metodi di importazione multicast e WebM non sono 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.