Cronologia revisioni

In questa pagina sono elencate le modifiche apportate all'API YouTube Data (v3) e gli aggiornamenti alla documentazione. Iscriviti a questo log delle modifiche. :

30 aprile 2024

Nota: questo è un annuncio relativo al ritiro.

Questo aggiornamento contiene le seguenti modifiche:

L'API non supporta più la possibilità di inserire o recuperare discussioni sui canali. Questa modifica è coerente con la funzionalità supportata sul sito web di YouTube, che non supporta la pubblicazione di commenti sui canali.

13 marzo 2024

Nota: questo è un annuncio relativo al ritiro.

Questo aggiornamento contiene le seguenti modifiche:

Il parametro sync per il parametro captions.insert e captions.update metodi è stata ritirata. YouTube non supporterà più aggiornato al 12 aprile 2024.

A seguito di questa modifica, gli sviluppatori devono includere informazioni sulle tempistiche quando inseriscono o aggiornare le tracce dei sottotitoli codificati, o il caricamento non andrà a buon fine.

12 marzo 2024

Questo aggiornamento contiene le seguenti modifiche:

La documentazione relativa alla risorsa captions è stata aggiornata per indicare che la lunghezza massima consentita per snippet.name è stata aggiornata è di 150 caratteri. L'API restituisce un nameTooLong se il nome della traccia supera questo valore.

7 marzo 2024

Nota: questo è un annuncio relativo al ritiro.

La proprietà della risorsa channel brandingSettings.channel.moderateComments è stato deprecato. YouTube verrà interrotto che supporta il parametro a partire dal 7 marzo 2024.

31 gennaio 2024

Questo aggiornamento contiene le seguenti modifiche:

Il nuovo forHandle del metodo channels.list consente di recuperare le informazioni su un canale specificando il relativo handle YouTube.

9 novembre 2023

Tutti i riferimenti alla risorsa videoId in Comments sono state rimosse perché la risorsa videoId non viene restituita utilizzando una chiamata API.

12 settembre 2023

Nota: questo è un annuncio relativo al ritiro.

Il metodo comments.markAsSpam è deprecata da alcuni anni. Questo metodo non è già supportato su YouTube e non è più supportati tramite l'API.

È stato aggiunto un avviso di deprecazione a tutti i documenti che fanno riferimento comments.markAsSpam.

22 agosto 2023

Il metodo search.list ora supporta videoPaidProductPlacement . Questo parametro ti consente di filtrare i risultati di ricerca in modo da includere solo i video i cui creator ha segnalato di avere una promozione a pagamento.

18 agosto 2023

La definizione della risorsa video liveStreamingDetails.concurrentViewers è stato aggiornato per indicare che il numero di spettatori simultanei restituiti dall'API di dati di YouTube potrebbe sono diversi dal numero di spettatori simultanei elaborati e privi di spam disponibili tramite YouTube Analisi. La Centro assistenza YouTube fornisce ulteriori informazioni sulle metriche dei live streaming.

7 agosto 2023

Come annunciato il 12 giugno 2023, Metodo search.list Il parametro relatedToVideoId è stato deprecato. Questo parametro non è più supportato e i riferimenti al parametro sono stati rimossi dalla documentazione dell'API.

28 giugno 2023

Il metodo thumbnails.set ora supporta il valore uploadRateLimitExceeded errore, che indica che il canale ha caricato troppi contenuti le miniature nelle ultime 24 ore. Riprova più tardi.

12 giugno 2023

Nota: questo è un annuncio relativo al ritiro.

Il metodo search.list Il parametro relatedToVideoId è stato deprecato. YouTube non supporterà più aggiornato al 7 agosto 2023.

Al momento, è stato aggiunto un avviso di ritiro al metodo search.list documentazione. Questo parametro verrà rimosso completamente dalla documentazione search.list a partire dal 7 agosto 2023.

Inoltre, è stato fornito un esempio che mostra come recuperare è stata rimossa dalla guida all'implementazione dell'API.

22 agosto 2022

Annotazioni del tipo corretto per video.statistics in stringa da non firmato.

5 agosto 2022

YouTube ha cambiato il modo in cui vengono generati gli ID didascalia e, nell'ambito di questa modifica, assegnando nuovi ID a tutte le tracce di sottotitoli codificati. Questa modifica potrebbe essere una per le applicazioni che archiviano caption_id, tuttavia non lo sarà interessa le applicazioni che non archiviano caption_id valori.

Da adesso fino al 1° dicembre 2022, captions.list, captions.update, captions.download e e captions.delete metodi eseguiranno supportare sia il vecchio che il nuovo ID traccia sottotitoli. Tuttavia, a partire dal 1° dicembre 2022, YouTube non supporterà più i vecchi ID traccia sottotitoli. A quel punto, la chiamata a uno di questi metodi API con un vecchio ID traccia sottotitoli genererà un captionNotFound errore.

Per prepararti a questo cambiamento, dovresti pianificare la sostituzione completa di tutti i dati della traccia di sottotitoli memorizzata da adesso fino al 1° dicembre 2022. Ciò significa che, per tutti i video per cui memorizzi una traccia di sottotitoli codificati, di dati, elimina quelli attualmente memorizzati, quindi richiama captions.list per recuperare il insieme di tracce di sottotitoli codificati corrente per il video e memorizzano i dati nella risposta dell'API come si farebbe normalmente.

12 luglio 2022

I Termini di servizio dei servizi API di YouTube sono stati aggiornati. Non dimenticare di apporre consulta i Termini di servizio dei servizi API di YouTube - Revisione Cronologia per ulteriori informazioni.

27 aprile 2022

La descrizione del metodo videos.insert è stata aggiornata per notare che la dimensione massima dei file per i video caricati è aumentata da 128 GB a 256 GB.

8 aprile 2022

Il metodo subscriptions.list myRecentSubscribers e mySubscribers delle definizioni dei parametri sono stati entrambi aggiornati per notare che il numero massimo di abbonati restituiti dall'API potrebbe essere limitato. Questa modifica rappresenta una correzione della documentazione e non una modifica del comportamento dell'API.

15 dicembre 2021

Come annunciato il 18 novembre 2021, in concomitanza con cambiamenti che rendono Non mi piace il video i conteggi vengono privati sull'intera piattaforma YouTube, il valorevideo statistics.dislikeCount ora è privata.

Puoi scoprire di più su questa modifica sul blog ufficiale di YouTube.

18 novembre 2021

Insieme alle modifiche alla imposta il numero di Non mi piace sui video privato sull'intera piattaforma YouTube, lo strumento video statistics.dislikeCount sarà resa privata a partire dal 13 dicembre 2021. Ciò significa che la proprietà Essere incluso in una risposta API dall'endpoint videos.list se la richiesta API è stata autenticati dal proprietario del video.

L'endpoint videos.rate non è interessato da questa modifica.

Sviluppatori che non mostrano pubblicamente il numero di Non mi piace, ma che hanno comunque bisogno di tale numero per il proprio Il client API può richiedere di essere inserito in una lista consentita per un'esenzione. Per richiedere un'esenzione, devi: devono completare questa operazione modulo di richiesta.

Puoi scoprire di più su questa modifica sul blog ufficiale di YouTube.

2 luglio 2021

Nota: questo è un annuncio relativo al ritiro.

L'endpoint commentThreads.update è stato deprecato e non è più supportato. Questo endpoint ha duplicato la funzionalità disponibile tramite altri endpoint API. Puoi invece chiama comments.update

metodo e, se il codice richiede una risorsa commentThreads, effettua una chiamata secondaria alla Metodo commentThreads.list.

1° luglio 2021

Tutti gli sviluppatori che utilizzano i servizi API di YouTube devono completare un controllo di conformità dell'API per poter ricevere una quota superiore alla quota predefinita di 10.000 unità. A oggi, sia il processo di controllo di conformità sia le richieste di allocazione di unità di quota aggiuntive sono stati condotti dagli sviluppatori compilando e inviando il modulo Servizi API di YouTube - Controllo ed estensione delle quote.

Per chiarire questi processi e soddisfare meglio le esigenze degli sviluppatori che utilizzano i nostri servizi API, stiamo aggiungendo tre nuovi moduli e una guida alla loro compilazione:

