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 per inserire gli annunci nelle trasmissioni live. 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 lunghezza 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. Quest'ultima strategia consente a YouTube di programmare i cue point con una frequenza maggiore, in modo che gli spettatori ricevano i cue point 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 è sospeso 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 di annunci automatico è 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 live. 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 ha consentito solo ai partner della rete 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 chat traguardo abbonato. 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 vietato (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 effettuato il 16 aprile 2020, inizialmente programmata per il 1° settembre 2020, è stata posticipata e ora avverrà a partire dal 1° ottobre 2020. Di conseguenza, le funzionalità incluse nell'annuncio relativo al ritiro e il metodo liveBroadcasts.control verranno deprecate 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. A partire da quella data, le richieste che utilizzano ancora quel campo non andranno a buon fine.

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 Completamento dell'URL di importazione HLS. Queste istruzioni sono valide indipendentemente dal fatto che l'URL di importazione HLS sia stato ottenuto dall'API di YouTube o da YouTube Creator 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 relativo al 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 alla vita di una trasmissione è stato aggiornato per spiegare come cambia la procedura dettagliata per la creazione e la gestione di un evento di YouTube dal vivo 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. In particolare, l'ID trasmissione e l'ID streaming 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 predefinita e lo stream predefinito di un canale vengono trasmessi in diretta attivamente, il che significa che il canale li utilizza per una trasmissione live nel momento in cui il ritiro entrerà in vigore, 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 stream e trasmissioni predefinite.
- La guida Life of a broadcast ti guida in una procedura passo passo che spiega come 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 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. Consulta la cronologia delle revisioni dell'API YouTube Data per ulteriori informazioni sulla nuova risorsa.

11 marzo 2020

La sezione Endpoint di importazione della guida Caricare contenuti live di YouTube tramite HLS è stata aggiornata per chiarire il processo che un codificatore dovrebbe utilizzare per completare il valore del parametro file= quando forma gli URL di importazione principali e di backup.

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. Consulta il Centro assistenza YouTube per ulteriori informazioni sull'impostazione del pubblico per il tuo canale, i tuoi video o le tue trasmissioni.
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 i Termini di servizio dei servizi API di YouTube - Cronologia delle revisioni. 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 Caricare contenuti di YouTube Live tramite HLS è stata aggiornata con due modifiche:

Spiega che è una best practice includere sia i segmenti riconosciuti che 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, potresti includere fino a due segmenti riconosciuti 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ò 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 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 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 sono presenti due nuovi elementi che descrivono i metodi dell'API:
- 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 alle trasmissioni dell'utente corrente.
  
  Puoi utilizzare i link in questa sezione per completare l'Explorer API con valori di esempio per il tuo caso d'uso o per aprire l'Explorer API a schermo intero con questi valori già compilati. 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 gli altri messaggi 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 richiamano 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 al momento il parametro onBehalfOfContentOwner è 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 metodi e risorse 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 prevede la formattazione delle stringhe di visualizzazione come verranno 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 messaggi 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 metodi e risorse esistenti
- La proprietà snippet.type ora supporta il valore superChatEvent, che indica che la risorsa descrive un Super Chat.
  
  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 DASH. Di conseguenza, la proprietà ingestionType della risorsa liveStream supporta il nuovo valore dash per identificare gli stream importati a YouTube utilizzando DASH.

La nuova guida Pubblicare contenuti di YouTube dal vivo tramite DASH fornisce linee guida per l'utilizzo del formato di pubblicazione DASH per trasmettere in streaming i 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 metodi e risorse esistenti

liveStream aggiornamenti delle risorse

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

liveBroadcast aggiornamenti delle risorse

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` Il valore `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 relativa a questo requisito nei Termini di servizio delle API di 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 le funzionalità di chat dal vivo durante le trasmissioni dal vivo attive e queste risorse e i relativi metodi supportano il recupero dei messaggi di 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 dal vivo.
`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 le esclusioni della chat live.
`fanFundingEvents`	Questa risorsa rappresenta un evento relativo ai finanziamenti 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. Nella chat live del canale viene visualizzato un badge accanto ai messaggi dello sponsor e gli sponsor, se presenti, possono anche partecipare alle chat live esclusivamente per gli 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 di 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 è abilitato il sottotitolaggio codificato per la trasmissione e, in questo caso, quale tipo di sottotitoli codificati vengono forniti: `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 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à: Impostare il valore della proprietà su `true` è equivalente a impostare la proprietà `contentDetails.closedCaptionsType` su `closedCaptionsHttpPost`. Impostare il valore della proprietà su `false` equivale 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. In particolare, la trasmissione predefinita di un canale è una trasmissione permanente ed è accessibile tramite la Dashboard dal vivo 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`	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 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 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 metodi e risorse esistenti

La risorsa liveStream contiene le seguenti nuove proprietà:

Proprietà
`snippet.isDefaultStream`	Indica se lo stream è lo stream 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 cambiare uno stream riutilizzabile in modo che non sia riutilizzabile e viceversa. Per ulteriori informazioni, consulta la sezione 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 f/s, lo stream sarà disponibile anche a 30 f/s sui dispositivi in 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 blog di YouTube Creators.

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 dell'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`	I metodi `liveBroadcasts.insert` e `liveStreams.insert` restituiscono entrambi 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 pianificata deve essere sufficientemente vicina alla data corrente da consentire la pianificazione 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 attuale 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 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 è stato modificato 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ù funzionalità e servizi 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 viene ritardato, puoi usare questo metodo anche per specificare un offset temporale quando avrà luogo il cambio di slate richiesto.
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 perché si sono verificati determinati errori. L'API supporta anche diversi nuovi errori.

27 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

Le seguenti proprietà sono state modificate nella risorsa liveBroadcast:
- La proprietà startWithSlateCuepoint è stata rinominata in startWithSlate.
- La proprietà enableArchive è stata rinominata in recordFromStart.
- L'oggetto slateSettings è stato deprecato 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 Guida introduttiva è 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.