Questa pagina elenca le modifiche all'API YouTube Live Streaming e gli aggiornamenti alla documentazione. Iscriviti a questo log delle modifiche.
9 ottobre 2023
Solo come riferimento, in questo file CSV puoi trovare gli ID dei adesivi e i Super Sticker.
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 per inserire annunci nelle trasmissioni dal vivo. 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 consente gli annunci automatici, può visualizzare i seguenti aspetti del comportamento degli annunci:
- la durata dell'intervallo tra le interruzioni pubblicitarie mid-roll.
- la strategia di pianificazione per i cue point degli annunci. I cue point possono essere inseriti contemporaneamente per tutti i visualizzatori oppure la tempistica dei cue point può variare da spettatore a spettatore. La seconda strategia consente a YouTube di programmare i cue point a una frequenza più elevata per consentire agli spettatori di ricevere i cue point quando sono idonei a farlo.
- 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 è in pausa fino a un determinato momento.
La documentazione riflette le seguenti modifiche all'API per supportare questa funzionalità:
- La risorsa
liveBroadcast
ora contiene un oggettomonetizationDetails
. I campi dell'oggetto indicano se l'inserimento automatico di annunci è abilitato 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 di annunci mid-roll per un determinato periodo di una trasmissione dal vivo. Inoltre, la documentazione ora identifica 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ù l'indicazione di valori per questi campi:snippet.title
status.privacyStatus
Se questi campi vengono omessi nella richiesta, verranno lasciati invariati.
1 novembre 2022
-
Il nuovo metodo
liveBroadcasts.cuepoint
consente a qualsiasi proprietario di un canale che trasmette dal vivo su YouTube di inserire cue point all'interno di quella trasmissione, il che può attivare interruzioni pubblicitarie. Questo metodo sostituisce il metodoliveCuepoints.insert
, che consentiva solo ai partner dei contenuti di YouTube di inserire cue point nelle trasmissioni dal vivo.Sono state aggiornate diverse guide in base alla 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 il 1° maggio 2023 o in una data successiva. Gli utenti dell'API devono aggiornare le proprie applicazioni in modo che chiamino invece il metodoliveBroadcasts.cuepoint
. -
La documentazione relativa al 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ù di specificare valori per questi campi:contentDetails.enableContentEncryption
contentDetails.enableDvr
contentDetails.enableEmbed
contentDetails.recordFromStart
contentDetails.startWithSlate
Se questi campi vengono omessi nella richiesta, verranno lasciati 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 le relative proprietà secondarie contengono informazioni sull'evento Regala un abbonamento. Analogamente, la nuova proprietàsnippet.giftMembershipReceivedDetails
e le relative proprietà secondarie contengono informazioni sull'evento Abbonamento regalo ricevuto.
15 settembre 2021
Questo aggiornamento contiene le seguenti modifiche:
-
La proprietà
snippet.type
ora supporta due nuovi valori:newSponsorEvent
memberMilestoneChatEvent
-
La nuova proprietà
snippet.memberMilestoneChatDetails
della risorsaliveChatMessage
e le relative proprietà secondarie contengono informazioni sull'evento Chat di fedeltà al canale. Analogamente, la nuova proprietàsnippet.newSponsorDetails
e le relative proprietà secondarie 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 un cambiamento nella funzionalità dell'API.Per designare una trasmissione dal vivo come rivolta ai minori, imposta la proprietà
status.selfDeclaredMadeForKids
sutrue
quando chiami il metodoliveBroadcasts.insert
per creare la trasmissione. -
Nota: questa modifica include un annuncio relativo al ritiro e un aggiornamento a un annuncio precedente sul ritiro.
Il metodo
liveBroadcasts.control
verrà deprecato a partire dal 1° ottobre 2020. Dopo questa data, tutte le chiamate a questo metodo restituiranno un errore vietato (403), che in seguito verrà completamente rimosso. I clienti possono comunque implementare le proprie slate aggiungendo un overlay al video inviato ai server di importazione di YouTube.La data di ritiro dell'annuncio del ritiro fatto il 16 aprile 2020, originariamente programmata per il 1° settembre 2020, è stata posticipata e ora avverrà il 1° ottobre 2020 o in una data successiva. Di conseguenza, le funzionalità incluse nell'annuncio di 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
, che è stato ritirato ad aprile 2016, non sarà più supportato a partire dal 17 agosto 2020. Le richieste che utilizzano ancora quel campo non andranno a buon fine a partire da quella data.
Se il codice utilizza ancora il campo cdn.format
, deve essere aggiornato in modo da specificare separatamente la frequenza fotogrammi e la risoluzione utilizzando le proprietà cdn.frameRate
e cdn.resolution
.
6 luglio 2020
La guida relativa alla pubblicazione di contenuti di YouTube dal vivo 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 Creator Studio.
-
Le istruzioni per la formattazione del valore del parametro
file
sono state spostate nella nuova sezione Completamento dell'URL di importazione HLS. Queste istruzioni si applicano indipendentemente dal fatto che l'URL di importazione HLS sia ottenuto dall'API YouTube o da YouTube Creator Studio.
Inoltre, nel nuovo confronto dei protocolli di importazione sono elencati i protocolli di importazione supportati da YouTube, i codec supportati per ciascun protocollo e informazioni aggiuntive sui casi d'uso appropriati per ciascun protocollo.
16 aprile 2020
Questo aggiornamento include una nuova proprietà e un annuncio sul 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 del video sullo stream video associato.Il documento sulla vita di una trasmissione è stato aggiornato per spiegare come cambia la procedura dettagliata di creazione e gestione di un evento di YouTube dal vivo se imposti le proprietà
contentDetails.enableAutoStart
ocontentDetails.enableAutoStop
sutrue
. -
Nota:questo è un annuncio di ritiro. Queste modifiche entreranno in vigore il 1° settembre 2020 o in una data successiva. 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. Interessa le applicazioni client API che utilizzano le risorse
liveStream
eliveBroadcast
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 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
. Nell'ambito di queste modifiche, questo parametro verrà deprecato. A partire dalla data del 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 permanenti esistenti prima di quel momento.
- Se il valore del parametro
Come riferimento, negli ultimi anni YouTube ha creato automaticamente uno stream e una trasmissione predefiniti per un canale quando quest'ultimo era abilitato per il live streaming. Lo stream predefinito esisteva a tempo indeterminato, non era associato a un'ora di inizio o di fine e non può essere eliminato. Allo stesso modo, la trasmissione predefinita è stata considerata persistente. È sempre esistito e non era legato a un determinato evento.
A partire dalla data di ritiro:
- YouTube non creerà più trasmissioni e stream predefiniti. Anziché fare affidamento sulle risorse predefinite, i client API devono essere in grado di creare e gestire le risorse
liveBroadcast
eliveStream
e associare queste risorse. - Se la trasmissione e lo stream predefinito di un canale sono attivi in modo attivo, ovvero il canale li sta utilizzando per una trasmissione dal vivo 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 predefinito di un canale non sono attivi attivamente, una volta che il ritiro entrerà in vigore, YouTube ignorerà i tentativi di utilizzo di queste risorse per trasmettere video.
Se la tua applicazione è interessata, fai riferimento ai seguenti documenti, che ti aiuteranno ad aggiornarla in modo che continui a funzionare come previsto dopo questa modifica:
- Una nuova guida alla migrazione prova a spiegare i passaggi che gli sviluppatori potrebbero dover svolgere nei client API che attualmente utilizzano trasmissioni e stream predefiniti.
- La guida La vita di una trasmissione ti guida attraverso una procedura passo passo che spiega come creare e gestire un evento dal vivo su YouTube. In ogni passaggio vengono spiegate le chiamate API o altre operazioni che devi eseguire per completare un'azione specifica. 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 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 il metodo members.list
. Per ulteriori informazioni sulla nuova risorsa, consulta la cronologia delle revisioni dell'API di dati di YouTube.
11 marzo 2020
La sezione Endpoint di importazione della guida Pubblicazione di contenuti dal vivo su YouTube tramite HLS è stata aggiornata per chiarire il processo che un codificatore deve utilizzare per completare il valore parametro file=
durante la creazione degli URL di importazione principali e di backup.
4 febbraio 2020
La guida relativa alla pubblicazione di contenuti live di YouTube tramite HLS è stata aggiornata in modo da tenere presente che le richieste DELETE
sono facoltative e che l'endpoint HLS di YouTube le ignora. Per motivi legati alle prestazioni, YouTube consiglia ai clienti di non inviare richieste
DELETE
.
10 gennaio 2020
L'API ora supporta la capacità di identificare i contenuti rivolti ai minori, che YouTube chiama "destinati ai bambini". Scopri di più sui contenuti "destinati ai bambini" nel Centro assistenza YouTube.
-
La risorsa
liveBroadcast
supporta due nuove proprietà per consentire a creatori di contenuti e spettatori di identificare i contenuti "destinati ai bambini":-
La proprietà
selfDeclaredMadeForKids
consente ai creator di contenuti di specificare se una trasmissione dal vivo è rivolta ai minori. Questa proprietà può essere impostata durante la creazione di una trasmissione con il metodoliveBroadcasts.insert
. Tieni presente che questa proprietà è inclusa nelle risposte API che contengono risorseliveBroadcast
solo se il proprietario del canale ha autorizzato la richiesta API. -
La proprietà
madeForKids
consente a qualsiasi utente 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 del tuo canale, dei tuoi video o delle tue trasmissioni.
-
La proprietà
-
Nell'API di dati di YouTube, la risorsa
channel
supporta anche le nuove proprietàselfDeclaredMadeForKids
emadeForKids
.
Abbiamo anche aggiornato i Termini di servizio e le Norme per gli sviluppatori dei servizi API di YouTube. Per ulteriori informazioni, consulta i Termini di servizio dei servizi API di YouTube - Cronologia delle revisioni. Le modifiche ai Termini di servizio e alle Norme per gli sviluppatori dei servizi API di YouTube entreranno in vigore il 10 gennaio 2020 (fuso orario del Pacifico).
20 agosto 2019
La sezione Requisiti della guida Caricare contenuti di YouTube dal vivo tramite HLS è stata aggiornata con due modifiche:
- Spiega che è una best practice includere sia i segmenti riconosciuti sia i segmenti in sospeso in ogni playlist multimediale. In questo modo è meno probabile che un segmento venga ignorato in caso di smarrimento di una playlist multimediale sul lato server. Ad esempio, puoi includere fino a due segmenti confermati e fino a cinque segmenti in sospeso in ogni playlist multimediale.
- Ora è obbligatorio inviare una playlist multimediale per ogni segmento multimediale. In questo modo il server può recuperare rapidamente in caso di smarrimento di una playlist multimediale. Questa pratica era precedentemente 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 importati su YouTube tramite HLS.
La nuova guida Pubblicazione di contenuti dal vivo su YouTube tramite HLS fornisce linee guida per l'utilizzo di HLS per lo streaming di contenuti dal vivo su YouTube da un codificatore. Lo scopo della guida è aiutare i fornitori di codificatori ad aggiungere il supporto per la distribuzione HLS ai propri prodotti.
4 aprile 2019
Questo aggiornamento contiene le seguenti modifiche:
-
La documentazione di riferimento delle 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 Explorer API. Per un esempio, consulta la documentazione del metodo
liveBroadcasts.list
. Ora ci sono due nuovi elementi nelle pagine che descrivono i metodi dell'API:-
Il widget Explorer API consente di selezionare gli ambiti di autorizzazione, inserire valori di parametri e proprietà di esempio, quindi inviare richieste API effettive e visualizzare le risposte API effettive. Il widget offre anche una visualizzazione a schermo intero che mostra esempi di codice completi, che vengono aggiornati in modo dinamico per utilizzare gli ambiti e i valori inseriti.
-
La sezione Casi d'uso comuni descrive uno o più casi d'uso comuni del metodo illustrato nella pagina. Ad esempio, puoi chiamare il metodo
liveBroadcasts.list
per recuperare dati su una trasmissione specifica o su quelle dell'utente corrente.Puoi utilizzare i link in questa sezione per completare in Explorer API con valori di esempio per il tuo caso d'uso o per aprire Explorer API a schermo intero con i valori già compilati. Lo scopo di queste modifiche è facilitare la visualizzazione di esempi di codice direttamente applicabili al caso d'uso che stai cercando di implementare nella tua applicazione.
Gli esempi di codice sono attualmente supportati per Java, JavaScript, PHP, Python e curl.
-
-
La pagina degli esempi di codice presenta una nuova UI che offre tutte le funzionalità descritte in precedenza. Utilizzando questo strumento, puoi esplorare i casi d'uso per metodi diversi, 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 in modo da riflettere il fatto che entrambe le risorse ora possono contenere informazioni sui Super Sticker. I Super Sticker sono un tipo di messaggio Superchat che mostra un'immagine. Come per 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 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
, l'operatore booleanosnippet.isSuperStickerEvent
indica se il messaggio Superchat è anche un Super Sticker. In tal caso, l'oggettosnippet.superStickerMetadata
contiene ulteriori dettagli sul Super Sticker.
5 aprile 2018
La descrizione del metodo superChatEvents.list
è stata aggiornata in modo da riflettere il fatto che la risposta dell'API non contiene più fanFundingEvents
, che sono state ritirate 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 dal vivo. 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 in modo da tenere presente 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 consiste nel formattare le stringhe di visualizzazione così come verrebbero utilizzate in inglese. Ad esempio, per impostazione predefinita, una stringa viene formattata come$1.00
anziché come$1,00
.
-
1 febbraio 2017
Questo aggiornamento contiene le seguenti modifiche:
-
Nuovi metodi e risorse
-
La nuova risorsa
superChatEvent
rappresenta un messaggio Superchat acquistato da un fan durante un live streaming di YouTube. Nella chat dal vivo di YouTube, i messaggi Superchat si distinguono dagli altri in due modi:- I messaggi Superchat vengono evidenziati con un colore.
- I messaggi Superchat rimangono bloccati nel riquadro di aggiornamento per un determinato periodo di tempo.
Il colore del messaggio Superchat, il periodo di tempo durante il quale rimane nel riquadro di aggiornamento e la lunghezza massima del messaggio sono tutti determinati dall'importo dell'acquisto. Per ulteriori informazioni sui messaggi Superchat, consulta il Centro assistenza YouTube.
L'API supporta un metodo per elencare gli eventi Superchat per i live streaming di un canale negli ultimi 30 giorni. Questo metodo restituisce anche i dati sugli eventi di finanziamenti dei fan (
fanFundingEvents
) provenienti dall'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 un messaggio Superchat.Inoltre, la nuova proprietà
snippet.superChatDetails
della risorsaliveChatMessage
e le relative proprietà secondarie 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
o la proprietàcontentDetails.projection
. I motivi 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 funzione Finanziamenti dei fan e l'API dedicata sarà disattivata il 28 febbraio 2017. A partire da questa data:
- Il metodo
liveChatMessages.list
non restituirà più messaggi con un valore disnippet.type
pari afanFundingEvent
. Analogamente, 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 Termini di servizio dei servizi API di YouTube pubblicati di recente ("Termini di servizio aggiornati"), discussi in dettaglio sul blog di YouTube Engineering and Developers offrono una vasta gamma di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore dal 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 per i Termini aggiornati. Inoltre, nella cronologia delle revisioni verranno spiegate anche le future modifiche ai Termini aggiornati o ai documenti di supporto. Puoi iscriverti a un feed RSS per elencare le modifiche nella cronologia delle revisioni da un link presente 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 su YouTube utilizzando DASH.
La nuova guida Pubblicazione di contenuti dal vivo su YouTube tramite DASH fornisce linee guida per l'utilizzo del formato di pubblicazione DASH per trasmettere in streaming i dati in diretta su YouTube da un codificatore. Il suo scopo è aiutare i fornitori di codificatori ad aggiungere il supporto per la consegna DASH ai loro prodotti.
18 aprile 2016
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
liveStream
aggiornamenti alle 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
e60fps
.cdn.resolution
La risoluzione dei dati video in entrata. I valori validi per la proprietà sono: 1440p
,1080p
,720p
,480p
,360p
e240p
. -
In conformità all'introduzione delle proprietà
cdn.frameRate
ecdn.resolution
della risorsaliveStream
,cdn.format
della risorsa è ora deprecato. La proprietàcdn.format
specifica risoluzione e frequenza fotogrammi in un singolo valore.Ti invitiamo a passare ai nuovi campi supportati. Nel frattempo,
cdn.format
continua a funzionare. Inoltre, al momento le richieste di inserimento dei live streaming hanno esito positivo, a condizione che specifichi i valori per la proprietàcdn.format
o per le proprietàcdn.frameRate
ecdn.resolution
. Se specifichi valori per tutte e tre le proprietà, l'API potrebbe restituire un errore se i valori non concordano.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 frame al secondo.
-
liveBroadcast
aggiornamenti alle 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à sono360
erectangular
. -
La definizione della proprietà
statistics.totalChatCount
della risorsaliveBroadcast
è stata aggiornata in modo da notare che il valore della proprietà viene visualizzato solo se la trasmissione ha almeno un messaggio di chat.
-
liveChatMessage
aggiornamenti alle risorse-
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 che è stato 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 che è stato escluso dalla partecipazione alla chat. L'oggetto contiene anche informazioni sull'esclusione stessa, vale a dire se l'esclusione è permanente o temporanea. Se l'esclusione è temporanea, una delle proprietà dell'oggetto specifica la durata dell'esclusione.
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 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 provato a inserire. Il seguente elenco identifica i motivi di 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
), ciascuno dei quali indica che non è presente un valore obbligatorio nella risorsaliveStream
che la richiesta ha provato a inserire. Il seguente elenco identifica i motivi di 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 nessuna 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) impongono la divulgazione di determinate informazioni agli utenti finali dell'UE e il consenso ottenuto dagli utenti finali. Pertanto, gli utenti finali dell'Unione Europea devono rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una notifica relativa a questo requisito nei Termini di servizio dell'API di YouTube.
17 dicembre 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Nuovi metodi e risorse
-
L'API supporta diverse nuove risorse per supportare la funzionalità di chat per le trasmissioni dal vivo. YouTube supporta la funzionalità di chat dal vivo durante le trasmissioni dal vivo attive. Queste risorse e i relativi metodi supportano il recupero dei messaggi nella chat, nonché le funzioni amministrative per la chat.
Risorse liveChatMessage
Questa risorsa rappresenta un messaggio in una chat dal vivo di YouTube. YouTube supporta diversi tipi di messaggi, inclusi SMS e finanziamenti dei fan. Alcuni tipi di messaggi identificano una fase specifica della chat, come 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 svolgere alcune funzioni amministrative, come l'esclusione degli utenti dalla chat o la rimozione di 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 di pubblicare messaggi in una chat dal vivo specifica. I divieti possono essere temporanei o permanenti. L'API supporta i metodi per inserire ed eliminare le esclusioni della chat dal vivo. fanFundingEvents
Questa risorsa rappresenta un evento di finanziamenti dei fan su un canale YouTube. I finanziamenti dei fan consentono agli spettatori di sostenere volontariamente i creator di YouTube con un sostegno monetario una tantum.
Il metodofanFundingEvents.list
dell'API elenca gli eventi di finanziamenti dei fan di un canale. Anche gli eventi di finanziamenti dei fan che vengono avviati tramite una chat dal vivo durante una trasmissione dal vivo di proprietà del canale attivano un messaggiofanFundingEvent
nella chat dal vivo della trasmissione.
Scopri di più sui finanziamenti dei fan nel Centro assistenza YouTube.sponsors
La risorsa sponsor
identifica uno sponsor di un canale YouTube. Uno sponsor paga una tariffa mensile a un canale. Accanto ai messaggi degli sponsor viene visualizzato un badge nelle chat dal vivo del canale. Inoltre, gli sponsor possono partecipare alle chat dal vivo riservate esclusivamente agli sponsor del canale, se presenti.
Il metodosponsors.list
dell'API elenca gli sponsor di un canale. Quando gli utenti si iscrivono per sponsorizzare un canale durante una trasmissione dal vivo di proprietà di quel canale, l'API aggiunge anche un messaggionewSponsorEvent
alla chat dal vivo 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 dal vivo 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 dal vivo o rimuovere le esclusioni esistenti.contentDetails.closedCaptionsType
Nota: questa proprietà sostituisce la proprietà contentDetails.enableClosedCaptions
.
Questa proprietà indica se i sottotitoli sono attivi per la tua trasmissione e, in questo caso, che tipo di sottotitoli stai fornendo:closedCaptionsDisabled
: i sottotitoli codificati sono disattivati per la trasmissione dal vivo.closedCaptionsHttpPost
: I sottotitoli verranno inviati, tramite HTTP POST, a un URL di importazione associato al tuo live streaming.closedCaptionsEmbedded
: i sottotitoli verranno codificati nel video stream utilizzando i formati EIA-608 e/o CEA-708.
contentDetails.enableClosedCaptions
Questa proprietà è stata ritirata il 17 dicembre 2015. Utilizza la proprietà contentDetails.closedCaptionsType
. 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
consente di filtrare una risposta dell'API in modo da includere trasmissioni di eventi, trasmissioni permanenti o tutte le trasmissioni.Una trasmissione permanente è una trasmissione che esiste sempre e non è legata a un determinato evento. In particolare, la trasmissione predefinita di un canale è 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 risorsaliveStream
segnala i seguenti nuovi errori di stato di integrità:Errori audioTooManyChannels
L'audio ha più di due canali, ma ne sono supportati solo uno (mono) o due (stereo). Correggi il numero di canali audio. frameRateHigh
La frequenza fotogrammi corrente è troppo alta. Imposta la frequenza fotogrammi su f/s o inferiore.%(framerate)s
-
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 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 che includa solo una delle due proprietà, quindi invia nuovamente la richiesta.
-
19 agosto 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Nuovi metodi e risorse
-
Nota: la documentazione relativa alla risorsa
liveChat
e ai relativi metodi è riservata e visibile solo a partner di YouTube selezionati.La nuova risorsa
liveChat
contiene un commento pubblicato durante una trasmissione dal vivo su YouTube. L'API supporta due metodi per questa risorsa:Metodi liveChats.list
Elenca i messaggi della chat dal vivo per una trasmissione. liveChats.insert
Crea un nuovo messaggio di chat. I messaggi della chat dal vivo possono essere recuperati e pubblicati solo durante la trasmissione dal vivo.
-
-
Aggiornamenti a risorse e metodi esistenti
-
La risorsa
liveStream
contiene le seguenti nuove proprietà:Proprietà snippet.isDefaultStream
Indica se questo stream è lo stream predefinito per il canale. Lo stream predefinito di un canale esiste a tempo indeterminato, non è associato a un'ora di inizio o di fine e non può essere eliminato. Consulta la definizione della proprietà per saperne di più su come funzionano gli stream predefiniti. status.healthStatus
Questo oggetto contiene informazioni che possono essere utilizzate per identificare, diagnosticare e risolvere problemi di streaming. L'oggetto contiene una serie di proprietà secondarie utili per valutare lo stato di un video stream in diretta.
In particolare, l'oggettostatus.healthStatus.configurationIssues[]
elenca i problemi che interessano uno stream video. In un nuovo documento, Problemi di configurazione per le risorse del live streaming, sono elencati 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 più trasmissioni diverse, se queste avvengono in momenti diversi. -
La risorsa
liveBroadcast
contiene le seguenti nuove proprietà:Proprietà snippet.isDefaultBroadcast
Indica se la trasmissione è quella predefinita per il canale. Quando un canale YouTube è abilitato 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 e la trasmissione è il modo in cui gli spettatori possono visualizzare lo stream predefinito. Per saperne di più su come funzionano le trasmissioni predefinite, consulta la definizione della proprietà. contentDetails.enableLowLatency
Indica se la trasmissione deve essere codificata per lo streaming a bassa latenza. Uno stream a bassa latenza può ridurre il tempo necessario affinché il video sia visibile agli utenti che guardano una trasmissione, ma può anche incidere sulla risoluzione degli 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 ha attivato la funzionalità di chat dal vivo. Tieni presente che questa proprietà non specifica un valore al termine della trasmissione. Pertanto, questa proprietà non identificherebbe il numero di messaggi di chat relativi a un video archiviato di una trasmissione dal vivo completata.
-
-
Errori nuovi e aggiornati
-
Oltre agli errori definiti per la nuova risorsa
liveChat
, l'API supporta il seguente nuovo errore:Dettagli errore liveStreams.update
Codice di risposta HTTP forbidden (403)
Motivo liveStreamModificationNotAllowed
Descrizione L'API non consente di modificare uno stream riutilizzabile in modo che non sia riutilizzabile o viceversa. Per ulteriori informazioni, consulta la sezione Informazioni su trasmissioni e stream.
-
21 maggio 2015
Questo aggiornamento contiene le seguenti modifiche:
-
YouTube ora supporta il live streaming di video a 60 frame al secondo (f/s), il che significa una riproduzione più fluida per i giochi e altri video con azioni rapide. Quando avvii un live streaming a 60 f/s, YouTube rende lo stream disponibile a 30 f/s sui dispositivi in cui non è ancora disponibile la visualizzazione a una frequenza fotogrammi elevata.
La proprietà
cdn.format
della risorsaliveStream
supporta due nuovi valori per questa funzionalità:720p_hfr
e1080p_hfr
.Visita lo YouTube Creators Blog per scoprire di più su questa funzionalità.
21 agosto 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La definizione del parametro
walltime
del metodoliveBroadcasts.control
è stata aggiornata in modo da notare che il valore della proprietà è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ
). -
L'API ora supporta i seguenti errori:
Tipo di errore Dettagli errore Descrizione insufficientPermissions
liveStreamingNotEnabled
Tutti i metodi per le risorse liveBroadcast
eliveStream
restituiscono questo errore se l'utente che ha autorizzato la richiesta API non è stato abilitato per lo streaming del video in diretta su YouTube. I dettagli che spiegano perché l'utente non può riprodurre in streaming il video in diretta potrebbero essere disponibili nelle impostazioni del canale dell'utente all'indirizzo https://www.youtube.com/features.rateLimitExceeded
userRequestsExceedRateLimit
I metodi liveBroadcasts.insert
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 in modo da ricordare che una trasmissione può essere associata a un solo stream video, mentre uno stream video può essere associato a più di una trasmissione. Questa modifica è solo una correzione alla documentazione; la funzionalità sottostante dell'API 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 passare allo statolive
. Se il valore della proprietà èfalse
, la trasmissione non può avere uno stagetesting
, quindi puoi passare direttamente allo statolive
. -
La proprietà
settings.offsetTimeMs
della risorsaliveCuepoint
è stata aggiornata in modo da ricordare 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 in modo da notare che puoi impostare un valore per la proprietàsettings.walltime
quando chiami questo 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 Dettagli 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 riprodurre in streaming il video in diretta su YouTube. I dettagli che spiegano perché l'utente non può riprodurre in streaming il video in diretta 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 abbastanza vicina alla data corrente da consentire la programmazione affidabile di una trasmissione in quel momento.
13 dicembre 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova proprietà
status.recordingStatus
della risorsaliveBroadcast
identifica lo stato attuale della trasmissione. -
La nuova proprietà
contentDetails.enableClosedCaptions
della risorsaliveBroadcast
indica se è possibile importare i sottotitoli 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 è in statotesting
olive
. Se imposti questa proprietà sutrue
, la risorsaliveStream
associata alla trasmissione specificherà l'URL di importazione da utilizzare per i sottotitoli della trasmissione. -
La proprietà
snippet.scheduledEndTime
della risorsaliveBroadcast
ora supporta le trasmissioni con una durata programmata 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 è programmata 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à programmata per continuare a tempo indeterminato. -
Ora la proprietà
contentDetails.recordFromStart
della risorsaliveBroadcast
, che aveva già un valore predefinito ditrue
, può essere impostata sufalse
solo se il canale di trasmissione può disattivare le registrazioni per le trasmissioni dal vivo.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 in modo da 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 sul flusso. Attualmente, l'unica proprietà dell'oggetto ècontentDetails.closedCaptionsIngestionUrl
, che specifica l'URL di importazione per i sottotitoli codificati associati al video stream. -
L'elenco dei valori validi per la proprietà
status.streamStatus
della risorsaliveStream
è stato aggiornato in modo da 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à un cambiamento dello slate. L'API restituisce un errore se una richiesta specifica un valore per questo parametro e per il parametrooffsetTimeMs
. -
Nella risposta dell'API a una richiesta
liveBroadcasts.list
, il valore della proprietàkind
è stato modificato dayoutube#liveBroadcastList
ayoutube#liveBroadcastListResponse
. -
Nella risposta dell'API a una richiesta
liveStreams.list
, il valore della proprietàkind
è stato modificato dayoutube#liveStreamList
ayoutube#liveStreamListResponse
. -
La proprietà
eventId
è stata deprecata sia daliveBroadcastListResponse
sia daliveStreamListResponse
. -
L'API supporta i seguenti nuovi errori:
Tipo di errore Dettagli errore Descrizione invalidValue
conflictingTimeFields
Il metodo liveBroadcasts.control
restituisce questo errore se nella tua richiesta sono specificati 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 nella tua richiesta sono specificati 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ù le funzionalità e i servizi sperimentali dell'API. Ora forniamo un elenco di API di YouTube soggette alle norme sul ritiro.
2 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo metodo
liveBroadcasts.control
consente di attivare/disattivare le impostazioni di visualizzazione di uno slate che viene visualizzato nello stream della trasmissione per una trasmissione già in corso. Se lo stream della trasmissione subisce un ritardo, puoi utilizzare questo metodo anche per specificare un offset temporale in cui si verificherà la modifica dello slate 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
: -
L'elemento
status.streamStatus
della risorsaliveStream
non supporta più il valoredeleted
come possibile stato del flusso. -
Le informazioni che l'API restituisce per molti messaggi di errore sono state modificate per spiegare meglio il motivo per cui si sono verificati errori specifici. 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 instartWithSlate
. - La proprietà
enableArchive
è stata rinominata inrecordFromStart
. - L'oggetto
slateSettings
è stato deprecato e rimosso dalla documentazione. Sono stati rimossi anche i messaggi di errore relativi all'oggettoslateSettings
o alle sue proprietà. Infine, la sezione "Visualizzazione di slate" della Guida introduttiva è stata rimossa.
- La proprietà
-
L'API non supporta più l'inserimento di 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 La vita di una trasmissione non menzionano più questa funzionalità.
-
La proprietà
settings.cueType
della risorsaliveCuepoint
non supporta piùslate
come valore di proprietà. L'unico valore supportato èad
. -
La proprietà
settings.eventState
della risorsaliveCuepoint
è stata deprecata 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, ove possibile, per fornire 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 programmata di una trasmissione deve essere successiva all'ora di inizio programmata.liveBroadcasts.insert
- La trasmissione specifica uno stato di 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 di
liveStream
è stata aggiornata in modo da riflettere il fatto 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'oggettocdn.multicastIngestionInfo
e le relative proprietà figlio sono stati rimossi dalla documentazione della risorsa. Inoltre,http
è stato rimosso dall'elenco dei valoricdn.ingestionType
supportati.