• Modulo per le richieste degli sviluppatori controllati: gli sviluppatori che hanno già superato un controllo di conformità delle API possono compilare e inviare questo modulo più breve per richiedere un'estensione della quota assegnata.
• Modulo per i ricorsi: gli sviluppatori i cui progetti API non hanno superato un controllo di conformità (o hanno negato l'aumento dell'unità di quota) possono compilare e inviare questo modulo.
• Modulo di cambio di controllo: gli sviluppatori o qualsiasi parte che gestisce un client API per conto di uno sviluppatore e che riscontri un passaggio di controllo (ad esempio, tramite l'acquisto o la vendita di azioni, una fusione o altra forma di transazione aziendale) associati a un progetto API devono compilare e inviare questo modulo. Ciò consente al team dedicato alle API di YouTube di aggiornare i nostri record, verificare la conformità del caso d'uso del nuovo progetto API e convalidare l'attuale allocazione della quota da parte dello sviluppatore.

Ogni nuovo modulo ci informerà del tuo utilizzo previsto delle API di YouTube e ci permetterà di offrirti un'assistenza migliore.

Ulteriori dettagli sono disponibili nella nostra nuova guida ai controlli di conformità delle API.

12 maggio 2021

Nota: questo è un annuncio relativo al ritiro.

Questo aggiornamento riguarda le seguenti modifiche all'API:

• La risorsa channel contentDetails.relatedPlaylists.favorites è stata ritirata. La funzionalità dei video preferiti è già stata ritirata per diversi anni, come indicato nella revisione del 28 aprile 2016, voce della cronologia.

  Prima di questo aggiornamento, l'API creava comunque una nuova playlist se un client API tentava Aggiungere un video a una playlist preferita inesistente. D'ora in poi, la playlist non sarà creati in questo caso e l'API restituirà un errore. Tenta di modificare le playlist preferite aggiungendo, modificando o eliminando elementi sono anch'essi deprecati in base agli annunci precedenti e potrebbero iniziare a restituire errori in qualsiasi momento.

• La seguente risorsa channel sono state ritirate. Queste proprietà non sono già supportate nell'interfaccia utente di YouTube Studio e su YouTube. Di conseguenza, non sono più supportati nemmeno tramite l'API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Tutte le proprietà sono state rimosse dalla channel della risorsa e le relative definizioni sono state rimosse elenco delle proprietà. Inoltre, gli errori associate a queste proprietà sono state rimosse dalla documentazione specifica del metodo.

• La seguente risorsa channelSection sono state ritirate. Queste proprietà non sono già supportate nell'interfaccia utente di YouTube Studio e su YouTube. Di conseguenza, non sono più supportati nemmeno tramite l'API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  In concomitanza con questa modifica, il metodo channelSection.list Il parametro hl ha anche è stata ritirata in quanto le funzionalità che supporta non sono supportate.

  Tutte le proprietà sono state rimosse dalla channelSection della risorsa e le relative definizioni sono state rimosse elenco delle proprietà. Inoltre, gli errori associate a queste proprietà sono state rimosse dalla documentazione specifica del metodo.

• Per la risorsa channelSection snippet.type proprietà, i seguenti valori sono stati deprecati. Questi valori non sono già supportati su YouTube pagine del canale e, di conseguenza, non sono più supportate tramite l'API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• La risorsa playlist La proprietà snippet.tags[] è stata deprecata. Questa proprietà non è già supportata su YouTube e, di conseguenza, non è più supportato tramite l'API.

9 febbraio 2021

La risorsa playlistItem supporta due nuove proprietà:

• snippet.videoOwnerChannelId identifica l'ID del canale che ha caricato il video della playlist.
• snippet.videoOwnerChannelTitle identifica il nome del canale che ha caricato il video della playlist.

28 gennaio 2021

Questo aggiornamento contiene le seguenti modifiche:

• playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list e Tutti i metodi sono supportati da playlists.update un nuovo errore playlistOperationUnsupported. L'errore si verifica quando una richiesta tenta di eseguire un'operazione non consentita per una determinata playlist. Ad esempio, un utente non può eliminare un video dalla playlist dei video caricati o eliminare la playlist stessa.

  In tutti i casi, questo errore restituisce un codice di risposta HTTP 400 (richiesta errata).

• Il metodo playlistItems.list watchHistoryNotAccessible e watchLaterNotAccessible errori hanno è stato rimosso dalla documentazione. Mentre gli utenti la cronologia delle visualizzazioni e gli elenchi Guarda più tardi non accessibili tramite l'API, questi errori specifici non vengono restituiti dall'API.

15 ottobre 2020

Sono state aggiunte due nuove sezioni alla scheda Norme:

• La nuova Sezione III.E.4.i fornisce ulteriori informazioni sui dati raccolti e inviati tramite il player incorporato di YouTube. Tu saranno responsabili di tutti i dati utente che ci invii tramite il player incorporato di YouTube prima che l'utente ha interagito con il player per indicare l'intenzione di riproduzione. Puoi limitare i dati condivisi con YouTube prima che un utente interagisca con il player impostando la riproduzione automatica su false.
• La nuova Sezione III.E.4.j riguarda a controllare lo stato dei contenuti destinati ai bambini prima di incorporarli sui tuoi siti. app. È tua responsabilità sapere quando i video che incorpori nel tuo client API vengono realizzati per i bambini e trattare di conseguenza i dati raccolti dal player incorporato. Di conseguenza, devi Controllare lo stato dei contenuti utilizzando il servizio API YouTube Data prima di incorporarli nell'API tramite player incorporato di YouTube.

La nuova sezione Trovare lo stato MadeForKids di un video guida spiega come cercare lo stato per bambini e ragazzi di un video utilizzando la Servizio API YouTube Data.

In concomitanza con queste modifiche, è stato aggiunto un promemoria alla documentazione relativa ai parametri del player incorporato per spiegare che Se attivi la riproduzione automatica, la riproduzione avverrà senza alcuna interazione dell'utente con il player. riproduzione la raccolta e la condivisione dei dati avvengono quindi al caricamento della pagina.

8 ottobre 2020

Questo aggiornamento riguarda tre piccole modifiche relative alla channel risorsa:

• snippet.thumbnails che identifica le miniature di un canale, potrebbe essere vuoto per i nuovi e la loro compilazione potrebbe richiedere fino a un giorno.
• statistics.videoCount riflette solo il numero dei video pubblici del canale, anche per i proprietari. Questo comportamento è coerente con i conteggi mostrati sul sito web di YouTube.
• Le parole chiave del canale, che sono identificate brandingSettings.channel.keywords , potrebbero essere troncati se superano la lunghezza massima consentita di 500 caratteri oppure se contengono virgolette non di escape ("). Tieni presente che i 500 caratteri non è un limite per parola chiave ma piuttosto un limite alla lunghezza totale di tutte le parole chiave. Questo comportamento è coerente con quello sul sito web di YouTube.

9 settembre 2020

Nota: questo è un annuncio relativo al ritiro.

Questo aggiornamento riguarda le seguenti modifiche all'API. Tutte le modifiche entreranno in vigore a partire dal giorno 9 settembre 2020, la data di questo annuncio. Tenendo conto di questo, gli sviluppatori non dovrebbero più fare affidamento su una qualsiasi delle funzionalità API elencate di seguito.

• Le risorse, i metodi, i parametri e le proprietà delle risorse dell'API seguenti sono deprecati immediatamente e smetteranno di funzionare a partire dalla data di questo annuncio:
  • La seguente risorsa channel proprietà:
    • La proprietà statistics.commentCount
    • L'oggetto brandingSettings.image e tutte le relative proprietà secondarie
    • L'elenco brandingSettings.hints e tutte le relative proprietà secondarie
  • Il metodo channels.list Parametro del filtro categoryId
  • La risorsa guideCategories e guideCategories.list metodo
• Risposte dell'API per Numero metodo channels.list contengono più prevPageToken se la richiesta API imposta la proprietà Parametro managedByMe a true. Questa modifica non interessa la proprietà prevPageToken per altre richieste channels.list e questa operazione non influisce sulle nextPageToken per eventuali richieste.
• contentDetails.relatedPlaylists.watchLater della risorsa channel e contentDetails.relatedPlaylists.watchHistory di proprietà sono state entrambe annunciate come deprecato l'11 agosto 2016. La Supporto dei metodi playlistItems.insert e playlistItems.delete per queste playlist sono stati completamente ritirati e le due proprietà sono state rimosse dalla documentazione.
• Il parametro mySubscribers del metodo channels.list, che era annunciati come deprecati il 30 luglio 2013, sono stati rimosso dalla documentazione. Utilizza la subscriptions.list e il parametro mySubscribers per recuperare un elenco dei sottoscrittori canale di un utente autenticato.
• L'oggetto invideoPromotion della risorsa channel e tutti i relativi oggetti figlio che sono state annunciate come deprecate il giorno 27 novembre 2017, sono stati rimossi dalla documentazione.

29 luglio 2020

Abbiamo semplificato la procedura di addebito della quota per le richieste API rimuovendo le costo associato al parametro part. Con effetto immediato, addebiteremo solo il costo base per il metodo chiamato. Puoi trovare ulteriori informazioni sulle quota qui.

L'effetto di questa modifica è che la maggior parte delle chiamate API avrà un costo per quota marginalmente inferiore, mentre alcune chiamate API avranno comunque lo stesso costo. Questa modifica non aumenta il costo di nessuna API chiamate. Nel complesso, l'impatto probabile è che la quota allocata, che può essere visualizzata Google Cloud Console, andrà oltre.

Consigliamo vivamente a tutti gli sviluppatori di completare una controllo di conformità relativo per garantire l'accesso continuo ai servizi API di YouTube.

Questa voce della cronologia delle revisioni è stata pubblicata per la prima volta il 20 luglio 2020.

28 luglio 2020

Tutti i video caricati tramite videos.insert endpoint di progetti API non verificati creati dopo il 28 luglio 2020 sarà limitato a modalità di visualizzazione privata. Per rimuovere questa limitazione, ogni progetto deve sottoporsi a un controllo per verificare la conformità con Termini di servizio.

I creator che utilizzano un client API non verificato per caricare video riceveranno un'email che spiega che il loro video è bloccato come privato e possono evitarlo usando un o un cliente controllato.

I progetti API creati prima del 28 luglio 2020 attualmente non interessate da questa modifica. Tuttavia, consigliamo vivamente a tutti gli sviluppatori completare un controllo di conformità per i loro progetti, al fine di garantire un accesso continuo ai servizi API di YouTube.

21 luglio 2020

[Aggiornamento del 28 luglio 2020.] L'aggiornamento della documentazione a cui si fa riferimento in questa revisione storia è stata ripubblicata il 28 luglio 2020.

Ieri abbiamo pubblicato un aggiornamento della documentazione relativa alla nostra procedura per l'addebito della quota. Tuttavia, a causa di circostanze impreviste, la modifica della quota non è ancora effettiva. Di conseguenza, documentazione è stata ripristinata per motivi di accuratezza. Per evitare confusione, la revisione voce della cronologia che spiega che la modifica è stata rimossa e verrà ripubblicata a breve.

7 luglio 2020

Nota: questo è un annuncio relativo al ritiro.

Il metodo videos.insert I parametri autoLevels e stabilize sono ora deprecati ed entrambi sono stati rimossi dalla documentazione. I valori vengono ignorati e non influiscono sul valore modo in cui vengono elaborati i video appena caricati.

15 giugno 2020

La nuova sezione Conformità con lo sviluppatore YouTube La guida alle norme fornisce indicazioni ed esempi per aiutarti a garantire che i tuoi client API aderiscano a parti specifiche dei servizi API di YouTube Termini e Criteri (TdS dell'API).

Queste indicazioni forniscono informazioni sul modo in cui YouTube applica determinati aspetti dei TdS dell'API, ma non devono sostituire i documenti esistenti. La guida risponde ad alcune delle domande più comuni che che gli sviluppatori chiedono durante i controlli di conformità delle API. Ci auguriamo che semplifichi lo sviluppo delle tue funzionalità aiutandoti a capire il modo in cui interpretiamo e applichiamo le nostre norme.

4 giugno 2020

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

La funzionalità bollettino del canale è stata completamente ritirata. Questa modifica è stata inizialmente annunciata il 17 aprile 2020 ed è entrata in vigore. Di conseguenza, Il metodo activities.insert non è più supportato activities.list non restituisce più i bollettini del canale. Per ulteriori dettagli, consulta Centro assistenza YouTube.

17 aprile 2020

Nota: questo è un annuncio relativo al ritiro.

YouTube sta ritirando la funzionalità Bollettino del canale. Di conseguenza, activities.insert metodo verrà ritirato e activities.list smetterà di restituire i bollettini del canale. Queste modifiche entreranno in vigore nell'API il giorno o dopo il 18 maggio 2020. Per ulteriori dettagli, consulta Centro assistenza YouTube.

31 marzo 2020

Questo aggiornamento contiene le seguenti modifiche:

• Nuove risorse e nuovi metodi

  • La nuova risorsa member rappresenta un abbonato a un canale YouTube. Un membro fornisce sostegno monetario ricorrente a un creator e riceve vantaggi speciali. Ad esempio, gli abbonati possono chattare quando creator attiva la modalità riservata agli abbonati per una chat.

    Questa risorsa sostituisce sponsor che fa parte dell'API YouTube Live Streaming. La La risorsa sponsor è ora deprecata e i client API devono aggiornare le chiamate a il metodo sponsors.list per utilizzare members.list.

  • Il nuovo membershipsLevel risorsa identifica un livello di prezzo gestito dall'autore che ha autorizzato la richiesta API. membershipsLevels.list recupera un elenco di tutti i livelli di abbonamento dell'autore.

10 gennaio 2020

L'API ora supporta la possibilità di identificare i contenuti destinati ai minori, che YouTube chiama "destinato ai bambini". Scopri di più su "destinato ai bambini" nel Centro assistenza YouTube.

Le channel e Le risorse di video supportano due nuove proprietà per Consentire ai creator di contenuti e agli spettatori di identificare i contenuti destinati ai bambini:

• La proprietà selfDeclaredMadeForKids consente ai creator di contenuti di specificare se un channel o video è destinato ai bambini.
  
  Per i canali, questa proprietà può essere impostata quando chiami il metodo Metodo channels.update. Per i video: questa proprietà può essere impostata quando si chiama il videos.insert o videos.update metodi.
  
  Tieni presente che questa proprietà è inclusa solo nelle risposte dell'API che contengono channel o video risorse se il proprietario del canale ha autorizzato la richiesta API.
• La proprietà madeForKids consente a qualsiasi utente di recuperare il contenuto "destinato ai bambini" stato di un canale o video. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Consulta le Scopri di più nel Centro assistenza YouTube Informazioni sull'impostazione del pubblico del tuo canale, dei tuoi video o delle tue trasmissioni.

Abbiamo anche aggiornato i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Non dimenticare di apporre consulta i Termini di servizio dei servizi API di YouTube - Revisione Cronologia per ulteriori informazioni. Le modifiche ai Termini di servizio dei servizi API di YouTube e Le norme per gli sviluppatori entreranno in vigore il 10 gennaio 2020 (fuso orario del Pacifico).

10 settembre 2019

La documentazione di riferimento dell'API è stata aggiornata per riflettere una modifica al modo in cui l'abbonato vengono riportati su YouTube e, di conseguenza, nelle risposte dell'API. In seguito a questo cambiamento, Il numero di iscritti restituito dal servizio API di dati di YouTube viene arrotondato per difetto a tre per il numero di iscritti superiore a 1000 iscritti. Questa modifica influisce sulle Risorsa di channel statistics.subscriberCount proprietà.

Nota: questa modifica influisce sul valore della proprietà anche nei casi in cui un utente invia una richiesta autorizzata di dati relativi al proprio canale. I proprietari del canale possono comunque vedere Il numero di iscritti in YouTube Studio.

Ad esempio, se un canale ha 123.456 iscritti, La proprietà statistics.subscriberCount conterrà il valore 123000. La tabella seguente mostra esempi di come il numero di iscritti viene arrotondato nelle risposte dell'API e abbreviato in altre interfacce utente di YouTube visibili pubblicamente:

Esempio di numero di iscritti	API Data di YouTube	UI di YouTube visibili pubblicamente
1234	1230	1230
12.345	12300	12.300
123.456	123000	123.000
1.234.567	1230000	1,23 Mln
12.345.678	12300000	12,3 Mln
123.456.789	123000000	123 Mln

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 channels.list. Ora nelle pagine sono presenti due nuovi elementi 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 per il metodo descritto nella pagina. Ad esempio, potresti chiamare il metodo channels.list per recuperare i dati relativi a un canale specifico o al canale dell'utente corrente.

    Puoi utilizzare i link in questa sezione per completare l'Explorer API con valori di esempio per il tuo caso d'uso o per aprire l'Explorer API a schermo intero con questi valori già compilati. Lo scopo di queste modifiche è semplificare 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.

• Anche lo strumento per gli esempi di codice è stato aggiornato con una nuova UI che offre tutte le stesse funzionalità descritte in precedenza. Utilizzando questo strumento, puoi esplorare i casi d'uso per diversi metodi, caricare valori in Explorer API e aprire l'Explorer API a schermo intero per ottenere esempi di codice in Java, JavaScript, PHP e Python.

  In concomitanza con questa modifica, sono state rimosse le pagine che in precedenza elencavano gli esempi di codice disponibili per Java, JavaScript, PHP e Python.

• Le guide rapide per Java, JavaScript, PHP e Python sono state aggiornate. Le guide riviste spiegano come eseguire un esempio con una chiave API e un altro esempio con un ID client OAuth 2.0 utilizzando esempi di codice di Explorer API.

Tieni presente che le modifiche descritte sopra sostituiscono uno strumento interattivo che è stato aggiunto alla documentazione dell'API nel 2017.

9 luglio 2018

Questo aggiornamento contiene le seguenti modifiche:

• La definizione della proprietà snippet.thumbnails della risorsa channel è stata aggiornata per tenere presente che, quando visualizzi le miniature nella tua applicazione, il codice deve utilizzare gli URL immagine esattamente come vengono restituiti nelle risposte dell'API. Ad esempio, la tua applicazione non deve utilizzare il dominio http anziché il dominio https in un URL restituito in una risposta dell'API.

  A partire da luglio 2018, gli URL delle miniature dei canali saranno disponibili solo nel dominio https, che è il modo in cui gli URL vengono visualizzati nelle risposte dell'API. Dopodiché, potresti visualizzare immagini non funzionanti nella tua applicazione se tenta di caricare immagini di YouTube dal dominio http.

• Nota: questo è un annuncio relativo al ritiro.

  La proprietà recordingDetails.location.altitude della risorsa video è stata deprecata. Non vi è alcuna garanzia che i video restituiscano valori per questa proprietà. Allo stesso modo, anche se le richieste API tentano di impostare un valore per quella proprietà, è possibile che i dati in entrata non vengano archiviati.

22 giugno 2018

La Guida all'implementazione, precedentemente nota come La guida all'implementazione e alla migrazione è stata aggiornata in modo da rimuovere le istruzioni per la migrazione dalla dall'API v2 all'API v3. Sono state inoltre rimosse le istruzioni per le funzionalità con sono state ritirate nell'API v3, come i video preferiti.

27 novembre 2017

Questo aggiornamento contiene le seguenti modifiche:

• Nota: questo è un annuncio relativo al ritiro.

  YouTube rimuoverà il supporto per le funzionalità Video in primo piano e Sito web in primo piano, che sono supportate nell'API tramite l'oggetto invideoPromotion della risorsa channel. Di conseguenza, l'oggetto in questione, incluse tutte le sue proprietà secondarie, verrà ritirato.

  Puoi recuperare e impostare i dati di invideoPromotion fino al 14 dicembre 2017. Dopo questa data:

  • Se provi a recuperare la parte invideoPromotion durante la chiamata a channels.list, verrà restituito un valore invideoPromotion vuoto o non verranno restituiti dati invideoPromotion.
  • I tentativi di aggiornare i dati di invideoPromotion durante la chiamata a channels.update restituiranno una risposta corretta almeno fino al 27 maggio 2018, ma verranno trattati come autonomi, il che significa che non eseguiranno effettivamente un aggiornamento.

  Dopo il 27 maggio 2018, è possibile che queste richieste restituiscano messaggi di errore che indicano, ad esempio, che invalidPromotion non è una parte non valida.

16 novembre 2017

Questo aggiornamento contiene le seguenti modifiche:

• Lo strumento interattivo snippet di codice ora supporta gli esempi di codice Node.js. Gli esempi sono visibili anche nella documentazione per quasi tutti i metodi dell'API, come il metodo channels.list.

  Gli esempi personalizzabili sono progettati per offrirti un punto di partenza specifico per il caso d'uso per un'applicazione Node.js. La funzionalità è simile a quella del codice nella guida rapida a Node.js. Tuttavia, gli esempi contengono alcune funzioni di utilità che non compaiono nella guida rapida:

  • La funzione removeEmptyParameters prende un elenco di coppie chiave-valore corrispondenti ai parametri della richiesta API e rimuove i parametri che non hanno valori.
  • La funzione createResource prende un elenco di coppie chiave/valore corrispondenti alle proprietà in una risorsa API. Quindi converte le proprietà in un oggetto JSON che può essere utilizzato nelle operazioni insert e update. L'esempio seguente mostra un insieme di nomi e valori delle proprietà e l'oggetto JSON che il codice creerebbe per esse:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Tutti questi esempi sono progettati per essere scaricati ed eseguiti localmente. Per ulteriori informazioni, consulta i prerequisiti per l'esecuzione di esempi di codice completi in locale nelle istruzioni dello strumento per gli snippet di codice.

25 ottobre 2017

Questo aggiornamento contiene le seguenti modifiche:

• Gli esempi di codice Python nello strumento interattivo snippet di codice sono stati aggiornati in modo da utilizzare le librerie google-auth e google-auth-oauthlib anziché la libreria oauth2client, che ora è deprecata.

  Oltre a questa modifica, lo strumento ora fornisce esempi di codice completi per le applicazioni Python installate e per le applicazioni server web Python, che utilizzano flussi di autorizzazione leggermente diversi. Per vedere gli esempi completi (e la modifica):

  1. Vai allo strumento interattivo snippet di codice o alla documentazione per qualsiasi metodo API, ad esempio il metodo channels.list.
  2. Fai clic sulla scheda Python sopra gli esempi di codice.
  3. Fai clic sul pulsante di attivazione/disattivazione sopra le schede per passare dalla visualizzazione di uno snippet a un esempio completo.
     
  4. A questo punto, la scheda dovrebbe mostrare un esempio di codice completo che utilizza il flusso di autorizzazione InstalledAppFlow. La descrizione sopra l'esempio spiega tutto questo e contiene un link a un esempio per un'applicazione server web.
  5. Fai clic sul link per passare all'esempio del server web. Questo esempio utilizza il framework dell'applicazione web Flask e un flusso di autorizzazione diverso.

  Tutti questi esempi sono progettati per essere scaricati ed eseguiti localmente. Se vuoi eseguire gli esempi, consulta le istruzioni per eseguire gli esempi di codice completi in locale nelle istruzioni dello strumento per gli snippet di codice.

29 agosto 2017

Questo aggiornamento contiene le seguenti modifiche:

• La definizione del parametro forContentOwner del metodo search.list è stata aggiornata per notare che se tale parametro è impostato su true, il parametro type deve essere impostato su video.
• La definizione del parametro regionCode del metodo search.list è stata aggiornata per chiarire che il parametro limita i risultati di ricerca ai video che possono essere visualizzati nella regione specificata.
• YouTube ha aggiornato i propri loghi e le proprie icone di branding. Nuovo "sviluppato con YouTube" i loghi possono essere scaricati dalla pagina delle linee guida per il branding. In questa pagina vengono visualizzati anche altri nuovi loghi e icone di YouTube e puoi scaricarli dal sito del brand YouTube.

24 luglio 2017

Questo aggiornamento contiene le seguenti modifiche:

• È disponibile una nuova guida rapida alle API di dati di YouTube per iOS. La guida spiega come utilizzare la YouTube Data API in una semplice applicazione per iOS scritta in Objective-C o Swift.
• Lo strumento interattivo snippet di codice per l'API di dati di YouTube ora include la documentazione che spiega alcune delle funzionalità dello strumento:
  .
  • Esecuzione delle richieste API
  • Passare dagli snippet di codice agli esempi di codice completi e viceversa
  • Utilizzare le funzioni boilerplate
  • Caricamento delle risorse esistenti (per i metodi di aggiornamento)

  Nota:lo strumento è incorporato anche nella documentazione di riferimento delle API per i metodi dell'API (esempio).

1 giugno 2017

Questo aggiornamento contiene le seguenti modifiche:

• Nota: questo è un annuncio relativo al ritiro.

  Le seguenti proprietà delle risorse video sono deprecate. Sebbene le proprietà saranno supportate fino al 1° dicembre 2017, non vi è alcuna garanzia che i video continueranno a restituire valori per queste proprietà fino a quel momento. Allo stesso modo, le richieste videos.insert e videos.update che impostano i valori di queste proprietà non genereranno errori prima di questa data, ma è possibile che i dati in arrivo non vengano archiviati.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 maggio 2017

Questo aggiornamento contiene le seguenti modifiche:

• La documentazione di riferimento delle API è stata aggiornata per rendere gli snippet di codice più onnipresenti e interattivi. Le pagine che spiegano i metodi delle API, come channels.list o videos.rate, ora dispongono di uno strumento interattivo che consente di visualizzare e personalizzare gli snippet di codice in Java, JavaScript, PHP, Python, Ruby, Apps Script e Go.

  Per ogni metodo specifico, lo strumento mostra snippet di codice per uno o più casi d'uso e ogni caso d'uso descrive un modo comune per chiamare quel metodo. Ad esempio, puoi chiamare il metodo channels.list per recuperare i dati relativi a un canale specifico o al canale dell'utente corrente.

  Puoi anche interagire con esempi di codice:

  • Modificando i valori dei parametri e delle proprietà, gli snippet di codice verranno aggiornati in modo dinamico per riflettere i valori forniti.

  • Passa dagli snippet di codice agli esempi completi e viceversa. Uno snippet di codice mostra la porzione di codice che chiama il metodo API. Un esempio completo contiene questo snippet e il codice boilerplate per l'autorizzazione e l'invio delle richieste. Gli esempi completi possono essere copiati ed eseguiti dalla riga di comando o da un server web locale.

  • Esegui le richieste facendo clic su un pulsante. Per eseguire le richieste, devi autorizzare lo strumento a chiamare l'API per tuo conto.

  Tieni presente che questo strumento ha sostituito Explorer API nelle pagine in cui è disponibile. Ogni pagina mostra un link in modo che tu abbia anche la possibilità di caricare la richiesta su cui stai lavorando in Explorer API.

• Anche lo strumento Snippet di codice delle API di dati è stato aggiornato con una nuova UI che offre tutte le stesse funzionalità descritte in precedenza. Le principali nuove funzionalità disponibili in questa pagina sono:

  • Supporto per le richieste API che scrivono dati.
  • Supporto per gli esempi Java.
  • Codice boilerplate più flessibile e completo per l'autorizzazione degli utenti e la creazione di richieste API.

27 aprile 2017

Questo aggiornamento contiene le seguenti modifiche:

• Nuove guide rapide spiegano come configurare un'applicazione semplice che effettui richieste di API di dati di YouTube. Al momento sono disponibili guide per Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python e Ruby.

30 marzo 2017

Questo aggiornamento contiene le seguenti modifiche:

• La nuova proprietà topicDetails.topicCategories[] della risorsa channel contiene un elenco di URL di Wikipedia che descrivono i contenuti del canale. Gli URL corrispondono agli ID argomento restituiti nella proprietà topicDetails.topicIds[] della risorsa.
• La nuova proprietà contentDetails.videoPublishedAt della risorsa playlistItem identifica la data e l'ora in cui il video è stato pubblicato su YouTube. La risorsa contiene già la proprietà snippet.publishedAt, che identifica l'ora in cui l'elemento è stato aggiunto alla playlist.
• Come la risorsa channel, la risorsa video ora restituisce la proprietà topicDetails.topicCategories[], che contiene un elenco di URL di Wikipedia che descrivono i contenuti del video. Per le risorse video, gli URL corrispondono agli ID argomento restituiti nella proprietà topicDetails.relevantTopicIds[] della risorsa.
• La nuova proprietà contentDetails.contentRating.mpaatRating della risorsa video identifica la valutazione che la Motion Picture Association of America ha assegnato a un trailer o a un'anteprima di un film.

27 febbraio 2017

Come originariamente annunciato l'11 agosto 2016, YouTube ha trasformato l'elenco supportato di ID argomento in un elenco selezionato. L'elenco completo degli ID argomento supportati è incluso nelle proprietà topicDetails per le risorse channel e video, nonché nel parametro topicId del metodo search.list.

Tieni presente che sono state apportate diverse modifiche all'elenco selezionato:

• I seguenti argomenti sono stati aggiunti come argomenti secondari di Society:

  Nome	ID argomento
  Attività commerciale	/m/09s1f
  Salute	/m/0kt51
  Forze armate	/m/01h6rj
  Politica	/m/05qt0
  Religione	/m/06bvp

• L'argomento Animated cartoon, in precedenza un argomento secondario di Entertainment, è stato rimosso.
• L'argomento Children's music, in precedenza un argomento secondario di Music, è stato rimosso.

In seguito a questa modifica, gli argomenti relativi a un video vengono ora sempre restituiti nel valore della proprietà topicDetails.relevantTopicIds[] della risorsa video.

29 novembre 2016

Questo aggiornamento contiene le seguenti modifiche:

• Sono state apportate tre piccole modifiche all'elenco di ID argomento che saranno supportati a partire dal 10 febbraio 2017:

  • La categoria Professional wrestling, che in precedenza era secondaria della categoria Sports, ora è secondaria di Entertainment.
  • La categoria TV shows, che è secondaria rispetto a Entertainment, è nuova.
  • La categoria Health, precedentemente secondaria di Lifestyle, è stata rimossa.

  Tieni inoltre presente che esistono alcune categorie principali (Entertainment, Gaming, Lifestyle, Music e Sports). Tutti i video associati a una categoria secondaria, come Tennis, verranno associati anche alla categoria principale (Sports).

10 novembre 2016

Questo aggiornamento contiene le seguenti modifiche:

• Come annunciato per la prima volta l'11 agosto 2016, il ritiro di Freebase e dell'API Freebase richiede diverse modifiche relative agli ID argomento. Gli ID argomento identificano gli argomenti associati alle risorse channel e video. Inoltre, puoi utilizzare il parametro di ricerca topicId per trovare canali o video correlati a un determinato argomento.

  A partire dal 10 febbraio 2017, YouTube inizierà a restituire un piccolo insieme di ID argomento invece dell'insieme molto più granulare di ID restituiti finora. Inoltre, non è garantito che i canali e i video siano associati ad alcun argomento, in linea con il comportamento attuale dell'API.

  Per consentirti di preparare i tuoi client API a queste modifiche, le definizioni dei seguenti parametri e proprietà dell'API sono state aggiornate in modo da elencare gli ID argomento che saranno supportati successivamente. Tieni presente che l'elenco delle categorie è lo stesso per tutte le proprietà.

  • Proprietà topicDetails.topicIds[] della risorsa channel.
  • Proprietà topicDetails.relevantTopicIds[] della risorsa video.
  • Parametro topicId del metodo search.list.

• Nota: questo è un annuncio relativo al ritiro.

  Le seguenti proprietà verranno ritirate:

  • Proprietà topicDetails.topicIds[] della risorsa channel. Questa proprietà sarà supportata fino al 10 novembre 2017.
  • Proprietà topicDetails.relevantTopicIds[] della risorsa video. Questa proprietà sarà supportata fino al 10 novembre 2017.
  • Proprietà topicDetails.topicIds[] della risorsa video. Questa proprietà non conterrà valori dopo il 10 febbraio 2017. Dopo questa data, il valore della proprietà topicDetails.relevantTopicIds[] identificherà tutti gli argomenti associati a un video.

• Poiché Freebase è già stato deprecato, la guida Ricerca con Freebase Topics è stata rimossa dalla documentazione. Quella guida ha fornito esempi di codice per mostrare come un'applicazione funzionerebbe con l'API Freebase.

  Inoltre, sono stati rimossi diversi esempi di codice relativi agli ID argomento dalla documentazione del metodo search.list.

2 novembre 2016

Questo aggiornamento contiene le seguenti modifiche:

• Nuove proprietà e nuovi parametri

  • La risorsa video contiene diverse nuove proprietà:

    • La proprietà player.embedHtml contiene un tag <iframe> che puoi utilizzare per incorporare un player che riproduce il video. Le nuove proprietà player.embedHeight e player.embedWidth identificano le dimensioni del player incorporato. Queste proprietà vengono restituite solo se la richiesta API specifica un valore per almeno uno dei parametri maxHeight o maxWidth. Questi due nuovi parametri vengono spiegati più avanti in questa voce della cronologia delle revisioni.

    • La nuova proprietà hasCustomThumbnail indica se l'utente che ha caricato il video ha fornito un'immagine di miniatura personalizzata per il video. Tieni presente che questa proprietà è visibile solo all'utente che ha caricato il video.

    • Il nuovo fpbRatingReasons[] identifica i motivi per cui il video ha ricevuto la classificazione FPB (Sudafrica).

    • Il nuovo mcstRating identifica la classificazione ricevuta dal video in Vietnam.

  • Il metodo videos.list supporta due nuovi parametri, maxHeight e maxWidth. Puoi utilizzare uno o entrambi i parametri durante il recupero della parte player nelle risorse video.

    Per impostazione predefinita, l'altezza di <iframe> restituito nella proprietà player.embedHtml è 360 px. La larghezza si regola in modo da corrispondere alle proporzioni del video, assicurando così che il player incorporato non abbia barre nere che inquadri il video. Quindi, ad esempio, se le proporzioni di un video sono 16:9, la larghezza del player sarà di 640 px.

    Con i nuovi parametri, puoi specificare che, anziché le dimensioni predefinite, il codice di incorporamento deve utilizzare un'altezza e/o una larghezza appropriate per il layout della tua applicazione. Il server API ridimensiona le dimensioni del player in modo appropriato per fare in modo che il player incorporato non presenti barre nere che inquadri il video. Tieni presente che entrambi i parametri specificano le dimensioni massime del player incorporato. Di conseguenza, se vengono specificati entrambi i parametri, una dimensione potrebbe essere comunque inferiore al limite massimo consentito per quella dimensione.

    Ad esempio, supponiamo che un video abbia proporzioni 16:9. Pertanto, il tag player.embedHtml conterrebbe un player 640 x 360 se il parametro maxHeight o maxWidth non è impostato.

    • Se il parametro maxHeight è impostato su 720 e il parametro maxWidth non è impostato, l'API restituisce un player 1280 x 720.
    • Se il parametro maxWidth è impostato su 960 e il parametro maxHeight non è impostato, l'API restituisce un player 960 x 540.
    • Se il parametro maxWidth è impostato su 960 e il parametro maxHeight è impostato su 450, l'API restituisce un player 800 x 450.

    Le nuove proprietà player.embedHeight e player.embedWidth, descritte in precedenza, identificano le dimensioni del player.

• Aggiornamenti a metodi, proprietà e parametri esistenti

  • La descrizione della risorsa channelSection è stata aggiornata per indicare che un canale può creare un massimo di 10 sezioni senza impostare i dati di targeting e un massimo di 100 sezioni con dati di targeting.

    Inoltre, la proprietà targeting della risorsa channelSection è stata aggiornata per riflettere il fatto che le opzioni di targeting possono essere impostate solo utilizzando l'API. Le opzioni di targeting vengono eliminate se la sezione del canale viene modificata utilizzando l'interfaccia utente sul sito web di YouTube.

  • La definizione della proprietà snippet.name della risorsa i18nLanguage è stata corretta per riflettere il fatto che il valore rappresenta il nome di una lingua così come è scritto nella lingua specificata dal parametro hl del metodo i18nLanguage.list.

  • La proprietà contentDetails.note della risorsa playlistItem è stata aggiornata per indicare che la lunghezza massima del valore della proprietà è di 280 caratteri.

  • Le proprietà contentDetails.startAt e contentDetails.endAt della risorsa playlistItem sono state deprecate. Questi campi vengono ignorati se sono impostati nelle richieste playlistItems.insert o playlistItems.update.

  • I metodi playlistItems.delete e playlistItems.update ora supportano il parametro onBehalfOfContentOwner, già supportato per diversi altri metodi. Anche le richieste che utilizzano questo metodo devono essere autorizzate con un token che fornisca l'accesso all'ambito https://www.googleapis.com/auth/youtubepartner.

  • I parametri publishedBefore e publishedAfter del metodo search.list sono stati entrambi aggiornati per indicare che i valori parametro sono inclusi. Pertanto, ad esempio, se il parametro publishedBefore è impostato, l'API restituisce le risorse create prima o all'ora specificata.

  • La proprietà contentDetails.contentRating.grfilmRating della risorsa video supporta tre valori aggiuntivi: grfilmK12, grfilmK15 e grfilmK18.

  • La descrizione del metodo videos.insert è stata aggiornata per notare che la dimensione massima dei file per i video caricati è aumentata da 64 a 128 GB.

• Errori nuovi e aggiornati

  • L'API supporta i seguenti nuovi errori:

    Tipo di errore	Dettagli dell'errore	Descrizione
    forbidden (403)	homeParameterDeprecated	Il metodo activities.list restituisce questo errore per indicare che i dati relativi all'attività nella home page dell'utente non sono disponibili tramite questa API. Questo errore può verificarsi se imposti il parametro home su true in una richiesta non autorizzata.
    invalidValue (400)	invalidContentDetails	Il metodo playlistItems.insert restituisce questo errore per indicare che l'oggetto contentDetails nella richiesta non è valido. Uno dei motivi per cui si verifica questo errore è che il campo contentDetails.note contiene più di 280 caratteri.
    forbidden (403)	watchHistoryNotAccessible	Il metodo playlistItems.list restituisce questo errore per indicare che la richiesta ha tentato di recuperare la "cronologia delle visualizzazioni" elementi della playlist, ma non è possibile recuperarli tramite l'API.
    forbidden (403)	watchLaterNotAccessible	Il metodo playlistItems.list restituisce questo errore per indicare che la richiesta ha tentato di recuperare "Guarda più tardi" elementi della playlist, ma non è possibile recuperarli tramite l'API.
    badRequest (400)	uploadLimitExceeded	Il metodo videos.insert restituisce questo errore per indicare che il canale ha superato il numero di video che può caricare.
    forbidden (403)	forbiddenEmbedSetting	Il metodo videos.update restituisce questo errore per indicare che la richiesta API tenta di impostare un'impostazione di incorporamento non valida per il video. Tieni presente che alcuni canali potrebbero non disporre delle autorizzazioni necessarie per offrire player incorporati per i live streaming. Consulta il Centro assistenza YouTube per ulteriori informazioni.

  • Il metodo playlistItems.insert non restituisce più un errore se inserisci un video duplicato in una playlist. Questo errore si è verificato in precedenza per alcune playlist, come i video preferiti, che non consentivano duplicati ma non sono più supportate. In generale, le playlist consentono la presenza di video duplicati.

• Altri aggiornamenti

  • La voce della cronologia delle revisioni relativa al 15 settembre 2016 è stata aggiornata per chiarire che, ogni volta che le proprietà contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater della risorsa channel vengono incluse in una risposta, queste contengono sempre i valori rispettivamente HL e WL. Inoltre, queste proprietà vengono incluse solo se un utente autorizzato sta recuperando dati sul proprio canale.

15 settembre 2016

Questo aggiornamento contiene le seguenti modifiche:

• L'aggiornamento della cronologia delle revisioni dell'11 agosto 2016 ha discusso di diverse modifiche relative agli ID argomento, tra cui il fatto che l'insieme di ID degli argomenti supportati cambierà a partire dal 10 febbraio 2017. L'elenco degli argomenti che saranno supportati verrà pubblicato entro il 10 novembre 2016.

• Le modifiche seguenti sono ora effettive. Avviso relativo a queste modifiche fornito nell'aggiornamento della cronologia delle revisioni l'11 agosto 2016:

  • Se il metodo activities.list viene chiamato con il parametro home impostato su true, la risposta dell'API ora contiene elementi simili a quelli che un utente di YouTube disconnesso potrebbe vedere sulla home page.

    Si tratta di una piccola modifica che ha lo scopo di offrire un'esperienza utente migliore rispetto al comportamento descritto nell'aggiornamento della cronologia delle revisioni dell'11 agosto 2016. Questo aggiornamento aveva dichiarato che le richieste che utilizzavano il parametro home avrebbero restituito un elenco vuoto.

  • Le proprietà contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater della risorsa channel ora contengono rispettivamente i valori HL e WL per tutti i canali.

    Precisiamo che queste proprietà sono visibili solo a un utente autorizzato che recupera i dati relativi al proprio canale. Le proprietà contengono sempre i valori HL e WL, anche per un utente autorizzato che recupera dati sul proprio canale. Di conseguenza, non è possibile recuperare tramite l'API la cronologia delle visualizzazioni e gli ID playlist Guarda più tardi.

    Inoltre, le richieste di recupero dei dettagli della playlist (playlists.list) o degli elementi della playlist (playlistItems.list) per la cronologia delle visualizzazioni o la playlist Guarda più tardi di un canale ora restituiscono elenchi vuoti. Questo comportamento è valido per i nuovi valori, HL e WL, nonché per qualsiasi ID playlist della cronologia delle visualizzazioni o della playlist Guarda più tardi che il client API potrebbe aver già memorizzato.

• L'oggetto fileDetails.recordingLocation della risorsa video e le relative proprietà figlio non vengono più restituiti. In precedenza, questi dati (come l'oggetto fileDetails principale) potevano essere recuperati solo dal proprietario di un video.

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

• I nuovi Termini di servizio dei servizi API di YouTube ("i Termini aggiornati"), discussi in dettaglio sul Blog di YouTube Engineering and Developers, forniscono un'ampia gamma di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto per spiegare le norme che gli sviluppatori devono seguire.

  L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti di supporto verranno spiegate anche nella cronologia delle revisioni. Puoi iscriverti a un feed RSS che elenca le modifiche nella cronologia delle revisioni da un link nel documento.

• Il ritiro di Freebase e dell'API Freebase sta causando diverse modifiche relative agli ID argomento. Gli ID argomento vengono utilizzati nelle risorse e nei metodi dell'API seguenti:

  • La parte topicDetails della risorsa channel identifica gli argomenti associati al canale.
  • La parte topicDetails della risorsa video identifica gli argomenti associati al video.
  • Il parametro topicId del metodo search.list ti consente di cercare video o canali correlati a un determinato argomento.

  Le modifiche a queste funzionalità sono:

  • A partire dal 10 febbraio 2017, YouTube inizierà a restituire un piccolo insieme di ID argomento invece dell'insieme molto più granulare di ID restituiti finora. Questo insieme di argomenti supportati identificherà categorizzazioni di alto livello come Sport o Basket ma, ad esempio, non identificherà squadre o giocatori specifici. Annunceremo l'insieme di argomenti supportati in modo che tu abbia il tempo di preparare la tua domanda per questo cambiamento.

  • Qualsiasi ID argomento di Freebase che hai già recuperato può essere utilizzato per cercare contenuti fino al 10 febbraio 2017. Tuttavia, una volta trascorso questo periodo di tempo, potrai utilizzare solo il gruppo più piccolo di argomenti identificato nell'elemento precedente per recuperare i risultati di ricerca per argomento.

  • Dopo il 10 febbraio 2017, se tenti di cercare risultati utilizzando un ID argomento non incluso nell'insieme più piccolo di ID argomento supportato, l'API restituirà un set di risultati vuoto.

• Diversi campi e parametri dell'API verranno ritirati a partire dal 12 settembre 2016:

  • Il parametro home del metodo activities.list consentiva a un utente autorizzato di recuperare il feed attività che sarebbe stato visualizzato sulla home page di YouTube per quell'utente. Per le richieste che utilizzano questo parametro dopo il 12 settembre 2016 viene restituito un elenco vuoto.

  • Le proprietà contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater della risorsa channel sono visibili solo a un utente autorizzato che recupera dati sul canale dell'utente. Dopo il 12 settembre 2016, contentDetails.relatedPlaylists.watchHistory restituirà il valore HL e la proprietà contentDetails.relatedPlaylists.watchLater restituirà il valore WL per tutti i canali.

    Le richieste di recupero dei dettagli della playlist (playlists.list) per la cronologia delle visualizzazioni di un canale o la playlist Guarda più tardi restituiranno un elenco vuoto a partire dal 12 settembre 2016. Anche le richieste di recupero degli elementi playlist (playlistItems.list) in una di queste playlist restituiranno un elenco vuoto al termine di questo periodo. Questo vale per i nuovi valori, HL e WL, nonché per qualsiasi ID playlist della cronologia delle visualizzazioni o della sezione Guarda più tardi che il client API potrebbe aver già memorizzato.

  • Dopo il 12 settembre 2016, non verrà più restituito l'oggetto fileDetails.recordingLocation della risorsa video né alcuna delle sue proprietà figlio. Questi dati possono essere recuperati solo dal proprietario di un video poiché l'oggetto fileDetails principale può essere recuperato solo da un proprietario del video.

13 giugno 2016

Questo aggiornamento contiene le seguenti modifiche:

• La proprietà contentDetails.googlePlusUserId della risorsa channel è stata deprecata. In precedenza, la proprietà era presente solo se il canale era associato a un profilo Google+. In seguito al ritiro, la proprietà non sarà più inclusa in nessuna risorsa di channel.

• La proprietà snippet.authorGoogleplusProfileUrl della risorsa comment è stata deprecata. In precedenza, la proprietà era presente solo se il canale era associato a un profilo Google+. In seguito al ritiro, la proprietà non sarà più inclusa in nessuna risorsa di comment.

Poiché nessuna di queste proprietà verrà restituita in seguito al ritiro, entrambe le proprietà sono state rimosse dalla documentazione della risorsa corrispondente.

31 maggio 2016

Questo aggiornamento contiene le seguenti modifiche:

• Il nuovo parametro myRecentSubscribers del metodo subscriptions.list recupera un elenco degli iscritti al canale dell'utente autenticato in ordine cronologico inverso rispetto alla data in cui si sono iscritti al canale.

  Tieni presente che il nuovo parametro supporta solo il recupero degli ultimi 1000 iscritti al canale dell'utente autenticato. Per recuperare un elenco completo degli abbonati, utilizza il parametro mySubscribers. Questo parametro, che non restituisce i sottoscrittori in un determinato ordine, non limita il numero di sottoscrittori che è possibile recuperare.

• La definizione della proprietà snippet.thumbnails.(key) è stata aggiornata per le risorse attività, playlistItem, playlist, risultato di ricerca, miniatura e video per tenere presente che per alcuni video sono disponibili dimensioni aggiuntive delle immagini in miniatura.

  • L'immagine standard è larga 640 px e alta 480 px.
  • L'immagine maxres è larga 1280 px e alta 720 px.

• La definizione del parametro part del metodo channelSection.list è stata aggiornata per notare che la parte targeting può essere recuperata al costo di 2 unità di quota.

• Il metodo videos.list ora restituisce un errore forbidden (403) quando una richiesta non autorizzata cerca di recuperare le parti fileDetails, processingDetails o suggestions di una risorsa video. Queste parti sono disponibili solo per il proprietario del video.

17 maggio 2016

Il nuovo strumento Snippet di codice delle API di dati fornisce brevi snippet di codice per i casi d'uso più comuni delle API di dati di YouTube. Gli snippet di codice sono attualmente disponibili per tutti i metodi dell'API di sola lettura in Apps Script, Go, JavaScript, PHP, Python e Ruby.

Per ogni metodo, lo strumento mostra esempi di codice per uno o più casi d'uso. Ad esempio, fornisce cinque snippet di codice per il metodo search.list:

• Elenca i video per parola chiave
• Elenca i video per località
• Elenca eventi dal vivo
• Cerca i video dell'utente autenticato
• Elencare i video correlati

Per ogni caso d'uso, lo strumento visualizza i parametri utilizzati nella richiesta API. Puoi modificare i valori parametro. In questo caso, lo strumento aggiorna gli snippet di codice per riflettere i valori parametro forniti.

Infine, lo strumento visualizza la risposta API a ogni richiesta. Se hai modificato i parametri della richiesta, la risposta dell'API si basa sui valori parametro forniti. Tieni presente che devi autorizzare lo strumento a inviare richieste per tuo conto affinché vengano visualizzate le risposte dell'API.

28 aprile 2016

Questo aggiornamento contiene le seguenti modifiche:

• La nuova proprietà contentDetails.projection della risorsa video specifica il formato di proiezione del video. I valori validi per la proprietà sono 360 e rectangular.

• Le proprietà recordingDetails.location e fileDetails.recordingLocation della risorsa video sono state aggiornate per spiegare la differenza tra le due proprietà:

  • La proprietà recordingDetails.location identifica la località che il proprietario del video vuole associare al video. Questa località è modificabile, disponibile per la ricerca sui video pubblici e potrebbe essere mostrata agli utenti per i video pubblici.
  • Il valore della proprietà fileDetails.recordingLocation è immutabile e rappresenta la posizione associata al file video originale caricato. Il valore è visibile solo al proprietario del video.

• La definizione della proprietà contentDetails.relatedPlaylists.favorites della risorsa channel è stata aggiornata per notare che il valore della proprietà potrebbe contenere un ID playlist che fa riferimento a una playlist vuota e che non può essere recuperato. Ciò è dovuto al fatto che la funzionalità dei video preferiti è già stata ritirata. Tieni presente che questa proprietà non è soggetta alle norme sul ritiro delle API.

• La definizione dell'errore ineligibleAccount, che può essere restituita dal metodo comments.insert, comments.update, commentThreads.insert o commentThreads.update, è stata aggiornata per indicare che l'errore si verifica quando l'account YouTube utilizzato per autorizzare la richiesta API non è stato unito all'Account Google dell'utente.

20 aprile 2016

Questo aggiornamento contiene le seguenti modifiche:

• La definizione del parametro part del metodo channels.update è stata aggiornata per notare che anche localizations è un valore valido per questo parametro.

• La sezione Utilizzo della quota della Guida introduttiva è stata aggiornata in modo da creare un link a Google Developers Console, dove puoi visualizzare la tua quota e l'utilizzo effettivo della quota.

16 marzo 2016

Questo aggiornamento contiene le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • La documentazione della risorsa channelBanner è stata aggiornata: tieni presente che le dimensioni consigliate per l'immagine del banner del canale caricata sono 2560 x 1440 px. Le dimensioni minime (2048 x 1152 px) non sono cambiate.

  • La nuova proprietà snippet.customUrl della risorsa channel identifica l'URL personalizzato associato al canale. Non tutti i canali hanno un URL personalizzato. Nel Centro assistenza YouTube vengono illustrati i requisiti di idoneità necessari per ottenere un URL personalizzato e le modalità di configurazione dell'URL.

  • L'oggetto brandingSettings.watch della risorsa channel e tutte le relative proprietà secondarie sono stati deprecati.

  • La risposta dell'API a una richiesta search.list ora contiene una proprietà regionCode. La proprietà identifica il codice regione utilizzato per la query di ricerca. Il codice regione indica all'API di restituire i risultati di ricerca per il paese specificato.

    Il valore della proprietà è un codice paese ISO di due lettere che identifica la regione. Il metodo i18nRegions.list restituisce un elenco di regioni supportate. Il valore predefinito è US. Se viene specificata una regione non supportata, YouTube potrebbe comunque selezionare un'altra regione, anziché il valore predefinito, per gestire la query.

  • Le definizioni delle proprietà snippet.label e snippet.secondaryReasons[].label della risorsa videoAbuseReportReason sono state aggiornate per indicare che contengono testo di etichette localizzate per i motivi della segnalazione di abusi.

    Inoltre, il metodo videoAbuseReportReasons.list ora supporta il parametro hl, che specifica la lingua da utilizzare per il testo dell'etichetta nella risposta dell'API. Il valore predefinito del parametro è en_US.

  • La nuova proprietà contentDetails.contentRating.ecbmctRating della risorsa video identifica la valutazione di un video rilasciata dall'Evaluation and Classification Board del Ministero della cultura e del turismo della Turchia.

    Inoltre, le proprietà API per altri sistemi di valutazione supportano i seguenti nuovi valori delle proprietà:

    • contentDetails.contentRating.fpbRating (Sudafrica)
      Valutazione: 10; valore proprietà: fpb10
    • contentDetails.contentRating.moctwRating (Taiwan)
      Classificazione: R-12; valore proprietà: moctwR12
    • contentDetails.contentRating.moctwRating (Taiwan)
      Classificazione: R-15; valore proprietà: moctwR15

  • La proprietà liveStreamingDetails.activeLiveChatId della risorsa video contiene l'ID della chat live attiva associata al video. Il valore della proprietà è presente solo se il video è una trasmissione live corrente in cui è attivata la chat dal vivo. Al termine della trasmissione e della chat live, la proprietà non viene più restituita per il video.

  • La proprietà status.rejectionReason della risorsa video supporta il nuovo valore della proprietà legal.

• L'API supporta i seguenti nuovi errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest (400)	notEditable	I metodi channelSections.insert, channelSections.update e channelSections.delete restituiscono questo errore per indicare che non è possibile creare, aggiornare o eliminare la sezione del canale specificata.
  badRequest (400)	styleRequired	I metodi channelSections.insert e channelSections.update restituiscono questo errore per indicare che la risorsa channelSection inviata nella richiesta API deve specificare un valore per la proprietà snippet.style.
  badRequest (400)	typeRequired	I metodi channelSections.insert e channelSections.update restituiscono questo errore per indicare che la risorsa channelSection inviata nella richiesta API deve specificare un valore per la proprietà snippet.type.
  badRequest (400)	processingFailure	Il metodo commentThreads.list restituisce questo errore per indicare che il server API non è riuscito a elaborare la richiesta. Sebbene possa trattarsi di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa commentThread nel corpo della richiesta per verificare che sia valida.
  forbidden (403)	commentsDisabled	Il metodo commentThreads.list restituisce questo errore per indicare che il video identificato dal parametro videoId ha disattivato i commenti.
  badRequest (400)	commentTextTooLong	Il metodo commentThreads.insert restituisce questo errore per indicare che la risorsa comment che viene inserita contiene troppi caratteri nella proprietà snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Il metodo playlistItems.insert restituisce questo errore per indicare che il video che stai tentando di aggiungere alla playlist si trova già in un'altra playlist della serie. Consulta il Centro assistenza YouTube per ulteriori informazioni sulle playlist delle serie.
  badRequest (400)	subscriptionForbidden	Il metodo subscriptions.insert restituisce questo errore per indicare che hai raggiunto il numero massimo di abbonamenti o che hai creato troppe iscrizioni recenti. Nel secondo caso, puoi riprovare la richiesta dopo alcune ore.
  badRequest (400)	invalidCategoryId	Il metodo videos.update restituisce questo errore per indicare che la proprietà snippet.categoryId nella risorsa video caricata ha specificato un ID categoria non valido. Utilizza il metodo videoCategories.list per recuperare le categorie supportate.
  badRequest (400)	invalidDescription	Il metodo videos.update restituisce questo errore per indicare che la proprietà snippet.description nella risorsa video caricata ha specificato un valore non valido.
  badRequest (400)	invalidPublishAt	Il metodo videos.update restituisce questo errore per indicare che la proprietà status.publishAt nella risorsa video caricata ha specificato un'ora di pubblicazione pianificata non valida.
  badRequest (400)	invalidRecordingDetails	Il metodo videos.update restituisce questo errore per indicare che l'oggetto recordingDetails nella risorsa video caricata ha specificato dettagli di registrazione non validi.
  badRequest (400)	invalidTags	Il metodo videos.update restituisce questo errore per indicare che la proprietà snippet.tags nella risorsa video caricata ha specificato un valore non valido.
  badRequest (400)	invalidTitle	Il metodo videos.update restituisce questo errore per indicare che la proprietà snippet.title nella risorsa video caricata ha specificato un titolo del video non valido o vuoto.
  badRequest (400)	invalidVideoMetadata	Il metodo videos.update restituisce questo errore per indicare che i metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte snippet di una risorsa video ma non imposta un valore per entrambe le proprietà snippet.title e snippet.categoryId.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) impongono di fornire determinate informative agli utenti finali dell'UE e di ottenere il consenso da loro. Pertanto, gli utenti finali nell'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 delle API di YouTube.

19 novembre 2015

L'API ora supporta la possibilità di impostare e recuperare testo localizzato per le proprietà snippet.title e snippet.description delle risorse playlist e video, la proprietà snippet.title della risorsa channelSection e la proprietà snippet.description della risorsa channel.

• Impostare titoli e descrizioni localizzati

  Puoi impostare valori localizzati per una risorsa quando chiami il relativo metodo insert o update. Per impostare valori localizzati per una risorsa, esegui entrambe le seguenti operazioni:

  • Assicurati che sia impostato un valore per la proprietà snippet.defaultLanguage della risorsa. Questa proprietà identifica la lingua delle proprietà snippet.title e snippet.description della risorsa. Il valore può essere qualsiasi lingua supportata per l'applicazione o la maggior parte degli altri codici lingua ISO 639-1:2002. Ad esempio, se carichi un video con titolo e descrizione in inglese, dovresti impostare la proprietà snippet.defaultLanguage su en.

    Nota per l'aggiornamento delle risorse channel: per impostare la proprietà snippet.defaultLanguage per una risorsa channel, in realtà devi aggiornare la proprietà brandingSettings.channel.defaultLanguage.

  • Aggiungi l'oggetto localizations alla risorsa che stai aggiornando. Ogni chiave oggetto è una stringa che identifica una lingua dell'applicazione o un codice lingua ISO 639-1:2002 e ogni chiave viene mappata a un oggetto contenente il titolo (e la descrizione) localizzati della risorsa.

    Lo snippet di esempio riportato di seguito imposta l'inglese come lingua predefinita della risorsa. Inoltre, aggiunge a un video titoli e descrizioni localizzati in tedesco e spagnolo:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Importante:ricorda che quando aggiorni i dati localizzati di una risorsa, la richiesta API deve includere tutte le versioni localizzate esistenti dei dati. Ad esempio, se in seguito hai inviato una richiesta successiva per aggiungere dati in portoghese al video nell'esempio precedente, la richiesta dovrà includere i dati localizzati per il tedesco, lo spagnolo e il portoghese.

• Recupero dei valori localizzati

  L'API supporta due modi per recuperare i valori localizzati di una risorsa:

  • Aggiungi il parametro hl alla richiesta channels.list, channelSections.list, playlists.list o videos.list per recuperare i dati localizzati per una lingua dell'applicazione specifica supportata dal sito web di YouTube. Se i dettagli localizzati della risorsa sono disponibili in quella lingua, l'oggetto snippet.localized della risorsa conterrà i valori localizzati. Tuttavia, se i dettagli localizzati non sono disponibili, l'oggetto snippet.localized conterrà i dettagli della risorsa nella lingua predefinita della risorsa.

    Ad esempio, supponiamo che una richiesta videos.list abbia recuperato dati per il video descritto sopra con dati localizzati in tedesco e spagnolo. Se il parametro hl fosse impostato su de, la risorsa conterrà i seguenti dati:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Tuttavia, se il parametro hl viene impostato su fr, l'oggetto snippet.localized conterrà il titolo e la descrizione in inglese perché l'inglese è la lingua predefinita per la risorsa e i dettagli localizzati in francese non sono disponibili.

    Importante: il parametro hl supporta solo i valori che identificano le lingue dell'applicazione supportate dal sito web di YouTube. Per determinare se il testo localizzato è disponibile per altre lingue, devi recuperare la parte localizations per la risorsa e filtrare per determinare se il testo localizzato esiste.
    
    Ad esempio, devi recuperare l'elenco completo delle localizzazioni per determinare se il testo localizzato è disponibile in inglese degli Appalachi.
    
    

  • Quando recuperi una risorsa, includi localizations nel valore del parametro part per recuperare tutti i dettagli localizzati della risorsa. Se stai recuperando dati localizzati per una lingua diversa dalla lingua corrente dell'applicazione YouTube, devi utilizzare questo approccio per recuperare tutte le localizzazioni, quindi applicare un filtro per determinare se esistono i dati localizzati che ti interessano.

• Errori relativi a valori di testo localizzati

  L'API supporta anche i seguenti nuovi errori per i valori di testo localizzati:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest (400)	defaultLanguageNotSetError	Questo errore indica che una richiesta che tenta di inserire o aggiornare l'oggetto localizations per una risorsa non riesce perché la proprietà snippet.defaultLanguage non è impostata per quella risorsa. I metodi channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert e videos.update supportano questo errore.
  badRequest (400)	localizationValidationError	Questo errore indica che la convalida di uno dei valori nell'oggetto localizations di una risorsa non è riuscita. Ad esempio, questo errore può verificarsi se l'oggetto contiene un codice lingua non valido. I metodi channels.update, channelSections.insert, channelSections.update, playlists.insert e playlists.update supportano questo errore.

4 novembre 2015

Questo aggiornamento contiene le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • Il parametro order del metodo search.list è stato aggiornato per notare che se ordini le trasmissioni live per viewCount, i risultati dell'API sono ordinati in base alle trasmissioni di spettatori simultanei mentre la trasmissione è ancora in corso.

  • Il parametro relatedToVideoId del metodo search.list è stato aggiornato per notare che, se il parametro è impostato, gli unici altri parametri supportati sono part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (che deve essere impostato su video) e fields. Questo aggiornamento non riflette un cambiamento nel comportamento dell'API.

  • La definizione della proprietà snippet.publishedAt della risorsa video è stata aggiornata per notare che il valore della proprietà, che specifica la data e l'ora in cui il video è stato pubblicato, potrebbe essere diverso dall'ora in cui è stato caricato il video. Ad esempio, se un video viene caricato come privato e poi reso pubblico in un secondo momento, il valore della proprietà specifica il momento in cui il video è stato reso pubblico. La definizione aggiornata spiega anche come viene compilato il valore per i video privati e non in elenco.

    Questa modifica non riflette un cambiamento nel comportamento dell'API.

  • La definizione della proprietà status.publishAt della risorsa video è stata aggiornata in modo da tenere presente che:

    • Se imposti il valore di questa proprietà quando chiami il metodo videos.update, devi impostare anche il valore della proprietà status.privacyStatus su private anche se il video è già privato.
    • Se la richiesta prevede la pubblicazione di un video in un determinato momento nel passato, il video viene pubblicato immediatamente. Di conseguenza, l'effetto dell'impostazione di una data e di un'ora passate per la proprietà status.publishAt equivale a quello della modifica del valore privacyStatus del video da private a public.

  • La proprietà contentDetails.contentRating.cncRating della risorsa video specifica la classificazione del video secondo la Commissione di classificazione cinematografica francese. Questa proprietà sostituisce la proprietà contentDetails.contentRating.fmocRating, che ora è deprecata.

  • La definizione dell'elemento brandingSettings.channel.keywords della risorsa channel è stata aggiornata per riflettere correttamente che il valore della proprietà contiene un elenco di stringhe separate da spazi e non un elenco separato da virgole, come documentato in precedenza. Questo aggiornamento non riflette un cambiamento nel comportamento dell'API.

  • La documentazione relativa al metodo thumbnails.set è stata aggiornata per indicare con precisione che il corpo della richiesta contiene l'immagine in miniatura che stai caricando e associando a un video. Il corpo della richiesta non contiene una risorsa thumbnail. In precedenza, la documentazione indicava che non è necessario fornire un corpo della richiesta quando si chiama questo metodo. Questo aggiornamento non riflette un cambiamento nel comportamento dell'API.

  • La descrizione della risorsa activity è stata aggiornata per riflettere il fatto che il metodo activities.list al momento non include risorse correlate ai nuovi commenti dei video. Anche i valori snippet.type e contentDetails.comment della risorsa sono stati aggiornati.

• Errori nuovi e aggiornati

  • L'API ora supporta i seguenti errori:

    Dettagli errore
    activities.insert	Codice risposta HTTP badRequest (400) Motivo invalidMetadata Descrizione La proprietà kind non corrisponde al tipo di ID fornito.
    commentThreads.update comments.insert comments.update	Codice risposta HTTP badRequest (400) Motivo commentTextTooLong Descrizione La risorsa comment che viene inserita o aggiornata contiene troppi caratteri nella proprietà snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Codice risposta HTTP forbidden (403) Motivo playlistItemsNotAccessible Descrizione La richiesta non è autorizzata a inserire, aggiornare o eliminare l'elemento della playlist specificato.
    playlists.delete playlists.insert playlists.update	Codice risposta HTTP badRequest (400) Motivo playlistForbidden Descrizione Questa operazione è vietata o la richiesta non è autorizzata correttamente.
    search.list	Codice risposta HTTP badRequest (400) Motivo invalidLocation Descrizione Il formato del valore del parametro location e/o locationRadius non è corretto.
    search.list	Codice risposta HTTP badRequest (400) Motivo invalidRelevanceLanguage Descrizione Il formato del valore del parametro relevanceLanguage non è corretto.
    subscriptions.insert	Codice risposta HTTP badRequest (400) Motivo subscriptionForbidden Descrizione Questo errore si verifica quando si verifica una delle seguenti condizioni: La sottoscrizione che stai tentando di creare esiste già Hai già raggiunto il numero massimo di abbonamenti Stai cercando di iscriverti a un tuo canale, ma questa operazione non è supportata. Hai creato troppi abbonamenti di recente e devi attendere alcune ore prima di riprovare a inviare la richiesta.
    videos.update	Codice risposta HTTP badRequest (400) Motivo invalidDefaultBroadcastPrivacySetting Descrizione La richiesta tenta di impostare un'impostazione di privacy non valida per la trasmissione predefinita.

28 agosto 2015

Questo aggiornamento contiene le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • La proprietà statistics.favoriteCount della risorsa video è stata deprecata.

    In conformità alle nostre norme sul ritiro, questa proprietà continuerà a essere inclusa nelle risorse di video per almeno un anno dopo questo annuncio. Tuttavia, il valore della proprietà ora è sempre impostato su 0.

7 agosto 2015

Questo aggiornamento contiene le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • La definizione della proprietà snippet.tags[] della risorsa video è stata aggiornata per fornire ulteriori informazioni su come il server API calcola la lunghezza del valore della proprietà. Tieni presente che questo aggiornamento non riflette un cambiamento nel comportamento dell'API.

    Nello specifico, la definizione ora spiega che se un tag contiene uno spazio, il server API gestisce il valore del tag come se fosse racchiuso tra virgolette e che queste ultime vengono conteggiate ai fini del limite di caratteri. Pertanto, ai fini dei limiti di caratteri, il tag Foo-Baz contiene sette caratteri, mentre il tag Foo Baz ne contiene nove.

  • Il metodo commentThreads.insert non supporta più il parametro shareOnGooglePlus, che in precedenza indicava se un commento e le risposte a quel commento dovevano essere pubblicati anche sul profilo Google+ dell'autore. Se una richiesta invia il parametro, il server API ignora il parametro, ma altrimenti gestisce la richiesta.

18 giugno 2015

Questo aggiornamento contiene le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • Il nuovo parametro order del metodo commentThreads.list specifica l'ordine in cui la risposta dell'API deve elencare i thread di commenti. I thread possono essere ordinati in base all'ora o alla pertinenza. Per impostazione predefinita, vengono ordinati in base all'ora.

  • La nuova proprietà snippet.defaultAudioLanguage della risorsa video specifica la lingua parlata nella traccia audio predefinita del video.

  • La definizione della proprietà contentDetails.licensedContent della risorsa video è stata aggiornata per chiarire che i contenuti devono essere stati originariamente caricati su un canale collegato a un partner dei contenuti di YouTube e poi rivendicati da tale partner. Ciò non rappresenta un cambiamento nel comportamento effettivo dell'API.

  • I metodi captions.delete, captions.download, captions.insert, captions.list e captions.update ora supportano il parametro onBehalfOfContentOwner, che è già supportato per diversi altri metodi. Anche le richieste che utilizzano questo metodo devono essere autorizzate con un token che fornisca l'accesso all'ambito https://www.googleapis.com/auth/youtubepartner.

• Errori nuovi e aggiornati

  • L'API ora supporta i seguenti errori:

    Dettagli errore
    videos.rate	Codice risposta HTTP badRequest (400) Motivo emailNotVerified Descrizione L'utente deve verificare il proprio indirizzo email prima di valutare il video.
    videos.rate	Codice risposta HTTP badRequest (400) Motivo videoPurchaseRequired Descrizione Solo gli utenti che li hanno noleggiati possono valutare i video a noleggio.

  • I metodi subscriptions.delete e subscriptions.insert non supportano più gli errori accountClosed e accountSuspended.

27 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

• Nuove risorse e nuovi metodi

  • La nuova risorsa videoAbuseReportReason contiene informazioni su un motivo per cui un video verrebbe segnalato per contenuti illeciti. Il metodo videoAbuseReportReasons.list ti consente di recuperare un elenco di tutti i motivi per cui i video potrebbero essere segnalati.

  • Il nuovo metodo videos.reportAbuse offre un modo per segnalare concretamente un video che include contenuti illeciti. Il corpo della richiesta contiene un oggetto JSON che specifica il video segnalato e il motivo per cui il video viene considerato contenuto illecito. È possibile ottenere motivi validi utilizzando il metodo videoAbuseReportReason.list descritto sopra.

    Anche la guida alla migrazione è stata aggiornata con un esempio di segnalazione di video illeciti. Con questa modifica, l'API v3 ora supporta tutte le funzionalità dell'API v2 che sono pianificate per supportare. Queste funzionalità sono tutte spiegate nella guida alla migrazione.

• Aggiornamenti a risorse e metodi esistenti

  • Il nuovo parametro del filtro forDeveloper del metodo search.list limita una ricerca per recuperare solo i video caricati tramite l'applicazione o il sito web dello sviluppatore. Il parametro forDeveloper può essere utilizzato in combinazione con parametri di ricerca facoltativi come il parametro q.

    Per questa funzionalità, ogni video caricato viene taggato automaticamente con il numero di progetto associato all'applicazione dello sviluppatore in Google Developers Console.

    Quando una richiesta di ricerca imposta in seguito il parametro forDeveloper su true, il server API utilizza le credenziali di autorizzazione della richiesta per identificare lo sviluppatore. Pertanto, uno sviluppatore può limitare i risultati ai video caricati tramite il suo sito web o la sua app, ma non ai video caricati tramite altri siti o app.

    La nuova funzionalità offre funzioni simili, anche se non identiche, a quelle dei tag sviluppatore supportate dall'API v2.

  • La nuova proprietà snippet.country della risorsa channel consente ai proprietari dei canali di associare i propri canali a un determinato paese.

    Nota: per impostare la proprietà snippet.country per una risorsa channel, in realtà devi aggiornare la proprietà brandingSettings.channel.country.

  • L'API ora supporta il targeting per le risorse channelSection. Il targeting per sezione del canale fornisce un modo per limitare la visibilità di una sezione di contenuti agli utenti che corrispondono a determinati criteri.

    L'API presenta tre opzioni di targeting. Affinché una sezione di canale sia visibile, un utente deve soddisfare tutte le impostazioni di targeting.

    • targeting.languages[]: un elenco di lingue dell'applicazione YouTube. Gli utenti che hanno scelto una di queste lingue possono visualizzare la sezione del canale corrispondente.

    • targeting.regions[]: un elenco di regioni di contenuti preferiti di YouTube. La sezione del canale è visibile agli utenti che hanno selezionato una di quelle regioni e agli utenti per i quali una di queste regioni viene selezionata automaticamente.

    • targeting.countries[]: un elenco di paesi in cui è visibile la sezione del canale. Ogni valore nell'elenco è un codice paese ISO 3166-1 alpha-2.

  • La definizione della proprietà contentDetails.duration della risorsa video è stata corretta in modo da riflettere che il valore può riflettere ore, giorni e così via.

  • La documentazione per i metodi channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete e videos.delete è stata corretta per riflettere il fatto che, se hanno esito positivo, questi metodi restituiscono tutti un codice di risposta 204 HTTP (No Content).

• Errori nuovi e aggiornati

  • L'API ora supporta i seguenti errori:

    Tipo di errore	Dettagli dell'errore	Descrizione
    badRequest (400)	targetInvalidCountry	I metodi channelSections.insert e channelSections.update restituiscono questo errore se la risorsa channelSection inserita conteneva un valore non valido per la proprietà targeting.countries[].
    badRequest (400)	targetInvalidLanguage	I metodi channelSections.insert e channelSections.update restituiscono questo errore se la risorsa channelSection inserita conteneva un valore non valido per la proprietà targeting.languages[].
    badRequest (400)	targetInvalidRegion	I metodi channelSections.insert e channelSections.update restituiscono questo errore se la risorsa channelSection inserita conteneva un valore non valido per la proprietà targeting.regions[].
    badRequest (400)	operationNotSupported	Il metodo comments.insert restituisce questo errore se l'utente dell'API non è in grado di inserire un commento in risposta al commento di primo livello identificato dalla proprietà snippet.parentId. In una risorsa commentThread, la proprietà snippet.canReply indica se il visualizzatore corrente può rispondere al thread.
    badRequest (400)	invalidChannelId	Il metodo search.list restituisce questo errore se il parametro channelId nella richiesta specifica un ID canale non valido.
    badRequest (400)	subscriptionForbidden	Il metodo subscriptions.insert restituisce questo errore se l'utente dell'API tenta di iscriversi al canale dell'utente.

  • Il metodo captions.update non supporta più gli errori invalidMetadata e videoNotFound.

16 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

• La guida alla migrazione è stata aggiornata per spiegare come eseguire la migrazione delle applicazioni che utilizzano ancora la funzionalità dei commenti dell'API v2.

  La guida inoltre richiama diverse funzionalità di commento che l'API v2 non supportava, ma che sono supportate nell'API v3. Queste includono:

  • Recupero dei commenti su un canale
  • Recupero di tutti i thread di commenti correlati a un canale, con la quale la risposta dell'API può contenere commenti sul canale o sui suoi video.
  • Aggiornamento del testo di un commento
  • Contrassegnare un commento come spam
  • Impostare lo stato di moderazione di un commento

• La guida all'iscrizione alle notifiche push è stata aggiornata per indicare il fatto che le notifiche vengono inviate soltanto all'hub Google PubSubHubBub e non anche all'hub Superfeedr, come indicato in precedenza.

9 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

• Le nuove risorse commentThread e comment dell'API ti consentono di recuperare, inserire, aggiornare, eliminare e moderare i commenti.

  • Una risorsa commentThread contiene informazioni su un thread di commenti di YouTube, che comprende un commento di primo livello e le risposte, se presenti, al commento in questione. Una risorsa commentThread può rappresentare i commenti su un video o su un canale.

    Il commento di primo livello e le risposte sono in realtà comment risorse nidificate all'interno della risorsa commentThread. È importante notare che la risorsa commentThread non contiene necessariamente tutte le risposte a un commento e devi utilizzare il metodo comments.list se desideri recuperare tutte le risposte per un determinato commento. Inoltre, alcuni commenti non hanno risposte.

    L'API supporta i seguenti metodi per le risorse commentThread:

    • commentThreads.list - Recupera un elenco di thread di commenti. Usa questo metodo per recuperare i commenti associati a un determinato video o canale.
    • commentThreads.insert – Crea un nuovo commento di primo livello. (utilizza il metodo comments.insert per rispondere a un commento esistente).
    • commentThreads.update – Modifica un commento di primo livello.

  • Una risorsa comment contiene informazioni su un singolo commento di YouTube. Una risorsa comment può rappresentare un commento su un video o su un canale. Inoltre, il commento potrebbe essere un commento di primo livello o una risposta a un commento di livello superiore.

    L'API supporta i seguenti metodi per le risorse comment:

    • comments.list - Recupera un elenco di commenti. Utilizza questo metodo per recuperare tutte le risposte a un determinato commento.
    • comments.insert - Crea una risposta a un commento esistente.
    • comments.update – Modifica un commento.
    • comments.markAsSpam - Segnala uno o più commenti come spam.
    • comments.setModerationStatus - Imposta lo stato di moderazione di uno o più commenti. Ad esempio, puoi eliminare un commento affinché sia visibile pubblicamente o rifiutarlo perché non idoneo alla visualizzazione. La richiesta API deve essere autorizzata dal proprietario del canale o del video associato ai commenti.
    • comments.delete - Elimina un commento.

  Tieni presente che il nuovo ambito https://www.googleapis.com/auth/youtube.force-ssl dell'API, descritto nella cronologia delle revisioni del 2 aprile 2015, è obbligatorio per le chiamate ai metodi comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert e commentThreads.update.

• La nuova guida Iscrizione alle notifiche push illustra il nuovo supporto dell'API per le notifiche push tramite PubSubHubBub, un protocollo di pubblicazione/sottoscrizione server-to-server per le risorse accessibili dal web. Il tuo server di callback PubSubHubBub può ricevere notifiche dei feed Atom quando un canale esegue una delle seguenti attività:

  • carica un video
  • aggiorna il titolo di un video
  • aggiorna la descrizione di un video

• Anche la guida alla migrazione è stata aggiornata per indicare il nuovo supporto delle notifiche push. Tuttavia, poiché l'API v2 supportava numerosi altri tipi di notifiche push non supportati dall'API v3, la menzione del supporto di PubSubHubBub è ancora elencata nella sezione Obsoleta della guida.

• Il nuovo ambito https://www.googleapis.com/auth/youtube.force-ssl dell'API è ora valido per qualsiasi metodo API che in precedenza supportava l'ambito https://www.googleapis.com/auth/youtube.

• L'API ora supporta i seguenti errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest (400)	invalidRating	Il metodo videos.rate restituisce questo errore se la richiesta contiene un valore imprevisto per il parametro rating.

• Il metodo subscriptions.insert non supporta più l'errore subscriptionLimitExceeded, che in precedenza indicava che l'abbonato identificato con la richiesta aveva superato il limite di frequenza di abbonamento.

2 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

• La nuova risorsa captions rappresenta una traccia di sottotitoli codificati di YouTube. Una traccia di sottotitoli è associata a un solo video di YouTube.

  L'API supporta metodi per elencare, inserire, aggiornare, scaricare ed eliminare le tracce dei sottotitoli codificati.

• Anche la guida alla migrazione è stata aggiornata per spiegare come eseguire la migrazione delle applicazioni che utilizzano ancora la funzionalità sottotitoli nell'API v2.

• Il nuovo ambito https://www.googleapis.com/auth/youtube.force-ssl dell'API richiede che la comunicazione con il server API avvenga tramite una connessione SSL.

  Questo nuovo ambito concede lo stesso accesso dell'ambito https://www.googleapis.com/auth/youtube. In effetti, questi due ambiti sono funzionalmente identici perché il server API di YouTube è disponibile solo tramite un endpoint HTTPS. Di conseguenza, anche se l'ambito https://www.googleapis.com/auth/youtube non richiede una connessione SSL, non esiste un altro modo per effettuare una richiesta API.

  Il nuovo ambito è obbligatorio per le chiamate a tutti i metodi della risorsa caption.

11 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

• La guida alla migrazione dell'API YouTube Data (v3) contiene una nuova scheda, denominata Novità nell'API v3, in cui sono elencate le funzioni supportate dall'API v3 e non supportate dall'API v2. Le stesse funzionalità erano in precedenza e sono ancora elencate nelle altre schede della guida. Ad esempio, la nuova funzionalità che spiega come aggiornare i dati delle campagne promozionali in-video di un canale è disponibile anche nella scheda Canali (profili).

• La guida alla migrazione dell'API YouTube Data (v3) è stata aggiornata per tenere presente che l'API v3 supporterà la seguente funzionalità dell'API v2:

  • Segnalazione di un video

• La guida alla migrazione dell'API YouTube Data (v3) è stata aggiornata per tenere presente che le seguenti funzionalità dell'API v2 non saranno supportate nell'API v3:

  • Recupero dei consigli sui video: la versione 3 dell'API non recupera un elenco contenente solo i video consigliati per l'utente corrente dell'API. Tuttavia, puoi utilizzare l'API v3 per trovare i video consigliati chiamando il metodo activities.list e impostando il valore del parametro home su true.

    Nella risposta dell'API, una risorsa corrisponde a un video consigliato se il valore della proprietà snippet.type è recommendation. In questo caso, le proprietà contentDetails.recommendation.reason e contentDetails.recommendation.seedResourceId conterranno informazioni sul motivo per cui il video è stato consigliato. Tieni presente che non possiamo garantire che la risposta conterrà un numero specifico di video consigliati.

  • Recuperare i suggerimenti relativi ai canali

  • Recupera i nuovi video delle iscrizioni: la versione 3 dell'API non recupera un elenco contenente soltanto i video caricati di recente sui canali a cui l'utente dell'API è iscritto. Tuttavia, puoi utilizzare l'API v3 per trovare nuovi video delle iscrizioni chiamando il metodo activities.list e impostando il valore del parametro home su true.

    Nella risposta dell'API, una risorsa corrisponde a un nuovo video in abbonamento se il valore della proprietà snippet.type è upload. Tieni presente che non possiamo garantire che la risposta conterrà un numero specifico di nuovi video iscritti.

  • Supporto dei feed RSS

  • Notifiche push per gli aggiornamenti dei feed: l'API v2 supportava le notifiche push, utilizzando il protocollo SUP (Simple Update Protocol) o PubSubHubbub, per monitorare i feed delle attività degli utenti di YouTube. Ricevevano notifiche per le nuove iscrizioni ai canali e quando i video venivano valutati, condivisi, contrassegnati come preferiti, commentati o caricati.

    L'API v3 supporterà le notifiche push con il protocollo PubSubHubbub, ma le notifiche riguarderanno solo i caricamenti e gli aggiornamenti dei titoli o delle descrizioni dei video.

  • Posizione del canale: la versione 2 dell'API ha utilizzato il tag <yt:location> per identificare la località dell'utente inserita nel profilo pubblico di YouTube del canale. Anche se alcuni sviluppatori hanno utilizzato questo campo per associare un canale a un determinato paese, i dati del campo non possono essere utilizzati in modo coerente a questo scopo.

  • Impostazione o recupero dei tag sviluppatore: l'API v2 supportava la possibilità di associare parole chiave o tag sviluppatore a un video al momento del caricamento. I tag sviluppatore non vengono mostrati agli utenti di YouTube, ma i proprietari dei video possono recuperare i video corrispondenti a un tag sviluppatore specifico.

    L'API v3 fornirà una funzionalità simile, ma non identica. Nello specifico, uno sviluppatore potrà cercare i video caricati dalla sua applicazione. Per questa funzionalità, ogni video caricato viene taggato automaticamente con il numero di progetto associato all'applicazione dello sviluppatore in Google Developers Console. Lo sviluppatore utilizza quindi lo stesso numero di progetto per cercare i video.

  • Elenca i video per data di pubblicazione, numero di visualizzazioni o valutazione: nell'API v2, il parametro orderby ti consente di ordinare i video di una playlist per posizione, durata, data di pubblicazione, titolo e diversi altri valori. Nell'API v3, gli elementi delle playlist vengono generalmente ordinati in base alla posizione in ordine crescente, mentre non sono disponibili altre opzioni di ordinamento.

    Esistono però alcune eccezioni. Un nuovo caricamento, un nuovo video preferito, un video che ti è piaciuto o un video guardato di recente vengono aggiunti automaticamente come primo elemento (snippet.position=0) per i seguenti tipi di playlist. Pertanto, ciascuno di questi elenchi viene effettivamente ordinato in base all'elemento dal più recente al meno recente, in base al momento in cui gli elementi sono stati aggiunti all'elenco.

    • caricamenti da parte dell'utente
    • video preferiti
    • video piaciuti
    • cronologia visualizzazioni

    Tieni presente, tuttavia, che un nuovo elemento è stato aggiunto alla sezione "Guarda più tardi" playlist viene aggiunta come ultimo elemento dell'elenco, in modo che l'elenco sia effettivamente ordinato dal meno recente al più recente.

  • Elaborazione batch: l'API v3 supporta uno dei casi d'uso dell'elaborazione batch supportati dall'API v2. I metodi channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list e videos.list dell'API v3 supportano tutti un parametro id, che può essere utilizzato per specificare un elenco di ID (ID video, ID canale e così via) delimitato da virgole. Utilizzando questi metodi, è possibile recuperare un elenco di più risorse con una singola richiesta.

  Con queste modifiche, la guida identifica tutte le funzionalità supportate nella precedente API (v2) che verranno ritirate nella versione corrente dell'API (v3).

4 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

• I metodi channelSections.delete e channelSections.update ora supportano il parametro onBehalfOfContentOwner, già supportato per diversi altri metodi.

• Le seguenti proprietà e le relative proprietà secondarie sono state ritirate:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Nota:nessuna di queste proprietà era soggetta alle norme sul ritiro delle API.

• La nuova proprietà contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons della risorsa video identifica i motivi che spiegano il motivo per cui il video ha ricevuto la classificazione DJCQT (Brasile).

• L'API ora supporta i seguenti errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  notFound (404)	channelNotFound	Il metodo channels.update restituisce questo errore se il parametro id della richiesta specifica un canale che non è possibile trovare.
  badRequest (400)	manualSortRequiredinvalidValue	I metodi playlistItems.insert e playlistItems.update restituiscono questo errore se la richiesta tenta di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi delle playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere questo errore rimuovendo l'elemento snippet.position dalla risorsa inviata nel corpo della richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi prima aggiornare l'impostazione di ordinamento della playlist impostandola su Manuale. Questa impostazione può essere modificata in Gestione video di YouTube.
  forbidden (403)	channelClosed	Il metodo playlists.list restituisce questo errore se il parametro channelId della richiesta specifica un canale che è stato chiuso.
  forbidden (403)	channelSuspended	Il metodo playlists.list restituisce questo errore se il parametro channelId della richiesta specifica un canale che è stato sospeso.
  forbidden (403)	playlistForbidden	Il metodo playlists.list restituisce questo errore se il parametro id della richiesta non supporta la richiesta o se quest'ultima non è autorizzata correttamente.
  notFound (404)	channelNotFound	Il metodo playlists.list restituisce questo errore se il parametro channelId della richiesta specifica un canale che non è possibile trovare.
  notFound (404)	playlistNotFound	Il metodo playlists.list restituisce questo errore se il parametro id della richiesta specifica una playlist che non è possibile trovare.
  notFound (404)	videoNotFound	Il metodo videos.list restituisce questo errore se il parametro id della richiesta specifica un video che non è possibile trovare.
  badRequest (400)	invalidRating	Il metodo videos.rate restituisce questo errore se la richiesta contiene un valore imprevisto per il parametro rating.

2 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

• Il metodo search.list ora supporta il parametro relevanceLanguage, che consente di richiedere i risultati più pertinenti per una determinata lingua.

  È stata aggiornata anche la guida alla migrazione dell'API di dati di YouTube (v3) per spiegare come utilizzare questo nuovo parametro. Il parametro colma una lacuna che esisteva in precedenza tra la versione corrente dell'API (v3) e la versione precedente (v2), già deprecata.

• Anche la Guida alla migrazione dell'API YouTube Data (v3) è stata aggiornata per indicare il ritiro dei feed speciali e dei campi di metadati forniti dall'API v2 per la descrizione di film, trailer, programmi televisivi, stagioni televisive ed episodi televisivi.

14 gennaio 2015

Questo aggiornamento contiene le seguenti modifiche:

• La guida alla migrazione dell'API YouTube Data (v3) è stata aggiornata per spiegare come utilizzare l'API v3 per caricare video tramite JavaScript. Per informazioni dettagliate, consulta la sezione Caricamento di un video. Questa funzionalità è paragonabile alla funzionalità di caricamento basato su browser supportata dall'API v2. Tieni presente che questa modifica alla guida alla migrazione non riflette una modifica effettiva dell'API, ma piuttosto la disponibilità di un nuovo codice campione per il caricamento di video con JavaScript lato client.

  Dato il supporto del caricamento dei video con la libreria client JavaScript e CORS, la guida alla migrazione non elenca più il caricamento basato su browser come funzionalità che potrebbe essere ritirata nell'API v3.

• La documentazione per il metodo videos.insert è stata aggiornata per includere il nuovo esempio di codice JavaScript descritto sopra. È stato aggiornato anche l'elenco di esempi di codice JavaScript per l'API YouTube Data (v3).

11 novembre 2014

Questo aggiornamento contiene le seguenti modifiche:

• Il costo della quota per una chiamata al metodo search.list è cambiato in 100 unità.

  Importante: in molti casi, puoi utilizzare altri metodi dell'API per recuperare le informazioni a un costo di quota inferiore. Ad esempio, prendi in considerazione questi due modi per trovare i video caricati sul canale GoogleDevelopers.

  • Costo quota: 100 unità

    Chiama il metodo search.list e cerca GoogleDevelopers.

  • Costo quota: 6 unità

    Chiama il metodo channels.list per trovare l'ID canale corretto. Imposta il parametro forUsername su GoogleDevelopers e il parametro part su contentDetails. Nella risposta dell'API, la proprietà contentDetails.relatedPlaylists.uploads specifica l'ID playlist dei video caricati sul canale.

    Successivamente, chiama il metodo playlistItems.list e imposta il parametro playlistId sull'ID acquisito e il parametro part su snippet.

8 ottobre 2014

Questo aggiornamento contiene le seguenti modifiche:

• La risorsa channel contiene due nuove proprietà:

  • La proprietà status.longUploadsStatus indica se il canale è idoneo a caricare video di durata superiore a 15 minuti. Questa proprietà viene restituita solo se il proprietario del canale ha autorizzato la richiesta API. I valori validi per la proprietà sono:

    • allowed - Il canale può caricare video di durata superiore a 15 minuti.
    • eligible – Il canale è idoneo a caricare video di durata superiore a 15 minuti, ma deve prima attivare la funzionalità.
    • disallowed – Il canale non è idoneo o idoneo a caricare video di durata superiore a 15 minuti.

    Per saperne di più su questi valori, consulta la definizione della proprietà. Anche il Centro assistenza YouTube fornisce informazioni più dettagliate su questa funzionalità.

  • La proprietà invideoPromotion.useSmartTiming indica se la campagna promozionale del canale utilizza i "tempi intelligenti". Questa funzionalità tenta di mostrare le promozioni in un punto del video in cui è più probabile che gli utenti facciano clic e che interrompano l'esperienza di visualizzazione. Inoltre, questa funzionalità seleziona una singola promozione da visualizzare su ogni video.

• Le definizioni delle proprietà snippet.title e snippet.categoryId della risorsa video sono state entrambe aggiornate per chiarire il modo in cui l'API gestisce le chiamate al metodo videos.update. Se chiami questo metodo per aggiornare la parte snippet di una risorsa video, devi impostare un valore per entrambe le proprietà.

  Se provi ad aggiornare la parte snippet di una risorsa video e non imposti un valore per entrambe le proprietà, l'API restituisce un errore invalidRequest. Anche la descrizione dell'errore è stata aggiornata.

• La proprietà contentDetails.contentRating.oflcRating della risorsa video, che identifica la classificazione di un video dall'Office of Film and Literature Classification della Nuova Zelanda, ora supporta due nuove classificazioni: oflcRp13 e oflcRp16. Questi corrispondono rispettivamente alle valutazioni RP13 e RP16.

• Il metodo channelBanners.insert ora supporta il seguente errore:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest	bannerAlbumFull	L'album della grafica del canale YouTube del proprietario del canale contiene troppe immagini. Il proprietario del canale deve andare all'indirizzo http://photos.google.com, andare alla pagina degli album e rimuovere alcune immagini dall'album.

12 settembre 2014

Questo aggiornamento contiene le seguenti modifiche:

• Il costo della quota per una chiamata al metodo search.list è cambiato da 1 a 2 unità oltre al costo delle parti delle risorse specificate.

13 agosto 2014

Questo aggiornamento contiene le seguenti modifiche:

• Il metodo subscriptions.insert ora supporta il seguente errore:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest	subscriptionLimitExceeded	L'abbonato identificato nella richiesta ha superato il limite di frequenza di abbonamento. È possibile provare altri abbonamenti tra qualche ora.

12 agosto 2014

Questo aggiornamento contiene le seguenti modifiche:

• Una nuova guida, intitolata Migrazione dell'applicazione all'API YouTube Data (v3), spiega come utilizzare l'API YouTube Data (v3) per eseguire le funzionalità disponibili nella YouTube Data API (v2). L'API precedente è stata ufficialmente ritirata il 4 marzo 2014. Lo scopo della guida è aiutarti a eseguire la migrazione delle applicazioni che utilizzano ancora l'API v2 alla versione più recente dell'API.

8 luglio 2014

Questo aggiornamento contiene le seguenti modifiche:

• Il metodo playlists.insert ora supporta il seguente errore:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest	maxPlaylistExceeded	Questo errore si verifica se non è possibile creare una playlist perché il canale ha già raggiunto il numero massimo di playlist consentito.

18 giugno 2014

Questo aggiornamento contiene le seguenti modifiche:

• La descrizione di ciascun metodo API è stata aggiornata in modo da includere il costo della quota sostenuto da una chiamata a quel metodo. Allo stesso modo, le definizioni dei parametri part sono state aggiornate per specificare il costo della quota di ogni parte che può essere recuperata in una chiamata API. Ad esempio, una chiamata al metodo subscriptions.insert ha un costo per quota di circa 50 unità. La risorsa subscription contiene anche tre parti (snippet, contentDetails e subscriberSnippet) e ognuna di queste ha un costo di due unità.

  Tieni presente che i costi della quota possono cambiare senza preavviso.

• La risorsa video ora supporta 43 nuovi sistemi di classificazione dei contenuti, che identificano le classificazioni ricevute dai video da varie agenzie di classificazione nazionali.

28 maggio 2014

Questo aggiornamento contiene le seguenti modifiche:

• Il metodo search.list ora supporta i parametri location e locationRadius, che ti consentono di cercare video associati a una posizione geografica. Per recuperare i risultati in base alla località, una richiesta deve specificare un valore per entrambi i parametri e l'API restituirà un errore se una richiesta include solo uno dei due parametri.

  • Il parametro location specifica le coordinate di latitudine/longitudine al centro dell'area geografica circolare.

  • Il parametro locationRadius consente di specificare la distanza massima dal centro dell'area tra la località associata a un video e la sua inclusione nei risultati di ricerca.

13 maggio 2014

Questo aggiornamento contiene le seguenti modifiche:

• La proprietà invideoPromotion.items[] della risorsa channel è stata aggiornata per indicare che in genere puoi impostare un solo articolo promosso per il tuo canale. Se provi a inserire troppi articoli sponsorizzati, l'API restituirà un errore tooManyPromotedItems con un codice di stato HTTP 400.

• La risorsa channelSection ora può contenere informazioni su alcuni nuovi tipi di contenuti in primo piano. La proprietà snippet.type della risorsa channelSection ora supporta i seguenti valori:

  • postedPlaylists: playlist che il proprietario del canale ha pubblicato nel feed attività del canale
  • postedVideos: video che il proprietario del canale ha pubblicato nel feed attività del canale
  • subscriptions: canali a cui il proprietario del canale si è iscritto

• La nuova proprietà contentDetails.contentRating.ifcoRating della risorsa video identifica la classificazione ricevuta da un video dall'Irish Film Classification Office.

• La definizione della proprietà position.cornerPosition della risorsa watermark è stata aggiornata per notare che la filigrana viene sempre visualizzata nell'angolo in alto a destra del player.

• La definizione del parametro q per il metodo search.list è stata aggiornata per notare che il termine di query può utilizzare l'operatore booleano NOT (-) per escludere i video associati a un determinato termine di ricerca. Il valore può anche utilizzare l'operatore booleano OR (|) per trovare i video associati a uno dei vari termini di ricerca disponibili.

• La definizione della proprietà pageInfo.totalResults restituita in una risposta API a una chiamata search.list è stata aggiornata per notare che il valore è un'approssimazione e potrebbe non rappresentare un valore esatto. Inoltre, il valore massimo è 1.000.000. Non devi utilizzare questo valore per creare link di impaginazione. Utilizza invece i valori delle proprietà nextPageToken e prevPageToken per determinare se mostrare i link di impaginazione.

• I metodi watermarks.set e watermarks.unset sono stati aggiornati per riflettere che l'API restituisce un codice di risposta HTTP 204 per le richieste riuscite a questi metodi.

2 maggio 2014

Questo aggiornamento contiene le seguenti modifiche:

• La nuova risorsa i18nLanguage identifica una lingua dell'applicazione supportata dal sito web di YouTube. La lingua dell'applicazione può anche essere indicata come lingua dell'interfaccia utente. Per il sito web di YouTube, è possibile selezionare automaticamente la lingua dell'applicazione in base alle impostazioni dell'Account Google, alla lingua del browser o alla posizione dell'IP. Inoltre, un utente può anche selezionare manualmente la lingua dell'interfaccia utente desiderata dal piè di pagina del sito di YouTube.

  L'API supporta un metodo per elencare le lingue delle applicazioni supportate. È possibile utilizzare le lingue supportate come valore del parametro hl durante la chiamata di metodi API come videoCategories.list e guideCategories.list.

• La nuova risorsa i18nRegion identifica un'area geografica che un utente di YouTube può selezionare come regione di contenuti preferita. La regione dei contenuti può essere definita anche impostazioni internazionali dei contenuti. Per il sito web di YouTube, una regione di contenuti potrebbe essere selezionata automaticamente in base a un'euristica come il dominio di YouTube o la località dell'IP dell'utente, inoltre un utente potrebbe anche selezionare manualmente la regione di contenuti desiderata dal piè di pagina del sito di YouTube.

  L'API supporta un metodo per elencare le regioni di contenuti supportate. È possibile usare i codici regione supportati come valore del parametro regionCode durante la chiamata di metodi API come search.list, videos.list, activities.list e videoCategories.list.

7 aprile 2014

Questo aggiornamento contiene le seguenti modifiche:

• La nuova risorsa channelSection contiene informazioni su un insieme di video che un canale ha scelto di mostrare. Ad esempio, una sezione potrebbe includere gli ultimi caricamenti di un canale, i caricamenti più popolari o i video di una o più playlist.

  L'API supporta metodi per elencare, inserire, aggiornare o eliminare le sezioni del canale. Puoi recuperare un elenco di sezioni del canale dell'utente autenticato, specificando un ID canale specifico o un elenco di ID di sezione di canale univoci.

  Anche la documentazione relativa agli errori è stata aggiornata per descrivere i messaggi di errore supportati dall'API in modo specifico per questi nuovi metodi.

• La definizione dell'oggetto fileDetails della risorsa video è stata aggiornata per spiegare che questo oggetto verrà restituito solo se la proprietà processingDetails.fileDetailsAvailability del video ha un valore available.

  Allo stesso modo, la definizione dell'oggetto suggestions della risorsa video è stata aggiornata per spiegare che questo oggetto verrà restituito solo se la proprietà processingDetails.tagSuggestionsAvailability o processingDetails.editorSuggestionsAvailability del video ha un valore available.

• La documentazione per i metodi videos.insert e videos.update è stata aggiornata per indicare che è possibile impostare la proprietà status.publishAt quando si chiamano questi metodi.

• La definizione dell'oggetto invideoPromotion della risorsa channel è stata aggiornata per spiegare che l'oggetto può essere recuperato solo dal proprietario del canale.

• L'elenco di parametri del metodo videos.rate è stato aggiornato per indicare che questo metodo non supporta effettivamente il parametro onBehalfOfContentOwner. Questo era un errore della documentazione, poiché le richieste di videos.rate che impostano questo parametro restituiscono un errore 500.

31 marzo 2014

Questo aggiornamento contiene le seguenti modifiche:

• La nuova proprietà status.publishAt della risorsa video consente di specificare la data e l'ora in cui è pianificata la pubblicazione di un video privato. Questa proprietà può essere impostata solo se lo stato di privacy del video è private e il video non è mai stato pubblicato. Questa nuova proprietà non è soggetta alle norme sul ritiro.

13 marzo 2014

Questo aggiornamento contiene le seguenti modifiche:

• L'API ora supporta la parte contentOwnerDetails per channel risorse. La nuova parte contiene i dati del canale che sono pertinenti per i partner di YouTube collegati al canale, compresi l'ID del proprietario dei contenuti collegato al canale e la data e l'ora in cui il proprietario dei contenuti e il canale sono stati collegati. Tieni presente che questa nuova parte non è soggetta alle norme sul ritiro.

• La documentazione ora indica la lunghezza massima di caratteri supportata per le seguenti proprietà:

  Risorsa	Proprietà	Lunghezza massima
  channel	invideoPromotion.items[].customMessage	40 caratteri
  video	snippet.title	100 caratteri
  video	snippet.description	5000 byte
  video	snippet.tags	500 caratteri. Tieni presente che il valore della proprietà è un elenco e che le virgole tra gli elementi nell'elenco vengono conteggiate ai fini del limite.

• La proprietà brandingSettings.watch.featuredPlaylistId della risorsa channel è stata deprecata. L'API restituirà un errore se tenti di impostare il relativo valore.

• Le seguenti proprietà delle risorse video sono state aggiunte all'elenco di valori che possono essere impostati durante l'inserimento o l'aggiornamento di un video:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• La documentazione relativa agli errori ora specifica il codice di risposta HTTP per ogni tipo di errore.

• L'API ora supporta i seguenti errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest (400)	invalidCriteria	Il metodo channels.list restituisce questo errore se la richiesta specifica parametri di filtro che non possono essere utilizzati in combinazione.
  badRequest (400)	channelTitleUpdateForbidden	Il metodo channels.update restituisce questo errore se tenti di aggiornare la parte brandingSettings di un canale e modificare il valore della proprietà brandingSettings.channel.title. Tieni presente che l'API non restituisce l'errore se ometti la proprietà.
  badRequest (400)	invalidRecentlyUploadedBy	Il metodo channels.update restituisce questo errore se la proprietà invideoPromotion.items[].id.recentlyUploadedBy specifica un ID canale non valido.
  badRequest (400)	invalidTimingOffset	Il metodo channels.update restituisce questo errore se la parte invideoPromotion specifica un offset di temporizzazione non valido.
  badRequest (400)	tooManyPromotedItems	Il metodo channels.update restituisce questo errore se la parte invideoPromotion specifica un numero di articoli sponsorizzati superiore a quello consentito.
  forbidden (403)	promotedVideoNotAllowed	Il metodo channels.update restituisce questo errore se la proprietà invideoPromotion.items[].id.videoId specifica un ID video che non è possibile trovare o non può essere utilizzato come elemento promosso.
  forbidden (403)	websiteLinkNotAllowed	Il metodo channels.update restituisce questo errore se la proprietà invideoPromotion.items[].id.websiteUrl specifica un URL non consentito.
  required (400)	requiredTimingType	Il metodo channels.update restituisce questo errore se una richiesta non specifica le impostazioni di temporizzazione predefinite per il momento in cui YouTube deve mostrare un articolo promosso.
  required (400)	requiredTiming	Il metodo channels.update deve specificare un oggetto invideoPromotion.items[].timing per ogni elemento promosso.
  required (400)	requiredWebsiteUrl	Il metodo channels.update deve specificare una proprietà invideoPromotion.items[].id.websiteUrl per ogni elemento promosso.
  badRequest (400)	invalidPublishAt	Il metodo videos.insert restituisce questo errore se i metadati della richiesta specificano un'ora di pubblicazione pianificata non valida.

4 marzo 2014

Questo aggiornamento contiene le seguenti modifiche:

• L'API YouTube Data v3 è ora soggetta alle norme sul ritiro descritte nei Termini di servizio delle API di YouTube. Tieni presente che la pagina in cui sono elencate le API soggette alle norme sul ritiro esclude in modo specifico che alcune funzionalità dell'API v3 siano soggette alle norme.

5 dicembre 2013

Questo aggiornamento contiene le seguenti modifiche:

• La documentazione del metodo search.list è stata aggiornata per indicare correttamente che non è necessario specificare un valore per un solo parametro di filtro quando invii una richiesta di ricerca. Puoi invece impostare un valore per i parametri di filtro zero o per un parametro di filtro.

• Le definizioni dei parametri del metodo search.list sono state aggiornate per notare che devi impostare il valore del parametro type su video se specifichi anche un valore per uno dei seguenti parametri:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• Le dimensioni minime delle immagini dei banner del canale caricate sono state ridotte a 2048 x 1152 px. In precedenza, la dimensione minima era di 2120 px per 1192 px. Inoltre, tieni presente che la documentazione delle risorse channel specifica le dimensioni massime di tutte le immagini banner fornite dall'API. Ad esempio, le dimensioni massime dell'immagine brandingSettings.image.bannerTvImageUrl per le applicazioni televisive sono di 2120 x 1192 px, ma l'immagine effettiva può essere 2048 x 1152 px. Il Centro assistenza YouTube fornisce ulteriori indicazioni per ottimizzare la grafica del canale per la visualizzazione su diversi tipi di dispositivi.

• Sono state aggiornate diverse definizioni delle proprietà delle risorse channel per riflettere le seguenti informazioni:

  • Il valore della proprietà brandingSettings.channel.description ha una lunghezza massima di 1000 caratteri.
  • La proprietà brandingSettings.channel.featuredChannelsTitle ha una lunghezza massima di 30 caratteri.
  • La proprietà brandingSettings.channel.featuredChannelsUrls[] ora può elencare fino a 100 canali.
  • Il valore della proprietà brandingSettings.channel.unsubscribedTrailer, se impostato, deve specificare l'ID video di YouTube di un video pubblico o non in elenco di proprietà del proprietario del canale.

• Il metodo channels.update ora supporta gli aggiornamenti alla proprietà invideoPromotion.items[].promotedByContentOwner. Questa proprietà indica se il nome del proprietario dei contenuti verrà mostrato quando viene visualizzata la promozione. Può essere impostato solo se la richiesta API che imposta il valore della proprietà viene effettuata per conto del proprietario dei contenuti utilizzando il parametro onBehalfOfContentOwner.

• I metodi playlistItems.list e playlistItems.insert ora supportano il parametro onBehalfOfContentOwner, già supportato per diversi altri metodi.

• Per la proprietà contentDetails.contentRating.acbRating, ora è possibile specificare una classificazione per i film rilasciata dall'Australian Classification Board (ACB) o dall'Australian Communications and Media Authority (ACMA) per la programmazione televisiva per bambini.

• Le nuove proprietà contentDetails.contentRating.catvRating e contentDetails.contentRating.catvfrRating identificano le classificazioni ricevute da un video secondo il sistema di classificazione TV canadese e il sistema di classificazione in lingua francese Régie du cinéma, utilizzato rispettivamente nel Québec.

• La nuova proprietà snippet.assignable della risorsa videoCategory indica se è possibile associare i video aggiornati o i video appena caricati a quella categoria di video.

• Sono stati aggiunti esempi di codice per i seguenti metodi:

  • activities.insert (Vai)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Vai)
  • search.list (Vai)
  • thumbnails.set (Java)
  • videos.insert (Vai)

