API YouTube Live Streaming - Cronologia delle revisioni

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

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 oggetto monetizationDetails. 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 metodo liveBroadcast.list supporta il valore monetizationDetails.
  • Il metodo update può essere utilizzato per mettere in pausa l'inserimento di annunci mid-roll per un determinato periodo di 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 metodo liveCuepoints.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 metodo liveCuepoints.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 metodo liveBroadcasts.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 risorsa liveChatMessage e le relative proprietà secondarie contengono informazioni sull'evento Regala un abbonamento. Analogamente, la nuova proprietà snippet.giftMembershipReceivedDetails e le relative proprietà secondarie contengono informazioni sull'evento Abbonamento regalo ricevuto.

15 settembre 2021

Questo aggiornamento contiene le seguenti modifiche:

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

    • newSponsorEvent
    • memberMilestoneChatEvent
  • La nuova proprietà snippet.memberMilestoneChatDetails della risorsa liveChatMessage e 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 risorsa liveBroadcast è 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 su true quando chiami il metodo liveBroadcasts.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:

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 o contentDetails.enableAutoStop su true.

  • 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 e liveBroadcast predefinite dei canali per trasmettere in streaming contenuti dal vivo su YouTube. In particolare, l'ID trasmissione e l'ID streaming associati alla trasmissione e allo stream permanenti non funzioneranno più per avviare nuove trasmissioni.

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

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

    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 e liveStream 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.

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 metodo liveBroadcasts.insert. Tieni presente che questa proprietà è inclusa nelle risposte API che contengono risorse liveBroadcast 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.
  • Nell'API di dati di YouTube, la risorsa channel supporta anche le nuove proprietà selfDeclaredMadeForKids e madeForKids.

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 su superStickerEvent per indicare che la risorsa contiene informazioni su un Super Sticker. In questo caso, la risorsa contiene anche l'oggetto snippet.superStickerDetails, che contiene informazioni aggiuntive sul Super Sticker.
  • In una risorsa superChatEvent, l'operatore booleano snippet.isSuperStickerEvent indica se il messaggio Superchat è anche un Super Sticker. In tal caso, l'oggetto snippet.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 parametro onBehalfOfContentOwner è 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 metodo superChatEvents.list ti consente di specificare che il valore della proprietà snippet.displayString deve essere formattato in base alle convenzioni di una determinata lingua. Anche la definizione 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 valore superChatEvent, che indica che la risorsa descrive un messaggio Superchat.

      Inoltre, la nuova proprietà snippet.superChatDetails della risorsa liveChatMessage e le relative proprietà secondarie contengono informazioni sull'evento Superchat.

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

  • Errori nuovi e aggiornati

    • L'API supporta i seguenti nuovi errori:

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

12 gennaio 2017

Nota:questo è un annuncio di ritiro.

In concomitanza con il rilascio della nuova funzionalità Superchat, YouTube ha ritirato la funzione Finanziamenti dei fan e l'API dedicata sarà disattivata il 28 febbraio 2017. A partire da questa data:

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

  • I Termini di servizio dei servizi API di YouTube 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 e 60fps.
        cdn.resolution La risoluzione dei dati video in entrata. I valori validi per la proprietà sono: 1440p, 1080p, 720p, 480p, 360p e 240p.
      • In conformità all'introduzione delle proprietà cdn.frameRate e cdn.resolution della risorsa liveStream, 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 e cdn.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 e 1440p_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à sono 360 e rectangular.
      • La definizione della proprietà statistics.totalChatCount della risorsa liveBroadcast è 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 e userBannedEvent, 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 errore 403 (Forbidden) per indicare che l'utente ha inviato troppe richieste in un determinato periodo di tempo. Il motivo dell'errore è userRequestsExceedRateLimit.

      I metodi liveBroadcasts.insert e liveBroadcasts.update supportano già lo stesso errore.
      liveStreams.insert Il metodo liveStreams.insert supporta quattro nuovi errori 400 (Bad Request) che identificano un valore di proprietà non valido nella risorsa liveStream che la richiesta ha provato a inserire. Il seguente elenco identifica i motivi di errore e le proprietà a cui sono associati:
      liveStreams.insert Il metodo liveStreams.insert supporta due nuovi errori 400 (Bad Request), ciascuno dei quali indica che non è presente un valore obbligatorio nella risorsa liveStream che la richiesta ha provato a inserire. Il seguente elenco identifica i motivi di errore e le proprietà a cui sono associati:
      Più precisamente, quando inserisci una risorsa liveStream, devi specificare un valore per la proprietà cdn.format o per le proprietà cdn.frameRate e cdn.resolution.
      • L'API restituisce un errore formatRequired se non specifichi un valore per nessuna delle tre proprietà.
      • L'API restituisce un errore frameRateRequired se specifichi un valore per cdn.resolution ma non per cdn.frameRate.
      • L'API restituisce un errore resolutionRequired se specifichi un valore per cdn.frameRate ma non per cdn.resolution.
      liveStreams.update Il metodo liveStreams.update restituisce un errore 403 (Forbidden) se la richiesta tenta di modificare il valore di una delle seguenti proprietà non modificabili: Il valore 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 metodo fanFundingEvents.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 messaggio fanFundingEvent 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 metodo sponsors.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 messaggio newSponsorEvent 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 su closedCaptionsHttpPost.
      • Impostare il valore della proprietà su false equivale a impostare la proprietà contentDetails.closedCaptionsType su closedCaptionsDisabled.
    • Il nuovo parametro broadcastType del metodo liveBroadcasts.list 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 risorsa liveStream 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 %(framerate)s f/s o inferiore.
  • La data di pubblicazione dell'aggiornamento della documentazione precedente è stata corretta.

  • Errori nuovi e aggiornati

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

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

