Cronologia revisioni

Questa pagina elenca le modifiche e gli aggiornamenti della documentazione dell'API YouTube Data (v3). Iscriviti a questo log delle modifiche. Iscriviti

10 luglio 2025

A partire dal 21 luglio 2025, YouTube modificherà i contenuti restituiti dal grafico mostPopular del metodo video.list. In passato, il grafico mostPopular rifletteva i video presenti nell'elenco Tendenze. Ora, la classifica mostPopular includerà i video delle classifiche Musica di tendenza, Film di tendenza e Giochi di tendenza. Questa modifica dell'API è in linea con il ritiro della pagina Tendenze di YouTube.

26 marzo 2025

A partire dal 31 marzo 2025, YouTube cambierà il modo in cui vengono conteggiate le visualizzazioni degli Short. In passato, per gli Short, una visualizzazione veniva conteggiata dopo che uno Short era stato riprodotto per un certo numero di secondi. Ora, le visualizzazioni terranno conto del numero di volte in cui uno Short viene riprodotto o rivisto, senza alcun requisito di tempo di visualizzazione minimo. Scopri di più

A partire dal 31 marzo 2025, i seguenti campi dell'API Data restituiranno il conteggio delle visualizzazioni degli Short in base a questa modifica:

  • channels.statistics.viewCount
  • videos.statistics.viewCount

30 ottobre 2024

L'API ora supporta la possibilità di identificare i video che contengono contenuti alterati o sintetici (A/S) dall'aspetto realistico. Scopri di più sulle norme di YouTube relative ai contenuti generati o assistiti dall'IA.

Ecco alcuni esempi di contenuti A/S:

  • Far dire o fare a una persona reale qualcosa che non ha detto o fatto
  • Alterare il filmato di un evento o un luogo reale
  • Generare una scena realistica che non è realmente avvenuta

Per indicare se un video contiene contenuti pubblicitari, imposta la proprietà status.containsSyntheticMedia. Questa proprietà può essere impostata quando si chiamano i metodi videos.insert o videos.update. Se impostata, la proprietà viene restituita nella risorsa video.

30 aprile 2024

Nota:questo è un annuncio di ritiro.

Questo aggiornamento contiene le seguenti modifiche:

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

13 marzo 2024

Nota:questo è un annuncio di ritiro.

Questo aggiornamento contiene le seguenti modifiche:

Il parametro sync per i metodi captions.insert e captions.update è stato dichiarato obsoleto. YouTube non supporterà più il parametro a partire dal 12 aprile 2024.

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

12 marzo 2024

Questo aggiornamento contiene le seguenti modifiche:

La documentazione per la risorsa captions è stata aggiornata per indicare che la lunghezza massima consentita per il campo snippet.name è di 150 caratteri. L'API restituisce un errore nameTooLong se il nome della traccia è più lungo.

7 marzo 2024

Nota:questo è un annuncio di ritiro.

La proprietà della risorsa channel brandingSettings.channel.moderateComments è stata ritirata. YouTube non supporterà più il parametro a partire dal 7 marzo 2024.

31 gennaio 2024

Questo aggiornamento contiene le seguenti modifiche:

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

9 novembre 2023

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

12 settembre 2023

Nota:questo è un annuncio di ritiro.

Il metodo comments.markAsSpam è deprecato da diversi anni. Questo metodo non è più supportato su YouTube e non è più supportato tramite l'API.

È stata aggiunta una notifica sul ritiro a tutti i documenti che fanno riferimento al metodo comments.markAsSpam.

22 agosto 2023

Il metodo search.list ora supporta il parametro videoPaidProductPlacement. Questo parametro ti consente di filtrare i risultati di ricerca in modo da includere solo i video che il creator ha indicato come contenenti una promozione a pagamento.

18 agosto 2023

La definizione della risorsa video liveStreamingDetails.concurrentViewers è stata aggiornata per indicare che i conteggi degli spettatori simultanei restituiti dall'API YouTube Data potrebbero differire da quelli elaborati e ripuliti dallo spam disponibili tramite YouTube Analytics. Il Centro assistenza YouTube fornisce maggiori informazioni sulle metriche del live streaming.

7 agosto 2023

Come annunciato il 12 giugno 2023, il parametro relatedToVideoId del metodo search.list è stato ritirato. 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 l'errore uploadRateLimitExceeded, che indica che il canale ha caricato troppe miniatura nelle ultime 24 ore e deve riprovare più tardi.

12 giugno 2023

Nota:questo è un annuncio di ritiro.

Il parametro relatedToVideoId del metodo search.list è stato ritirato. YouTube non supporterà più il parametro a partire dal 7 agosto 2023.

Al momento, è stata aggiunta una notifica sul ritiro alla documentazione del metodo search.list. Questo parametro verrà rimosso completamente dalla documentazione di search.list a partire dal 7 agosto 2023.

Inoltre, un esempio che mostra come recuperare i video correlati è stato rimosso dalla guida all'implementazione dell'API.

22 agosto 2022

Sono state corrette le annotazioni dei tipi per i campi video.statistics in modo che la stringa sia di tipo unsigned long.

5 agosto 2022

YouTube ha modificato il modo in cui vengono generati gli ID didascalia e, nell'ambito di questa modifica, sta assegnando nuovi ID didascalia a tutte le tracce di didascalie. Questa modifica potrebbe essere incompatibile con le versioni precedenti per le applicazioni che memorizzano valori caption_id, anche se non influirà sulle applicazioni che non memorizzano valori caption_id.

Da oggi al 1° dicembre 2022, i metodi captions.list, captions.update, captions.download e captions.delete supporteranno sia gli ID traccia delle didascalie vecchi che quelli nuovi. Tuttavia, a partire dal 1° dicembre 2022, YouTube non supporterà più i vecchi ID traccia dei sottotitoli codificati. A quel punto, la chiamata a uno qualsiasi di questi metodi API con un vecchio ID traccia dei sottotitoli codificati genererà un errore captionNotFound.

Per prepararti a questa modifica, pianifica di sostituire completamente tutti i dati delle tracce di sottotitoli codificati memorizzati entro il 1° dicembre 2022. Ciò significa che per qualsiasi video per il quale memorizzi i dati delle tracce dei sottotitoli codificati, devi eliminare i dati attualmente memorizzati, quindi chiamare il metodo captions.list per recuperare l'insieme corrente di tracce dei sottotitoli codificati per il video e memorizzare i dati nella risposta dell'API come faresti normalmente.

12 luglio 2022

I Termini di servizio dei servizi API di YouTube sono stati aggiornati. Per ulteriori informazioni, consulta la cronologia delle revisioni dei Termini di servizio dei servizi API di YouTube.

27 aprile 2022

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

8 aprile 2022

Le definizioni dei parametri myRecentSubscribers e mySubscribers del metodo subscriptions.list sono state aggiornate per indicare che il numero massimo di iscritti restituito dall'API potrebbe essere limitato. Questa modifica rappresenta una correzione della documentazione e non un cambiamento nel comportamento dell'API.

15 dicembre 2021

Come annunciato il 18 novembre 2021, in concomitanza con le modifiche per rendere privati i conteggi dei non mi piace dei video sull'intera piattaforma YouTube, la proprietà statistics.dislikeCount della risorsa video è ora privata.

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

18 novembre 2021

Insieme alle modifiche per rendere privati i conteggi dei Non mi piace dei video su tutta la piattaforma YouTube, la proprietà video della risorsa statistics.dislikeCount diventerà privata a partire dal 13 dicembre 2021. Ciò significa che la proprietà verrà inclusa in una risposta API dall'endpoint videos.list solo se la richiesta API è stata autenticata dal proprietario del video.

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

Gli sviluppatori che non mostrano pubblicamente il conteggio dei non mi piace e hanno comunque bisogno di questo dato per il proprio client API possono richiedere di essere inseriti in una lista consentita per un'esenzione. Per richiedere un'esenzione, devi compilare questo modulo di richiesta.

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

2 luglio 2021

Nota:questo è un annuncio di ritiro.

L'endpoint commentThreads.update è stato ritirato e non è più supportato. Questo endpoint duplica la funzionalità disponibile tramite altri endpoint API. In alternativa, puoi chiamare il numero comments.update

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

1° luglio 2021

Tutti gli sviluppatori che utilizzano i servizi API di YouTube devono completare un controllo di conformità delle API per ottenere una quota superiore all'allocazione predefinita di 10.000 unità. Finora, sia la procedura di verifica della conformità sia le richieste di allocazione di unità di quota aggiuntive sono state eseguite dagli sviluppatori compilando e inviando il modulo di controllo ed estensione della quota dei servizi API di YouTube.