24 ottobre 2013

Questo aggiornamento contiene le seguenti modifiche:

• L'API include due funzioni aggiuntive progettate per aiutare a trovare e mettere in primo piano i contenuti trasmessi in diretta:

  La nuova proprietà snippet.liveBroadcastContent nei risultati di ricerca indica se una risorsa video o canale ha contenuti trasmessi in diretta. I valori validi per la proprietà sono upcoming, active e none.

  • La nuova proprietà snippet.liveBroadcastContent della risorsa video indica se il video è una trasmissione live imminente o attiva. L'elenco seguente spiega i possibili valori della proprietà:

    • upcoming - Il video è una trasmissione live che non è ancora iniziata.
    • active - Il video è una trasmissione live in corso.
    • none - Il video non è una trasmissione live futura o attiva. Questo sarà il valore della proprietà per le trasmissioni completate che sono ancora visibili su YouTube.

  • La nuova proprietà liveStreamingDetails della risorsa video è un oggetto che contiene metadati relativi a una trasmissione video in diretta. Per recuperare questi metadati, includi liveStreamingDetails nell'elenco delle parti delle risorse del valore del parametro part. I metadati includono le seguenti nuove proprietà:

    • liveStreamingDetails.actualStartTime: l'ora in cui è iniziata la trasmissione. Questo valore sarà presente una volta che lo stato della trasmissione sarà active.
    • liveStreamingDetails.actualEndTime: l'ora in cui è realmente terminata la trasmissione. Questo valore sarà presente al termine della trasmissione.
    • liveStreamingDetails.scheduledStartTime: l'ora di inizio programmata della trasmissione.
    • liveStreamingDetails.scheduledEndTime: l'ora di fine della trasmissione programmata. Se il valore della proprietà è vuoto o se la proprietà non è presente, la trasmissione è pianificata per durare a tempo indeterminato.
    • liveStreamingDetails.concurrentViewers. Il numero di persone che hanno guardato la trasmissione live.

    Per recuperare questi metadati, includi liveStreamingDetails nel valore del parametro part quando chiami il metodo videos.list, videos.insert o videos.update.

  Tieni presente che il 1° ottobre 2013 sono state rilasciate altre due funzioni per identificare i contenuti delle trasmissioni live: il parametro eventType del metodo search.list e la proprietà snippet.liveBroadcastContent del risultato di ricerca.