19 agosto 2015

Questo aggiornamento contiene le seguenti modifiche:

  • 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'oggetto status.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 HTTPforbidden (403)
      MotivoliveStreamModificationNotAllowed
      DescrizioneL'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 risorsa liveStream supporta due nuovi valori per questa funzionalità: 720p_hfr e 1080p_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 metodo liveBroadcasts.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 e liveStream 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 e liveStreams.insert restituiscono entrambi questo errore per indicare che l'utente ha inviato troppe richieste in un determinato periodo di tempo.

2 maggio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Le descrizioni della risorsa liveStream e del metodo liveBroadcasts.bind sono state aggiornate 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 risorsa liveBroadcast è stata aggiornata per spiegare che, se il valore della proprietà è true, devi eseguire la transizione della trasmissione allo stato testing prima di poterla passare allo stato live. Se il valore della proprietà è false, la trasmissione non può avere uno stage testing, quindi puoi passare direttamente allo stato live.

  • La proprietà settings.offsetTimeMs della risorsa liveCuepoint è 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 e liveStream ora supportano i parametri onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Questi parametri ti consentono di utilizzare le stesse credenziali di autorizzazione per completare le richieste API per 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 e liveStreams.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 metodo liveBroadcasts.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 risorsa liveBroadcast identifica lo stato attuale della trasmissione.

  • La nuova proprietà contentDetails.enableClosedCaptions della risorsa liveBroadcast 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 stato testing o live. Se imposti questa proprietà su true, la risorsa liveStream associata alla trasmissione specificherà l'URL di importazione da utilizzare per i sottotitoli della trasmissione.

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

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

  • Ora la proprietà contentDetails.recordFromStart della risorsa liveBroadcast, che aveva già un valore predefinito di true, può essere impostata su false 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 su false, l'API restituirà un errore Forbidden. Inoltre, se il tuo canale non dispone di questa autorizzazione e tenti di aggiornare una trasmissione per impostare la proprietà recordFromStart su false, l'API restituirà un errore modificationNotAllowed.

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

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

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

  • Il nuovo oggetto contentDetails in una risorsa liveStream contiene informazioni 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 risorsa liveStream è stato aggiornato in modo da includere una descrizione di ogni stato.

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

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

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

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

  • L'API supporta i seguenti nuovi errori:

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

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

10 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

2 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

27 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Le seguenti proprietà sono state modificate nella risorsa liveBroadcast:

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

  • 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 risorsa liveCuepoint non supporta più slate come valore di proprietà. L'unico valore supportato è ad.

    • La proprietà settings.eventState della risorsa liveCuepoint è 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'oggetto cdn.multicastIngestionInfo e le relative proprietà figlio sono stati rimossi dalla documentazione della risorsa. Inoltre, http è stato rimosso dall'elenco dei valori cdn.ingestionType supportati.