Per chiarire queste procedure e soddisfare meglio le esigenze degli sviluppatori che utilizzano i nostri servizi API, stiamo aggiungendo tre nuovi moduli e una guida per compilarli:

  • Modulo di richiesta per sviluppatori sottoposti a verifica: gli sviluppatori che hanno già superato un controllo di conformità dell'API possono compilare e inviare questo modulo più breve per richiedere un'estensione della quota allocata.
  • Modulo di ricorso: gli sviluppatori i cui progetti API non hanno superato un controllo di conformità (o a cui è stato negato un aumento delle unità di quota) possono compilare e inviare questo modulo.
  • Modulo per il cambio di controllo: gli sviluppatori o qualsiasi parte che gestisce un client API per conto di uno sviluppatore che registra un cambio di controllo (ad esempio, tramite un acquisto o una vendita di azioni, una fusione o un'altra forma di transazione aziendale) associato a un progetto API deve compilare e inviare questo modulo. In questo modo, il team API di YouTube può aggiornare i nostri record, controllare la conformità del caso d'uso del nuovo progetto API e convalidare l'allocazione della quota attuale dello sviluppatore.

Ogni nuovo modulo ci informerà sull'utilizzo previsto dell'API di YouTube e ci consentirà di fornirti un'assistenza migliore.

Per ulteriori dettagli, consulta la nostra nuova guida agli audit di conformità delle API.

12 maggio 2021

Nota:questo è un annuncio di ritiro.

Questo aggiornamento riguarda le seguenti modifiche all'API:

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

    Prima di questo aggiornamento, l'API creava comunque una nuova playlist se un client API tentava di aggiungere un video a una playlist dei preferiti inesistente. In futuro, la playlist non verrà creata in questo caso e l'API restituirà un errore. Anche i tentativi di modificare le playlist dei preferiti aggiungendo, modificando o eliminando elementi sono tutti ritirati in base agli annunci precedenti e potrebbero iniziare a restituire errori in qualsiasi momento.

  • Le seguenti proprietà della 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 neanche 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 rappresentazione della risorsa e le loro definizioni sono state rimosse dall'elenco delle proprietà della risorsa. Inoltre, gli errori associati a queste proprietà sono stati rimossi dalla documentazione specifica del metodo.

  • Le seguenti proprietà della 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 neanche tramite l'API.

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

    Insieme a questa modifica, anche il parametro hl del metodo channelSection.list è stato ritirato perché le funzionalità che supporta non sono supportate.

    Tutte le proprietà sono state rimosse dalla channelSection rappresentazione della risorsa e le loro definizioni sono state rimosse dall'elenco delle proprietà della risorsa. Inoltre, gli errori associati a queste proprietà sono stati rimossi dalla documentazione specifica del metodo.

  • Per la proprietà snippet.type della risorsa channelSection, i seguenti valori sono stati ritirati. Questi valori non sono già più supportati nelle pagine dei canali YouTube e, di conseguenza, non sono più supportati neanche tramite l'API.

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

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

9 febbraio 2021

La risorsa playlistItem supporta due nuove proprietà:

28 gennaio 2021

Questo aggiornamento contiene le seguenti modifiche:

  • I metodi playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list e playlists.update supportano 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).

  • Gli errori watchHistoryNotAccessible e watchLaterNotAccessible del metodo playlistItems.list sono stati rimossi dalla documentazione. Sebbene la cronologia delle visualizzazioni e gli elenchi Guarda più tardi degli utenti non siano accessibili tramite l'API, questi particolari errori non vengono restituiti dall'API.

15 ottobre 2020

Sono state aggiunte due nuove sezioni alle Norme per gli sviluppatori:

  • La nuova Sezione III.E.4.i fornisce informazioni aggiuntive sui dati raccolti e inviati tramite il player YouTube incorporato. Sei responsabile di tutti i dati utente che ci invii tramite qualsiasi player YouTube incorporato prima che l'utente abbia 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 il controllo dello stato di contenuti realizzati per i bambini prima di incorporarli nei tuoi siti e app. È tua responsabilità sapere quando i video che incorpori nel tuo client API sono destinati ai bambini e trattare di conseguenza i dati raccolti dal player incorporato. Pertanto, devi controllare lo stato dei contenuti utilizzando il servizio API YouTube Data prima di incorporarli nel client API tramite qualsiasi player incorporato di YouTube.

La nuova guida Trovare lo stato di un video come "realizzato per i bambini" spiega come cercare lo stato MFK di un video utilizzando il servizio API YouTube Data.

Insieme a queste modifiche, è stato aggiunto un promemoria alla documentazione sui parametri del player incorporato per spiegare che se attivi la riproduzione automatica, la riproduzione avverrà senza alcuna interazione dell'utente con il player; la raccolta e la condivisione dei dati di riproduzione avverranno quindi al caricamento della pagina.

8 ottobre 2020