• Il metodo videos.insert ora supporta il parametro notifySubscribers, che indica se YouTube deve inviare una notifica sul nuovo video agli utenti che si iscrivono al canale del video. Il valore predefinito del parametro è True, il che indica che gli iscritti riceveranno una notifica quando vengono caricati nuovi video. Tuttavia, il proprietario di un canale che carica molti video potrebbe preferire impostare il valore su False per evitare di inviare una notifica su ogni nuovo video agli iscritti del canale.

• L'elenco di proprietà che è possibile modificare quando si chiama il metodo channels.update è stato aggiornato per includere le proprietà invideoPromotion.items[].customMessage e invideoPromotion.items[].websiteUrl. Inoltre, l'elenco è stato modificato per identificare le proprietà brandingSettings modificabili. Queste proprietà brandingSettings erano già modificabili, quindi la modifica alla documentazione non riflette una modifica alla funzionalità esistente dell'API.

• I metodi playlists.insert, playlists.update e playlists.delete ora supportano il parametro onBehalfOfContentOwner, che è già supportato per diversi altri metodi.

• Il metodo playlists.insert ora supporta il parametro onBehalfOfContentOwnerChannel, che è già supportato per diversi altri metodi.

• La proprietà contentDetails.contentRating.tvpgRating della risorsa video ora supporta un valore di pg14, che corrisponde a una valutazione TV-14.

