Questa pagina elenca le modifiche all'API YouTube Live Streaming e gli aggiornamenti della documentazione. Iscriviti a questo log delle modifiche.
14 luglio 2025
La descrizione del metodo liveChatMessages.streamList
è stata aggiornata per fornire indicazioni sull'utilizzo dell'API streamList.
9 ottobre 2023
Solo a titolo di riferimento, puoi trovare gli ID sticker correlati ai Super Sticker in questo
file CSV.
Le definizioni della proprietà snippet.superStickerDetails.superStickerMetadata.stickerId
della risorsa liveChatMessage
e della proprietà snippet.superStickerMetadata.stickerId
della risorsa superChatEvent
sono state aggiornate per riflettere queste informazioni.
15 settembre 2023
L'API ora supporta un nuovo modo di inserire gli annunci nelle trasmissioni live. Oltre a
liveCuepoints
, che ti consente di
inserire manualmente interruzioni pubblicitarie in una trasmissione, YouTube ora supporta una funzionalità per inserire automaticamente
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 pubblicitari. I cue point possono essere inseriti contemporaneamente per tutti gli spettatori oppure la loro tempistica può variare da spettatore a spettatore. Quest'ultima strategia consente a YouTube di programmare i cue point a una velocità maggiore, in modo che gli spettatori possano riceverli quando sono idonei.
- un periodo durante il quale non vengono mostrati annunci mid-roll; per questa funzionalità, il proprietario della trasmissione specifica che l'inserimento di annunci mid-roll è sospeso fino a un determinato orario.
La documentazione riflette le seguenti modifiche all'API per supportare questa funzionalità:
- La risorsa
liveBroadcast
ora contiene un oggettomonetizationDetails
. I campi dell'oggetto indicano se l'inserimento automatico degli annunci è attivato per la trasmissione e specificano informazioni aggiuntive per la pianificazione dei cue point. - Il parametro
part
del metodoliveBroadcast.list
supporta il valoremonetizationDetails
. - Il metodo
update
può essere utilizzato per mettere in pausa l'inserimento degli annunci mid-roll per un determinato periodo di tempo per una trasmissione live. La documentazione ora identifica anche diversi errori che possono verificarsi durante l'aggiornamento dei dettagli di monetizzazione per una trasmissione live.
1° agosto 2023
Questo aggiornamento contiene le seguenti modifiche:
-
Il metodo
liveBroadcasts.update
non richiede più la specifica dei valori per questi campi:snippet.title
status.privacyStatus
Se ometti questi campi dalla richiesta, rimarranno invariati.
1 novembre 2022
-
Il nuovo metodo
liveBroadcasts.cuepoint
consente a qualsiasi proprietario di un canale che trasmette una live su YouTube di inserire cue point nella trasmissione, che possono attivare interruzioni pubblicitarie. Questo metodo sostituisce il metodoliveCuepoints.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 di ritiro.
Il metodo
liveCuepoints.insert
è ora deprecato. Il supporto per il metodoliveCuepoints.insert
verrà rimosso a partire dal 1° maggio 2023. Gli utenti dell'API devono aggiornare le proprie applicazioni per chiamare il metodoliveBroadcasts.cuepoint
. -
La documentazione per il 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 dei valori per questi campi:contentDetails.enableContentEncryption
contentDetails.enableDvr
contentDetails.enableEmbed
contentDetails.recordFromStart
contentDetails.startWithSlate
Se ometti questi campi dalla richiesta, rimarranno invariati.
-
È stata rimossa la documentazione relativa ai 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 risorsaliveChatMessage
e i relativi elementi secondari contengono informazioni sull'evento di regalo di abbonamento. Allo stesso modo, 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 risorsaliveChatMessage
e i relativi elementi secondari contengono informazioni sull'evento Messaggio di fedeltà al canale. Allo stesso modo, la nuova proprietàsnippet.newSponsorDetails
e i relativi elementi secondari contengono informazioni sull'evento Nuovo sponsor.
1 dicembre 2020
Il metodo liveBroadcasts.transition
dell'API
supporta un nuovo errore 403
(Forbidden
), che indica che l'utente
ha inviato troppe richieste in un determinato periodo di tempo. Il motivo dell'errore è userRequestsExceedRateLimit
.
21 settembre 2020
-
La definizione della proprietà
status.madeForKids
della risorsaliveBroadcast
è stata aggiornata per chiarire che la proprietà è di sola lettura. Ciò non riflette una modifica della funzionalità dell'API.Per designare una trasmissione live come destinata ai bambini, imposta la proprietà
status.selfDeclaredMadeForKids
sutrue
quando chiami il metodoliveBroadcasts.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 tipo vietato (403) e il metodo verrà rimosso completamente in un secondo momento. I clienti possono comunque implementare la propria numerazione aggiungendo una sovrimpressione al video inviato ai server di caricamento di YouTube.La data di ritiro dell'annuncio di ritiro del 16 aprile 2020, originariamente prevista per il 1° settembre 2020, è stata posticipata e ora avverrà a partire dal 1° ottobre 2020. Pertanto, le funzionalità incluse in questo annuncio di ritiro e il metodo
liveBroadcasts.control
verranno ritirati contemporaneamente.
17 luglio 2020
Nota:questo è un aggiornamento di un 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 questa data, le richieste che utilizzano ancora questo campo non andranno a buon fine.
Se il tuo codice utilizza ancora il campo cdn.format
, deve essere aggiornato per specificare
separatamente il frame rate e la risoluzione utilizzando le proprietà
cdn.frameRate
e
cdn.resolution
.
6 luglio 2020
La guida Distribuzione di contenuti live di YouTube tramite HLS è stata aggiornata con alcune modifiche:
- La durata consigliata per un segmento multimediale è stata aggiornata a un massimo di quattro secondi.
- Una nuova sezione spiega come ottenere un URL di caricamento HLS da YouTube Creator Studio.
-
Le istruzioni per la formattazione del valore del parametro
file
sono state spostate nella nuova sezione Completamento dell'URL di importazione HLS. Queste istruzioni si applicano indipendentemente dal fatto che l'URL di caricamento HLS venga ottenuto dall'API di YouTube o da YouTube Creator Studio.
Inoltre, il nuovo confronto tra protocolli di importazione elenca i protocolli di importazione supportati da YouTube, i codec supportati per ogni protocollo e ulteriori informazioni sui casi d'uso appropriati per 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 sul flusso video associato.Il documento Ciclo di vita di una trasmissione è stato aggiornato per spiegare come cambia la procedura passo passo di creazione e gestione di un evento live di YouTube se imposti le proprietà
contentDetails.enableAutoStart
ocontentDetails.enableAutoStop
sutrue
. -
Nota:questo è un annuncio di ritiro. Queste modifiche entreranno in vigore a partire dal 1° settembre 2020. La data effettiva in cui le modifiche entrano in vigore è indicata di seguito come data di ritiro.
Questo aggiornamento spiega una modifica che potrebbe provocare errori. Influisce sulle applicazioni client API che utilizzano le risorse
liveStream
eliveBroadcast
predefinite dei canali per trasmettere contenuti live su YouTube. In particolare, l'ID trasmissione e l'ID stream associati alla trasmissione e allo stream persistenti non funzioneranno più per avviare nuove trasmissioni.La tua applicazione sarà interessata se si verifica una delle seguenti condizioni:
- Controlla il valore della proprietà
isDefaultBroadcast
della risorsaliveBroadcast
. Questa proprietà non verrà restituita dopo la data di ritiro. - Controlla il valore della proprietà
isDefaultStream
della risorsaliveStream
. Questa proprietà non verrà restituita dopo la data di ritiro. - Chiama il metodo
liveBroadcasts.list
e imposta il valore del parametrobroadcastType
supersistent
oall
. Questo parametro verrà ritirato nell'ambito di queste modifiche. A partire dalla data di ritiro:- Se il valore del parametro
broadcastType
èpersistent
, il metodoliveBroadcasts.list
non restituirà alcun risultato. - Se il valore del parametro
broadcastType
èall
, il metodoliveBroadcasts.list
non restituirà le trasmissioni persistenti esistenti prima di quel momento.
- Se il valore del parametro
Come contesto, negli ultimi anni YouTube ha creato automaticamente uno stream predefinito e una trasmissione predefinita per un canale quando questo è stato abilitato per il live streaming. Lo stream predefinito esisteva a tempo indeterminato, non aveva un'ora di inizio o di fine associata e non poteva essere eliminato. Analogamente, la trasmissione predefinita è stata considerata persistente. È sempre esistito e non era vincolato a un evento specifico.
A partire dalla data di ritiro:
- YouTube non creerà più stream e trasmissioni predefiniti. Anziché fare affidamento sulle risorse predefinite, i client API devono essere in grado di creare e gestire le risorse
liveBroadcast
eliveStream
e di associarle. - Se la trasmissione predefinita e lo stream predefinito di un canale sono attivi, ovvero il canale li sta utilizzando per una trasmissione live al momento dell'entrata in vigore del ritiro, la trasmissione in corso non sarà interessata. Tuttavia, al termine della trasmissione, il canale non potrà utilizzare di nuovo la trasmissione e lo stream predefiniti.
- Se la trasmissione predefinita e lo stream predefinito di un canale non sono attivi, dopo l'entrata in vigore del ritiro, YouTube ignorerà i tentativi di utilizzare queste risorse per trasmettere video.
Se la tua applicazione è interessata, consulta i seguenti documenti, che ti aiuteranno ad aggiornare l'applicazione in modo che continui a funzionare 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 Ciclo di vita di una trasmissione ti accompagna in una procedura passo passo che spiega come creare e gestire un evento live su YouTube. Ogni passaggio spiega le chiamate API o altre operazioni che devi eseguire per completare un'azione specifica e la tua applicazione dovrà seguire questa procedura quando YouTube smetterà di supportare stream e trasmissioni predefiniti.
- Controlla il valore della proprietà
31 marzo 2020
Nota:questo è un annuncio di 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 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 Distribuzione di contenuti live di YouTube tramite HLS è stata aggiornata per
chiarire la procedura che un codificatore deve utilizzare per completare il valore del parametro file=
quando forma gli URL di importazione principali e di backup.
4 febbraio 2020
La guida Distribuzione di contenuti live di YouTube 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 chiama "destinati ai bambini". Scopri di più sui contenuti "destinati ai bambini" nel Centro assistenza YouTube.
-
La risorsa
liveBroadcast
supporta due nuove proprietà per consentire a creatori di contenuti e spettatori di identificare i contenuti "destinati ai bambini":-
La proprietà
selfDeclaredMadeForKids
consente ai creator di specificare se una trasmissione live è destinata ai minori. Questa proprietà può essere impostata durante la creazione di una trasmissione tramite il metodoliveBroadcasts.insert
. Tieni presente che questa proprietà è inclusa solo nelle risposte dell'API che contengono risorseliveBroadcast
se il proprietario del canale ha autorizzato la richiesta API. -
La proprietà
madeForKids
consente a qualsiasi utente API di recuperare lo stato "realizzato per i 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.
-
La proprietà
-
Nell'API YouTube Data, la risorsa
channel
supporta anche le nuove proprietàselfDeclaredMadeForKids
emadeForKids
.
Abbiamo anche aggiornato i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta la cronologia delle revisioni dei Termini di servizio dei servizi API di YouTube. Le modifiche ai Termini di servizio delle API di YouTube e alle Norme per gli sviluppatori entreranno in vigore il 10 gennaio 2020, ora del Pacifico.
20 agosto 2019
La sezione Requisiti della guida Pubblicare contenuti live di YouTube tramite HLS è stata aggiornata con due modifiche:
- Spiega che è una best practice includere sia i segmenti riconosciuti sia quelli in sospeso in ogni playlist media. Questa pratica riduce la probabilità che un segmento venga ignorato se una playlist multimediale viene persa sul lato server. Ad esempio, puoi 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. Ciò consente al server di ripristinarsi rapidamente in caso di perdita di una playlist multimediale. In precedenza, questa pratica era elencata come consiglio.
28 giugno 2019
YouTube ora supporta l'importazione HLS. Di conseguenza, la proprietà ingestionType
della risorsa liveStream
supporta il nuovo valore hls
per identificare gli stream caricati su YouTube utilizzando HLS.
La nuova guida Distribuzione di contenuti live di YouTube tramite HLS fornisce linee guida per l'utilizzo di HLS per lo streaming di contenuti live su YouTube da un codificatore. La guida ha lo scopo di aiutare i fornitori di codificatori ad aggiungere il supporto della distribuzione 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 ogni metodo e per fornire esempi di codice dinamici e di alta qualità tramite il widget Explorer API. Per un esempio, consulta la documentazione del metodo
liveBroadcasts.list
. Ora nelle pagine che descrivono i metodi API sono presenti due nuovi elementi:-
Il widget Explorer API ti consente di selezionare gli ambiti di autorizzazione, inserire valori di esempio per parametri e proprietà, quindi inviare richieste API effettive e visualizzare risposte API effettive. Il widget offre anche una visualizzazione a schermo intero che mostra esempi di codice completi, che vengono aggiornati dinamicamente per utilizzare gli ambiti e i valori che hai inserito.
-
La sezione Casi d'uso comuni descrive uno o più casi d'uso comuni per il metodo spiegato nella pagina. Ad esempio, puoi chiamare il metodo
liveBroadcasts.list
per recuperare i dati relativi a una trasmissione specifica o alle trasmissioni dell'utente corrente.Puoi utilizzare i link in questa sezione per compilare APIs Explorer con valori di esempio per il tuo caso d'uso o per aprire APIs Explorer 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 cercando di implementare nella tua applicazione.
Al momento, gli esempi di codice sono supportati per Java, JavaScript, PHP, Python e curl.
-
-
Anche la pagina Esempi di codice ha una nuova UI che offre tutte le stesse funzionalità descritte sopra. Con questo strumento puoi esplorare i 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.
Insieme a questa modifica, sono state rimosse le pagine che in precedenza elencavano gli esempi di codice disponibili per Java, PHP e Python.
25 febbraio 2019
La documentazione delle risorse liveChatMessage
e superChatEvent
è stata aggiornata per riflettere il fatto che ora entrambe possono contenere informazioni sui Super Sticker. I Super Sticker sono un tipo di messaggio Superchat che mostra un'immagine. Come le altre 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 susuperStickerEvent
per indicare che la risorsa contiene informazioni su un Super Sticker. In questo caso, la risorsa contiene anche l'oggettosnippet.superStickerDetails
, che contiene informazioni aggiuntive sul Super Sticker. - In una risorsa
superChatEvent
, il valore booleanosnippet.isSuperStickerEvent
indica se il messaggio Superchat è anche un Super Sticker. In questo caso, l'oggettosnippet.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 parametroonBehalfOfContentOwner
è attualmente obbligatorio. Inoltre, la descrizione del metodo è stata aggiornata per indicare che le chiamate a questo metodo devono essere autorizzate da un account associato a un proprietario dei contenuti di YouTube.
-
9 febbraio 2017
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
-
Il nuovo parametro
hl
del metodosuperChatEvents.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 della proprietà è stata aggiornata di conseguenza.Il valore del parametro deve essere un codice lingua incluso nell'elenco restituito dal metodo
i18nLanguages.list
. Il valore predefinito èen
, il che significa che il comportamento predefinito è formattare le stringhe di visualizzazione come se fossero utilizzate in inglese. Ad esempio, per impostazione predefinita, una stringa viene formattata come$1.00
anziché$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:- I messaggi Superchat sono evidenziati 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 rimane nel riquadro di aggiornamento e la lunghezza massima del messaggio sono tutti determinati dall'importo dell'acquisto. Il Centro assistenza YouTube fornisce ulteriori informazioni sulle 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 valoresuperChatEvent
, che indica che la risorsa descrive una Superchat.Inoltre, la nuova proprietà
snippet.superChatDetails
della risorsaliveChatMessage
e i relativi elementi secondari contengono informazioni sull'evento Superchat. -
La proprietà
cdn.resolution
della risorsaliveStream
ora supporta il valore2160p
.
-
-
Errori nuovi e aggiornati
-
L'API supporta i seguenti nuovi errori:
Dettagli errore liveBroadcasts.insert
,liveBroadcasts.update
I metodi liveBroadcasts.insert
eliveBroadcasts.update
restituiscono errori400
(Bad Request
) per indicare che la risorsaliveBroadcast
inserita o aggiornata contiene un valore non valido per la proprietàcontentDetails.enableEmbed
ocontentDetails.projection
. I motivi dell'errore per i due nuovi errori sono rispettivamenteinvalidEmbedSetting
einvalidProjection
.
-
12 gennaio 2017
Nota:questo è un annuncio di ritiro.
In concomitanza con il rilascio della nuova funzionalità Superchat, YouTube ha ritirato la funzionalità Finanziamento dei fan e l'API Finanziamento dei fan verrà disattivata il 28 febbraio 2017. A partire da questa data:
- Il metodo
liveChatMessages.list
non restituirà più messaggi con unsnippet.type
difanFundingEvent
. Allo stesso modo, le risorseliveChatMessage
non conterranno più l'oggettosnippet.fanFundingEventDetails
. - Il metodo
fanFundingEvents.list
non restituirà più dati.
11 agosto 2016
Questo aggiornamento contiene le seguenti modifiche:
-
I nuovi Termini di servizio dei servizi API di YouTube ("i Termini aggiornati"), descritti in dettaglio nel blog di YouTube Engineering and Developers, forniscono un ricco insieme di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto per spiegare le norme che gli sviluppatori devono rispettare.
L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti di supporto verranno spiegate anche nella cronologia delle revisioni. 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 caricati su YouTube utilizzando DASH.
La nuova guida Importazione di contenuti live di YouTube tramite DASH fornisce linee guida per l'utilizzo del formato di importazione DASH per lo streaming di dati live su YouTube da un codificatore. È progettato per aiutare i fornitori di codificatori ad aggiungere il supporto della distribuzione 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 il frame rate e la risoluzione dei dati video in entrata:Proprietà cdn.frameRate
La frequenza fotogrammi dei dati video in entrata. I valori validi sono 30fps
e60fps
.cdn.resolution
La risoluzione dei dati video in entrata. I valori validi della proprietà sono: 1440p
,1080p
,720p
,480p
,360p
e240p
. -
In seguito all'introduzione delle proprietà
cdn.frameRate
ecdn.resolution
della risorsaliveStream
, la proprietàcdn.format
della risorsa è ora ritirata. La proprietàcdn.format
specifica la risoluzione e la frequenza dei fotogrammi in un unico valore.Ti consigliamo di eseguire la transizione ai campi appena supportati. Nel frattempo,
cdn.format
continua a funzionare. Inoltre, le richieste di inserimento di live streaming vanno a buon fine se specifichi valori per la proprietàcdn.format
o per le proprietàcdn.frameRate
ecdn.resolution
. Se fornisci valori per tutte e tre le proprietà, l'API potrebbe restituire un errore se i valori non sono coerenti.Tieni presente che, anche se la proprietà
cdn.format
è deprecata, ora supporta due nuovi valori,1440p
e1440p_hfr
, per riflettere il supporto dell'API per gli stream a 1440p a 30 o 60 fotogrammi 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 dello stream live 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à sono360
erectangular
. -
La definizione della proprietà
statistics.totalChatCount
della risorsaliveBroadcast
è stata aggiornata per indicare che il valore della proprietà viene visualizzato solo se la trasmissione ha almeno un messaggio della chat.
-
- Aggiornamenti delle risorse
liveChatMessage
-
La proprietà
snippet.type
supporta due nuovi valori,messageDeletedEvent
euserBannedEvent
, che corrispondono alle nuove proprietà descritte nel seguente punto elenco. Anche la definizione della proprietàsnippet.authorChannelId
è stata aggiornata per spiegare cosa identifica il valore della proprietà per questi nuovi tipi di messaggi. -
La risorsa
liveChatMessage
contiene le seguenti nuove proprietà:Proprietà snippet.messageDeletedDetails
Questo oggetto contiene informazioni su un messaggio eliminato da un moderatore della chat. L'oggetto è presente solo se il valore della proprietà snippet.type
èmessageDeletedEvent
.snippet.userBannedDetails
Questo oggetto contiene informazioni su un utente a cui è stato vietato di partecipare alla chat. L'oggetto contiene anche informazioni sul ban stesso, ovvero se è permanente o temporaneo. Se il ban è temporaneo, una delle proprietà dell'oggetto specifica la durata del ban.
Questo oggetto è presente solo se il valore della proprietàsnippet.type
èuserBannedEvent
.
-
- Aggiornamenti delle risorse
-
Errori nuovi e aggiornati
-
L'API supporta i seguenti nuovi errori:
Dettagli errore liveBroadcasts.bind
Il metodo liveBroadcasts.bind
restituisce un errore403
(Forbidden
) per indicare che l'utente ha inviato troppe richieste in un determinato periodo di tempo. Il motivo dell'errore èuserRequestsExceedRateLimit
.
I metodiliveBroadcasts.insert
eliveBroadcasts.update
supportano già lo stesso errore.liveStreams.insert
Il metodo liveStreams.insert
supporta quattro nuovi errori400
(Bad Request
) che identificano un valore di proprietà non valido nella risorsaliveStream
che la richiesta ha tentato di inserire. Il seguente elenco identifica i motivi dell'errore 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 errori400
(Bad Request
), ognuno dei quali indica che un valore obbligatorio non è presente nella risorsaliveStream
che la richiesta ha tentato di inserire. Il seguente elenco identifica i motivi dell'errore e le proprietà a cui sono associati:
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
, devi specificare un valore per la proprietàcdn.format
o per le proprietàcdn.frameRate
ecdn.resolution
.
- L'API restituisce un errore
formatRequired
se non specifichi un valore per una delle tre proprietà. - L'API restituisce un errore
frameRateRequired
se specifichi un valore percdn.resolution
ma non percdn.frameRate
. - L'API restituisce un errore
resolutionRequired
se specifichi un valore percdn.frameRate
ma non percdn.resolution
.
liveStreams.update
Il metodo liveStreams.update
restituisce un errore403
(Forbidden
) se la richiesta tenta di modificare il valore di una delle seguenti proprietà non modificabili: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 vengano fornite determinate informative e che venga ottenuto il consenso degli utenti finali nell'UE. Pertanto, per gli utenti finali nell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto un avviso di questo requisito nei nostri Termini di servizio dell'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 live. YouTube supporta la funzionalità di chat live durante le trasmissioni live 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 di testo ed eventi di finanziamento dei fan. Alcuni tipi di messaggi identificano una fase particolare della chat, ad esempio l'inizio di un periodo riservato agli abbonati o la fine della chat. L'API supporta metodi per elencare, inserire ed eliminare i messaggi della chat live. liveChatModerators
Questa risorsa identifica un moderatore della chat. I moderatori possono svolgere alcune funzioni amministrative, come bannare 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 impedito di 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 live. 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 monetario una tantum.
Il metodofanFundingEvents.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 live di proprietà del canale attivano anche un messaggiofanFundingEvent
nella chat live della trasmissione.
Scopri di più sul finanziamento dei fan nel Centro assistenza YouTube.sponsors
La risorsa sponsor
identifica uno sponsor di un canale YouTube. Uno sponsor paga una quota mensile a un canale. Un badge viene visualizzato accanto ai messaggi dello sponsor nelle chat live del canale e gli sponsor possono anche partecipare a chat live esclusive per gli sponsor del canale, se presenti.
Il metodosponsors.list
dell'API elenca gli sponsor di un canale. Quando gli utenti si abbonano a un canale durante una trasmissione live di proprietà del canale, l'API aggiunge anche un messaggionewSponsorEvent
alla chat live della trasmissione.
Scopri di più sulle sponsorizzazioni nel Centro assistenza YouTube.
-
-
Aggiornamenti a risorse e metodi esistenti
-
La risorsa
liveBroadcast
contiene le seguenti nuove proprietà:Proprietà snippet.liveChatId
L'ID della chat live di YouTube della trasmissione. Con questo ID, puoi utilizzare i metodi della risorsa liveChatMessage
per recuperare, inserire o eliminare i messaggi di chat. Puoi anche aggiungere o rimuovere moderatori della chat, impedire agli utenti di partecipare alle chat live o rimuovere i ban esistenti.contentDetails.closedCaptionsType
Nota: questa proprietà sostituisce la proprietà contentDetails.enableClosedCaptions
.
Questa proprietà indica se i sottotitoli codificati sono attivi per la trasmissione e, in caso affermativo, il tipo di sottotitoli codificati che stai fornendo:closedCaptionsDisabled
: i sottotitoli codificati sono disattivati per la trasmissione live.closedCaptionsHttpPost
: invierai i sottotitoli codificati, tramite HTTP POST, a un URL di importazione associato al tuo live streaming.closedCaptionsEmbedded
: i sottotitoli codificati nel flusso 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
equivale a impostare la proprietàcontentDetails.closedCaptionsType
suclosedCaptionsHttpPost
. - Impostare il valore della proprietà su
false
equivale a impostare la proprietàcontentDetails.closedCaptionsType
suclosedCaptionsDisabled
.
-
Il nuovo parametro
broadcastType
del metodoliveBroadcasts.list
ti consente di filtrare una risposta API in modo da includere trasmissioni di eventi, trasmissioni persistenti o tutte le trasmissioni.Una trasmissione persistente è una trasmissione che esiste sempre e non è legata a un evento particolare. Nello specifico, la trasmissione predefinita di un canale è una trasmissione persistente ed è accessibile tramite la dashboard Live di YouTube Creator Studio. Le altre trasmissioni del canale sono trasmissioni di eventi.
-
-
Il campo
status.healthStatus.configurationIssues[].type
della risorsaliveStream
segnala i seguenti nuovi errori di 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 fps o un valore inferiore.%(framerate)s
-
È stata corretta la data di pubblicazione dell'aggiornamento precedente della documentazione.
-
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 statocreated
oready
.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'impostazionecontentDetails.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 per la risorsa
liveChat
e i 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 di chat. I messaggi della chat live possono essere recuperati e pubblicati solo durante la trasmissione.
-
-
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 un flusso video live.
In particolare, l'oggettostatus.healthStatus.configurationIssues[]
elenca i problemi che interessano un flusso 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 svolgono in orari diversi. -
La risorsa
liveBroadcast
contiene le seguenti nuove proprietà:Proprietà snippet.isDefaultBroadcast
Indica se questa trasmissione è quella predefinita per il canale. Quando un canale YouTube viene 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 video live a YouTube, mentre la trasmissione è il modo in cui gli spettatori possono vedere lo stream predefinito. Per saperne di più su come funzionano le trasmissioni predefinite, consulta la definizione della proprietà. contentDetails.enableLowLatency
Indica se questa trasmissione deve essere codificata per lo streaming a bassa latenza. Uno stream a bassa latenza può ridurre il tempo necessario per rendere visibile il video agli utenti che guardano una trasmissione, anche se può influire sulla risoluzione per gli spettatori dello stream. statistics.totalChatCount
Il numero totale di messaggi della chat live associati alla trasmissione. La proprietà e il relativo valore sono presenti se la trasmissione è visibile all'utente e la funzionalità di chat live è attivata. Tieni presente che questa proprietà non specificherà un valore al termine della trasmissione. Pertanto, questa proprietà non identificherebbe il numero di messaggi della chat per un video archiviato di una trasmissione live completata.
-
-
Errori nuovi e aggiornati
-
Oltre agli errori definiti per la nuova risorsa
liveChat
, l'API supporta il seguente nuovo errore:Dettagli errore liveStreams.update
Codice di risposta HTTP forbidden (403)
Motivo liveStreamModificationNotAllowed
Descrizione L'API non consente di modificare un flusso riutilizzabile in modo che non sia riutilizzabile o viceversa. Per ulteriori informazioni, vedi Informazioni su trasmissioni e stream.
-
21 maggio 2015
Questo aggiornamento contiene le seguenti modifiche:
-
YouTube ora supporta lo streaming video live a 60 frame al secondo (fps), il che significa una riproduzione più fluida per i giochi e altri video con azioni rapide. Quando avvii un live streaming su YouTube a 60 fps, YouTube rende disponibile lo stream anche a 30 fps sui dispositivi in cui la visualizzazione ad alta frequenza dei fotogrammi non è ancora disponibile.
La proprietà
cdn.format
della risorsaliveStream
supporta due nuovi valori per questa funzionalità:720p_hfr
e1080p_hfr
.Per ulteriori informazioni su questa funzionalità, consulta il blog di YouTube Creators.
21 agosto 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La definizione del parametro
walltime
del metodoliveBroadcasts.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
eliveStream
restituiscono questo errore se l'utente che ha autorizzato la richiesta API non è stato abilitato allo streaming di video live su YouTube. I dettagli che spiegano perché l'utente non può trasmettere video in live streaming potrebbero essere disponibili nelle impostazioni del canale dell'utente all'indirizzo https://www.youtube.com/features.rateLimitExceeded
userRequestsExceedRateLimit
I metodi liveBroadcasts.insert
eliveStreams.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 metodoliveBroadcasts.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 è solo una correzione alla documentazione; la funzionalità API sottostante non è cambiata. -
La proprietà
contentDetails.monitorStream.enableMonitorStream
della risorsaliveBroadcast
è stata aggiornata per spiegare che se il valore della proprietà ètrue
, devi eseguire la transizione della trasmissione allo statotesting
prima di poterla trasferire allo statolive
. Se il valore della proprietà èfalse
, la trasmissione non può avere una fasetesting
, quindi puoi passare direttamente allo statolive
. -
La proprietà
settings.offsetTimeMs
della risorsaliveCuepoint
è 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
eliveStream
ora supportano i parametrionBehalfOfContentOwner
eonBehalfOfContentOwnerChannel
. Questi parametri ti consentono di utilizzare le stesse credenziali di autorizzazione per completare le richieste API per diversi canali associati allo stesso proprietario dei contenuti. -
La documentazione del metodo
liveCuepoints.insert
è stata aggiornata per indicare che puoi impostare un valore per la proprietàsettings.walltime
quando chiami questo metodo. -
La documentazione sugli errori ora specifica il codice di risposta HTTP per ogni tipo di errore.
-
L'API ora supporta il seguente errore:
Tipo di errore Dettaglio errore Descrizione insufficientPermissions
livePermissionBlocked
I metodi liveBroadcasts.insert
,liveBroadcasts.transition
eliveStreams.insert
restituiscono questo errore se l'utente che ha autorizzato la richiesta non è in grado di trasmettere video in live streaming su YouTube. I dettagli che spiegano perché l'utente non può trasmettere video in live streaming potrebbero essere disponibili nelle impostazioni del canale dell'utente all'indirizzo https://www.youtube.com/features. -
L'errore
invalidScheduledStartTime
del metodoliveBroadcasts.insert
è stato aggiornato per chiarire che l'ora di inizio pianificata deve essere sufficientemente vicina alla data corrente da consentire di pianificare in modo affidabile una trasmissione in quel momento.
13 dicembre 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova proprietà
status.recordingStatus
della risorsaliveBroadcast
identifica lo stato attuale della trasmissione. -
La nuova proprietà
contentDetails.enableClosedCaptions
della risorsaliveBroadcast
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 statotesting
olive
. Se imposti questa proprietà sutrue
, la risorsaliveStream
associata alla trasmissione specifica l'URL di importazione da utilizzare per i sottotitoli codificati della trasmissione. -
La proprietà
snippet.scheduledEndTime
della risorsaliveBroadcast
ora supporta le trasmissioni programmate per continuare a tempo indeterminato. Con questa modifica, la proprietà non è più obbligatoria nelle richiesteliveBroadcasts.insert
eliveBroadcasts.update
.
Se recuperi una risorsaliveBroadcast
che non specifica un valore per questa proprietà, la trasmissione è pianificata per continuare a tempo indeterminato. Allo stesso modo, se chiami il metodoliveBroadcasts.insert
oliveBroadcasts.update
e non specifichi un valore per questa proprietà, la trasmissione verrà pianificata per continuare a tempo indeterminato. -
La proprietà
contentDetails.recordFromStart
della risorsaliveBroadcast
, che aveva già un valore predefinito ditrue
, ora può essere impostata solo sufalse
se il canale di trasmissione è autorizzato a disattivare le registrazioni per le trasmissioni live.Se il tuo canale non dispone dell'autorizzazione per disattivare le registrazioni e tenti di inserire una trasmissione con la proprietà
recordFromStart
impostata sufalse
, l'API restituirà un erroreForbidden
. Inoltre, se il tuo canale non dispone di questa autorizzazione e tenti di aggiornare una trasmissione per impostare la proprietàrecordFromStart
sufalse
, l'API restituirà un erroremodificationNotAllowed
. -
La risorsa
liveBroadcast
non contiene più una proprietàenableArchive
, che era stata menzionata nelle descrizioni delle proprietàcontentDetails.enableDvr
econtentDetails.enableEmbed
. -
L'elenco dei valori validi per la proprietà
status.lifeCycleStatus
della risorsaliveBroadcast
è stato aggiornato per includere una descrizione di ogni stato. -
La nuova proprietà
settings.walltime
della risorsaliveCuepoint
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 risorsaliveStream
contiene informazioni sullo stream. Al momento, l'unica proprietà dell'oggetto ècontentDetails.closedCaptionsIngestionUrl
, che specifica l'URL di importazione dei sottotitoli codificati associati allo stream video. -
L'elenco dei valori validi per la proprietà
status.streamStatus
della risorsaliveStream
è stato aggiornato per includere una descrizione di ogni stato. -
Il nuovo parametro
walltime
del metodoliveBroadcasts.control
consente di specificare la data e l'ora in cui si verificherà una modifica della scheda. L'API restituisce un errore se una richiesta specifica un valore per questo parametro e per il parametrooffsetTimeMs
. -
Nella risposta API a una richiesta
liveBroadcasts.list
, il valore della proprietàkind
è cambiato dayoutube#liveBroadcastList
ayoutube#liveBroadcastListResponse
. -
Nella risposta API a una richiesta
liveStreams.list
, il valore della proprietàkind
è cambiato dayoutube#liveStreamList
ayoutube#liveStreamListResponse
. -
La proprietà
eventId
è stata ritirata sia daliveBroadcastListResponse
che daliveStreamListResponse
. -
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 parametrioffsetTimeMs
ewalltime
. Una richiesta può omettere entrambi i parametri o specificare un valore per uno dei due parametri.invalidValue
invalidWalltime
Il metodo liveBroadcasts.control
restituisce questo errore se il valore del parametrowalltime
non è valido.forbidden
enableClosedCaptionsModificationNotAllowed
Il metodo liveBroadcasts.update
restituisce questo errore se tenti di aggiornare il valorecontentDetails.enableClosedCaptions
e lo stato della trasmissione non ècreated
oready
.invalidValue
conflictingTimeFields
Il metodo liveCuepoints.insert
restituisce questo errore se la richiesta specifica valori per le proprietàsettings.offsetTimeMs
esettings.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 errorecdnRequired
simile a quello supportato dal metodoliveStreams.insert
.
10 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
YouTube non identifica più i servizi e le funzionalità API sperimentali. Ora forniamo un elenco delle API di YouTube soggette alle norme di ritiro.
2 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo metodo
liveBroadcasts.control
ti consente di attivare/disattivare le impostazioni di visualizzazione per una schermata che viene visualizzata nello stream di trasmissione per una trasmissione già in corso. Se il tuo stream di trasmissione è in ritardo, puoi anche utilizzare questo metodo per specificare un offset temporale in cui si verificherà la modifica della schermata 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 risorsaliveBroadcast
: -
status.streamStatus
della risorsaliveStream
non supporta più il valoredeleted
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 cambiate nella risorsa
liveBroadcast
:- La proprietà
startWithSlateCuepoint
è stata rinominata instartWithSlate
. - La proprietà
enableArchive
è stata rinominata inrecordFromStart
. - L'oggetto
slateSettings
è stato ritirato e rimosso dalla documentazione. Sono stati rimossi anche i messaggi di errore relativi all'oggettoslateSettings
o alle sue proprietà. Infine, è stata rimossa la sezione "Visualizzazione delle schede" della guida Come iniziare.
- La proprietà
-
L'API non supporta più la possibilità di inserire slate in-stream utilizzando il metodo
liveCuepoints.insert
. I seguenti documenti sono stati aggiornati di conseguenza:-
La pagina indice, la guida Guida introduttiva e il tutorial Ciclo di vita di una trasmissione non menzionano più questa funzionalità.
-
La proprietà
settings.cueType
della risorsaliveCuepoint
non supporta piùslate
come valore della proprietà. L'unico valore supportato èad
. -
La proprietà
settings.eventState
della risorsaliveCuepoint
è 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.
-
L'API ora 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 il multicast e WebM non sono metodi di importazione supportati, come indicato in precedenza. L'elenco dei formati per la proprietàcdn.format
è stato aggiornato di conseguenza e l'oggettocdn.multicastIngestionInfo
e le relative proprietà secondarie sono stati rimossi dalla documentazione della risorsa. Inoltre,http
è stato rimosso dall'elenco dei valoricdn.ingestionType
supportati.