Questo aggiornamento riguarda tre piccole modifiche relative alla risorsa channel:

  • L'oggetto snippet.thumbnails, che identifica le immagini in miniatura di un canale, potrebbe essere vuoto per i canali appena creati e potrebbe essere necessario fino a un giorno per il completamento.
  • La proprietà statistics.videoCount riflette il conteggio dei soli 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, identificate nella proprietà brandingSettings.channel.keywords, potrebbero essere troncate se superano la lunghezza massima consentita di 500 caratteri o se contengono virgolette non sottoposte a escape ("). Tieni presente che il limite di 500 caratteri non è un limite per parola chiave, ma un limite alla lunghezza totale di tutte le parole chiave. Questo comportamento è coerente con quello del sito web YouTube.

9 settembre 2020

Nota:questo è un annuncio di ritiro.

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

  • Le seguenti risorse, metodi, parametri e proprietà delle risorse API sono ritirati immediatamente e smetteranno di funzionare a partire dalla data di questo annuncio:
    • Le seguenti proprietà della risorsa channel:
      • Proprietà statistics.commentCount
      • L'oggetto brandingSettings.image e tutte le relative proprietà secondarie
      • L'elenco brandingSettings.hints e tutte le relative proprietà secondarie
    • Il parametro di filtro categoryId del metodo channels.list
    • Risorsa guideCategories e metodo guideCategories.list
  • Le risposte API per il metodo channels.list non contengono più la proprietà prevPageToken se la richiesta API imposta il parametro managedByMe su true. Questa modifica non influisce sulla proprietà prevPageToken per altre richieste channels.list e non influisce sulla proprietà nextPageToken per nessuna richiesta.
  • Le proprietà contentDetails.relatedPlaylists.watchLater e contentDetails.relatedPlaylists.watchHistory della risorsa channel sono state entrambe annunciate come ritirate l'11 agosto 2016. Il supporto dei metodi playlistItems.insert e playlistItems.delete per queste playlist è ora completamente deprecato e le due proprietà sono state rimosse dalla documentazione.
  • Il parametro mySubscribers del metodo channels.list, di cui è stato annunciato il ritiro il 30 luglio 2013, è stato rimosso dalla documentazione. Utilizza il metodo subscriptions.list e il relativo parametro mySubscribers per recuperare un elenco degli iscritti al canale dell'utente autenticato.
  • L'oggetto invideoPromotion della risorsa channel e tutte le relative proprietà secondarie, il cui ritiro è stato annunciato 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 il costo aggiuntivo associato al parametro part. Con effetto immediato, addebiteremo solo il costo base per il metodo chiamato. Puoi trovare maggiori informazioni sulla quota semplificata qui.

L'effetto di questa modifica è che la maggior parte delle chiamate API avrà un costo della quota leggermente inferiore, mentre alcune chiamate API avranno comunque lo stesso costo. Questa modifica non aumenta il costo delle chiamate API. Nel complesso, l'impatto probabile è che la quota allocata, visibile nella console Google Cloud, durerà un po' di più.

Consigliamo vivamente a tutti gli sviluppatori di completare una verifica della conformità per i loro progetti per garantire l'accesso continuo ai servizi API di YouTube.

Questa voce della cronologia delle revisioni è stata pubblicata originariamente il 20 luglio 2020.

28 luglio 2020

Tutti i video caricati tramite l'endpoint videos.insert da progetti API non verificati creati dopo il 28 luglio 2020 saranno limitati alla modalità di visualizzazione privata. Per eliminare questa limitazione, ogni progetto deve essere sottoposto a un audit per verificare la conformità ai Termini di servizio.

I creator che utilizzano un client API non verificato per caricare video riceveranno un'email in cui viene spiegato che il loro video è bloccato come privato e che possono evitare la limitazione utilizzando un client ufficiale o sottoposto ad audit.

I progetti API creati prima del 28 luglio 2020 non sono attualmente interessati da questa modifica. Tuttavia, consigliamo vivamente a tutti gli sviluppatori di completare una verifica della conformità per i loro progetti per garantire l'accesso continuo ai servizi API di YouTube.

21 luglio 2020

[Aggiornato il 28 luglio 2020.] L'aggiornamento della documentazione a cui fa riferimento questa voce della cronologia delle revisioni è stato ripubblicato il 28 luglio 2020.

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

7 luglio 2020

Nota:questo è un annuncio di ritiro.

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

15 giugno 2020

La nuova guida Conformità alle norme per gli sviluppatori di YouTube fornisce indicazioni ed esempi per aiutarti a garantire che i tuoi client API rispettino parti specifiche dei Termini e delle Norme dei servizi API di YouTube (TOS API).

Queste indicazioni offrono informazioni su come YouTube applica determinati aspetti dei TdS dell'API, ma non sostituiscono i documenti esistenti. La guida risponde ad alcune delle domande più comuni che gli sviluppatori pongono durante i controlli di conformità delle API. Ci auguriamo che semplifichi il processo di sviluppo delle funzionalità aiutandoti a capire come interpretiamo e applichiamo le nostre norme.

4 giugno 2020

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

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

17 aprile 2020

Nota:questo è un annuncio di ritiro.

YouTube sta ritirando la funzionalità dei bollettini del canale. Di conseguenza, il metodo activities.insert verrà deprecato e il metodo activities.list non restituirà più i bollettini del canale. Queste modifiche entreranno in vigore nell'API a partire dal 18 maggio 2020. Per maggiori dettagli, consulta il 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 abbonato fornisce un supporto monetario ricorrente a un creator e riceve vantaggi speciali. Ad esempio, gli abbonati possono chattare quando il creator attiva la modalità chat riservata agli abbonati.

      Questa risorsa sostituisce la risorsa sponsor, documentata nell'ambito dell'API YouTube Live Streaming. La risorsa sponsor è ora ritirata e i client API devono aggiornare le chiamate al metodo sponsors.list per utilizzare invece il metodo members.list.

    • La nuova risorsa membershipsLevel identifica un livello di prezzo gestito dal creator che ha autorizzato la richiesta API. Il metodo membershipsLevels.list recupera un elenco di tutti i livelli di abbonamento del creator.

10 gennaio 2020

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

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

  • La proprietà selfDeclaredMadeForKids consente ai creator di specificare se un canale o un video è destinato ai bambini.

    Per i canali, questa proprietà può essere impostata quando viene chiamato il metodo channels.update. Per i video, questa proprietà può essere impostata quando si chiamano i metodi videos.insert o videos.update.

    Tieni presente che questa proprietà è inclusa solo nelle risposte API che contengono risorse channel o video se il proprietario del canale ha autorizzato la richiesta API.
  • La proprietà madeForKids consente a qualsiasi utente di recuperare lo stato "destinato ai bambini" di un canale o di un video. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Per ulteriori informazioni sull'impostazione del pubblico per il tuo canale, i tuoi video o le tue trasmissioni, consulta il Centro assistenza YouTube.

Abbiamo anche aggiornato i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta la cronologia delle revisioni dei Termini di servizio dei servizi API di YouTube. Le modifiche ai Termini di servizio delle API di YouTube e alle Norme per gli sviluppatori entreranno in vigore il 10 gennaio 2020, ora del Pacifico.

10 settembre 2019

La documentazione di riferimento dell'API è stata aggiornata per riflettere una modifica al modo in cui vengono riportati i conteggi degli iscritti su YouTube e, di conseguenza, nelle risposte dell'API. A seguito della modifica, il numero di iscritti restituito dal servizio API YouTube Data viene arrotondato per difetto a tre cifre significative per i canali con più di 1000 iscritti. Questa modifica interessa la proprietà statistics.subscriberCount della risorsa channel.

Nota:questa modifica influisce sul valore della proprietà anche nei casi in cui un utente invia una richiesta autorizzata di dati sul proprio canale. I proprietari dei canali possono comunque visualizzare il numero esatto 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 vengono arrotondati i numeri degli iscritti nelle risposte API e abbreviati in altre interfacce utente di YouTube visibili pubblicamente:

Numero di iscritti di esempio API Data di YouTube Interfacce utente 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 dell'API è stata aggiornata per spiegare meglio i casi d'uso comuni per ogni metodo e per fornire esempi di codice dinamici e di alta qualità tramite il widget Explorer API. Per un esempio, consulta la documentazione del metodo channels.list. Ora nelle pagine che descrivono i metodi API sono presenti due nuovi elementi:

    • Il widget Explorer API ti consente di selezionare gli ambiti di autorizzazione, inserire valori di esempio per parametri e proprietà, quindi inviare richieste API effettive e visualizzare risposte API effettive. Il widget offre anche una visualizzazione a schermo intero che mostra esempi di codice completi, che vengono aggiornati dinamicamente per utilizzare gli ambiti e i valori che hai inserito.

    • La sezione Casi d'uso comuni descrive uno o più casi d'uso comuni per il metodo spiegato nella pagina. Ad esempio, puoi chiamare il metodo 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 compilare APIs Explorer con valori di esempio per il tuo caso d'uso o per aprire APIs Explorer a schermo intero con questi valori già compilati. Queste modifiche mirano a semplificare la visualizzazione di esempi di codice direttamente applicabili al caso d'uso che stai cercando di implementare nella tua applicazione.

    Al momento, gli esempi di codice sono supportati per Java, JavaScript, PHP, Python e curl.

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

    Insieme a questa modifica, sono state rimosse le pagine che in precedenza elencavano gli esempi di codice disponibili per Java, 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 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 indicare che, quando visualizzi le miniature nella tua applicazione, il codice deve utilizzare gli URL delle immagini 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 API.

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

  • Nota:questo è un annuncio di ritiro.

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

22 giugno 2018

La Guida all'implementazione, precedentemente nota come Guida all'implementazione e alla migrazione, è stata aggiornata per rimuovere le istruzioni per la migrazione dall'API v2 all'API v3. Inoltre, sono state rimosse anche le istruzioni per le funzionalità che sono state ritirate nell'API v3, come i video preferiti.

27 novembre 2017

Questo aggiornamento contiene le seguenti modifiche:

  • Nota:questo è un annuncio di ritiro.

    YouTube sta rimuovendo il supporto per le funzionalità Video in primo piano e Sito web in primo piano, supportate nell'API tramite l'oggetto invideoPromotion della risorsa channel. Di conseguenza, questo oggetto, comprese tutte le relative proprietà secondarie, verrà ritirato.

    Puoi comunque recuperare e impostare i dati di invideoPromotion fino al 14 dicembre 2017. Dopodiché:

    • I tentativi di recuperare la parte invideoPromotion durante la chiamata di channels.list restituiranno un invideoPromotion vuoto o nessun dato invideoPromotion.
    • I tentativi di aggiornamento dei dati invideoPromotion durante la chiamata a channels.update restituiranno una risposta positiva almeno fino al 27 maggio 2018, ma verranno trattati come no-op, il che significa che non eseguiranno effettivamente un aggiornamento.

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

16 novembre 2017

Questo aggiornamento contiene le seguenti modifiche:

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

    I campioni personalizzabili sono progettati per fornire un punto di partenza specifico per un caso d'uso per un'applicazione Node.js. La funzionalità è simile al codice della guida rapida di Node.js. Tuttavia, gli esempi contengono alcune funzioni di utilità che non sono presenti nella guida rapida:

    • La funzione removeEmptyParameters accetta un elenco di coppie chiave-valore corrispondenti ai parametri della richiesta API e rimuove i parametri senza valori.
    • La funzione createResource accetta un elenco di coppie chiave-valore corrispondenti alle proprietà di 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 loro: 
      # 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 eseguire 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 di snippet di codice interattivo sono stati aggiornati per utilizzare le librerie google-auth e google-auth-oauthlib anziché la libreria oauth2client, che ora è ritirata.

    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 visualizzare gli esempi completi (e questa modifica):

    1. Vai allo strumento interattivo per gli snippet di codice o alla documentazione di 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 quella di un campione completo.
    4. La scheda ora dovrebbe mostrare un esempio di codice completo che utilizza il flusso di autorizzazione InstalledAppFlow. La descrizione sopra l'esempio spiega questo aspetto e rimanda anche a un esempio per un'applicazione server web.
    5. Fai clic sul link per passare all'esempio di web server. Questo esempio utilizza il framework per applicazioni 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 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 indicare che, se questo 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 loghi e le icone del brand. I nuovi loghi "developed with YouTube" possono essere scaricati dalla pagina delle linee guida per il branding. Nella pagina sono mostrati anche altri nuovi loghi e icone di YouTube, che possono essere scaricati dal sito del brand YouTube.

24 luglio 2017

Questo aggiornamento contiene le seguenti modifiche:

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

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

1 giugno 2017

Questo aggiornamento contiene le seguenti modifiche:

17 maggio 2017

Questo aggiornamento contiene le seguenti modifiche:

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

    Per ogni metodo, lo strumento mostra snippet di codice per uno o più casi d'uso e ogni caso d'uso descrive un modo comune di chiamare il 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 gli esempi di codice:

    • Modifica i valori dei parametri e delle proprietà e gli snippet di codice vengono aggiornati dinamicamente in base ai valori che fornisci.

    • Alterna tra snippet di codice ed esempi completi. Uno snippet di codice mostra la porzione di codice che chiama il metodo API. Un esempio completo contiene questo snippet, nonché il codice boilerplate per autorizzare e inviare le richieste. Gli esempi completi possono essere copiati ed eseguiti dalla riga di comando o da un web server 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 l'Explorer API nelle pagine in cui è disponibile. Ogni pagina mostra un link che ti consente anche di caricare la richiesta su cui stai lavorando in Explorer API.

  • Anche lo strumento Snippet di codice dell'API Data è stato aggiornato con una nuova UI che offre tutte le funzionalità descritte sopra. 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 autorizzare gli utenti e creare richieste API.

27 aprile 2017

Questo aggiornamento contiene le seguenti modifiche:

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 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, ora la risorsa video 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 classificazione assegnata dalla Motion Picture Association of America al trailer o all'anteprima di un film.

27 febbraio 2017

Come annunciato originariamente l'11 agosto 2016, YouTube ha sostituito l'elenco supportato di ID argomento con 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:
    NomeID argomento
    Attività commerciale/m/09s1f
    Salute/m/0kt51
    Forze armate/m/01h6rj
    Politica/m/05qt0
    Religione/m/06bvp
  • L'argomento Animated cartoon, in precedenza figlio di Entertainment, è stato rimosso.
  • L'argomento Children's music, in precedenza figlio di Music, è stato rimosso.

A seguito di questa modifica, gli argomenti correlati a un video vengono sempre restituiti nel valore della proprietà topicDetails.relevantTopicIds[] della risorsa video.

29 novembre 2016

Questo aggiornamento contiene le seguenti modifiche:

  • A partire dal 10 febbraio 2017, verranno apportate tre piccole modifiche all'elenco degli ID argomento supportati:

    • La categoria Professional wrestling, che in precedenza era una categoria secondaria di Sports, ora è una categoria secondaria di Entertainment.
    • La categoria TV shows, che è un elemento figlio di Entertainment, è nuova.
    • La categoria Health, in precedenza secondaria di Lifestyle, è stata rimossa.

    Tieni presente anche che esistono alcune categorie principali (Entertainment, Gaming, Lifestyle, Music e Sports). Qualsiasi video associato a una categoria secondaria, come Tennis, verrà associato 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. Puoi anche utilizzare il parametro di ricerca topicId per trovare canali o video correlati a un determinato argomento.

    Il 10 febbraio 2017, YouTube inizierà a restituire un piccolo insieme di ID argomento anziché l'insieme molto più granulare di ID restituito finora. Inoltre, tieni presente che non è garantita l'associazione di canali e video a determinati argomenti, in linea con il comportamento attuale dell'API.

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

  • Nota:questo è un annuncio di ritiro.

    Le seguenti proprietà sono in fase di ritiro:

    • La proprietà topicDetails.topicIds[] della risorsa channel. Questa proprietà sarà supportata fino al 10 novembre 2017.
    • La proprietà topicDetails.relevantTopicIds[] della risorsa video. Questa proprietà sarà supportata fino al 10 novembre 2017.
    • La 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 ritirato, la guida Ricerca con gli argomenti di Freebase è stata rimossa dalla documentazione. Questa guida forniva esempi di codice per mostrare come un'applicazione avrebbe funzionato con l'API Freebase.

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

2 novembre 2016

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove proprietà e 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 sono 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 una 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 attribuita al video in Vietnam.

    • Il metodo videos.list supporta due nuovi parametri, maxHeight e maxWidth. Puoi utilizzare uno o entrambi i parametri quando recuperi la parte player nelle risorse video.

      Per impostazione predefinita, l'altezza di <iframe> restituita nella proprietà player.embedHtml è 360 px. La larghezza si adatta alle proporzioni del video, garantendo così che il player incorporato non abbia barre nere che incorniciano il video. 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 adatte al layout dell'applicazione. Il server API ridimensiona le dimensioni del player in modo appropriato per garantire che il player incorporato non abbia barre nere che incorniciano il video. Tieni presente che entrambi i parametri specificano le dimensioni massime del player incorporato. Pertanto, se vengono specificati entrambi i parametri, una dimensione potrebbe comunque essere inferiore alla quantità massima consentita per quella dimensione.

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

      • Se il parametro maxHeight è impostato su 720 e il parametro maxWidth non è impostato, l'API restituirà un player 1280x720.
      • Se il parametro maxWidth è impostato su 960 e il parametro maxHeight non è impostato, l'API restituirà un player 960x540.
      • Se il parametro maxWidth è impostato su 960 e il parametro maxHeight è impostato su 450, l'API restituirà un player 800x450.

      Le nuove proprietà player.embedHeight e player.embedWidth, descritte sopra, 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 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 ritirate. 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, che è già supportato per diversi altri metodi. Le richieste che utilizzano questo metodo devono anche 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 aggiornati per indicare che i valori dei parametri sono inclusi. 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 indicare che la dimensione massima dei file per i video caricati è aumentata da 64 GB a 128 GB.

  • Errori nuovi e aggiornati

    • L'API supporta i seguenti nuovi errori:

      Tipo di errore Dettaglio errore Descrizione
      forbidden (403) homeParameterDeprecated Il metodo activities.list restituisce questo errore per indicare che i dati sull'attività della 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 gli elementi della playlist "Cronologia delle visualizzazioni", ma questi non possono essere recuperati utilizzando l'API.
      forbidden (403) watchLaterNotAccessible Il metodo playlistItems.list restituisce questo errore per indicare che la richiesta ha tentato di recuperare gli elementi della playlist "Guarda più tardi", ma questi non possono essere recuperati utilizzando 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 avere l'autorizzazione per offrire player incorporati per i live streaming. Per ulteriori informazioni, consulta il Centro assistenza YouTube.

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

  • Altri aggiornamenti

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

15 settembre 2016

Questo aggiornamento contiene le seguenti modifiche:

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

  • Le seguenti modifiche sono ora in vigore. La comunicazione di queste modifiche è stata fornita nell'aggiornamento della cronologia delle revisioni dell'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 che non ha eseguito l'accesso vedrebbe nella home page.

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

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

      Per essere chiari, queste proprietà sono visibili solo a un utente autorizzato che recupera i dati sul proprio canale. Le proprietà contengono sempre i valori HL e WL, anche per un utente autorizzato che recupera i dati relativi al proprio canale. Pertanto, gli ID della cronologia delle visualizzazioni e della playlist Guarda più tardi non possono essere recuperati tramite l'API.

      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 vale per i nuovi valori, HL e WL, nonché per gli ID cronologia delle visualizzazioni o playlist Guarda più tardi che il tuo client API potrebbe aver già memorizzato.

  • L'oggetto fileDetails.recordingLocation della risorsa video e le relative proprietà secondarie 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"), descritti in dettaglio nel blog di YouTube Engineering and Developers, forniscono un ricco insieme di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto per spiegare le norme che gli sviluppatori devono rispettare.

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

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

    • 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 consente di cercare video o canali correlati a un argomento specifico.

    Le modifiche a queste funzionalità sono:

    • A partire dal 10 febbraio 2017, YouTube inizierà a restituire un piccolo insieme di ID argomento anziché l'insieme molto più granulare di ID restituito finora. Questo insieme di argomenti supportati identificherà le classificazioni di livello superiore 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 applicazione per questa modifica.

    • Gli ID argomento di Freebase che hai già recuperato possono essere utilizzati per cercare contenuti fino al 10 febbraio 2017. Tuttavia, dopo questo periodo di tempo, potrai utilizzare solo il gruppo più piccolo di argomenti identificati nell'elemento precedente per recuperare i risultati di ricerca per argomento.

    • Dopo il 10 febbraio 2017, se provi a cercare risultati utilizzando un ID argomento che non fa parte del set più piccolo di ID argomento supportati, l'API restituirà un set di risultati vuoto.

  • A partire dal 12 settembre 2016, diversi campi e parametri dell'API verranno ritirati:

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

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

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

    • L'oggetto fileDetails.recordingLocation della risorsa video o una qualsiasi delle sue proprietà secondarie non verrà più restituito dopo il 12 settembre 2016. Questi dati possono essere recuperati solo dal proprietario di un video, poiché l'oggetto fileDetails principale può essere recuperato solo dal proprietario di un video.

13 giugno 2016

Questo aggiornamento contiene le seguenti modifiche:

  • La proprietà contentDetails.googlePlusUserId della risorsa channel è stata ritirata. In precedenza, la proprietà era presente solo se il canale era associato a un profilo Google+. Dopo il ritiro, la proprietà non verrà più inclusa in alcuna risorsa channel.

  • La proprietà snippet.authorGoogleplusProfileUrl della risorsa comment è stata ritirata. In precedenza, la proprietà era presente solo se il canale era associato a un profilo Google+. Dopo il ritiro, la proprietà non verrà più inclusa in alcuna risorsa comment.

Poiché nessuna di queste proprietà verrà restituita dopo il ritiro, entrambe 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 al momento dell'iscrizione al canale.

    Tieni presente che il nuovo parametro supporta solo il recupero dei 1000 iscritti più recenti al canale dell'utente autenticato. Per recuperare un elenco completo di iscritti, utilizza il parametro mySubscribers. Questo parametro, che non restituisce gli iscritti in un ordine particolare, non limita il numero di iscritti che possono essere recuperati.

  • La definizione della proprietà snippet.thumbnails.(key) è stata aggiornata per le risorse activity, playlistItem, playlist, search result, thumbnail e video per indicare che sono disponibili dimensioni aggiuntive per le immagini in miniatura per alcuni video.

    • L'immagine standard ha una larghezza di 640 px e un'altezza di 480 px.
    • L'immagine maxres ha una larghezza di 1280 px e un'altezza di 720 px.

  • La definizione del parametro part del metodo channelSection.list è stata aggiornata per indicare 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 autorizzata in modo improprio tenta 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 dell'API Data fornisce brevi snippet di codice per i casi d'uso comuni dell'API YouTube Data. Gli snippet di codice sono attualmente disponibili per tutti i metodi 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:

  • Elencare i video per parola chiave
  • Elencare i video per località
  • Elencare gli eventi live
  • Cercare i video dell'utente autenticato
  • Elenca video correlati

Per ogni caso d'uso, lo strumento mostra i parametri utilizzati nella richiesta API. Puoi modificare i valori dei parametri. In questo caso, lo strumento aggiorna gli snippet di codice in modo che riflettano i valori dei parametri che hai fornito.

Infine, lo strumento mostra la risposta API a ogni richiesta. Se hai modificato i parametri della richiesta, la risposta dell'API si basa sui valori dei parametri che hai fornito. 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 della 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 posizione che il proprietario del video vuole associare al video. Questa posizione è modificabile, disponibile per la ricerca nei 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 indicare che il valore della proprietà potrebbe contenere un ID playlist che fa riferimento a una playlist vuota e che non può essere recuperata. 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 restituito 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 indicare che localizations è anche un valore valido per questo parametro.

  • La sezione Utilizzo della quota della guida introduttiva è stata aggiornata con un link alla console per sviluppatori Google, dove puoi visualizzare la quota effettiva e il suo utilizzo.

16 marzo 2016

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • La documentazione della risorsa channelBanner è stata aggiornata per indicare che le dimensioni consigliate per l'immagine del banner del canale caricata sono 2560 x 1440 px. Le dimensioni minime (2048 px 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 URL personalizzati. Il Centro assistenza YouTube spiega i requisiti di idoneità per ottenere un URL personalizzato e come configurarlo.

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

    • 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 selezionarne un'altra, 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 il testo dell'etichetta localizzata per i motivi della segnalazione di abuso.

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

    • La nuova proprietà contentDetails.contentRating.ecbmctRating della risorsa video identifica la classificazione di un video da parte del Consiglio di valutazione e classificazione del Ministero della cultura e del turismo della Turchia.

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

      • contentDetails.contentRating.fpbRating (Sudafrica)
        Classificazione: 10; valore della proprietà: fpb10
      • contentDetails.contentRating.moctwRating (Taiwan)
        Classificazione: R-12; valore della proprietà: moctwR12
      • contentDetails.contentRating.moctwRating (Taiwan)
        Classificazione: R-15; valore della 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 attuale con la chat live attivata. 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 Dettaglio errore Descrizione
    badRequest (400) notEditable I metodi channelSections.insert, channelSections.update e channelSections.delete restituiscono questo errore per indicare che la sezione del canale specificata non può essere creata, aggiornata o eliminata.
    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 correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa commentThread nel corpo della richiesta per assicurarti che sia valida.
    forbidden (403) commentsDisabled Il metodo commentThreads.list restituisce questo errore per indicare che i commenti sono stati disattivati per il video identificato dal parametro videoId.
    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 è già presente in un'altra playlist della serie. Per ulteriori informazioni sulle playlist delle serie, consulta il Centro assistenza YouTube.
    badRequest (400) subscriptionForbidden Il metodo subscriptions.insert restituisce questo errore per indicare che hai raggiunto il numero massimo di abbonamenti o che hai creato troppi abbonamenti recenti. In quest'ultimo caso, puoi riprovare a inviare la richiesta dopo qualche ora.
    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 orario di pubblicazione pianificata non valido.
    badRequest (400) invalidRecordingDetails Il metodo videos.update restituisce questo errore per indicare che l'oggetto recordingDetails nella risorsa video caricata specificava 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 specificava 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 le proprietà snippet.title e snippet.categoryId.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) richiedono che vengano fornite determinate informative e che venga ottenuto il consenso degli utenti finali nell'UE. Pertanto, per gli utenti finali nell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto un avviso di questo requisito nei nostri Termini di servizio dell'API di YouTube.

19 novembre 2015

L'API ora supporta la possibilità di impostare e recuperare il 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 metodo insert o update per quella risorsa. 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 suo valore può essere qualsiasi lingua dell'applicazione supportata o la maggior parte degli altri codici lingua ISO 639-1:2002. Ad esempio, se carichi un video con titolo e descrizione in inglese, imposterai la proprietà snippet.defaultLanguage su en.

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

    • Aggiungi l'oggetto localizations alla risorsa che stai aggiornando. Ogni chiave dell'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 che contiene il titolo (e la descrizione) localizzato della risorsa.

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

      {
  "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 per una risorsa, la richiesta API deve includere tutte le versioni localizzate esistenti dei dati. Ad esempio, se inviassi una richiesta successiva per aggiungere dati in portoghese al video nell'esempio precedente, la richiesta dovrebbe includere i dati localizzati per tedesco, spagnolo e portoghese.

  • Recupero dei valori localizzati

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

    • Aggiungi il parametro hl alla richiesta channels.list, channelSections.list, playlists.list o videos.list per recuperare i dati localizzati per una specifica lingua dell'applicazione supportata dal sito web YouTube. Se sono disponibili dettagli localizzati della risorsa 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 i dati per il video descritto sopra con dati localizzati in tedesco e spagnolo. Se il parametro hl fosse impostato su de, la risorsa conterrebbe 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 fosse impostato su fr, l'oggetto snippet.localized conterrebbe il titolo e la descrizione in inglese perché l'inglese è la lingua predefinita per la risorsa e i dettagli in francese localizzati 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 è disponibile un testo localizzato per altre lingue, devi recuperare la parte localizations della risorsa e filtrare per determinare se esiste un testo localizzato.

      Ad esempio, devi recuperare l'elenco completo delle localizzazioni per determinare se è disponibile un testo localizzato in inglese appalachiano.

    • Quando recuperi una risorsa, includi localizations nel valore del parametro part per recuperare tutti i dettagli localizzati per quella risorsa. Se stai recuperando dati localizzati per una lingua che non è una lingua dell'applicazione YouTube attuale, devi utilizzare questo approccio per recuperare tutte le localizzazioni e poi filtrare per determinare se esistono i dati localizzati desiderati.

  • Errori relativi ai valori di testo localizzati

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

    Tipo di errore Dettaglio errore Descrizione
    badRequest (400) defaultLanguageNotSetError Questo errore indica che una richiesta che tenta di inserire o aggiornare l'oggetto localizations per una risorsa non va a buon fine perché la proprietà snippet.defaultLanguage non è impostata per quella risorsa. Questo errore è supportato dai metodi channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert e videos.update.
    badRequest (400) localizationValidationError Questo errore indica che uno dei valori nell'oggetto localizations di una risorsa non è stato convalidato. Ad esempio, questo errore potrebbe 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 indicare che se ordini le trasmissioni live in base a viewCount, i risultati dell'API vengono ordinati in base al numero di spettatori simultanei delle trasmissioni mentre sono ancora in corso.

    • Il parametro relatedToVideoId del metodo search.list è stato aggiornato per indicare 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 una modifica nel comportamento dell'API.

    • La definizione della proprietà snippet.publishedAt della risorsa video è stata aggiornata per indicare che il valore della proprietà, che specifica la data e l'ora di pubblicazione del video, potrebbe essere diverso dall'ora di caricamento del video. Ad esempio, se un video viene caricato come video privato e poi reso pubblico in un secondo momento, il valore della proprietà specifica l'ora 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 per indicare:

      • 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 momento passato, il video viene pubblicato immediatamente. Pertanto, l'effetto dell'impostazione della proprietà status.publishAt su una data e un'ora passate è lo stesso della modifica della proprietà privacyStatus del video da private a public.

    • La proprietà contentDetails.contentRating.cncRating della risorsa video specifica la classificazione del video attribuita dalla Commissione di classificazione cinematografica francese. Questa proprietà sostituisce la proprietà contentDetails.contentRating.fmocRating, che è stata ritirata.

    • La definizione di 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 una modifica nel comportamento dell'API.

    • La documentazione del metodo thumbnails.set è stata aggiornata per riflettere con precisione che il corpo della richiesta contiene l'immagine della 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 dovevi fornire un corpo della richiesta quando chiamavi questo metodo. Questo aggiornamento non riflette una modifica nel comportamento dell'API.

    • La descrizione della risorsa activity è stata aggiornata per riflettere il fatto che il metodo activities.list attualmente non include risorse relative ai nuovi commenti sui video. Anche 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 di risposta HTTPbadRequest (400)
      MotivoinvalidMetadata
      DescrizioneLa proprietà kind non corrisponde al tipo di ID fornito.
      commentThreads.update
      comments.insert
      comments.update
      Codice di risposta HTTPbadRequest (400)
      MotivocommentTextTooLong
      DescrizioneLa risorsa comment che viene inserita o aggiornata contiene troppi caratteri nella proprietà snippet.topLevelComment.snippet.textOriginal.
      playlistItems.insert
      playlistItems.update
      Codice di risposta HTTPforbidden (403)
      MotivoplaylistItemsNotAccessible
      DescrizioneLa richiesta non è autorizzata correttamente a inserire, aggiornare o eliminare l'elemento della playlist specificato.
      playlists.delete
      playlists.insert
      playlists.update
      Codice di risposta HTTPbadRequest (400)
      MotivoplaylistForbidden
      DescrizioneQuesta operazione è vietata o la richiesta non è autorizzata correttamente.
      search.list
      Codice di risposta HTTPbadRequest (400)
      MotivoinvalidLocation
      DescrizioneIl valore del parametro location e/o locationRadius non è formattato correttamente.
      search.list
      Codice di risposta HTTPbadRequest (400)
      MotivoinvalidRelevanceLanguage
      DescrizioneIl valore del parametro relevanceLanguage non è formattato correttamente.
      subscriptions.insert
      Codice di risposta HTTPbadRequest (400)
      MotivosubscriptionForbidden
      Descrizione Questo errore si verifica quando si verifica una delle seguenti condizioni:
      • L'abbonamento che stai cercando di creare esiste già
      • Hai già raggiunto il numero massimo di abbonamenti
      • Stai tentando di iscriverti al tuo canale, ma l'operazione non è supportata.
      • Di recente hai creato troppi abbonamenti e devi attendere qualche ora prima di riprovare a inviare la richiesta.
      videos.update
      Codice di risposta HTTPbadRequest (400)
      MotivoinvalidDefaultBroadcastPrivacySetting
      DescrizioneLa richiesta tenta di impostare un'impostazione della 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 ritirata.

      In conformità con le nostre norme di ritiro, questa proprietà continuerà a essere inclusa nelle risorse 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 maggiori informazioni su come il server API calcola la lunghezza del valore della proprietà. Tieni presente che questo aggiornamento non riflette una modifica del 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 le virgolette 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 relative risposte dovevano essere pubblicati anche sul profilo Google+ dell'autore. Se una richiesta invia il parametro, il server API lo ignora, ma 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 per ora o pertinenza. Il comportamento predefinito prevede l'ordinamento 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 caricati originariamente su un canale collegato a un partner di contenuti YouTube e poi rivendicati da quest'ultimo. Ciò non rappresenta una modifica del 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. Le richieste che utilizzano questo metodo devono anche 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 di risposta HTTPbadRequest (400)
      MotivoemailNotVerified
      DescrizioneL'utente deve verificare il proprio indirizzo email prima di valutare il video.
      videos.rate
      Codice di risposta HTTPbadRequest (400)
      MotivovideoPurchaseRequired
      DescrizioneI video a noleggio possono essere valutati solo dagli utenti che li hanno noleggiati.

    • 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 potrebbe essere segnalato per contenuti illeciti. Il metodo videoAbuseReportReasons.list consente di recuperare un elenco di tutti i motivi per cui i video potrebbero essere segnalati.

    • Il nuovo metodo videos.reportAbuse consente di segnalare effettivamente un video che contiene contenuti illeciti. Il corpo della richiesta contiene un oggetto JSON che specifica il video segnalato e il motivo per cui è ritenuto contenere contenuti illeciti. I motivi validi possono essere ottenuti dal metodo videoAbuseReportReason.list descritto sopra.

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

  • Aggiornamenti a risorse e metodi esistenti

    • Il nuovo parametro di filtro forDeveloper del metodo search.list limita una ricerca al recupero dei soli video caricati tramite l'applicazione o il sito web dello sviluppatore. Il parametro forDeveloper può essere utilizzato insieme a parametri di ricerca facoltativi come il parametro q.

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

      Quando una richiesta di ricerca imposta successivamente 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 la propria app o il proprio sito web, ma non ai video caricati tramite altri siti o app.

      La nuova funzionalità offre un funzionamento simile, anche se non identico, a quello dei tag sviluppatore supportati 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, devi aggiornare la proprietà brandingSettings.channel.country.

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

      L'API espone tre opzioni di targeting. Per essere visibile, una sezione del canale deve soddisfare tutte le impostazioni di targeting.

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

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

  • Errori nuovi e aggiornati

    • L'API ora supporta i seguenti errori:

      Tipo di errore Dettaglio 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 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 lo spettatore attuale 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 API tenta di iscriversi al proprio canale.

    • 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 dall'API v2.

    La guida descrive anche diverse funzionalità di commento non supportate dall'API v2, ma supportate nell'API v3. tra cui:

    • Recuperare i commenti su un canale
    • Recupero di tutti i thread di commenti correlati a un canale, il che significa che la risposta dell'API può contenere commenti sul canale o su uno qualsiasi dei suoi video.
    • Aggiornare il testo di un commento
    • Contrassegnare un commento come spam
    • Impostare lo stato di moderazione di un commento

  • La guida Iscrizione alle notifiche push è stata aggiornata per riflettere il fatto che le notifiche vengono inviate solo 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 relative risposte, se esistenti. Una risorsa commentThread può rappresentare i commenti su un video o un canale.

      Il commento di primo livello e le risposte sono in realtà risorse comment 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 vuoi recuperare tutte le risposte a 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. Utilizza 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 un canale. Inoltre, il commento può essere un commento di primo livello o una risposta a un commento di primo livello.

      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, approvare un commento per la visualizzazione pubblica 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, è necessario 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 spiega il nuovo supporto dell'API per le notifiche push tramite PubSubHubBub, un protocollo di pubblicazione/iscrizione server-server per le risorse accessibili dal web. Il 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 per le notifiche push. Tuttavia, poiché l'API v2 supportava numerosi altri tipi di notifiche push che non sono supportati nell'API v3, la menzione del supporto di PubSubHubBub è ancora elencata nella sezione Ritirate di questa guida.

  • Il nuovo ambito https://www.googleapis.com/auth/youtube.force-ssl dell'API è ora un ambito 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 Dettaglio errore Descrizione
    badRequest (400) invalidRating Il metodo videos.rate restituisce questo errore se la richiesta conteneva 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 dell'abbonamento.

2 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

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

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

  • È stata aggiornata anche la guida alla migrazione, che spiega come eseguire la migrazione delle applicazioni che utilizzano ancora la funzionalità dei sottotitoli codificati 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 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 in realtà un altro modo per effettuare una richiesta API.

    Il nuovo ambito è necessario 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à dell'API v3, che elenca le funzionalità supportate dall'API v3 e non dall'API v2. Le stesse funzionalità erano e sono ancora elencate in altre schede della guida. Ad esempio, la nuova funzionalità che spiega come aggiornare i dati di una campagna promozionale in-video di un canale è elencata anche nella scheda Canali (profili).

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

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

    • Recuperare i video consigliati: l'API v3 non recupera un elenco che contiene solo i video consigliati per l'utente API corrente. 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 è garantito che la risposta contenga un determinato numero di video consigliati.

    • Recuperare i suggerimenti per i canali

    • Recuperare i nuovi video degli abbonamenti: l'API v3 non recupera un elenco che contiene solo i video caricati di recente sui canali a cui l'utente API è iscritto. Tuttavia, puoi utilizzare l'API v3 per trovare nuovi video degli abbonamenti 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 è garantito che la risposta contenga un determinato numero di nuovi video delle iscrizioni.

    • Supporto dei feed RSS

    • Notifiche push per gli aggiornamenti dei feed: l'API v2 supportava le notifiche push, utilizzando il Simple Update Protocol (SUP) o PubSubHubbub, per monitorare i feed delle attività degli utenti di YouTube. Le notifiche venivano fornite 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 utilizzando il protocollo PubSubHubbub, ma le notifiche riguarderanno solo i caricamenti di video e gli aggiornamenti ai titoli o alle descrizioni dei video.

    • Posizione del canale: l'API v2 utilizzava il tag <yt:location> per identificare la posizione dell'utente inserita nel profilo pubblico YouTube del canale. Anche se alcuni sviluppatori utilizzavano questo campo per associare un canale a un determinato paese, i dati del campo non potevano essere utilizzati in modo coerente per 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 visualizzati dagli utenti di YouTube, ma i proprietari dei video possono recuperare i video che corrispondono 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 propria applicazione. Per questa funzionalità, ogni video caricato viene automaticamente taggato 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 consente di ordinare i video in una playlist in base a posizione, durata, data di pubblicazione, titolo e diversi altri valori. Nell'API v3, gli elementi della playlist vengono in genere ordinati in base alla posizione in ordine crescente e non sono disponibili altre opzioni di ordinamento.

      Esistono alcune eccezioni. Un nuovo caricamento, un video preferito, un video che hai messo Mi piace o un video guardato di recente viene aggiunto automaticamente come primo elemento (snippet.position=0) per i seguenti tipi di playlist. Pertanto, ogni elenco viene ordinato in base all'elemento più recente e a quello meno recente in base all'ora in cui gli elementi sono stati aggiunti all'elenco.

      • caricamenti utente
      • video preferiti
      • video piaciuti
      • cronologia visualizzazioni

      Tuttavia, un nuovo elemento aggiunto alla playlist "Guarda più tardi" viene aggiunto come ultimo elemento dell'elenco, quindi l'elenco viene ordinato dall'elemento meno recente a quello 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 separati da virgole (ID video, ID canale e così via). Utilizzando questi metodi, puoi recuperare un elenco di più risorse con una singola richiesta.

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

4 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

  • I metodi channelSections.delete e channelSections.update ora supportano il parametro onBehalfOfContentOwner, che è 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 di ritiro delle API.

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

  • L'API ora supporta i seguenti errori:

    Tipo di errore Dettaglio 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 della 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 dell'ordinamento della playlist 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 chiuso.
    forbidden (403) channelSuspended Il metodo playlists.list restituisce questo errore se il parametro channelId della richiesta specifica un canale sospeso.
    forbidden (403) playlistForbidden Il metodo playlists.list restituisce questo errore se il parametro id della richiesta non supporta la richiesta o se la richiesta 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:

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 utilizzando JavaScript. Per maggiori dettagli, consulta la sezione Caricare un video. Questa funzionalità è paragonabile a quella di caricamento basato sul 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 di esempio per il caricamento di video con JavaScript lato client.

    Considerato il supporto per il caricamento di video con la libreria client JavaScript e CORS, la guida alla migrazione non elenca più il caricamento basato sul 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 degli 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 è stato modificato in 100 unità.

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

    • Costo della quota: 100 unità

      Chiama il metodo search.list e cerca GoogleDevelopers.

    • Costo della 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 per i video caricati del canale.

      Quindi 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 al caricamento di 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 della proprietà sono:

      • allowed: il canale può caricare video di durata superiore a 15 minuti.
      • eligible: il canale è idoneo al caricamento di video di durata superiore a 15 minuti, ma deve prima attivare la funzionalità.
      • disallowed: il canale non è in grado o non è idoneo a caricare video di durata superiore a 15 minuti.

      Per ulteriori informazioni su questi valori, consulta la definizione della proprietà. Il Centro assistenza YouTube fornisce anche informazioni più dettagliate su questa funzionalità.

    • La proprietà invideoPromotion.useSmartTiming indica se la campagna promozionale del canale utilizza la "tempistica intelligente". Questa funzionalità tenta di mostrare le promozioni in un punto del video in cui è più probabile che vengano cliccate e meno probabile che interrompano l'esperienza di visualizzazione. Questa funzionalità rileva anche una singola promozione da mostrare su ogni video.

  • Le definizioni delle proprietà snippet.title e snippet.categoryId della risorsa video sono state 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 dell'Ufficio di classificazione di film e letteratura della Nuova Zelanda, ora supporta due nuove classificazioni: oflcRp13 e oflcRp16. Corrispondono rispettivamente alle classificazioni RP13 e RP16.

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

    Tipo di errore Dettaglio errore Descrizione
    badRequest bannerAlbumFull L'album Grafica del canale YouTube del proprietario del canale contiene troppe immagini. Il proprietario del canale deve andare alla pagina http://photos.google.com, accedere 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 è passato da 1 unità a 2 unità, oltre al costo delle parti di risorse specificate.

13 agosto 2014

Questo aggiornamento contiene le seguenti modifiche:

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

    Tipo di errore Dettaglio errore Descrizione
    badRequest subscriptionLimitExceeded L'abbonato identificato con la richiesta ha superato il limite di frequenza dell'abbonamento. Potrai tentare di sottoscrivere 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 nell'API YouTube Data (v2). La vecchia API è stata ritirata ufficialmente il 4 marzo 2014. La guida ha lo scopo di 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 Dettaglio 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 consentite.

18 giugno 2014

Questo aggiornamento contiene le seguenti modifiche:

28 maggio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Il metodo search.list ora supporta i parametri location e locationRadius, che consentono di cercare video associati a una posizione geografica. Una richiesta deve specificare un valore per entrambi i parametri per recuperare i risultati in base alla località 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 specifica la distanza massima che la posizione associata a un video può avere dal centro dell'area affinché il video venga comunque incluso 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 elemento promozionale per il tuo canale. Se tenti di inserire troppi elementi promozionali, l'API restituirà un errore tooManyPromotedItems, che ha 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 pubblicate dal proprietario del canale nel feed attività del canale
    • postedVideos: video che il proprietario del canale ha pubblicato nel feed delle attività del canale
    • subscriptions: i canali a cui il proprietario del canale si è iscritto

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

  • La definizione della proprietà position.cornerPosition della risorsa watermark è stata aggiornata per indicare 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 indicare 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.

  • La definizione della proprietà pageInfo.totalResults restituita in una risposta API a una chiamata search.list è stata aggiornata per indicare 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 paginazione. Utilizza invece i valori delle proprietà nextPageToken e prevPageToken per determinare se mostrare i link di paginazione.

  • I metodi watermarks.set e watermarks.unset sono stati aggiornati per indicare 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 YouTube. La lingua dell'applicazione può anche essere definita lingua dell'interfaccia utente. Per il sito web di YouTube, la lingua dell'applicazione potrebbe essere selezionata automaticamente in base alle impostazioni dell'Account Google, alla lingua del browser o alla posizione IP. Inoltre, un utente potrebbe 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 dell'applicazione supportate. Le lingue supportate possono essere utilizzate come valore del parametro hl quando chiami 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 come località dei contenuti. Per il sito web di YouTube, una regione di contenuti potrebbe essere selezionata automaticamente in base a euristiche come il dominio YouTube o la posizione IP dell'utente. Inoltre, un utente potrebbe 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. I codici regione supportati possono essere utilizzati come valore del parametro regionCode quando si chiamano 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 mettere in evidenza. Ad esempio, una sezione potrebbe mostrare i caricamenti più recenti 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 per il canale dell'utente autenticato specificando un ID canale particolare o un elenco di ID sezione del canale univoci.

    Anche la documentazione sugli errori è stata aggiornata per descrivere i messaggi di errore supportati dall'API specificamente per questi nuovi metodi.

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

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

  • La documentazione per i metodi videos.insert e videos.update è stata aggiornata per indicare che la proprietà status.publishAt può essere impostata quando vengono chiamati 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 dei parametri per il metodo videos.rate è stato aggiornato per indicare che questo metodo non supporta effettivamente il parametro onBehalfOfContentOwner. Si è trattato di un errore di documentazione, in quanto le richieste videos.rate che impostano questo parametro restituiscono un errore 500.

31 marzo 2014

Questo aggiornamento contiene le seguenti modifiche:

13 marzo 2014

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta la parte contentOwnerDetails per le risorse channel. La nuova parte contiene i dati del canale pertinenti per i partner di YouTube collegati al canale, inclusi 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 di ritiro.

  • La documentazione ora elenca la lunghezza massima dei 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 dell'elenco vengono conteggiate ai fini del limite.

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

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

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

  • L'API ora supporta i seguenti errori:

    Tipo di errore Dettaglio errore Descrizione
    badRequest (400) invalidCriteria Il metodo channels.list restituisce questo errore se la richiesta specifica parametri di filtro che non possono essere utilizzati insieme.
    badRequest (400) channelTitleUpdateForbidden Il metodo channels.update restituisce questo errore se tenti di aggiornare la parte brandingSettings di un canale e modifichi 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 sincronizzazione non valido.
    badRequest (400) tooManyPromotedItems Il metodo channels.update restituisce questo errore se la parte invideoPromotion specifica un numero di elementi promozionali 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 può essere trovato o utilizzato come elemento promozionale.
    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 quando YouTube deve mostrare un elemento promozionale.
    required (400) requiredTiming Il metodo channels.update deve specificare un oggetto invideoPromotion.items[].timing per ogni elemento promozionale.
    required (400) requiredWebsiteUrl Il metodo channels.update deve specificare una proprietà invideoPromotion.items[].id.websiteUrl per ogni elemento promozionale.
    badRequest (400) invalidPublishAt Il metodo videos.insert restituisce questo errore se i metadati della richiesta specificano un orario di pubblicazione programmata non valido.

4 marzo 2014

Questo aggiornamento contiene le seguenti modifiche:

5 dicembre 2013

Questo aggiornamento contiene le seguenti modifiche:

  • La documentazione del metodo search.list è stata aggiornata per riflettere correttamente il fatto che non è necessario specificare un valore per esattamente un parametro di filtro quando si invia una richiesta di ricerca. Puoi impostare un valore per zero parametri di filtro o per un parametro di filtro.

  • Le definizioni dei parametri del metodo search.list sono state aggiornate per indicare 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 del banner del canale caricate sono state ridotte a 2048 x 1152 px. In precedenza, le dimensioni minime erano 2120 x 1192 px. Inoltre, tieni presente che la documentazione della risorsa channel specifica le dimensioni massime di tutte le immagini banner pubblicate dall'API. Ad esempio, la dimensione massima dell'immagine brandingSettings.image.bannerTvImageUrl per le applicazioni TV è 2120 px x 1192 px, ma l'immagine effettiva potrebbe essere 2048 px 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.
    • Se impostato, il valore della proprietà brandingSettings.channel.unsubscribedTrailer 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 della proprietà invideoPromotion.items[].promotedByContentOwner. Questa proprietà indica se il nome del proprietario dei contenuti verrà mostrato durante la visualizzazione della 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, che è già supportato per diversi altri metodi.

  • La proprietà contentDetails.contentRating.acbRating ora può specificare una classificazione dell'Australian Classification Board (ACB) per i film o dell'Australian Communications and Media Authority (ACMA) per i programmi televisivi per bambini.

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

  • La nuova proprietà snippet.assignable della risorsa videoCategory indica se i video aggiornati o caricati di recente possono essere associati a quella categoria di video.

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

24 ottobre 2013

Questo aggiornamento contiene le seguenti modifiche:

  • L'API include due funzionalità aggiuntive progettate per aiutarti a trovare e mettere in evidenza i contenuti delle trasmissioni live:

    La nuova proprietà snippet.liveBroadcastContent nei risultati di ricerca indica se una risorsa video o un canale contiene contenuti di trasmissioni live. I valori validi della proprietà sono upcoming, active e none.

    • La nuova proprietà snippet.liveBroadcastContent della risorsa video indica se il video è una trasmissione live in programma 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 in programma o attiva. Questo sarà il valore della proprietà per le trasmissioni completate ancora visibili su YouTube.

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

      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 funzionalità per l'identificazione dei 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 relativa al nuovo video agli utenti iscritti al canale del video. Il valore predefinito del parametro è True, che indica che gli iscritti riceveranno una notifica dei video appena caricati. Tuttavia, un proprietario del canale che carica molti video potrebbe preferire impostare il valore su False per evitare di inviare una notifica su ogni nuovo video agli iscritti al canale.

  • L'elenco delle proprietà che possono essere modificate quando viene chiamato 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 della 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 classificazione TV-14.

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

  • 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) - Visione consentita dai 6 anni in su.
    • mibacVm12 (V.M.12) – Visione consentita dai 12 anni in su.

  • La nuova proprietà invideoPromotion.items[].promotedByContentOwner della risorsa channel indica se il nome del proprietario dei contenuti verrà mostrato durante la visualizzazione della 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 i dati del 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 che contenga l'ambito https://www.googleapis.com/auth/youtubepartner-channel-audit. Inoltre, qualsiasi token che utilizza questo ambito deve essere revocato quando la MCN decide di accettare o rifiutare il canale o entro due settimane dalla data di emissione del token.

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

    Per impostazione predefinita, il canale è lo stesso per cui sono impostati i dati della promozione nel 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 in questione.

  • La risorsa channel contiene tre nuove proprietà: brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl, che specificano gli URL delle immagini del banner visualizzate nelle pagine dei canali nelle applicazioni TV.

  • La nuova proprietà snippet.liveBroadcastContent nei risultati di ricerca indica se una risorsa video o un canale contiene contenuti di trasmissioni live. I valori validi della proprietà sono upcoming, active e none.

    • Per una risorsa video, un valore pari a upcoming indica che il video è una trasmissione live che non è ancora iniziata, mentre un valore pari a active indica che il video è una trasmissione live 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 live in corso.

  • Nella risorsa watermark, la proprietà targetChannelId è cambiata da oggetto a stringa. Anziché 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 in modo che restituisca solo eventi di trasmissione attivi, imminenti o completati.

  • La nuova proprietà contentDetails.contentRating.mibacRating identifica la classificazione attribuita a un video dal Ministero dei Beni e delle Attività Culturali e del Turismo italiano.

  • L'API ora supporta i seguenti errori:

    Tipo di errore Dettaglio errore Descrizione
    badRequest invalidImage Il metodo thumbnails.set restituisce questo errore se i contenuti dell'immagine fornita non sono validi.
    forbidden videoRatingDisabled Il metodo videos.rate restituisce questo errore se il proprietario del video in fase di valutazione ha disattivato le valutazioni per quel video.

27 agosto 2013

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova risorsa watermark identifica un'immagine che viene visualizzata durante la riproduzione dei video di un canale specifico. Puoi anche specificare un canale di destinazione a cui l'immagine verrà collegata, nonché i dettagli di temporizzazione che determinano quando viene visualizzata la filigrana durante la riproduzione dei video e per quanto tempo è visibile.

    Il metodo watermarks.set carica e imposta l'immagine della filigrana di un canale. Il metodo watermarks.unset elimina l'immagine del watermark di un canale.

    La documentazione relativa agli errori descrive i messaggi di errore supportati dall'API specificamente 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. Pertanto, il valore della proprietà è false se il numero degli iscritti del canale è visibile pubblicamente.

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

  • Il metodo videos.list ora supporta il parametro regionCode, che identifica la regione dei contenuti per cui 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.

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

    Tipo di errore Dettaglio 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 elemento promozionale. A questo scopo, imposta il valore della proprietà invideoPromotion.items[].id.type su website e utilizza la nuova proprietà invideoPromotion.items[].id.websiteUrl per specificare l'URL. Utilizza anche la nuova proprietà invideoPromotion.items[].customMessage per definire un messaggio personalizzato da visualizzare per la promozione.

      I link possono indirizzare 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 per i siti web associati e i siti dei commercianti.

      Se aggiungi link promozionali, accetti che questi non vengano utilizzati per reindirizzare il traffico a siti non autorizzati e che rispettino le Norme di Google Ads, le Norme sugli annunci di YouTube, le Norme della community di YouTube e i Termini di servizio di YouTube.

    • Le proprietà relative alle impostazioni di temporizzazione per la visualizzazione degli articoli promozionali 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 tempistica per ogni elemento promozionato nell'elenco invideoPromotion.items[].

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

      • La nuova proprietà invideoPromotion.items[].timing.durationMs specifica il periodo di tempo, in millisecondi, in cui deve essere visualizzata la promozione. L'oggetto invideoPromotion.defaultTiming contiene anche un campo durationMs che specifica la durata predefinita di visualizzazione dell'articolo promozionale.

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

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

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

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

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

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

    Tipo di errore Dettaglio errore Descrizione
    badRequest invalidMine Il parametro mine non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner YouTube. Devi rimuovere il parametro mine, eseguire l'autenticazione come utente YouTube rimuovendo il parametro onBehalfOfContentOwner o 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:

30 luglio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • In una risorsa channelBanner, il valore della proprietà kind è cambiato 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 di sterlina (#) seguito da una stringa esadecimale di sei caratteri, ad esempio #2793e6.

  • L'API ora supporta la possibilità di specificare se un abbonamento 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 cui l'abbonato riceverà notifiche. I valori validi della proprietà sono all e uploads.

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

    • Il parametro chart identifica il grafico che vuoi 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 di video per cui deve essere recuperata la classifica. Questo parametro può essere utilizzato solo in combinazione con il parametro chart. Per impostazione predefinita, i grafici non sono limitati a una categoria specifica.

  • 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 video potrebbero essere menzionati o apparire nel video.

  • La proprietà recordingDetails.location.elevation della risorsa video è stata rinominata in recordingDetails.location.altitude e la 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 sistemi di classificazione, tra cui le classificazioni MPAA, TVPG e così via. Per ogni sistema di classificazione, l'API ora supporta un valore di classificazione che indica che il video non è stato classificato. Tieni presente che per le classificazioni MPAA, una classificazione "non classificato" viene spesso utilizzata per identificare le versioni integrali dei film per i quali la versione tagliata ha ricevuto una classificazione ufficiale.

  • La nuova proprietà contentDetails.contentRating.ytRating della risorsa video identifica i contenuti soggetti a limiti di età. Il valore della proprietà sarà ytAgeRestricted se YouTube ha identificato il video come contenente contenuti inappropriati per gli utenti di età inferiore a 18 anni. Se la proprietà è assente 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.

  • I metodi channelBanners.insert, channels.update, videos.getRating e videos.rate ora supportano tutti 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à secondarie. La documentazione ora elenca anche l'elenco aggiornato delle proprietà che puoi impostare per l'oggetto invideoPromotion della risorsa channel.

  • Il modulo error documentation descrive i seguenti nuovi errori:

    Tipo di errore Dettaglio errore Descrizione
    forbidden accountDelegationForbidden Questo errore non è specifico di un particolare metodo API. Indica che l'utente autenticato non è autorizzato ad agire per conto dell'account Google specificato.
    forbidden authenticatedUserAccountClosed Questo errore non è specifico di un particolare metodo API. Indica che l'account YouTube dell'utente autenticato è chiuso. Se l'utente agisce per conto di un altro Account Google, questo errore indica che l'altro account è chiuso.
    forbidden authenticatedUserAccountSuspended Questo errore non è specifico di un particolare metodo API. 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 è specifico di un particolare metodo API. Indica che il server API non riesce a 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 è specifico di un particolare metodo API. L'utente CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato.
    notFound contentOwnerAccountNotFound Questo errore non è specifico di un particolare metodo API. L'account proprietario dei contenuti specificato non è stato trovato.
    badRequest invalidPart Questo errore non è specifico di un particolare metodo API. Il parametro part della richiesta specifica 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 il video che stai tentando di aggiornare non è stato trovato. 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 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 l'attività precedente dell'utente autorizzato su YouTube non fornisce informazioni sufficienti per generare il feed delle attività.

  • Le risorse della playlist ora contengono la proprietà snippet.tags. La proprietà verrà restituita solo agli utenti autorizzati che recuperano i dati relativi alle proprie playlist. Gli utenti autorizzati possono anche impostare i tag delle playlist quando chiamano 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 dal 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 YouTube specificato.

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

    Nello specifico, per quanto riguarda questa release, il parametro ora consente a un partner di contenuti di inserire, aggiornare o eliminare video in uno qualsiasi dei canali YouTube di proprietà del partner.

  • Il modulo error documentation descrive i seguenti nuovi errori:

    Tipo di errore Dettaglio errore Descrizione
    forbidden insufficientCapabilities Questo errore non è specifico di un particolare metodo API. 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 per diversi metodi 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 come 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 abbia un nome utente univoco, il che non è più vero.

22 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

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:

8 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Le risorse del canale ora supportano l'oggetto inVideoPromotion, che contiene informazioni su una campagna promozionale associata al canale. Un canale può utilizzare una campagna promozionale in-video per mostrare le immagini in miniatura di un video promosso all'interno del video player durante la riproduzione dei video del canale.

    Puoi recuperare questi dati includendo invideoPromotion nel valore del parametro part in una richiesta channels.list.

  • Il nuovo metodo channels.update può essere utilizzato per aggiornare i dati della campagna promozionale in-video di un canale. Tieni presente che il metodo supporta solo gli aggiornamenti della parte invideoPromotion della risorsa channel e non supporta ancora gli aggiornamenti di 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 ha uno di questi link ha già un'identità YouTube pubblica, che è un prerequisito per diverse azioni, come il caricamento di video.

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

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

  • Il nuovo parametro myRating del metodo videos.list consente di recuperare un elenco di video a cui l'utente autenticato ha assegnato una valutazione like o dislike.

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

    Il metodo restituisce un errore forbidden per le richieste che tentano di recuperare le informazioni sulla classificazione dei video, ma non sono autorizzate a farlo.

  • Con l'introduzione del parametro myRating, anche il metodo videos.list è stato aggiornato per supportare la paginazione. Tieni presente, tuttavia, che i parametri di paginazione sono supportati solo per le richieste che utilizzano il parametro myRating. I parametri e le informazioni di paginazione 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, mentre il parametro pageToken identifica una pagina specifica del set di risultati che vuoi recuperare.

    • La risorsa youtube#videoListResponse, restituita in risposta a una richiesta videos.list, ora contiene l'oggetto pageInfo, che include dettagli come il numero totale di risultati e il numero di risultati inclusi nel set di risultati corrente. La risorsa youtube#videoListResponse può includere anche le proprietà nextPageToken e prevPageToken, ognuna 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 rimuovendo le vibrazioni causate 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 è stato effettuato l'abbonamento.

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

  • Il nuovo parametro mySubscribers del metodo subscriptions.list ti consente di recuperare un elenco degli iscritti dell'utente attualmente autenticato. Questo parametro può essere utilizzato solo in una richiesta autorizzata correttamente.

    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à:

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

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

19 aprile 2013

Questo aggiornamento contiene le seguenti modifiche:

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

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

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

    Anche la documentazione sugli 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 nello stesso modo in cui venivano restituite in precedenza, anche se ora la documentazione 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 per la pagina del canale e le pagine di visualizzazione dei video del canale.

  • La risorsa playlistItem contiene le seguenti nuove proprietà:

    • Il nuovo oggetto status contiene informazioni sullo stato dell'elemento della playlist, mentre la proprietà status.privacyStatus identifica lo stato della privacy dell'elemento della playlist.

  • La risorsa video contiene le seguenti nuove proprietà:

  • 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 le seguenti funzionalità:

    • Il nuovo parametro forMine limita una ricerca in modo da recuperare solo i video dell'utente autenticato.

    • Il parametro order ora supporta la possibilità di ordinare i risultati alfabeticamente per titolo (order=title) o per numero di 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 Dettaglio 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 specifica dettagli di registrazione non validi.
    badRequest invalidVideoGameRating I metadati della richiesta specificano una classificazione dei videogiochi non valida.
    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 consente di limitare una ricerca di canali per recuperare tutti i canali o solo i programmi.

    • Il parametro videoType ti consente di limitare la ricerca di video per recuperare tutti i video o solo i film o solo gli episodi dei programmi.

  • La definizione della parte recordingDetails della risorsa video è stata aggiornata per indicare che l'oggetto verrà restituito per un video solo se sono stati impostati i dati di geolocalizzazione o l'ora 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 API supportano nuovi parametri destinati esclusivamente ai partner di contenuti di YouTube. I partner di 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 YouTube specificato.

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

      I metodi channels.list, search.list, videos.delete, videos.list e videos.update supportano tutti questo parametro.

    • Il parametro managedByMe, supportato dal metodo channels.list, indica all'API di restituire tutti i canali di proprietà del proprietario dei contenuti specificati 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 sezioni fileDetails, processingDetails e suggestions forniscono informazioni ai proprietari dei video sui 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à delle immagini in miniatura
      • suggerimenti per migliorare la qualità dei video o dei metadati
      • dettagli sul file originale caricato su YouTube

      Tutte queste parti possono essere recuperate solo dal proprietario del video. L'elenco seguente descrive brevemente le nuove parti, mentre la documentazione delle risorse video definisce tutte le proprietà contenute in ciascuna parte.

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

      • L'oggetto processingProgress contiene informazioni sullo stato di avanzamento dell'elaborazione del file video caricato da parte di YouTube. Le proprietà dell'oggetto identificano lo stato di elaborazione attuale e stimano il tempo rimanente prima che YouTube termini l'elaborazione del video. Questa sezione indica anche se per il video sono disponibili diversi tipi di dati o contenuti, come i dettagli del file o le immagini in miniatura.

        Questo oggetto è progettato per essere interrogato in modo che l'utente che carica 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 definizione.
      • caption: indica se i sottotitoli codificati sono disponibili per il video.
      • licensedContent: indica se il video contiene contenuti 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 aggiornano 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 in modo da elencare le parti appena aggiunte descritte sopra, nonché la parte recordingDetails, che era stata omessa inavvertitamente.

  • 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 miniatura ora specifica la larghezza e l'altezza dell'immagine. Le immagini in miniatura vengono attualmente restituite nelle risorse activity, channel, playlist, playlistItem, search result, subscription e video.

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

    L'API restituisce un errore notFound se il video identificato dal parametro non viene trovato 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 errori elenca gli errori che l'API può restituire. La pagina include errori generali, che potrebbero verificarsi per più metodi API diversi, nonché errori specifici del metodo.

16 gennaio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Sono ora disponibili esempi di codice per i metodi e le lingue mostrati nell'elenco seguente:

  • Ora una risorsa activity può segnalare un'channelItemazione, che si verifica quando YouTube aggiunge un video a un canale YouTube generato automaticamente. L'algoritmo di YouTube identifica gli argomenti con una presenza significativa sul sito web di YouTube e genera automaticamente i canali per questi argomenti.

  • Sono stati aggiornati i seguenti parametri search.list:

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

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

    Nome parametro Valore Descrizione
    channelId string Restituisce le risorse create dal canale specificato.
    publishedAfter datetime Restituisce le risorse create dopo l'ora specificata.
    publishedBefore datetime Restituisce le risorse create prima dell'ora specificata.
    regionCode string Restituisce 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 della ricerca 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 della ricerca 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 relative 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 nella 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 altre proprietà resourceId, contiene una proprietà kind che specifica il tipo di risorsa, ad esempio video o playlist. Contiene anche esattamente una delle diverse proprietà, ad esempio videoId, playlistId e così via, che specifica l'ID che identifica in modo univoco la 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 sui contenuti della playlist.
    playlist contentDetails.itemCount unsigned integer Il numero di video nella playlist.
    playlist player object Questo oggetto contiene le informazioni che utilizzeresti 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 è stato registrato il video.
    video recordingDetails.location object Questo oggetto contiene informazioni sulla 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 della località in cui è stato registrato il video.
    video recordingDetails.recordingDate datetime La data e l'ora in cui è stato registrato il video. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

  • La documentazione di diversi metodi 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, nonché le proprietà obbligatorie o modificabili.

    Nota:la documentazione per altri metodi potrebbe già elencare le proprietà richieste 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 tenti di creare o aggiornare una playlist che avrebbe lo stesso titolo di una playlist già esistente nello stesso canale.

  • Diversi metodi API supportano nuovi tipi di errori. La tabella riportata di seguito identifica il metodo e gli errori appena supportati:

    Metodo Tipo di errore Dettaglio 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.