• La definizione della proprietà snippet.liveBroadcastContent, che fa parte dei risultati di ricerca, è stata corretta per indicare che live è un valore di proprietà valido, mentre active non è un valore di proprietà valido.

• La proprietà contentDetails.contentRating.mibacRating della risorsa video ora supporta due valutazioni aggiuntive:

  • mibacVap (VAP) - I bambini devono essere accompagnati da un adulto.
  • mibacVm6 (V.M.6) – Limitato ai minori di 6 anni.
  • mibacVm12 (V.M.12) – Visibile solo agli utenti dai 12 anni in su.

• La nuova proprietà invideoPromotion.items[].promotedByContentOwner della risorsa channel indica se il nome del proprietario dei contenuti verrà mostrato quando viene visualizzata la promozione. Questo campo può essere impostato solo se la richiesta API che imposta il valore viene effettuata per conto del proprietario dei contenuti. Per saperne di più, consulta il parametro onBehalfOfContentOwner.

1° ottobre 2013

Questo aggiornamento contiene le seguenti modifiche:

• Il nuovo oggetto auditDetails della risorsa channel contiene dati di canale che una rete multicanale valuterebbe per determinare se accettare o rifiutare un determinato canale. Tieni presente che qualsiasi richiesta API che recupera questa parte della risorsa deve fornire un token di autorizzazione contenente l'ambito https://www.googleapis.com/auth/youtubepartner-channel-audit. Inoltre, i token che utilizzano questo ambito devono essere revocati quando la rete multicanale decide di accettare o rifiutare il canale oppure entro due settimane dalla data di emissione.

• La proprietà invideoPromotion.items[].id.type della risorsa channel ora supporta il valore recentUpload, che indica che l'articolo promosso è il video caricato più di recente da un canale specificato.

  Per impostazione predefinita, il canale è uguale a quello per cui sono impostati i dati relativi alle promozioni in-video. Tuttavia, puoi promuovere il video caricato più di recente da un altro canale impostando il valore della nuova proprietà invideoPromotion.items[].id.recentlyUploadedBy sull'ID canale di quel canale.

• La risorsa channel contiene tre nuove proprietà (brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl e brandingSettings.image.bannerTvHighImageUrl) che specificano gli URL delle immagini dei banner visualizzate sulle pagine dei canali nelle applicazioni televisive.

• La nuova proprietà snippet.liveBroadcastContent nei risultati di ricerca indica se una risorsa video o canale ha contenuti trasmessi in diretta. I valori validi per la proprietà sono upcoming, active e none.

  • Per una risorsa video, il valore upcoming indica che la trasmissione dal vivo non è ancora iniziata, mentre il valore active indica che il video è una trasmissione dal vivo in corso.
  • Per una risorsa channel, un valore di upcoming indica che il canale ha una trasmissione programmata che non è ancora iniziata, mentre un valore di acive indica che il canale ha una trasmissione dal vivo in corso.

• Nella risorsa watermark, la proprietà targetChannelId è stata modificata da oggetto a stringa. Invece di contenere una proprietà secondaria che specifica l'ID canale YouTube del canale a cui rimanda l'immagine della filigrana, la proprietà targetChannelId ora specifica il valore stesso. Di conseguenza, la proprietà targetChannelId.value della risorsa è stata rimossa.

• Il metodo thumbnails.set ora supporta il parametro onBehalfOfContentOwner, che è già supportato per diversi altri metodi.

• Il metodo search.list ora supporta il parametro eventType, che limita una ricerca alla restituzione solo di eventi di trasmissione attivi, imminenti o completati.

• La nuova proprietà contentDetails.contentRating.mibacRating identifica la valutazione ricevuta dal Ministero dei beni e delle attività culturali e del Turismo in Italia.

• L'API ora supporta i seguenti errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest	invalidImage	Il metodo thumbnails.set restituisce questo errore se i contenuti dell'immagine forniti non sono validi.
  forbidden	videoRatingDisabled	Il metodo videos.rate restituisce questo errore se il proprietario del video valutato ha disattivato i voti per il video in questione.

27 agosto 2013

Questo aggiornamento contiene le seguenti modifiche:

• La nuova risorsa watermark identifica un'immagine che viene visualizzata durante le riproduzioni dei video di un canale specifico. Puoi anche specificare un canale di destinazione a cui si collega l'immagine, nonché dettagli sui tempi che determinano quando mostrare la filigrana durante le riproduzioni del video e per quanto tempo sarà visibile.

  Il metodo watermarks.set consente di caricare e impostare l'immagine della filigrana di un canale. Il metodo watermarks.unset elimina l'immagine della filigrana di un canale.

  La documentazione degli errori descrive i messaggi di errore supportati dall'API in modo specifico per i metodi watermarks.set e watermarks.unset.

• La nuova proprietà statistics.hiddenSubscriberCount della risorsa channel contiene un valore booleano che indica se il numero di iscritti del canale è nascosto. Di conseguenza, il valore della proprietà è false se il numero di iscritti del canale è visibile pubblicamente.

• Il metodo playlists.list ora supporta i parametri onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Entrambi i parametri sono già supportati da diversi altri metodi.

• Il metodo videos.list ora supporta il parametro regionCode, che identifica la regione di contenuti per la quale deve essere recuperato un grafico. Questo parametro può essere utilizzato solo in combinazione con il parametro chart. Il valore del parametro è un codice paese ISO 3166-1 alpha-2.

• L'error documentation descrive il seguente nuovo errore comune di richiesta, che potrebbe verificarsi per più metodi API:

  Tipo di errore	Dettagli dell'errore	Descrizione
  forbidden	insufficientPermissions	Gli ambiti associati al token OAuth 2.0 fornito per la richiesta non sono sufficienti per accedere ai dati richiesti.

15 agosto 2013

Questo aggiornamento contiene le seguenti modifiche:

• L'oggetto invideoPromotion della risorsa channel ha le seguenti proprietà nuove e aggiornate:

  • L'API ora supporta la possibilità di specificare un sito web come articolo promosso. Per farlo, imposta il valore della proprietà invideoPromotion.items[].id.type su website e utilizza la nuova proprietà invideoPromotion.items[].id.websiteUrl per specificare l'URL. Inoltre, utilizza la nuova proprietà invideoPromotion.items[].customMessage per definire un messaggio personalizzato da mostrare per la promozione.

    I link possono rimandare a siti web associati, siti di commercianti o siti di social network. Per ulteriori informazioni sull'attivazione dei link per i tuoi contenuti, consulta le istruzioni del Centro assistenza YouTube relative ai siti web associati e ai siti dei commercianti.

    Aggiungendo i link promozionali, accetti che tali link non saranno utilizzati per reindirizzare il traffico a siti non autorizzati e che tali link saranno conformi alle Norme AdWords, alle Norme sugli annunci di YouTube, alle Norme della community di YouTube e ai Termini di servizio di YouTube.

  • Le proprietà relative alle impostazioni di sincronizzazione per la visualizzazione degli elementi promossi durante la riproduzione video sono state ristrutturate:

    • L'oggetto invideoPromotion.timing è stato spostato in invideoPromotion.items[].timing. Questo oggetto ora ti consente di personalizzare i dati di tempo per ciascun elemento promosso nell'elenco invideoPromotion.items[].

    • Il nuovo oggetto invideoPromotion.defaultTiming specifica le impostazioni di temporizzazione predefinite per la promozione. Queste impostazioni definiscono quando un articolo promosso verrà visualizzato durante la riproduzione di uno dei video del tuo canale. Puoi ignorare la tempistica predefinita per qualsiasi elemento promosso utilizzando l'oggetto invideoPromotion.items[].timing.

    • La nuova proprietà invideoPromotion.items[].timing.durationMs specifica per quanto tempo, in millisecondi, la promozione deve essere visualizzata. L'oggetto invideoPromotion.defaultTiming contiene anche un campo durationMs che specifica la quantità di tempo predefinita in cui l'elemento promosso verrà visualizzato.

  • Le proprietà invideoPromotion.items[].type e invideoPromotion.items[].videoId sono state entrambe spostate nell'oggetto invideoPromotion.items[].id.

• Il metodo subscriptions.list ora supporta i parametri onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Entrambi i parametri sono già supportati da diversi altri metodi.

• Nella risposta dell'API a una richiesta thumbnails.set, il valore della proprietà kind è stato modificato da youtube#thumbnailListResponse a youtube#thumbnailSetResponse.

• Sono stati aggiunti esempi di codice per i seguenti metodi:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  Tieni presente che anche l'esempio Python di esempio per il metodo playlistItems.insert è stato rimosso, poiché la funzionalità dimostrata ora è gestita dal metodo videos.rate.

• error documentation descrive il seguente nuovo errore di contesto della richiesta, che potrebbe verificarsi per qualsiasi metodo API che supporta il parametro di richiesta mine:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest	invalidMine	Il parametro mine non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner di YouTube. Devi rimuovere il parametro mine, autenticarti come utente di YouTube rimuovendo il parametro onBehalfOfContentOwner oppure agire come uno dei canali del partner fornendo il parametro onBehalfOfContentOwnerChannel, se disponibile per il metodo chiamato.

8 agosto 2013

Questo aggiornamento contiene le seguenti modifiche:

• La sezione Utilizzo della quota della guida Guida introduttiva all'API YouTube Data è stata aggiornata per riflettere una modifica del costo della quota di un caricamento video da circa 16.000 a circa 1600 unità.

30 luglio 2013

Questo aggiornamento contiene le seguenti modifiche:

• In una risorsa channelBanner, il valore della proprietà kind è stato modificato da youtube#channelBannerInsertResponse a youtube#channelBannerResource. Questa risorsa viene restituita in risposta a una richiesta channelBanners.insert.

• La nuova proprietà brandingSettings.channel.profileColor della risorsa channel specifica un colore in evidenza che si abbina ai contenuti del canale. Il valore della proprietà è un simbolo del cancelletto (#) seguito da una stringa esadecimale a sei caratteri, come #2793e6.

• L'API ora supporta la possibilità di specificare se un'iscrizione riguarda tutte le attività di un canale o solo i nuovi caricamenti. La nuova proprietà contentDetails.activityType della risorsa subscription identifica i tipi di attività per i quali l'abbonato riceverà una notifica. I valori validi per la proprietà sono all e uploads.

• Il metodo videos.list supporta nuovi parametri per recuperare un grafico dei video più popolari su YouTube:

  • Il parametro chart identifica il grafico da recuperare. Al momento, l'unico valore supportato è mostPopular. Tieni presente che il parametro chart è un parametro di filtro, il che significa che non può essere utilizzato nella stessa richiesta di altri parametri di filtro (id e myRating).
  • Il parametro videoCategoryId identifica la categoria video per cui è necessario recuperare il grafico. Questo parametro può essere utilizzato solo in combinazione con il parametro chart. Per impostazione predefinita, i grafici non sono limitati a una determinata categoria.

• La nuova proprietà topicDetails.relevantTopicIds[] della risorsa video fornisce un elenco di ID argomento Freebase pertinenti al video o ai suoi contenuti. Gli argomenti di questi argomenti potrebbero essere menzionati o visualizzati nel video.

• La proprietà recordingDetails.location.elevation della risorsa video è stata rinominata in recordingDetails.location.altitude, mentre la relativa proprietà fileDetails.recordingLocation.location.elevation è stata rinominata in fileDetails.recordingLocation.location.altitude.

• L'oggetto contentDetails.contentRating della risorsa video specifica le classificazioni ricevute da un video in base a vari schemi di classificazione, tra cui le classificazioni MPAA, TVPG e così via. Per ogni sistema di classificazione, ora l'API supporta un valore di classificazione che indica che il video non è stato valutato. Tieni presente che per le classificazioni MPAA, la dicitura "senza classificazione" La classificazione viene spesso utilizzata per identificare le versioni integrali dei film per cui la versione tagliata ha ricevuto una classificazione ufficiale.

• La nuova proprietà contentDetails.contentRating.ytRating della risorsa video identifica contenuti soggetti a limiti di età. Il valore della proprietà sarà ytAgeRestricted se YouTube ha identificato che il video include contenuti non appropriati per gli utenti di età inferiore a 18 anni. Se la proprietà non è presente o se il valore della proprietà è vuoto, i contenuti non sono stati identificati come soggetti a limiti di età.

• Il parametro mySubscribers del metodo channels.list è stato ritirato. Utilizza il metodo subscriptions.list e il relativo parametro mySubscribers per recuperare un elenco degli iscritti al canale dell'utente autenticato.

• Ora i metodi channelBanners.insert, channels.update, videos.getRating e videos.rate supportano il parametro onBehalfOfContentOwner. Questo parametro indica che l'utente autenticato agisce per conto del proprietario dei contenuti specificato nel valore del parametro.

• La documentazione del metodo channels.update è stata aggiornata per riflettere il fatto che questo metodo può essere utilizzato per aggiornare l'oggetto brandingSettings della risorsa channel e le relative proprietà figlio. La documentazione ora elenca anche l'elenco aggiornato di proprietà che puoi impostare per l'oggetto invideoPromotion della risorsa channel.

• L'error documentation descrive i seguenti nuovi errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  forbidden	accountDelegationForbidden	Questo errore non riguarda un metodo API specifico. Indica che l'utente autenticato non è autorizzato ad agire per conto dell'Account Google specificato.
  forbidden	authenticatedUserAccountClosed	Questo errore non riguarda un metodo API specifico. Indica che l'account YouTube dell'utente autenticato è stato chiuso. Se l'utente agisce per conto di un altro Account Google, questo errore indica che l'altro account è stato chiuso.
  forbidden	authenticatedUserAccountSuspended	Questo errore non riguarda un metodo API specifico. Indica che l'account YouTube dell'utente autenticato è sospeso. Se l'utente agisce per conto di un altro Account Google, questo errore indica che l'altro account è sospeso.
  forbidden	authenticatedUserNotChannel	Questo errore non riguarda un metodo API specifico. Indica che il server API non è in grado di identificare il canale associato alla richiesta API. Se la richiesta è autorizzata e utilizza il parametro onBehalfOfContentOwner, devi impostare anche il parametro onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Questo errore non riguarda un metodo API specifico. L'utente del CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato.
  notFound	contentOwnerAccountNotFound	Questo errore non riguarda un metodo API specifico. L'account del proprietario dei contenuti specificato non è stato trovato.
  badRequest	invalidPart	Questo errore non riguarda un metodo API specifico. Il parametro part della richiesta specifica le parti che non possono essere scritte contemporaneamente.
  badRequest	videoChartNotFound	Il metodo videos.list restituisce questo errore quando la richiesta specifica un grafico video non supportato o non disponibile.
  notFound	videoNotFound	Il metodo videos.update restituisce questo errore per indicare che non è possibile trovare il video che stai tentando di aggiornare. Controlla il valore della proprietà id nel corpo della richiesta per assicurarti che sia corretto.

10 giugno 2013

Questo aggiornamento contiene le seguenti modifiche:

• Il nuovo parametro forUsername del metodo channels.list ti consente di recuperare informazioni su un canale specificando il relativo nome utente YouTube.

• Il metodo activities.list ora supporta il parametro regionCode, che indica all'API di restituire risultati pertinenti per il paese specificato. YouTube utilizza questo valore quando la precedente attività dell'utente autorizzato su YouTube non fornisce informazioni sufficienti per generare il feed attività.

• Le risorse playlist ora contengono la proprietà snippet.tags. La proprietà verrà restituita solo agli utenti autorizzati che stanno recuperando dati sulle proprie playlist. Gli utenti autorizzati possono anche impostare i tag delle playlist quando richiamano i metodi playlists.insert o playlists.update.

• Il parametro onBehalfOfContentOwner, precedentemente supportato per i metodi channels.list e search.list, ora è supportato anche per i metodi videos.insert, videos.update e videos.delete. Tieni presente che quando questo parametro viene utilizzato in una chiamata al metodo videos.insert, la richiesta deve specificare anche un valore per il nuovo parametro onBehalfOfContentOwnerChannel, che identifica il canale a cui verrà aggiunto il video. Il canale deve essere collegato al proprietario dei contenuti specificato nel parametro onBehalfOfContentOwner.

  Il parametro indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube CMS che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. L'account CMS con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato.

  Questo parametro è destinato ai partner della rete di contenuti che possiedono e gestiscono molti canali YouTube diversi. Il parametro consente ai partner di eseguire l'autenticazione una sola volta e di accedere a tutti i dati dei loro video e del loro canale, senza dover fornire le credenziali di autenticazione per ogni singolo canale.

  Nello specifico, per quanto riguarda questa versione, il parametro ora consente a un partner della rete di contenuti di inserire, aggiornare o eliminare video in qualsiasi canale YouTube di sua proprietà.

• L'error documentation descrive i seguenti nuovi errori:

  Tipo di errore	Dettagli dell'errore	Descrizione
  forbidden	insufficientCapabilities	Questo errore non riguarda un metodo API specifico. Indica che l'utente CMS che chiama l'API non dispone di autorizzazioni sufficienti per eseguire l'operazione richiesta. Questo errore è associato all'utilizzo del parametro onBehalfOfContentOwner, supportato da diversi metodi dell'API.
  unauthorized	authorizationRequired	Il metodo activities.list restituisce questo errore quando la richiesta utilizza il parametro home ma non è autorizzata correttamente.

• Nella risorsa channels, la proprietà invideoPromotion.channelId è stata rimossa perché l'ID canale è già specificato utilizzando la proprietà id della risorsa.

• La nuova guida Utilizzo degli ID canale spiega in che modo l'API utilizza gli ID canale. La guida può essere particolarmente utile per gli sviluppatori che eseguono la migrazione dalla versione precedente dell'API e che hanno applicazioni che richiedono contenuti per l'utente default o che si basano sull'idea che ogni canale YouTube ha un nome utente univoco, cosa che ora non è più così.

22 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

• Il nuovo metodo channelBanners.insert ti consente di caricare un'immagine banner che può essere successivamente impostata come immagine banner per un canale utilizzando la nuova proprietà brandingSettings.image.bannerExternalUrl della risorsa channel.

• La documentazione relativa al metodo channels.update è stata aggiornata per elencare le proprietà che possono essere modificate quando si chiama il metodo.

• Nella documentazione della risorsa video non è più indicato unspecified come valore di proprietà valido per le proprietà suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] e suggestions.editorSuggestions[].

• Il parametro maxResults del metodo videos.list ora ha un valore predefinito di 5.

• error documentation ora elenca gli errori per i metodi channelBanners.insert e subscriptions.list. Elenca anche diversi nuovi errori per il metodo channels.update.

14 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

• Le pagine autonome ora elencano esempi di codice per Java, .NET, PHP e Ruby.

• La pagina che elenca gli esempi di codice Python ora include esempi per l'aggiunta di un abbonamento, la creazione di una playlist e l'aggiornamento di un video.

10 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

• YouTube non identifica più funzionalità e servizi API sperimentali. Al suo posto, forniamo un elenco di API di YouTube soggette alle norme sul ritiro.

8 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

• Le risorse del canale ora supportano l'oggetto inVideoPromotion, che racchiude informazioni su una campagna promozionale associata al canale. Un canale può utilizzare una campagna promozionale in-video per mostrare le miniature di un video sponsorizzato all'interno del video player durante le riproduzioni dei video del canale.

  Per recuperare questi dati, includi invideoPromotion nel valore del parametro part in una richiesta channels.list.

• Il nuovo metodo channels.update può essere utilizzato per aggiornare i dati delle campagne promozionali in-video di un canale. Tieni presente che il metodo supporta solo gli aggiornamenti alla parte invideoPromotion della risorsa channel e non ancora gli aggiornamenti ad altre parti della risorsa.

2 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

• Le risorse del canale ora supportano la proprietà status.isLinked, che indica se i dati del canale identificano un utente già collegato a un nome utente YouTube o a un account Google+. Un utente che possiede uno di questi link dispone già di un'identità pubblica su YouTube, che è un prerequisito per diverse azioni, come il caricamento di video.

• Le risorse di abbonamento ora supportano la parte subscriberSnippet. L'oggetto incapsula contiene i dati di snippet per il canale dell'abbonato.

• L'API ora supporta il metodo videos.getRating, che recupera le valutazioni assegnate dall'utente autenticato a un elenco di uno o più video.

• Il nuovo parametro myRating del metodo videos.list ti consente di recuperare un elenco di video valutati dall'utente autenticato con una valutazione like o dislike.

  Il parametro myRating e il parametro id sono ora entrambi considerati parametri di filtro, il che significa che una richiesta API deve specificare esattamente uno di questi parametri. In precedenza, il parametro id era obbligatorio per questo metodo.

  Il metodo restituisce un errore forbidden per le richieste che tentano di recuperare informazioni sulla classificazione dei video ma non sono autorizzate in modo adeguato.

• Con l'introduzione del parametro myRating, anche il metodo videos.list è stato aggiornato per supportare l'impaginazione. Tieni presente, tuttavia, che i parametri di paging sono supportati solo per le richieste che utilizzano il parametro myRating. Le informazioni e i parametri di presentazione non sono supportati per le richieste che utilizzano il parametro id.

  • Il parametro maxResults specifica il numero massimo di video che l'API può restituire nel set di risultati e il parametro pageToken identifica una pagina specifica del set di risultati da recuperare.

  • La risorsa youtube#videoListResponse, che viene restituita in risposta a una richiesta videos.list, ora contiene l'oggetto pageInfo, contenente dettagli quali il numero totale di risultati e il numero di risultati inclusi nel set di risultati corrente. La risorsa youtube#videoListResponse può anche includere le proprietà nextPageToken e prevPageToken, ciascuna delle quali fornisce un token che può essere utilizzato per recuperare una pagina specifica nel set di risultati.

• Il metodo videos.insert supporta i seguenti nuovi parametri:

  • autoLevels - Imposta il valore di questo parametro su true per indicare a YouTube di migliorare automaticamente l'illuminazione e il colore del video.
  • stabilize - Imposta il valore di questo parametro su true per indicare a YouTube di regolare il video eliminando i tremori causati dai movimenti della videocamera.

• La proprietà channelTitle è stata aggiunta a snippet per le seguenti risorse:

  • playlistItem - La proprietà specifica il nome del canale che ha aggiunto l'elemento della playlist.
  • playlist - La proprietà specifica il nome del canale che ha creato la playlist.
  • subscription - La proprietà specifica il nome del canale a cui è iscritto.

• Sono stati aggiunti esempi di codice per i seguenti metodi:

  • activities.insert (rubino)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• Il nuovo parametro mySubscribers del metodo subscriptions.list ti consente di recuperare un elenco degli abbonati degli utenti attualmente autenticati. Questo parametro può essere utilizzato solo in una richiesta debitamente autorizzata.

  Nota: questa funzionalità ha lo scopo di sostituire il parametro mySubscribers attualmente supportato per il metodo channels.list. Questo parametro verrà ritirato.

• In una risorsa video, il valore della proprietà unspecified non è più un valore possibile per nessuna delle seguenti proprietà:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Le richieste API che contengono un parametro imprevisto ora restituiscono un errore badRequest e il motivo segnalato per l'errore è unexpectedParameter.

• L'errore restituito dal metodo playlistItems.insert quando la playlist contiene già il numero massimo di elementi consentiti è stato aggiornato. L'errore è ora segnalato come forbidden e il motivo è playlistContainsMaximumNumberOfVideos.

19 aprile 2013

Questo aggiornamento contiene le seguenti modifiche:

• Il nuovo metodo videos.rate consente a un utente di impostare una valutazione di like o dislike per un video o di rimuoverla da un video.

  Anche la documentazione relativa agli errori è stata aggiornata per elencare gli errori che l'API potrebbe restituire in risposta a una chiamata al metodo videos.rate.

• Ora le immagini in miniatura sono identificate nella documentazione dell'API come risorsa separata e il nuovo metodo thumbnails.set ti consente di caricare una miniatura personalizzata del video su YouTube e di impostarla per un video.

  Anche la documentazione relativa agli errori è stata aggiornata per elencare gli errori che l'API potrebbe restituire in risposta a una chiamata al metodo thumbnails.set.

  Tieni presente che questa modifica non influisce sulle risorse esistenti che restituiscono immagini in miniatura. Le immagini in miniatura vengono restituite in queste risorse come in precedenza, anche se la documentazione ora elenca i nomi delle diverse dimensioni delle miniature che l'API potrebbe restituire.

• La nuova parte brandingSettings della risorsa channel identifica le impostazioni, il testo e le immagini della pagina del canale e delle pagine di visualizzazione dei video.

• La risorsa playlistItem contiene le seguenti nuove proprietà:

  • Il nuovo oggetto status incapsula le informazioni sullo stato relative all'elemento della playlist, mentre la proprietà status.privacyStatus identifica lo stato di privacy dell'elemento.

• La risorsa video contiene le seguenti nuove proprietà:

  • La proprietà status.publicStatsViewable indica se le statistiche dei video estese sulla pagina di visualizzazione sono visibili pubblicamente. Queste statistiche sono visibili per impostazione predefinita e statistiche come il numero di visualizzazioni e i voti di un video continueranno a essere visibili pubblicamente anche se il valore di questa proprietà è impostato su false. Puoi impostare il valore di questa proprietà quando chiami il metodo videos.insert o videos.update.

  • L'oggetto contentDetails.contentRating include le classificazioni ricevute dal video in base a vari schemi di classificazione. L'elenco che segue identifica i sistemi di classificazione supportati e fornisce un link alla proprietà associata a ogni sistema di classificazione. Le definizioni delle proprietà identificano i valori di classificazione supportati per ciascun sistema.

    Paese	Sistema di classificazione	Proprietà
    Stati Uniti	MPAA (Motion Picture Association of America)	contentDetails.contentRating.mpaaRating
    Stati Uniti	TV Parental Guidelines	contentDetails.contentRating.tvpgRating
    Australia	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brasile	Dipartimento di Giustizia, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	Sistema di classificazione video domestico canadese (CHVRS)	contentDetails.contentRating.chvrsRating
    Francia	Centre national du cinéma et de l'image animée (Ministero della cultura francese)	contentDetails.contentRating.fmocRating
    Germania	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Gran Bretagna	BBFC (British Board of Film Classification)	contentDetails.contentRating.bbfcRating
    India	Certificazione CBFC (Central Board of Film Certification)	contentDetails.contentRating.cbfcRating
    Giappone	映倫管理委員號 (EIRIN)	contentDetails.contentRating.eirinRating
    Corea	영상물등무선방 (KMRB)	contentDetails.contentRating.kmrbRating
    Messico	Direzione generale della radio, televisione e cinematografia (RTC)	contentDetails.contentRating.rtcRating
    Nuova Zelanda	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    Russia	Registro nazionale del cinema della Federazione Russa	contentDetails.contentRating.russiaRating
    Spagna	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• La documentazione del metodo playlistItems.update è stata aggiornata per riflettere il fatto che la proprietà snippet.resourceId deve essere specificata nella risorsa inviata come corpo della richiesta.

• Il metodo search.list ora supporta la seguente funzionalità:

  • Il nuovo parametro forMine limita una ricerca al fine di recuperare solo i video dell'utente autenticato.

  • Il parametro order ora supporta la possibilità di ordinare i risultati in ordine alfabetico per titolo (order=title) o per conteggio dei video in ordine decrescente (order=videoCount).

  • Il nuovo parametro safeSearch indica se i risultati di ricerca devono includere contenuti con limitazioni.

• Il metodo videos.insert supporta diversi nuovi errori, elencati nella tabella seguente:

  Tipo di errore	Dettagli dell'errore	Descrizione
  badRequest	invalidCategoryId	La proprietà snippet.categoryId specifica un ID categoria non valido. Utilizza il metodo videoCategories.list per recuperare le categorie supportate.
  badRequest	invalidRecordingDetails	metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	I metadati della richiesta specificano una classificazione non valida per il videogioco.
  badRequest	invalidVideoMetadata	I metadati della richiesta non sono validi.

• Il parametro onBehalfOfContentOwner è stato rimosso dall'elenco dei parametri supportati per i metodi videos.update e videos.delete.

12 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

• La proprietà channelTitle è stata aggiunta a snippet per le seguenti risorse:

  • activity - La proprietà specifica il nome del canale responsabile dell'attività.
  • search - La proprietà specifica il nome del canale associato alla risorsa identificata dal risultato di ricerca.
  • video - La proprietà specifica il nome del canale che ha caricato il video.

• Il metodo search.list supporta i seguenti nuovi parametri:

  • Il parametro channelType ti consente di limitare la ricerca dei canali per recuperare tutti i canali o solo i programmi.

  • Il parametro videoType ti consente di limitare una ricerca di video per recuperare tutti i video o solo i film o solo le puntate dei programmi.

• La definizione della parte recordingDetails della risorsa video è stata aggiornata per notare che l'oggetto verrà restituito per un video solo se sono stati impostati i dati di geolocalizzazione o il tempo di registrazione del video.

• Il metodo playlistItems.update ora restituisce un errore invalidSnippet, che viene restituito se la richiesta API non specifica uno snippet valido.

• Diversi metodi dell'API supportano nuovi parametri destinati esclusivamente ai partner della rete di contenuti di YouTube. I partner per i contenuti di YouTube includono studi cinematografici e televisivi, case discografiche e altri creator di contenuti che rendono disponibili i loro contenuti su YouTube.

  • Il parametro onBehalfOfContentOwner indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube CMS che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. L'account CMS con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato.

    Questo parametro è destinato ai partner della rete di contenuti che possiedono e gestiscono molti canali YouTube diversi. Il parametro consente ai partner di eseguire l'autenticazione una sola volta e di accedere a tutti i dati dei loro video e del loro canale, senza dover fornire le credenziali di autenticazione per ogni singolo canale.

    Questo parametro è supportato dai metodi channels.list, search.list, videos.delete, videos.list e videos.update.

  • Il parametro managedByMe, supportato dal metodo channels.list, indica all'API di restituire tutti i canali di proprietà del proprietario dei contenuti specificato dal parametro onBehalfOfContentOwner.

  • Il parametro forContentOwner, supportato dal metodo search.list, indica all'API di limitare i risultati di ricerca in modo da includere solo le risorse di proprietà del proprietario dei contenuti specificato dal parametro onBehalfOfContentOwner.

25 febbraio 2013

Questo aggiornamento contiene le seguenti modifiche:

• L'API supporta diverse nuove parti e proprietà per le risorse video:

  • Le nuove parti fileDetails, processingDetails e suggestions forniscono ai proprietari dei video informazioni sui loro video caricati. Questi dati sono molto utili nelle applicazioni che consentono il caricamento di video e includono quanto segue:

    • stato e avanzamento dell'elaborazione
    • errori o altri problemi riscontrati durante l'elaborazione di un video
    • disponibilità di immagini in miniatura
    • suggerimenti per migliorare la qualità dei video o dei metadati
    • i dettagli relativi al file originale caricato su YouTube

    Tutte queste parti possono essere recuperate solo dal proprietario del video. L'elenco riportato di seguito descrive brevemente le nuove parti e la documentazione delle risorse video definisce tutte le proprietà contenute in ogni parte.

    • L'oggetto fileDetails contiene informazioni sul file video caricato su YouTube, tra cui risoluzione e durata del file, codec audio e video, velocità in bit dello stream e altro ancora.

    • L'oggetto processingProgress contiene informazioni sull'avanzamento di YouTube nell'elaborazione del file video caricato. Le proprietà dell'oggetto identificano lo stato di elaborazione corrente e stimano il tempo restante prima che YouTube finisca di elaborare il video. Questa parte indica inoltre se sono disponibili diversi tipi di dati o contenuti, come i dettagli dei file o le immagini in miniatura, per il video.

      Questo oggetto è progettato per essere oggetto di polling, in modo che l'utente che ha caricato il video possa monitorare i progressi compiuti da YouTube nell'elaborazione del file video caricato.

    • L'oggetto suggestions contiene suggerimenti che identificano opportunità per migliorare la qualità del video o i metadati del video caricato.

  • La parte contentDetails contiene quattro nuove proprietà. Queste proprietà possono essere recuperate con richieste non autenticate.

    • dimension - Indica se il video è disponibile in 2D o 3D.
    • definition – Indica se il video è disponibile in definizione standard o alta.
    • caption. Indica se sono disponibili i sottotitoli codificati per il video.
    • licensedContent. Indica se il video include contenuti che sono stati rivendicati da un partner per i contenuti di YouTube.

  • La parte status contiene due nuove proprietà. I proprietari dei video possono impostare i valori per entrambe le proprietà quando inseriscono o aggiorna un video. Queste proprietà possono essere recuperate anche con richieste non autenticate.

    • embeddable. Indica se il video può essere incorporato in un altro sito web.
    • license - Specifica la licenza del video. I valori validi sono creativeCommon e youtube.

• La definizione del parametro part è stata aggiornata per i metodi videos.list, videos.insert e videos.update al fine di elencare le parti appena aggiunte, descritte in precedenza, e la parte recordingDetails, che sono state inavvertitamente omesse.

• La nuova proprietà contentDetails.googlePlusUserId della risorsa channel specifica l'ID profilo Google+ associato al canale. Questo valore può essere utilizzato per generare un link al profilo Google+.

• Ogni oggetto immagine in miniatura ora specifica la larghezza e l'altezza dell'immagine. Al momento le immagini in miniatura vengono restituite nelle risorse activity, channel, playlist, playlistItem, search result, subscription e video.

• playlistItems.list ora supporta il parametro videoId, che può essere utilizzato in combinazione con il parametro playlistId per recuperare solo l'elemento della playlist che rappresenta il video specificato.

  L'API restituisce un errore notFound se non è possibile trovare il video identificato dal parametro nella playlist.

• La documentazione relativa agli errori descrive un nuovo errore forbidden, che indica che una richiesta non è autorizzata correttamente per l'azione richiesta.

• La proprietà snippet.channelId della risorsa channel è stata rimossa. La proprietà id della risorsa fornisce lo stesso valore.

30 gennaio 2013

Questo aggiornamento contiene le seguenti modifiche:

• La nuova pagina relativa agli errori elenca gli errori che l'API può restituire. La pagina include errori generali, che potrebbero verificarsi per diversi metodi dell'API, nonché errori specifici dei metodi.

16 gennaio 2013

Questo aggiornamento contiene le seguenti modifiche:

• Sono ora disponibili esempi di codice per i metodi e i linguaggi riportati nell'elenco seguente:

  • activities.insert - Java
  • playlistItems.insert - Python
  • playlistItems.list: Java, JavaScript, PHP, Python, Ruby
  • playlists.insert: Java, JavaScript, Python
  • search.list: Java, JavaScript, Python, Ruby
  • videos.insert - Java

• Una risorsa activity ora può segnalare un'azione channelItem, che si verifica quando YouTube aggiunge un video a un canale YouTube generato automaticamente. YouTube identifica in modo algoritmico gli argomenti che hanno una presenza significativa sul sito web di YouTube e genera automaticamente i canali pertinenti.

• I seguenti parametri search.list sono stati aggiornati:

  • Il parametro q non è più designato come filtro, il che significa che...
  • Il parametro relatedToVideo è stato rinominato relatedToVideoId.
  • Il parametro published è stato sostituito con due nuovi parametri, publishedAfter e publishedBefore, descritti di seguito.

• Il metodo search.list supporta i seguenti nuovi parametri:

  Nome del parametro	Valore	Descrizione
  channelId	string	Restituire le risorse create dal canale specificato.
  publishedAfter	datetime	Restituire le risorse create dopo il periodo di tempo specificato.
  publishedBefore	datetime	Restituire le risorse create prima dell'ora specificata.
  regionCode	string	Restituisci le risorse per il paese specificato.
  videoCategoryId	string	Filtra i risultati di ricerca dei video in modo da includere solo i video associati alla categoria di video specificata.
  videoEmbeddable	string	Filtra i risultati di ricerca dei video in modo da includere solo i video che possono essere riprodotti in un player incorporato in una pagina web. Imposta il valore del parametro su true per recuperare solo i video incorporabili.
  videoSyndicated	string	Filtra i risultati di ricerca dei video in modo da includere solo i video che possono essere riprodotti al di fuori di YouTube.com. Imposta il valore del parametro su true per recuperare solo i video in syndication.

• Diverse risorse API supportano nuove proprietà. La tabella seguente identifica le risorse e le loro nuove proprietà:

  Risorsa	Nome proprietà	Valore	Descrizione
  activity	contentDetails.playlistItem.playlistItemId	string	L'ID elemento della playlist assegnato da YouTube per identificare in modo univoco l'elemento della playlist.
  activity	contentDetails.channelItem	object	Un oggetto che contiene informazioni su una risorsa aggiunta a un canale. Questa proprietà è presente solo se snippet.type è channelItem.
  activity	contentDetails.channelItem.resourceId	object	Un oggetto che identifica la risorsa aggiunta al canale. Come le altre proprietà resourceId, contiene una proprietà kind che specifica il tipo di risorsa, ad esempio video o playlist. Contiene inoltre esattamente una delle varie proprietà (videoId, playlistId e così via) che specifica l'ID che identifica in modo univoco quella risorsa.
  channel	status	object	Questo oggetto contiene informazioni sullo stato della privacy del canale.
  channel	status.privacyStatus	string	Lo stato della privacy del canale. I valori validi sono private e public.
  playlist	contentDetails	object	Questo oggetto contiene metadati relativi ai contenuti della playlist.
  playlist	contentDetails.itemCount	unsigned integer	Il numero di video nella playlist.
  playlist	player	object	Questo oggetto contiene le informazioni che useresti per riprodurre la playlist in un player incorporato.
  playlist	player.embedHtml	string	Un tag <iframe> che incorpora un video player che riproduce la playlist.
  video	recordingDetails	object	Questo oggetto contiene informazioni che identificano o descrivono il luogo e l'ora in cui il video è stato registrato.
  video	recordingDetails.location	object	Questo oggetto contiene informazioni di geolocalizzazione associate al video.
  video	recordingDetails.location.latitude	double	Latitudine in gradi.
  video	recordingDetails.location.longitude	double	Longitudine in gradi.
  video	recordingDetails.location.elevation	double	Altitudine sopra la Terra, in metri.
  video	recordingDetails.locationDescription	string	Una descrizione testuale del luogo in cui il video è stato registrato.
  video	recordingDetails.recordingDate	datetime	La data e l'ora in cui il video è stato registrato. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• La documentazione relativa a diversi metodi dell'API ora identifica le proprietà che devono essere specificate nel corpo della richiesta o che vengono aggiornate in base ai valori nel corpo della richiesta. La tabella seguente elenca questi metodi e le proprietà richieste o modificabili.

  Nota:la documentazione relativa ad altri metodi potrebbe già elencare le proprietà obbligatorie e modificabili.

  Metodo	Proprietà
  activities.insert	Proprietà obbligatorie: snippet.description Proprietà modificabili: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Proprietà obbligatorie: id
  playlistItems.update	Proprietà obbligatorie: id
  videos.update	Proprietà obbligatorie: id

• L'API non segnala più un errore playlistAlreadyExists se cerchi di creare o aggiornare una playlist che ha lo stesso titolo di una playlist già esistente nello stesso canale.

• Diversi metodi dell'API supportano nuovi tipi di errori. La tabella seguente identifica il metodo e i nuovi errori supportati:

  Metodo	Tipo di errore	Dettagli dell'errore	Descrizione
  guideCategories.list	notFound	notFound	Impossibile trovare la categoria della guida identificata dal parametro id. Utilizza il metodo guideCategories.list per recuperare un elenco di valori validi.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	La richiesta non è autorizzata correttamente a eliminare l'elemento della playlist specificato.
  videoCategories.list	notFound	videoCategoryNotFound	Impossibile trovare la categoria di video identificata dal parametro id. Utilizza il metodo videoCategories.list per recuperare un elenco di valori validi.