Questa pagina elenca le modifiche all'API di dati di YouTube (v3) e gli aggiornamenti alla documentazione. Iscriviti a questo log delle modifiche.
30 aprile 2024
Nota:questo è un annuncio relativo al ritiro.
Questo aggiornamento contiene le seguenti modifiche:
L'API non supporta più l'inserimento o il recupero delle discussioni del canale. Questa modifica è coerente con la funzionalità supportata sul sito web di YouTube, che non supporta la pubblicazione di commenti sui canali.
13 marzo 2024
Nota:questo è un annuncio relativo al ritiro.
Questo aggiornamento contiene le seguenti modifiche:
Il parametro sync
per i metodi captions.insert
e captions.update
è stato deprecato. A partire dal 12 aprile 2024, YouTube non supporterà più questo parametro.
A seguito di questa modifica, gli sviluppatori devono includere informazioni sulla tempistica durante l'inserimento o l'aggiornamento delle tracce di 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 in modo da notare che la lunghezza massima consentita per il campo snippet.name
è di 150 caratteri. L'API restituisce un errore nameTooLong
se il nome del canale è più lungo.
7 marzo 2024
Nota:questo è un annuncio relativo al ritiro.
La proprietà della risorsa channel
brandingSettings.channel.moderateComments
è stata deprecata. A partire dal 7 marzo 2024, YouTube non supporterà più il parametro.
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 di YouTube.
9 novembre 2023
Tutti i riferimenti alla risorsa videoId
in Comments
sono stati rimossi perché la risorsa videoId
non viene restituita mediante una chiamata API.
12 settembre 2023
Nota:questo è un annuncio relativo al ritiro.
Il metodo comments.markAsSpam
è deprecato per diversi anni. Questo metodo non è già supportato su YouTube e non è più supportato tramite l'API.
È stato aggiunto un avviso di 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 contrassegnato come promozioni a pagamento.
18 agosto 2023
La definizione dell'elemento liveStreamingDetails.concurrentViewers
della risorsa video
è stata aggiornata in modo da tenere presente che il numero di spettatori simultanei restituiti dall'API di dati di YouTube potrebbe essere diverso dal numero di spettatori simultanei elaborati e privi di spam disponibili tramite YouTube Analytics. Per saperne di più sulle metriche relative al live streaming, consulta il Centro assistenza YouTube.
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 miniature nelle ultime 24 ore e che dovresti riprovare più tardi.
12 giugno 2023
Nota:questo è un annuncio relativo al ritiro.
Il parametro relatedToVideoId
del metodo search.list è stato deprecato. A partire dal 7 agosto 2023, YouTube non supporterà più questo parametro.
Al momento, è stato aggiunto un avviso di deprecazione 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
Annotazioni di tipo corrette per i campi video.statistics in cui creare una stringa da "long senza firma".
5 agosto 2022
YouTube ha cambiato il modo in cui vengono generati gli ID dei sottotitoli codificati e, nell'ambito di questo cambiamento, sta assegnando nuovi ID a tutte le tracce dei sottotitoli codificati. Questa modifica potrebbe essere una modifica incompatibile con le versioni precedenti per le applicazioni che archiviano i valori caption_id
, anche se non influirà sulle applicazioni che non archiviano i valori caption_id
.
Da adesso fino al 1° dicembre 2022, i metodi
captions.list
,
captions.update
,
captions.download
,
e captions.delete
supporteranno
gli ID traccia di sottotitoli sia vecchi che nuovi. Tuttavia, a partire dal 1° dicembre 2022, YouTube non supporterà più i vecchi ID traccia di sottotitoli codificati. A quel punto, se chiami uno di questi metodi dell'API
con un ID traccia di sottotitoli precedente, verrà restituito un
errore captionNotFound
.
Per prepararti a questa modifica, ti consigliamo di sostituire completamente tutti i dati delle tracce di sottotitoli codificati archiviati da adesso fino al 1° dicembre 2022. Ciò significa che, per qualsiasi video per cui memorizzi i dati delle tracce di sottotitoli codificati, devi eliminare i dati attualmente memorizzati, quindi chiamare il metodo captions.list
per recuperare l'insieme corrente di tracce di sottotitoli codificati per il video e archiviare 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 i Termini di servizio dei servizi API di YouTube - Cronologia delle revisioni.
27 aprile 2022
La descrizione del metodo videos.insert
è stata aggiornata in modo da tenere presente 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 in modo da tenere presente che il numero massimo di abbonati restituiti dall'API potrebbe essere limitato.
Questa modifica rappresenta una correzione della documentazione e non una modifica del comportamento dell'API.
15 dicembre 2021
Come annunciato il 18 novembre 2021, in concomitanza con le modifiche volte a rendere privato il conteggio dei Non mi piace sui video sull'intera piattaforma YouTube, la proprietà statistics.dislikeCount
della risorsa video
è ora privata.
Puoi scoprire di più su questa modifica sul blog ufficiale di YouTube.
18 novembre 2021
In concomitanza con le modifiche per rendere privato il conteggio dei Non mi piace sui video sull'intera piattaforma YouTube, la proprietà statistics.dislikeCount
della risorsa video
verrà resa 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 numero di Non mi piace e che hanno comunque bisogno del numero di Non mi piace per il loro 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 sul blog ufficiale di YouTube.
2 luglio 2021
Nota:questo è un annuncio relativo al ritiro.
L'endpoint commentThreads.update
è stato deprecato e non è più supportato.
Questo endpoint ha duplicato le funzionalità disponibili tramite altri endpoint API. Puoi però chiamare il metodo comments.update
commentThreads
, effettua una chiamata secondaria al metodo commentThreads.list
.
1° luglio 2021
Tutti gli sviluppatori che utilizzano i servizi API di YouTube sono tenuti a completare un controllo della conformità delle API per poter ottenere una quota superiore all'allocazione predefinita di 10.000 unità. A oggi, sia il processo di controllo della conformità sia le richieste di allocazione di unità di quota aggiuntive sono state condotte dagli sviluppatori che hanno compilato e inviato il modulo API di YouTube - Controllo ed estensione della quota.
Per chiarire questi processi e soddisfare meglio le esigenze degli sviluppatori che utilizzano i nostri servizi API, aggiungeremo tre nuovi moduli e una guida per la compilazione:
- Modulo per le richieste degli sviluppatori controllate: gli sviluppatori che hanno già superato un controllo della conformità dell'API possono compilare e inviare questo modulo più breve per richiedere un'estensione della quota allocata.
- Modulo per i ricorsi: gli sviluppatori i cui progetti API non hanno superato il controllo di conformità (o a cui è stato negato l'aumento delle unità della quota) possono compilare e inviare questo modulo.
- Modulo di modifica di controllo: gli sviluppatori o qualsiasi parte che gestisca un client API per conto di uno sviluppatore e che subisca un passaggio di controllo (ad esempio tramite acquisto o vendita di azioni, fusione o altra forma di transazione aziendale) associato a un progetto API sia tenuto a compilare e inviare questo modulo. Ciò consente al team API di YouTube di aggiornare i dati in nostro possesso, verificare la conformità ai casi d'uso del nuovo progetto API e convalidare l'attuale allocazione della quota da parte dello sviluppatore.
Ogni nuovo modulo ci comunicherà l'uso previsto dell'API di YouTube e ci consentirà di aiutarti meglio.
Ulteriori dettagli sono disponibili nella nostra nuova guida ai controlli di conformità delle API.
12 maggio 2021
Nota:questo è un annuncio relativo al ritiro.
Questo aggiornamento copre le seguenti modifiche all'API:
-
La proprietà
contentDetails.relatedPlaylists.favorites
della risorsachannel
è stata deprecata. La funzionalità Video preferiti è già 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 preferita inesistente. In futuro, la playlist non verrà creata in questo caso e l'API restituirà un errore. Anche i tentativi di modificare le playlist preferite aggiungendo, modificando o eliminando elementi sono deprecati in base agli annunci precedenti e potrebbero iniziare a restituire errori in qualsiasi momento.
-
Le seguenti proprietà delle risorse
channel
sono state deprecate. Queste proprietà non sono già supportate nell'interfaccia utente di YouTube Studio e su YouTube. Di conseguenza, non sono più supportati 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 rappresentazione della risorsa
channel
e le relative 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à delle risorse
channelSection
sono state deprecate. Queste proprietà non sono già supportate nell'interfaccia utente di YouTube Studio e su YouTube. Di conseguenza, non sono più supportati 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 metodochannelSection.list
è stato deprecato poiché le funzionalità che supporta non sono supportate.Tutte le proprietà sono state rimosse dalla rappresentazione della risorsa
channelSection
e le relative 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 risorsachannelSection
, i seguenti valori sono stati deprecati. Questi valori non sono già supportati sulle pagine del canale YouTube e, di conseguenza, non sono più supportati tramite l'API.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
La proprietà
snippet.tags[]
della risorsaplaylist
è stata deprecata. Questa proprietà è già non supportata su YouTube e, di conseguenza, non è più supportata tramite l'API.
9 febbraio 2021
La risorsa playlistItem
supporta due nuove proprietà:
- La proprietà
snippet.videoOwnerChannelId
identifica l'ID del canale che ha caricato il video della playlist. - La proprietà
snippet.videoOwnerChannelTitle
identifica il nome del canale che ha caricato il video della playlist.
28 gennaio 2021
Questo aggiornamento contiene le seguenti modifiche:
-
I metodi
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
eplaylists.update
supportano tutti un nuovo erroreplaylistOperationUnsupported
. 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 né la playlist stessa.In tutti i casi, questo errore restituisce un codice di risposta HTTP
400
(richiesta errata). -
Gli errori
watchHistoryNotAccessible
ewatchLaterNotAccessible
del metodoplaylistItems.list
sono stati rimossi dalla documentazione. Sebbene la cronologia delle visualizzazioni e gli elenchi Guarda più tardi degli utenti non siano effettivamente accessibili tramite l'API, questi errori particolari 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 ulteriori informazioni sui dati raccolti e inviati tramite il player incorporato di YouTube. L'utente è responsabile di tutti i dati utente che ci invii tramite un player incorporato di YouTube prima che l'utente abbia interagito con il player per indicare l'intento 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 dei contenuti destinati ai bambini prima di incorporarli sui tuoi siti e nelle tue app. Hai la responsabilità di sapere quando i video che incorpori nel tuo client API sono destinati ai bambini e di trattare di conseguenza i dati raccolti dal player incorporato. Pertanto, devi verificare lo stato dei contenuti utilizzando il servizio API YouTube Data prima di incorporarli sul tuo client API tramite qualsiasi player incorporato di YouTube.
La nuova guida Trovare lo stato MadeForKids di un video spiega come cercare lo stato per i contenuti destinati ai bambini di un video utilizzando il servizio API di dati di YouTube.
Insieme a queste modifiche, abbiamo aggiunto un promemoria alla documentazione relativa ai parametri del player incorporato per spiegare che, se attivi la riproduzione automatica, la riproduzione avverrà senza alcuna interazione dell'utente con il player; di conseguenza, la raccolta e la condivisione dei dati di riproduzione avvengono al caricamento pagina.
8 ottobre 2020
Questo aggiornamento riguarda tre piccole modifiche relative alla risorsa channel
:
- L'oggetto
snippet.thumbnails
, che identifica le miniature di un canale, potrebbe essere vuoto per i nuovi canali e potrebbe richiedere fino a un giorno. - La proprietà
statistics.videoCount
rispecchia il numero dei video pubblici del canale solo, 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 senza caratteri di escape ("
). Tieni presente che il limite di 500 caratteri non è un limite per parola chiave, ma un limite relativo alla lunghezza totale di tutte le parole chiave. Questo comportamento è coerente con quello sul sito web di YouTube.
9 settembre 2020
Nota:questo è un annuncio relativo al ritiro.
Questo aggiornamento copre le seguenti modifiche all'API. Tutte le modifiche entreranno in vigore a partire dal 9 settembre 2020, data di questo annuncio. Tenendo conto di questo, gli sviluppatori non devono più fare affidamento su nessuna delle funzionalità dell'API elencate di seguito.
-
Le risorse, i metodi, i parametri e le proprietà delle risorse dell'API seguenti vengono deprecati immediatamente e smetteranno di funzionare a partire dalla data di questo annuncio:
- Le seguenti proprietà delle risorse
channel
:- La proprietà
statistics.commentCount
- L'oggetto
brandingSettings.image
e tutte le relative proprietà figlio - L'elenco
brandingSettings.hints
e tutte le relative proprietà secondarie
- La proprietà
- Parametro di filtro
categoryId
del metodochannels.list
- La risorsa
guideCategories
e il metodoguideCategories.list
- Le seguenti proprietà delle risorse
-
Le risposte dell'API per il metodo
channels.list
non contengono più la proprietàprevPageToken
se la richiesta API imposta il parametromanagedByMe
sutrue
. Questa modifica non influisce sulla proprietàprevPageToken
per altre richiestechannels.list
e non influisce sulla proprietànextPageToken
per le richieste. -
Le proprietà
contentDetails.relatedPlaylists.watchLater
econtentDetails.relatedPlaylists.watchHistory
della risorsachannel
sono state annunciate come deprecate l'11 agosto 2016. Anche il supporto dei metodiplaylistItems.insert
eplaylistItems.delete
per queste playlist è ora completamente deprecato e le due proprietà sono state rimosse dalla documentazione. -
Il parametro
mySubscribers
del metodochannels.list
, che era stato annunciato come deprecato il 30 luglio 2013, è stato rimosso dalla documentazione. Utilizza il metodosubscriptions.list
e il relativo parametromySubscribers
per recuperare un elenco degli iscritti al canale dell'utente autenticato. -
L'oggetto
invideoPromotion
della risorsachannel
e tutte le relative proprietà figlio, che sono state annunciate come deprecate il 27 novembre 2017, sono stati rimossi dalla documentazione.
29 luglio 2020
Abbiamo semplificato la nostra procedura per l'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. Ulteriori informazioni sulla quota semplificata sono disponibili qui.
L'effetto di questa modifica è che la maggior parte delle chiamate API avrà un costo di 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 in Google Cloud Console, andrà un po' oltre.
Consigliamo vivamente a tutti gli sviluppatori di completare un controllo di conformità per i loro progetti al fine di garantire un 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
dai progetti API non verificati creati dopo il 28 luglio 2020 verranno limitati alla modalità di visualizzazione privata. Per rimuovere questa limitazione, ogni progetto deve
essere sottoposto a un controllo per verificare
la conformità ai
Termini di servizio.
I creator che utilizzano un client API non verificato per caricare il video riceveranno un'email in cui viene spiegato che il video è stato bloccato come privato e che possono evitare la limitazione utilizzando un client ufficiale o controllato.
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 un controllo di conformità per i loro progetti al fine di garantire l'accesso continuo ai servizi API di YouTube.
21 luglio 2020
[Ultimo aggiornamento: 28 luglio 2020] L'aggiornamento della documentazione a cui viene fatto riferimento in questa voce della cronologia delle revisioni è stato ripubblicato il 28 luglio 2020.
Ieri abbiamo pubblicato un aggiornamento della documentazione relativo alla nostra procedura per l'addebito della quota. Tuttavia, a causa di circostanze impreviste, la modifica della quota non è ancora effettiva. Di conseguenza, la documentazione è stata ripristinata per motivi di 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 relativo al ritiro.
I parametri autoLevels
e stabilize
del metodo videos.insert
sono ora deprecati ed entrambi i parametri sono stati rimossi dalla documentazione. I valori vengono ignorati e non influiscono
sulla modalità di elaborazione dei video appena caricati.
15 giugno 2020
La nuova guida Rispetto delle Norme per gli sviluppatori di YouTube fornisce indicazioni ed esempi per aiutarti a garantire che i tuoi client API rispettino le sezioni specifiche dei Termini e delle Norme (TdS delle API) dei servizi API di YouTube.
Queste indicazioni offrono insight su come YouTube applica determinati aspetti dei TdS dell'API, ma non sostituisce i documenti esistenti. Questa guida risponde ad alcune delle domande più comuni poste dagli sviluppatori durante i controlli di conformità delle API. Ci auguriamo che questo ti semplifichi il processo di sviluppo delle funzionalità, aiutandoti a comprendere il modo in cui interpretiamo e applichiamo le nostre norme.
4 giugno 2020
Nota:questo è un aggiornamento di un precedente annuncio sul ritiro.
La funzionalità Bollettino del canale è stata ritirata completamente. Questa modifica era stata inizialmente annunciata il 17 aprile 2020 ed è ora in vigore. Di conseguenza, il metodo activities.insert
non è più supportato e il metodo activities.list
non restituisce più i bollettini del canale. Per ulteriori dettagli, visita il Centro assistenza YouTube.
17 aprile 2020
Nota:questo è un annuncio relativo al ritiro.
YouTube sta ritirando la funzionalità dei bollettini del canale. Di conseguenza, il metodo activities.insert
verrà ritirato e il metodo activities.list
interromperà la restituzione dei bollettini del canale. Queste modifiche entreranno in vigore nell'API a partire dal 18 maggio 2020. Per ulteriori dettagli, visita il Centro assistenza YouTube.
31 marzo 2020
Questo aggiornamento contiene le seguenti modifiche:
-
Nuove risorse e metodi
-
La nuova risorsa
member
rappresenta l'abbonamento a un canale YouTube. Un abbonato fornisce un sostegno economico ricorrente a un creator e riceve vantaggi speciali. Ad esempio, gli abbonati possono chattare quando il creator attiva la modalità riservata agli abbonati per una chat.Questa risorsa sostituisce la risorsa
sponsor
, documentata nell'ambito dell'API YouTube Live Streaming. La risorsasponsor
è ora deprecata e i client API devono aggiornare le chiamate al metodosponsors.list
per utilizzare invece il metodomembers.list
. -
La nuova risorsa
membershipsLevel
identifica un livello di prezzo gestito dall'autore che ha autorizzato la richiesta API. Il metodomembershipsLevels.list
consente di recuperare un elenco di tutti i livelli dell'abbonamento del creator.
-
10 gennaio 2020
L'API ora supporta la possibilità di identificare i contenuti rivolti ai minori, definiti da YouTube come "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 ai creator di contenuti e agli spettatori di identificare i contenuti destinati ai bambini:
-
La proprietà
selfDeclaredMadeForKids
consente ai creator di contenuti di specificare se un canale o un video è destinato ai bambini.
Per i canali, questa proprietà può essere impostata quando si chiama il metodochannels.update
. Per i video, questa proprietà può essere impostata quando chiami i metodivideos.insert
ovideos.update
.
Tieni presente che questa proprietà è inclusa nelle risposte dell'API che contengono risorsechannel
ovideo
solo 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
. Consulta il Centro assistenza YouTube per ulteriori informazioni sull'impostazione del pubblico per il tuo canale, i tuoi video o le tue trasmissioni.
Abbiamo inoltre aggiornato i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta i Termini di servizio dei servizi API di YouTube - Cronologia delle revisioni. Le modifiche ai Termini di servizio e alle Norme per gli sviluppatori dei servizi API di YouTube entreranno in vigore il 10 gennaio 2020 (fuso orario del Pacifico).
10 settembre 2019
La documentazione di riferimento dell'API è stata aggiornata per riflettere una modifica alle modalità di segnalazione del numero di iscritti su YouTube e, di conseguenza, nelle risposte dell'API. In seguito alla modifica, il numero di iscritti restituito dal servizio API YouTube Data viene arrotondato per difetto a tre cifre significative per il numero di iscritti superiore a 1000. Questa modifica influisce sulla proprietà statistics.subscriberCount della risorsa channel
.
Nota: questa modifica influisce sul valore di questa proprietà anche nei casi in cui un utente invii una richiesta autorizzata di dati relativi al 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 il numero di iscritti viene arrotondato nelle risposte dell'API e abbreviato in altre interfacce utente di YouTube visibili pubblicamente:
Esempio di numero di iscritti | API Data di YouTube | UI di YouTube visibili pubblicamente |
---|---|---|
1234 | 1230 | 1230 |
12.345 | 12300 | 12.300 |
123.456 | 123000 | 123.000 |
1.234.567 | 1230000 | 1,23 Mln |
12.345.678 | 12300000 | 12,3 Mln |
123.456.789 | 123000000 | 123 Mln |
4 aprile 2019
Questo aggiornamento contiene le seguenti modifiche:
-
La documentazione di riferimento delle API è stata aggiornata per spiegare meglio i casi d'uso comuni per ciascun metodo e per fornire esempi di codice dinamici e di alta qualità tramite il widget Explorer API. Per un esempio, consulta la documentazione del metodo
channels.list
. Ora sono disponibili due nuovi elementi nelle pagine che descrivono i metodi dell'API:-
Il widget Explorer API consente di selezionare gli ambiti di autorizzazione, inserire esempi di valori di parametri e proprietà, quindi inviare richieste API effettive e visualizzare le risposte effettive dell'API. Il widget offre anche una visualizzazione a schermo intero che mostra esempi di codice completi, che vengono aggiornati in modo dinamico per utilizzare gli ambiti e i valori inseriti.
-
La sezione Casi d'uso comuni descrive uno o più casi d'uso comuni per il metodo illustrato 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 completare il programma Explorer API con valori di esempio per il tuo caso d'uso o per aprire l'Explorer API a schermo intero con questi valori già compilati. Lo scopo di queste modifiche è facilitare la visualizzazione di esempi di codice direttamente applicabili al caso d'uso che stai cercando di implementare nella tua applicazione.
Gli esempi di codice sono attualmente supportati per Java, JavaScript, PHP, Python e curl.
-
-
Anche lo strumento per gli esempi di codice è stato aggiornato con una nuova UI che offre tutte le funzionalità descritte in precedenza. Utilizzando questo strumento, puoi esplorare casi d'uso per metodi diversi, caricare valori in Explorer API e aprire l'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 aggiornate spiegano come eseguire un esempio con una chiave API e un altro campione con un ID client OAuth 2.0 utilizzando esempi di codice di Explorer API.
Tieni presente che le modifiche descritte sopra sostituiscono uno strumento interattivo che è stato aggiunto alla documentazione dell'API nel 2017.
9 luglio 2018
Questo aggiornamento contiene le seguenti modifiche:
-
La definizione della proprietà
snippet.thumbnails
della risorsachannel
è stata aggiornata in modo da notare che, quando visualizzi le miniature nell'applicazione, il codice deve utilizzare gli URL immagine esattamente come vengono restituiti nelle risposte dell'API. Ad esempio, l'applicazione non deve utilizzare il dominiohttp
anziché il dominiohttps
in un URL restituito in una risposta dell'API.A partire da luglio 2018, gli URL delle miniature dei canali saranno disponibili solo nel dominio
https
, ovvero il modo in cui gli URL vengono visualizzati nelle risposte dell'API. Dopodiché, potresti visualizzare immagini non funzionanti nella tua applicazione se tenta di caricare immagini di YouTube dal dominiohttp
. -
Nota:questo è un annuncio relativo al ritiro.
La proprietà
recordingDetails.location.altitude
della risorsavideo
è stata deprecata. Non c'è alcuna garanzia che i video restituiscano valori per questa proprietà. Allo stesso modo, anche se le richieste API tentano di impostare un valore per quella proprietà, è possibile che i dati in entrata non vengano archiviati.
22 giugno 2018
La guida all'implementazione, precedentemente nota come guida all'implementazione e alla migrazione, è stata aggiornata per rimuovere le istruzioni per la migrazione dall'API v2 all'API v3. Sono state inoltre rimosse 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 relativo al ritiro.
YouTube sta rimuovendo il supporto per le funzionalità Video in primo piano e Sito web in primo piano, che sono supportate nell'API tramite l'oggetto
invideoPromotion
della risorsachannel
. Di conseguenza, l'oggetto e tutte le sue proprietà figlio verranno deprecati.Puoi ancora recuperare e impostare i dati relativi a
invideoPromotion
fino al 14 dicembre 2017. Dopo questa data:- I tentativi di recuperare la parte
invideoPromotion
durante la chiamata achannels.list
restituiranno un valoreinvideoPromotion
vuoto o non restituiranno alcun datoinvideoPromotion
. - I tentativi di aggiornare i dati di
invideoPromotion
durante la chiamata al numerochannels.update
restituiranno una risposta positiva almeno fino al 27 maggio 2018, ma verranno trattati come operazioni autonome, ovvero non eseguiranno effettivamente un aggiornamento.
Dopo il 27 maggio 2018, è possibile che queste richieste restituiscano messaggi di errore indicanti, ad esempio, che
invalidPromotion
non è una parte valida. - I tentativi di recuperare la parte
16 novembre 2017
Questo aggiornamento contiene le seguenti modifiche:
-
Lo strumento interattivo per snippet di codice ora supporta gli esempi di codice Node.js. Gli esempi sono visibili anche nella documentazione per quasi tutti i metodi dell'API, come il metodo
channels.list
.Gli esempi personalizzabili sono progettati per offrirti un punto di partenza specifico per il caso d'uso per un'applicazione Node.js. La funzionalità è simile 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 che non hanno valori. - La funzione
createResource
accetta un elenco di coppie chiave/valore corrispondenti alle proprietà in una risorsa API. Quindi converte le proprietà in un oggetto JSON che può essere utilizzato nelle operazioniinsert
eupdate
. L'esempio seguente mostra un insieme di nomi e valori di proprietà e l'oggetto JSON che verrà creato dal codice:# 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 snippet di codice.
- La funzione
25 ottobre 2017
Questo aggiornamento contiene le seguenti modifiche:
-
Gli esempi di codice Python nello strumento interattivo degli snippet di codice sono stati aggiornati in modo da utilizzare le librerie
google-auth
egoogle-auth-oauthlib
anziché la libreriaoauth2client
, che ora è deprecata.Oltre a questa modifica, lo strumento ora fornisce esempi di codice completi per le applicazioni Python installate e le applicazioni server web Python, che utilizzano flussi di autorizzazione leggermente diversi. Per visualizzare gli esempi completi (e questa modifica):
- Vai allo strumento interattivo per snippet di codice o consulta la documentazione relativa a qualsiasi metodo API, ad esempio il metodo
channels.list
. - Fai clic sulla scheda
Python
sopra gli esempi di codice. - Fai clic sul pulsante di attivazione/disattivazione sopra le schede per passare dalla visualizzazione di uno snippet all'esempio completo.
- La scheda ora dovrebbe mostrare un esempio di codice completo che utilizza il flusso di autorizzazione
InstalledAppFlow
. La descrizione sopra l'esempio spiega questo concetto e contiene anche un link a un esempio di applicazione server web. - Fai clic sul link per passare all'esempio del server web. L'esempio utilizza il framework dell'applicazione web Flask e un flusso di autorizzazione diverso.
Tutti questi esempi sono progettati per essere scaricati ed eseguiti localmente. Se vuoi eseguire gli esempi, consulta le istruzioni per eseguire esempi di codice completi a livello locale nelle istruzioni dello strumento Snippet di codice.
- Vai allo strumento interattivo per snippet di codice o consulta la documentazione relativa a qualsiasi metodo API, ad esempio il metodo
29 agosto 2017
Questo aggiornamento contiene le seguenti modifiche:
- La definizione del parametro
forContentOwner
del metodosearch.list
è stata aggiornata in modo da notare che, se il parametro è impostato sutrue
, il parametrotype
deve essere impostato suvideo
. - La definizione del parametro
regionCode
del metodosearch.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 "sviluppati con YouTube" possono essere scaricati dalla pagina delle linee guida per il branding. In questa pagina vengono mostrati anche altri nuovi loghi e icone di YouTube, che possono essere scaricati dal sito del brand di YouTube.
24 luglio 2017
Questo aggiornamento contiene le seguenti modifiche:
- Per iOS è disponibile una nuova guida rapida all'API di dati di YouTube. La guida spiega come utilizzare l'API di dati di YouTube in una semplice applicazione per iOS scritta in Objective-C o Swift.
- Lo strumento interattivo per snippet di codice per l'API di dati di YouTube ora include la documentazione che spiega alcune funzionalità dello strumento:
- Esecuzione delle richieste API
- Passare dagli snippet di codice agli esempi di codice completi
- Utilizzo delle funzioni boilerplate
- Caricamento delle risorse esistenti (per i metodi di aggiornamento)
Nota: lo strumento è anche incorporato nella documentazione di riferimento dell'API per i metodi API (esempio).
1 giugno 2017
Questo aggiornamento contiene le seguenti modifiche:
-
Nota:questo è un annuncio relativo al ritiro.
Le seguenti
video
proprietà delle risorse sono in fase di ritiro. Anche se le proprietà saranno supportate fino al 1° dicembre 2017, non vi è alcuna garanzia che i video continuino a restituire valori per queste proprietà fino a quel momento. Analogamente, le richiestevideos.insert
evideos.update
che impostano questi valori delle proprietà non generano errori prima di questa data, ma è possibile che i dati in entrata non vengano archiviati.
17 maggio 2017
Questo aggiornamento contiene le seguenti modifiche:
-
La documentazione di riferimento delle API è stata aggiornata per rendere gli snippet di codice più onnipresenti e interattivi. Le pagine che spiegano i metodi delle API, come
channels.list
ovideos.rate
, ora dispongono di uno strumento interattivo che ti consente di visualizzare e personalizzare 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, ognuno dei quali descrive un modo comune per chiamare questo metodo. Ad esempio, puoi chiamare il metodo
channels.list
per recuperare i dati relativi a un canale specifico o a quello dell'utente corrente.Puoi anche interagire con gli esempi di codice:
-
Modificando i valori dei parametri e delle proprietà, gli snippet di codice verranno aggiornati in modo dinamico per riflettere i valori forniti.
-
Passa dagli snippet di codice agli esempi completi. Uno snippet di codice mostra la porzione di codice che chiama il metodo API. Un esempio completo contiene lo snippet e il codice boilerplate per l'autorizzazione e l'invio delle richieste. Gli esempi completi possono essere copiati ed eseguiti dalla riga di comando o da un server web locale.
-
Esegui le richieste facendo clic su un pulsante. Per eseguire le richieste, devi autorizzare lo strumento a chiamare l'API per tuo conto.
Tieni presente che questo strumento ha sostituito Explorer API nelle pagine in cui è disponibile. Ogni pagina mostra un link in modo che tu abbia anche la possibilità di caricare la richiesta a cui stai lavorando in Explorer API.
-
-
Anche lo strumento Snippet di codice dell'API di dati è stato aggiornato con una nuova interfaccia utente che offre tutte le funzionalità descritte in precedenza. Le nuove funzionalità principali 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:
- Nuove guide rapide che spiegano come configurare una semplice applicazione che effettui richieste all'API di dati di YouTube. Le guide sono attualmente disponibili per Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python e Ruby.
30 marzo 2017
Questo aggiornamento contiene le seguenti modifiche:
- La nuova proprietà
topicDetails.topicCategories[]
della risorsachannel
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 risorsaplaylistItem
identifica il momento in cui il video è stato pubblicato su YouTube. La risorsa contiene già la proprietàsnippet.publishedAt
, che identifica l'ora in cui l'elemento è stato aggiunto alla playlist. - Come la risorsa
channel
, la risorsavideo
ora restituisce la proprietàtopicDetails.topicCategories[]
, che contiene un elenco di URL di Wikipedia che descrivono i contenuti del video. Per le risorsevideo
, gli URL corrispondono agli ID argomento restituiti nella proprietàtopicDetails.relevantTopicIds[]
della risorsa. - La nuova proprietà
contentDetails.contentRating.mpaatRating
della risorsavideo
identifica la valutazione attribuita dalla Motion Picture Association of America al trailer o all'anteprima di un film.
27 febbraio 2017
Come annunciato l'11 agosto 2016, YouTube ha modificato l'elenco degli ID argomento supportati in un elenco selezionato. L'elenco completo degli ID argomento supportati è incluso nelle proprietà topicDetails
per le risorse channel
e video
, nonché nel parametro topicId
del metodo search.list
.
Tieni presente che sono state apportate diverse modifiche all'elenco selezionato:
- I seguenti argomenti sono stati aggiunti come argomenti secondari di
Society
:Nome ID argomento Attività commerciale /m/09s1f
Integrità /m/0kt51
Forze armate /m/01h6rj
Politica /m/05qt0
Religione /m/06bvp
- L'argomento
Animated cartoon
, in precedenza secondario diEntertainment
, è stato rimosso. - L'argomento
Children's music
, in precedenza secondario diMusic
, è stato rimosso.
A seguito di questa modifica, gli argomenti correlati a un video ora vengono sempre restituiti nel valore della proprietà topicDetails.relevantTopicIds[]
della risorsa video
.
29 novembre 2016
Questo aggiornamento contiene le seguenti modifiche:
-
Sono state apportate tre piccole modifiche all'elenco di ID argomento che saranno supportati a partire dal 10 febbraio 2017:
- La categoria
Professional wrestling
, che in precedenza era secondaria rispetto alla categoriaSports
, ora è secondaria diEntertainment
. - La categoria
TV shows
, che è secondaria diEntertainment
, è nuova. - La categoria
Health
, che in precedenza era secondaria diLifestyle
, è stata rimossa.
Tieni inoltre presente che esistono alcune categorie principali (
Entertainment
,Gaming
,Lifestyle
,Music
eSports
). Qualsiasi video associato a una categoria secondaria, comeTennis
, verrà anche associato alla categoria principale (Sports
). - La categoria
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
evideo
; inoltre, puoi utilizzare il parametro di ricercatopicId
per trovare canali o video correlati a un determinato argomento.Il 10 febbraio 2017, YouTube inizierà a restituire un piccolo insieme di ID argomento, invece di un insieme molto più granulare di ID restituito finora. Inoltre, tieni presente che non è garantito che canali e video vengano associati ad alcun argomento, il che è coerente con il comportamento attuale dell'API.
Per consentirti di preparare i client API a queste modifiche, le definizioni dei parametri e delle proprietà API seguenti sono state aggiornate in modo da elencare gli ID argomento che saranno supportati successivamente. Tieni presente che l'elenco delle categorie è lo stesso per tutte le proprietà.
- La proprietà
topicDetails.topicIds[]
della risorsachannel
. - La proprietà
topicDetails.relevantTopicIds[]
della risorsavideo
. - Il parametro
topicId
del metodosearch.list
.
- La proprietà
-
Nota:questo è un annuncio relativo al ritiro.
Le seguenti proprietà verranno ritirate:
- La proprietà
topicDetails.topicIds[]
della risorsachannel
. Questa proprietà sarà supportata fino al 10 novembre 2017. - La proprietà
topicDetails.relevantTopicIds[]
della risorsavideo
. Questa proprietà sarà supportata fino al 10 novembre 2017. - La proprietà
topicDetails.topicIds[]
della risorsavideo
. 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.
- La proprietà
-
Poiché Freebase è già stato ritirato, la guida Ricerca con Freebase Topics è stata rimossa dalla documentazione. La guida ha fornito 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:
-
Nuovi parametri e proprietà
-
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
eplayer.embedWidth
identificano le dimensioni del player incorporato. Queste proprietà vengono restituite solo se la richiesta API specifica un valore per almeno uno dei parametrimaxHeight
omaxWidth
. Questi due nuovi parametri verranno illustrati più avanti in questa voce della cronologia delle revisioni. -
La nuova proprietà
hasCustomThumbnail
indica se l'utente che ha caricato il video ha fornito un'immagine in miniatura personalizzata per il video. Tieni presente che questa proprietà è visibile solo all'utente che ha caricato il video. -
Il nuovo
fpbRatingReasons[]
identifica i motivi per cui il video ha ricevuto la classificazione FPB (Sudafrica). -
Il nuovo
mcstRating
identifica la classificazione ricevuta dal video in Vietnam.
-
-
Il metodo
videos.list
supporta due nuovi parametri:maxHeight
emaxWidth
. Puoi utilizzare uno dei parametri o entrambi i parametri quando recuperi la parteplayer
nelle risorsevideo
.Per impostazione predefinita, l'altezza del
<iframe>
restituito nella proprietàplayer.embedHtml
è 360 px. La larghezza si adatta alle proporzioni del video, assicurando così che il player incorporato non presenti barre nere che incorniciano il video. Quindi, ad esempio, se le proporzioni di un video sono 16:9, la larghezza del player sarà 640 px.Con i nuovi parametri, puoi specificare che, al posto delle dimensioni predefinite, il codice per l'incorporamento deve utilizzare l'altezza e/o la larghezza appropriate per il layout della tua applicazione. Il server API scala le dimensioni del player nel modo più appropriato per garantire che il player incorporato non presenti 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 essere comunque inferiore al numero massimo consentito per quella dimensione.
Ad esempio, supponi che le proporzioni di un video siano 16:9. Pertanto, il tag
player.embedHtml
conterrebbe un player 640 x 360 se non viene impostato il parametromaxHeight
omaxWidth
.- Se il parametro
maxHeight
è impostato su720
e il parametromaxWidth
non è impostato, l'API restituirà un player 1280 x 720. - Se il parametro
maxWidth
è impostato su960
e il parametromaxHeight
non è impostato, l'API restituirà un player 960 x 540. - Se il parametro
maxWidth
è impostato su960
e il parametromaxHeight
è impostato su450
, l'API restituirà un player 800 x 450.
Le nuove proprietà
player.embedHeight
eplayer.embedWidth
, descritte sopra, identificano le dimensioni del player. - Se il parametro
-
-
Aggiornamenti a metodi, proprietà e parametri esistenti
-
La descrizione della risorsa
channelSection
è stata aggiornata in modo da notare che un canale può creare un massimo di 10 sezioni senza impostare dati di targeting e può creare un massimo di 100 sezioni con dati di targeting.Inoltre, la proprietà
targeting
della risorsachannelSection
è 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 risorsai18nLanguage
è stata corretta in modo che il valore rappresenti il nome di una lingua così come è scritto nella lingua specificata dal parametrohl
del metodoi18nLanguage.list
. -
La proprietà
contentDetails.note
della risorsaplaylistItem
è stata aggiornata in modo da notare che la lunghezza massima del valore della proprietà è di 280 caratteri. -
Le proprietà
contentDetails.startAt
econtentDetails.endAt
della risorsaplaylistItem
sono state ritirate. Questi campi vengono ignorati se sono impostati nelle richiesteplaylistItems.insert
oplaylistItems.update
. -
I metodi
playlistItems.delete
eplaylistItems.update
ora supportano il parametroonBehalfOfContentOwner
, che è già supportato per molti altri metodi. Le richieste che utilizzano questo metodo devono anche essere autorizzate con un token che fornisca l'accesso all'ambitohttps://www.googleapis.com/auth/youtubepartner
. -
I parametri
publishedBefore
epublishedAfter
del metodosearch.list
sono stati aggiornati per indicare che i valori dei parametri sono inclusivi. Ad esempio, se il parametropublishedBefore
è impostato, l'API restituisce le risorse create prima o al momento specificato. -
La proprietà
contentDetails.contentRating.grfilmRating
della risorsavideo
supporta tre valori aggiuntivi:grfilmK12
,grfilmK15
egrfilmK18
. -
La descrizione del metodo
videos.insert
è stata aggiornata in modo da notare 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 Dettagli errore Descrizione forbidden (403)
homeParameterDeprecated
Il metodo activities.list
restituisce questo errore per indicare che i dati relativi all'attività nella home page dell'utente non sono disponibili tramite questa API. Questo errore può verificarsi se imposti il parametrohome
sutrue
in una richiesta non autorizzata.invalidValue (400)
invalidContentDetails
Il metodo playlistItems.insert
restituisce questo errore per indicare che l'oggettocontentDetails
nella richiesta non è valido. Uno dei motivi per cui si verifica questo errore è che il campocontentDetails.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 non è stato possibile recuperarli 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 non è stato possibile recuperarli 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 configurare un'impostazione di incorporamento non valida per il video. Tieni presente che alcuni canali potrebbero non disporre dell'autorizzazione per offrire player incorporati per i live streaming. Consulta il Centro assistenza YouTube per ulteriori informazioni. -
Il metodo
playlistItems.insert
non restituisce più un errore se inserisci un video duplicato in una playlist. Questo errore si è verificato in precedenza per alcune playlist, come i video preferiti, che non consentivano la creazione di duplicati, ma non sono più supportate. In genere, le playlist consentono i video duplicati.
-
-
Altri aggiornamenti
-
La voce della cronologia delle revisioni relativa al 15 settembre 2016 è stata aggiornata per chiarire che, ogni volta che le proprietà
contentDetails.relatedPlaylists.watchHistory
econtentDetails.relatedPlaylists.watchLater
della risorsachannel
sono incluse in una risposta, contengono sempre i valoriHL
eWL
, rispettivamente. Inoltre, queste proprietà sono incluse solo se un utente autorizzato sta recuperando dati sul proprio canale dell'utente.
-
15 settembre 2016
Questo aggiornamento contiene le seguenti modifiche:
-
L'11 agosto 2016, l'aggiornamento della cronologia delle revisioni ha discusso di diverse modifiche relative agli ID argomento, incluso il fatto che l'insieme di ID degli argomenti supportati cambierà a partire dal 10 febbraio 2017. L'elenco degli argomenti che saranno supportati sarà pubblicato entro il 10 novembre 2016.
-
Le seguenti modifiche sono ora effettive. L'avviso di queste modifiche è stato dato nell'aggiornamento della cronologia delle revisioni l'11 agosto 2016:
-
Se il metodo
activities.list
viene chiamato con il parametrohome
impostato sutrue
, la risposta dell'API ora contiene elementi simili a quelli che vedono un utente di YouTube disconnesso sulla home page.Si tratta di una leggera modifica il cui scopo è fornire una migliore esperienza utente rispetto al comportamento descritto nell'aggiornamento della cronologia delle revisioni dell'11 agosto 2016. L'aggiornamento aveva dichiarato che le richieste che utilizzavano il parametro
home
avrebbero restituito un elenco vuoto. -
Le proprietà
contentDetails.relatedPlaylists.watchHistory
econtentDetails.relatedPlaylists.watchLater
della risorsachannel
ora contengono valori rispettivamente pari aHL
eWL
per tutti i canali.Precisiamo che queste proprietà sono visibili soltanto a un utente autorizzato che recupera i dati relativi al canale dell'utente. Le proprietà contengono sempre i valori
HL
eWL
, anche nel caso di un utente autorizzato che recupera i dati relativi al proprio canale. Pertanto, la cronologia delle visualizzazioni e gli ID delle 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 restituiscono elenchi vuoti. Questo comportamento vale per i nuovi valoriHL
eWL
, nonché per la cronologia delle visualizzazioni o gli ID delle playlist Guarda più tardi che il tuo client API potrebbe aver già memorizzato.
-
-
L'oggetto
fileDetails.recordingLocation
della risorsavideo
e le relative proprietà figlio non vengono più restituiti. In precedenza, questi dati (come l'oggetto principalefileDetails
) potevano essere recuperati solo dal proprietario del video.
11 agosto 2016
Questo aggiornamento contiene le seguenti modifiche:
-
I nuovi Termini di servizio dei servizi API di YouTube ("Termini aggiornati"), illustrati in dettaglio sul Blog per sviluppatori e ingegneri di YouTube, forniscono una vasta gamma di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto per spiegare le norme che gli sviluppatori devono rispettare.
L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni per i Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti di supporto verranno spiegate nella cronologia delle revisioni. Puoi iscriverti a un feed RSS che elenca le modifiche nella cronologia delle revisioni da un link presente nel documento.
-
Il ritiro di Freebase e dell'API Freebase sta causando diversi cambiamenti relativi agli ID argomento. Gli ID argomento vengono utilizzati nelle risorse e nei metodi dell'API seguenti:
- La parte
topicDetails
della risorsachannel
identifica gli argomenti associati al canale. - La parte
topicDetails
della risorsavideo
identifica gli argomenti associati al video. - Il parametro
topicId
del metodosearch.list
ti consente di cercare video o canali correlati a un determinato argomento.
Le modifiche a queste funzionalità sono:
-
A partire dal 10 febbraio 2017, YouTube inizierà a restituire un piccolo insieme di ID argomento, invece di un insieme molto più granulare di ID restituiti finora. Questo insieme di argomenti supportati identificherà classificazioni di alto livello come Sport o Basket, ma, ad esempio, non identificherà squadre o giocatori specifici. Annunceremo l'insieme degli argomenti supportati in modo che tu abbia il tempo di preparare la tua domanda di partecipazione a questo cambiamento.
-
Qualsiasi ID argomento Freebase già recuperato può essere utilizzato per cercare contenuti fino al 10 febbraio 2017. Trascorso questo periodo, potrai però utilizzare solo l'insieme più ridotto 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 non incluso nell'insieme più piccolo di ID argomento supportati, l'API restituirà un set di risultati vuoto.
- La parte
-
Diversi campi e parametri dell'API verranno ritirati a partire dal 12 settembre 2016:
-
Il parametro
home
del metodoactivities.list
ha consentito a un utente autorizzato di recuperare il feed attività che avrebbe visualizzato sulla 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
econtentDetails.relatedPlaylists.watchLater
della risorsachannel
sono visibili soltanto a un utente autorizzato che recupera i dati relativi al canale dell'utente. Dopo il 12 settembre 2016,contentDetails.relatedPlaylists.watchHistory
restituirà un valore pari aHL
e la proprietàcontentDetails.relatedPlaylists.watchLater
restituirà un valore pari aWL
per tutti i canali.Le richieste per recuperare i dettagli della playlist (
playlists.list
) relative alla cronologia delle visualizzazioni di un canale o alla playlist Guarda più tardi restituiranno un elenco vuoto dopo il 12 settembre 2016. Le richieste per recuperare gli elementi della playlist (playlistItems.list
) in una di queste playlist restituiranno anche un elenco vuoto dopo questo intervallo di tempo. Questo vale per i nuovi valoriHL
eWL
, nonché per la cronologia delle visualizzazioni o gli ID delle playlist Guarda più tardi che il tuo client API potrebbe aver già memorizzato. -
Dopo il 12 settembre 2016, l'oggetto
fileDetails.recordingLocation
della risorsavideo
o le relative proprietà secondarie non verranno più restituiti. Questi dati possono essere recuperati solo dal proprietario di un video, poiché l'oggetto principalefileDetails
può essere recuperato solo da un proprietario del video.
-
13 giugno 2016
Questo aggiornamento contiene le seguenti modifiche:
-
La proprietà
contentDetails.googlePlusUserId
della risorsachannel
è stata deprecata. In precedenza, la proprietà era presente solo se il canale era associato a un profilo Google+. Dopo il ritiro, la proprietà non sarà più inclusa in nessuna risorsachannel
. -
La proprietà
snippet.authorGoogleplusProfileUrl
della risorsacomment
è stata deprecata. In precedenza, la proprietà era presente solo se il canale era associato a un profilo Google+. Dopo il ritiro, la proprietà non sarà più inclusa in nessuna risorsacomment
.
Poiché nessuna di queste proprietà verrà restituita dopo il ritiro, entrambe sono state rimosse dalla documentazione delle risorse corrispondente.
31 maggio 2016
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo parametro
myRecentSubscribers
del metodosubscriptions.list
recupera un elenco degli iscritti al canale dell'utente autenticato, in ordine cronologico inverso rispetto all'ora in cui si sono iscritti al canale.Tieni presente che il nuovo parametro supporta solo il recupero degli ultimi 1000 iscritti al canale dell'utente autenticato. Per recuperare un elenco completo degli abbonati, utilizza il parametro
mySubscribers
. Questo parametro, che non restituisce i sottoscrittori in un determinato ordine, non limita il numero di sottoscrittori recuperabili. -
La definizione della proprietà
snippet.thumbnails.(key)
è stata aggiornata per le risorse activity, playlistItem, playlist, risultati di ricerca, miniatura e video, in modo da tenere presente che per alcuni video sono disponibili ulteriori dimensioni delle immagini in miniatura.- L'immagine
standard
è larga 640 px e alta 480 px. - L'immagine
maxres
è larga 1280 px e alta 720 px.
- L'immagine
-
La definizione del parametro
part
del metodochannelSection.list
è stata aggiornata in modo da notare che la partetargeting
può essere recuperata al costo di2
unità di quota. -
Il metodo
videos.list
ora restituisce un errore forbidden (403
) quando una richiesta non autorizzata tenta di recuperare le partifileDetails
,processingDetails
osuggestions
di una risorsavideo
. Queste parti sono disponibili solo per il proprietario del video.
17 maggio 2016
Il nuovo strumento Snippet di codice dell'API di dati fornisce brevi snippet di codice per i casi d'uso più comuni dell'API di dati di YouTube. 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 ciascun metodo, lo strumento mostra esempi di codice per uno o più casi d'uso. Ad esempio, fornisce cinque snippet di codice per il metodo search.list
:
- Elenca i video per parola chiave
- Elenca i video per località
- Elenca eventi dal vivo
- Cerca i video dell'utente autenticato
- Elenca video correlati
Per ogni caso d'uso, lo strumento mostra i parametri utilizzati nella richiesta API. Puoi modificare i valori dei parametri. In tal caso, lo strumento aggiorna gli snippet di codice per riflettere 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 perché le risposte dell'API vengano visualizzate.
28 aprile 2016
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova proprietà
contentDetails.projection
della risorsavideo
specifica il formato di proiezione del video. I valori validi della proprietà sono360
erectangular
. -
Le proprietà
recordingDetails.location
efileDetails.recordingLocation
della risorsavideo
sono state aggiornate per spiegare la differenza tra le due proprietà:- La proprietà
recordingDetails.location
identifica la località che il proprietario del video vuole associare al video. Questa 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 proprietà
-
La definizione della proprietà
contentDetails.relatedPlaylists.favorites
della risorsachannel
è stata aggiornata in modo da notare che il valore della proprietà potrebbe contenere un ID playlist che fa riferimento a una playlist vuota e che non può essere recuperato. Ciò è dovuto al fatto che la funzionalità Video preferiti è già stata ritirata. Tieni presente che questa proprietà non è soggetta alle norme sul ritiro delle API. -
La definizione dell'errore
ineligibleAccount
, che può essere restituita dal metodocomments.insert
,comments.update
,commentThreads.insert
ocommentThreads.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 metodochannels.update
è stata aggiornata in modo da rilevare che anchelocalizations
è un valore valido per questo parametro. -
La sezione relativa all'utilizzo delle quote della guida introduttiva è stata aggiornata in modo da eseguire il collegamento alla Google Developer's Console, dove puoi visualizzare la quota e l'utilizzo effettivi della tua quota.
16 marzo 2016
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
-
La documentazione delle risorse di
channelBanner
è stata aggiornata in modo da rilevare che le dimensioni consigliate per l'immagine del banner del canale caricata sono pari a 2560 x 1440 px. Le dimensioni minime (2048 x 1152 px) non sono cambiate. -
La nuova proprietà
snippet.customUrl
della risorsachannel
identifica l'URL personalizzato associato al canale. Non tutti i canali hanno URL personalizzati. Il Centro assistenza YouTube illustra i requisiti di idoneità per ottenere un URL personalizzato e come configurarlo. -
L'oggetto
brandingSettings.watch
della risorsachannel
e tutte le relative proprietà figlio sono deprecati. -
La risposta dell'API a una richiesta
search.list
ora contiene una proprietàregionCode
. La proprietà identifica il codice regione utilizzato per la query di ricerca. Il codice regione indica all'API di restituire i risultati di ricerca per il paese specificato.Il valore della proprietà è un codice paese ISO di due lettere che identifica la regione. Il metodo
i18nRegions.list
restituisce un elenco di regioni supportate. Il valore predefinito èUS
. Se viene specificata una regione non supportata, YouTube potrebbe comunque selezionare un'altra regione, anziché il valore predefinito, per gestire la query. -
Le definizioni delle proprietà
snippet.label
esnippet.secondaryReasons[].label
della risorsavideoAbuseReportReason
sono state aggiornate in modo che le proprietà contengono un testo di etichette localizzato per i motivi della segnalazione di abuso.Inoltre, il metodo
videoAbuseReportReasons.list
ora supporta il parametrohl
, che specifica la lingua da utilizzare per il testo dell'etichetta nella risposta dell'API. Il valore predefinito del parametro èen_US
. -
La nuova proprietà
contentDetails.contentRating.ecbmctRating
della risorsavideo
identifica la valutazione di un video della commissione di valutazione e classificazione della Turchia del Ministero della cultura e del turismo.Inoltre, le proprietà API per gli altri sistemi di classificazione supportano i seguenti nuovi valori di proprietà:
contentDetails.contentRating.fpbRating
(Sudafrica)
Valutazione: 10; valore proprietà:fpb10
contentDetails.contentRating.moctwRating
(Taiwan)
Valutazione: R-12; valore proprietà:moctwR12
contentDetails.contentRating.moctwRating
(Taiwan)
Valutazione: R-15; valore proprietà:moctwR15
-
La proprietà
liveStreamingDetails.activeLiveChatId
della risorsavideo
contiene l'ID della chat live attiva associata al video. Il valore della proprietà è presente solo se il video è una trasmissione dal vivo in corso per cui è attivata la chat dal vivo. Al termine della trasmissione e della chat live, la proprietà del video non sarà più restituita. -
La proprietà
status.rejectionReason
della risorsavideo
supporta il nuovo valore di proprietàlegal
.
-
-
L'API supporta i seguenti nuovi errori:
Tipo di errore Dettagli errore Descrizione badRequest (400)
notEditable
I metodi channelSections.insert
,channelSections.update
echannelSections.delete
restituiscono questo errore per indicare che non è possibile creare, aggiornare o eliminare la sezione del canale specificata.badRequest (400)
styleRequired
I metodi channelSections.insert
echannelSections.update
restituiscono questo errore per indicare che la risorsachannelSection
inviata nella richiesta API deve specificare un valore per la proprietàsnippet.style
.badRequest (400)
typeRequired
I metodi channelSections.insert
echannelSections.update
restituiscono questo errore per indicare che la risorsachannelSection
inviata nella richiesta API deve specificare un valore per la proprietàsnippet.type
.badRequest (400)
processingFailure
Il metodo commentThreads.list
restituisce questo errore per indicare che il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsacommentThread
nel corpo della richiesta per assicurarti che sia valida.forbidden (403)
commentsDisabled
Il metodo commentThreads.list
restituisce questo errore per indicare che il video identificato dal parametrovideoId
ha disattivato i commenti.badRequest (400)
commentTextTooLong
Il metodo commentThreads.insert
restituisce questo errore per indicare che la risorsacomment
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 cercando di aggiungere alla playlist è già presente in un'altra playlist della serie. Consulta il Centro assistenza YouTube per ulteriori informazioni sulle playlist delle serie.badRequest (400)
subscriptionForbidden
Il metodo subscriptions.insert
restituisce questo errore per indicare che hai raggiunto il numero massimo di abbonamenti o che hai creato troppi abbonamenti recenti. In quest'ultimo caso, puoi riprovare dopo alcune ore.badRequest (400)
invalidCategoryId
Il metodo videos.update
restituisce questo errore per indicare che la proprietàsnippet.categoryId
nella risorsavideo
caricata ha specificato un ID categoria non valido. Utilizza il metodovideoCategories.list
per recuperare le categorie supportate.badRequest (400)
invalidDescription
Il metodo videos.update
restituisce questo errore per indicare che la proprietàsnippet.description
nella risorsavideo
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 risorsavideo
caricata ha specificato un'ora di pubblicazione pianificata non valida.badRequest (400)
invalidRecordingDetails
Il metodo videos.update
restituisce questo errore per indicare che l'oggettorecordingDetails
nella risorsavideo
caricata ha specificato dettagli di registrazione non validi.badRequest (400)
invalidTags
Il metodo videos.update
restituisce questo errore per indicare che la proprietàsnippet.tags
nella risorsavideo
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 risorsavideo
caricata ha specificato un titolo del video non valido o vuoto.badRequest (400)
invalidVideoMetadata
Il metodo videos.update
restituisce questo errore per indicare che i metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la partesnippet
di una risorsavideo
, ma non imposta un valore per entrambe le proprietàsnippet.title
esnippet.categoryId
.
18 dicembre 2015
Le leggi dell'Unione Europea (UE) impongono che sia necessario fornire determinate informazioni agli utenti finali dell'UE e ottenere il consenso da questi ultimi. Pertanto, gli utenti finali dell'Unione Europea sono tenuti a rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una notifica relativa a questo requisito nei Termini di servizio dell'API di YouTube.
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
oupdate
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
esnippet.description
della risorsa. Il suo valore può corrispondere a una qualsiasi lingua dell'applicazione supportata o alla maggior parte degli altri codici lingua ISO 639-1:2002. Ad esempio, se carichi un video con titolo e descrizione in inglese, devi impostare la proprietàsnippet.defaultLanguage
suen
.Nota sull'aggiornamento delle risorse
channel
: per impostare la proprietàsnippet.defaultLanguage
per una risorsachannel
, devi aggiornare la proprietàbrandingSettings.channel.defaultLanguage
. -
Aggiungi l'oggetto
localizations
alla risorsa che stai aggiornando. Ogni chiave oggetto è una stringa che identifica un codice lingua dell'applicazione o un codice lingua ISO 639-1:2002 e ogni chiave è mappata a un oggetto che contiene il titolo (e la descrizione) localizzati della risorsa.Lo snippet di esempio riportato di seguito imposta l'inglese come lingua predefinita della risorsa. Inoltre, aggiunge a un video titoli e descrizioni localizzati in tedesco e spagnolo:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
Importante: ricorda che quando aggiorni i dati localizzati di una risorsa, la richiesta API deve includere tutte le versioni localizzate esistenti dei dati. Se ad esempio hai inviato una richiesta successiva per aggiungere dati in portoghese al video nell'esempio precedente, la richiesta dovrà includere i dati localizzati per il tedesco, lo spagnolo e il portoghese.
-
-
Recupero di valori localizzati
L'API supporta due modi per recuperare i valori localizzati per una risorsa:
-
Aggiungi il parametro
hl
alla richiestachannels.list
,channelSections.list
,playlists.list
ovideos.list
per recuperare i dati localizzati per una lingua dell'applicazione supportata dal sito web di YouTube. Se i dettagli localizzati della risorsa sono disponibili in quella lingua, l'oggettosnippet.localized
della risorsa conterrà i valori localizzati. Tuttavia, se i dettagli localizzati non sono disponibili, l'oggettosnippet.localized
conterrà i dettagli della risorsa nella lingua predefinita della risorsa.Ad esempio, supponiamo che una richiesta
videos.list
abbia recuperato dati relativi al video descritto sopra con dati localizzati in tedesco e spagnolo. Se il parametrohl
fosse impostato sude
, la risorsa conterrà i seguenti dati:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
Tuttavia, se il parametro
hl
fosse impostato sufr
, l'oggettosnippet.localized
conterrebbe il titolo e la descrizione in inglese, perché l'inglese è la lingua predefinita della risorsa e i dettagli localizzati in francese non sono disponibili.Importante:il parametrohl
supporta solo i valori che identificano le lingue di applicazione supportate dal sito web di YouTube. Per determinare se il testo localizzato è disponibile in altre lingue, devi recuperare la partelocalizations
per la risorsa e filtrare per determinare se esiste il testo localizzato.
Ad esempio, dovresti recuperare l'elenco completo delle localizzazioni per determinare se il testo localizzato è disponibile in inglese degli Appalachi.
-
Quando recuperi una risorsa, includi
localizations
nel valore parametropart
per recuperare tutti i dettagli localizzati della risorsa. Se stai recuperando dati localizzati per una lingua che non è una lingua attuale dell'applicazione YouTube, devi utilizzare questo approccio per recuperare tutte le localizzazioni, quindi applicare un filtro 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 Dettagli errore Descrizione badRequest (400)
defaultLanguageNotSetError
Questo errore indica che una richiesta che tenta di inserire o aggiornare l'oggetto localizations
per una risorsa non è andata a buon fine perché la proprietàsnippet.defaultLanguage
non è impostata per la risorsa. I metodichannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
evideos.update
supportano questo errore.badRequest (400)
localizationValidationError
Questo errore indica che la convalida di uno dei valori nell'oggetto localizations
di una risorsa non è riuscita. Ad esempio, questo errore può verificarsi se l'oggetto contiene un codice lingua non valido. I metodichannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
eplaylists.update
supportano questo errore.
4 novembre 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
-
Il parametro
order
del metodosearch.list
è stato aggiornato in modo da tenere presente che se ordini le trasmissioni live in base al criterioviewCount
, i risultati dell'API vengono ordinati in base al numero di spettatori simultanei delle trasmissioni mentre le trasmissioni sono ancora in corso. -
Il parametro
relatedToVideoId
del metodosearch.list
è stato aggiornato e ora è presente che, se impostato, gli unici altri parametri supportati sonopart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(che deve essere impostato suvideo
) efields
. Questo aggiornamento non riflette una modifica del comportamento dell'API. -
La definizione della proprietà
snippet.publishedAt
della risorsavideo
è stata aggiornata in modo da tenere presente che il valore della proprietà, che specifica la data e l'ora di pubblicazione del video, potrebbe essere diverso dall'ora in cui il video è stato caricato. Ad esempio, se un video viene caricato come privato e poi reso pubblico in un secondo momento, il valore della proprietà specifica il momento in cui il video è stato reso pubblico. La definizione aggiornata spiega anche come viene compilato il valore per i video privati e non in elenco.Questa modifica non riflette un cambiamento nel comportamento dell'API.
-
La definizione della proprietà
status.publishAt
della risorsavideo
è stata aggiornata in modo da includere la nota:- Se imposti il valore di questa proprietà quando chiami il metodo
videos.update
, devi impostare anche il valore della proprietàstatus.privacyStatus
suprivate
anche se il video è già privato. - Se la richiesta pianifica la pubblicazione di un video in un determinato momento del passato, il video verrà pubblicato immediatamente. Di conseguenza, l'impostazione della proprietà
status.publishAt
su una data e un'ora passate equivale alla modifica del valoreprivacyStatus
del video daprivate
apublic
.
- Se imposti il valore di questa proprietà quando chiami il metodo
-
La proprietà
contentDetails.contentRating.cncRating
della risorsavideo
specifica la valutazione del video secondo la Commission deClassification Cinematographique della Francia. Questa proprietà sostituisce la proprietàcontentDetails.contentRating.fmocRating
, che ora è deprecata. -
La definizione di brandingSettings.channel.keywords della risorsa
channel
è stata aggiornata in modo da 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 del comportamento dell'API. -
La documentazione relativa al metodo
thumbnails.set
è stata aggiornata in modo da riflettere con precisione il fatto che il corpo della richiesta contiene l'immagine in miniatura che stai caricando e associando a un video. Il corpo della richiesta non contiene una risorsathumbnail
. In precedenza, la documentazione indicava che non era necessario fornire un corpo della richiesta quando si chiama questo metodo. Questo aggiornamento non riflette una modifica del comportamento dell'API. -
La descrizione della risorsa
activity
è stata aggiornata in modo da riflettere il fatto che il metodoactivities.list
al momento non include risorse relative ai nuovi commenti ai video. Anchesnippet.type
econtentDetails.comment
della risorsa sono stati aggiornati.
-
-
Errori nuovi e aggiornati
-
L'API ora supporta i seguenti errori:
Dettagli errori activities.insert
Codice risposta HTTP badRequest (400)
Motivo invalidMetadata
Descrizione La proprietà kind
non corrisponde al tipo di ID fornito.commentThreads.update
comments.insert
comments.update
Codice risposta HTTP badRequest (400)
Motivo commentTextTooLong
Descrizione La risorsa comment
che viene inserita o aggiornata contiene troppi caratteri nella proprietàsnippet.topLevelComment.snippet.textOriginal
.playlistItems.insert
playlistItems.update
Codice risposta HTTP forbidden (403)
Motivo playlistItemsNotAccessible
Descrizione La richiesta non è autorizzata a inserire, aggiornare o eliminare l'elemento della playlist specificato. playlists.delete
playlists.insert
playlists.update
Codice risposta HTTP badRequest (400)
Motivo playlistForbidden
Descrizione Questa operazione è vietata o la richiesta non è autorizzata correttamente. search.list
Codice risposta HTTP badRequest (400)
Motivo invalidLocation
Descrizione Il formato del valore parametro location
e/olocationRadius
non è corretto.search.list
Codice risposta HTTP badRequest (400)
Motivo invalidRelevanceLanguage
Descrizione Il formato del valore parametro relevanceLanguage
non è corretto.subscriptions.insert
Codice risposta HTTP badRequest (400)
Motivo subscriptionForbidden
Descrizione Questo errore si verifica quando si verifica una delle seguenti condizioni: - La sottoscrizione che stai cercando di creare esiste già
- Hai già raggiunto il numero massimo di abbonamenti
- Stai tentando di iscriverti al tuo canale. L'iscrizione non è supportata.
- Hai creato troppi abbonamenti di recente e devi attendere alcune ore prima di riprovare a inviare la richiesta.
videos.update
Codice risposta HTTP badRequest (400)
Motivo invalidDefaultBroadcastPrivacySetting
Descrizione La richiesta tenta di configurare un'impostazione di privacy non valida per la trasmissione predefinita.
-
28 agosto 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
-
La proprietà
statistics.favoriteCount
della risorsavideo
è stata deprecata.In conformità con le nostre norme sul ritiro, questa proprietà continuerà a essere inclusa nelle risorse di
video
per almeno un anno dopo questo annuncio. Tuttavia, ora il valore della proprietà è sempre impostato su0
.
-
7 agosto 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
-
La definizione della proprietà
snippet.tags[]
della risorsavideo
è stata aggiornata per fornire ulteriori informazioni su come il server API calcola la lunghezza del valore della proprietà. Tieni presente che questo aggiornamento non riflette 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 verranno 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 contiene nove caratteri.
-
Il metodo
commentThreads.insert
non supporta più il parametroshareOnGooglePlus
, che in precedenza indicava se un commento e le relative risposte dovevano essere pubblicati anche nel profilo Google+ dell'autore. Se il parametro viene inviato da una richiesta, il server API ignora il parametro, ma in caso contrario gestisce la richiesta.
-
18 giugno 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Aggiornamenti a risorse e metodi esistenti
-
Il nuovo parametro
order
del metodocommentThreads.list
specifica l'ordine in cui la risposta dell'API deve elencare i thread di commenti. I thread possono essere ordinati per data o pertinenza. Per impostazione predefinita, vengono ordinati in base all'orario. -
La nuova proprietà
snippet.defaultAudioLanguage
della risorsavideo
specifica la lingua parlata nella traccia audio predefinita del video. -
La definizione della proprietà
contentDetails.licensedContent
della risorsavideo
è stata aggiornata per chiarire che i contenuti devono essere stati originariamente caricati su un canale collegato a un partner per i contenuti di YouTube e poi rivendicati da quel partner. Ciò non rappresenta una modifica del comportamento effettivo dell'API. -
I metodi
captions.delete
,captions.download
,captions.insert
,captions.list
ecaptions.update
ora supportano il parametroonBehalfOfContentOwner
, che è già supportato per molti altri metodi. Le richieste che utilizzano questo metodo devono anche essere autorizzate con un token che fornisca l'accesso all'ambitohttps://www.googleapis.com/auth/youtubepartner
.
-
-
Errori nuovi e aggiornati
-
L'API ora supporta i seguenti errori:
Dettagli errori videos.rate
Codice risposta HTTP badRequest (400)
Motivo emailNotVerified
Descrizione L'utente deve verificare il proprio indirizzo email prima di valutare il video. videos.rate
Codice risposta HTTP badRequest (400)
Motivo videoPurchaseRequired
Descrizione I video a noleggio possono essere valutati solo dagli utenti che li hanno noleggiati. -
I metodi
subscriptions.delete
esubscriptions.insert
non supportano più gli erroriaccountClosed
eaccountSuspended
.
-
27 aprile 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Nuove risorse e metodi
-
La nuova risorsa
videoAbuseReportReason
contiene informazioni sul motivo per cui un video viene segnalato per contenuti illeciti. Il metodovideoAbuseReportReasons.list
ti consente di recuperare un elenco di tutti i motivi per cui i video potrebbero essere segnalati. -
Il nuovo metodo
videos.reportAbuse
offre un modo per segnalare effettivamente un video che include contenuti illeciti. Il corpo della richiesta contiene un oggetto JSON che specifica il video segnalato e il motivo per cui il video include contenuti illeciti. Utilizzando il metodovideoAbuseReportReason.list
descritto sopra è possibile ottenere motivi validi.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 dovrebbe supportare. Queste funzionalità sono illustrate tutte nella guida alla migrazione.
-
-
Aggiornamenti a risorse e metodi esistenti
-
Il nuovo parametro di filtro
forDeveloper
del metodosearch.list
limita una ricerca al solo recupero dei video caricati tramite l'applicazione o il sito web dello sviluppatore. Il parametroforDeveloper
può essere utilizzato in combinazione con parametri di ricerca facoltativi come il parametroq
.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
sutrue
, 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 l'app o il sito web dello sviluppatore, ma non ai video caricati tramite altri siti o app.La nuova funzionalità offre funzionalità simili, anche se non identiche, alla funzionalità dei tag sviluppatore supportata dall'API v2.
-
La nuova proprietà
snippet.country
della risorsachannel
consente ai proprietari dei canali di associare i loro canali a un determinato paese.Nota: per impostare la proprietà
snippet.country
per una risorsachannel
, devi aggiornare la proprietàbrandingSettings.channel.country
. -
L'API ora supporta il targeting per le risorse
channelSection
. Il targeting per sezione del canale consente di limitare la visibilità di una sezione di contenuti agli utenti che soddisfano determinati criteri.L'API mostra tre opzioni di targeting. Un utente deve soddisfare tutte le impostazioni di targeting affinché la sezione di un canale sia visibile.
-
targeting.languages[]
: un elenco di lingue per le applicazioni di YouTube. Gli utenti che hanno scelto una di queste lingue possono visualizzare la sezione del canale corrispondente. -
targeting.regions[]
: un elenco di regioni di contenuti preferite di YouTube. La sezione del canale è visibile agli utenti che hanno selezionato una di queste regioni e agli utenti per i quali una di queste è stata selezionata automaticamente. -
targeting.countries[]
: un elenco di paesi in cui la sezione del canale è visibile. Ogni valore nell'elenco è un codice paese ISO 3166-1 alpha-2.
-
-
La definizione della proprietà
contentDetails.duration
della risorsavideo
è stata corretta in modo che il valore possa riflettere ore, giorni e così via. -
La documentazione per il metodo
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
evideos.delete
è stata corretta in modo che, se l'esito è positivo, questi metodi restituiscono tutti un codice di risposta204
HTTP (No Content
).
-
-
Errori nuovi e aggiornati
-
L'API ora supporta i seguenti errori:
Tipo di errore Dettagli errore Descrizione badRequest (400)
targetInvalidCountry
I metodi channelSections.insert
echannelSections.update
restituiscono questo errore se la risorsachannelSection
inserita conteneva un valore non valido per la proprietàtargeting.countries[]
.badRequest (400)
targetInvalidLanguage
I metodi channelSections.insert
echannelSections.update
restituiscono questo errore se la risorsachannelSection
inserita conteneva un valore non valido per la proprietàtargeting.languages[]
.badRequest (400)
targetInvalidRegion
I metodi channelSections.insert
echannelSections.update
restituiscono questo errore se la risorsachannelSection
inserita conteneva un valore non valido per la proprietàtargeting.regions[]
.badRequest (400)
operationNotSupported
Il metodo comments.insert
restituisce questo errore se l'utente dell'API non è in grado di inserire un commento in risposta al commento di primo livello identificato dalla proprietàsnippet.parentId
. In una risorsacommentThread
, la proprietàsnippet.canReply
indica se il visualizzatore corrente può rispondere al thread.badRequest (400)
invalidChannelId
Il metodo search.list
restituisce questo errore se per il parametrochannelId
nella richiesta è stato specificato un ID canale non valido.badRequest (400)
subscriptionForbidden
Il metodo subscriptions.insert
restituisce questo errore se l'utente dell'API tenta di iscriversi al proprio canale. -
Il metodo
captions.update
non supporta più gli erroriinvalidMetadata
evideoNotFound
.
-
16 aprile 2015
Questo aggiornamento contiene le seguenti modifiche:
-
La guida alla migrazione è stata aggiornata per spiegare come eseguire la migrazione di applicazioni che utilizzano ancora la funzionalità per i commenti dell'API v2.
La guida richiama anche diverse funzionalità di commento non supportate dall'API v2, ma supportate nell'API v3. Questi includono:
- Recupero dei commenti su un canale
- Il recupero di tutti i thread di commenti relativi a un canale, il che significa che la risposta dell'API può contenere commenti sul canale o sui suoi video.
- Aggiornamento del testo di un commento
- Contrassegnare un commento come spam
- Impostazione dello stato di moderazione di un commento
-
La guida all'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
ecomment
dell'API consentono di recuperare, inserire, aggiornare, eliminare e moderare i commenti.-
Una risorsa
commentThread
contiene informazioni su un thread di commenti di YouTube, composto da un commento di primo livello e delle eventuali risposte a quel commento. Una risorsacommentThread
può rappresentare commenti su un video o un canale.Il commento di primo livello e le risposte sono in realtà risorse
comment
nidificate all'interno della risorsacommentThread
. È importante notare che la risorsacommentThread
non contiene necessariamente tutte le risposte a un commento. Se vuoi recuperare tutte le risposte a un commento specifico, devi utilizzare il metodocomments.list
. 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. Usa il metodocomments.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 risorsacomment
può rappresentare un commento su un video o un canale. Può trattarsi, inoltre, di 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, puoi cancellare un commento per la pubblicazione 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
– Eliminare un commento.
Tieni presente che il nuovo ambito
https://www.googleapis.com/auth/youtube.force-ssl
dell'API, descritto nella cronologia delle revisioni del 2 aprile 2015, è obbligatorio per le chiamate ai metodicomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
ecommentThreads.update
. -
-
La nuova guida Iscrizione alle notifiche push illustra il nuovo supporto dell'API per le notifiche push tramite PubSubHubBub, un protocollo di pubblicazione/sottoscrizione server-to-server per le risorse accessibili dal web. Il tuo server di callback di PubSubHubBub può ricevere le notifiche del feed Atom quando un canale svolge 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 in modo da notare il nuovo supporto per le notifiche push. Tuttavia, poiché l'API v2 supportava numerosi altri tipi di notifiche push non supportate nell'API v3, la menzione del supporto di PubSubHubBub è ancora elencata nella sezione Deprecato della guida.
-
Il nuovo ambito
https://www.googleapis.com/auth/youtube.force-ssl
dell'API è ora un ambito valido per qualsiasi metodo API che supportava in precedenza l'ambitohttps://www.googleapis.com/auth/youtube
. -
L'API ora supporta i seguenti errori:
Tipo di errore Dettagli errore Descrizione badRequest (400)
invalidRating
Il metodo videos.rate
restituisce questo errore se la richiesta contiene un valore imprevisto per il parametrorating
. -
Il metodo
subscriptions.insert
non supporta più l'erroresubscriptionLimitExceeded
, che indicava in precedenza che l'abbonato identificato con la richiesta aveva superato il limite di tariffa dell'abbonamento.
2 aprile 2015
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova risorsa
captions
rappresenta una traccia di sottotitoli di YouTube. Una traccia di sottotitoli codificati è associata esattamente a un video di YouTube.L'API supporta metodi per elencare, inserire, aggiornare, scaricare ed eliminare le tracce dei sottotitoli.
-
Anche la guida alla migrazione è stata aggiornata per spiegare come eseguire la migrazione delle applicazioni che utilizzano ancora la funzionalità dei sottotitoli nell'API v2.
-
Il nuovo ambito
https://www.googleapis.com/auth/youtube.force-ssl
dell'API richiede che la comunicazione con il server API avvenga su una connessione SSL.Questo nuovo ambito concede lo stesso accesso dell'ambito
https://www.googleapis.com/auth/youtube
. Di fatto, questi due ambiti sono identici dal punto di vista funzionale perché il server API di YouTube è disponibile solo tramite un endpoint HTTPS. Di conseguenza, anche se l'ambitohttps://www.googleapis.com/auth/youtube
non richiede una connessione SSL, in realtà non esiste un altro modo per effettuare una richiesta API.Il nuovo ambito è obbligatorio per le chiamate a tutti i metodi della risorsa
caption
.
11 marzo 2015
Questo aggiornamento contiene le seguenti modifiche:
-
La guida alla migrazione dell'API di dati di YouTube (v3) contiene una nuova scheda, denominata Novità nell'API v3, in cui sono elencate le funzionalità supportate dall'API v3 e non supportate dall'API v2. Le stesse funzionalità erano già presenti e sono ancora elencate in altre schede della guida. Ad esempio, la nuova funzione che spiega come aggiornare i dati delle campagne promozionali in-video di un canale è elencata anche nella scheda Canali (profili).
-
La guida alla migrazione dell'API di dati di YouTube (v3) è stata aggiornata in modo da tenere presente che l'API v3 supporterà la seguente funzionalità dell'API v2:
-
La guida alla migrazione dell'API di dati di YouTube (v3) è stata aggiornata in modo da tenere presente che le seguenti funzionalità dell'API v2 non saranno supportate nell'API v3:
-
Recupero dei consigli sui video – L'API v3 non recupera un elenco contenente 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 parametrohome
sutrue
.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
econtentDetails.recommendation.seedResourceId
conterranno informazioni sul motivo per cui il video è stato consigliato. Tieni presente che non vi è alcuna garanzia che la risposta contenga un numero specifico di video consigliati. -
Recupero dei nuovi video delle iscrizioni – L'API v3 non recupera un elenco contenente solo i video che sono stati caricati di recente sui canali a cui l'utente dell'API si è iscritto. Tuttavia, puoi utilizzare l'API v3 per trovare nuovi video delle iscrizioni chiamando il metodo
activities.list
e impostando il valore del parametrohome
sutrue
.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 vi è alcuna garanzia che la risposta contenga un numero specifico di nuovi video delle iscrizioni. -
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 per gli utenti di YouTube. Le notifiche venivano inviate in caso di nuove iscrizioni ai canali e quando i video sono stati valutati, condivisi, contrassegnati come preferiti, commentati o caricati.
L'API v3 supporta le notifiche push tramite il protocollo PubSubHubbub, ma le notifiche riguarderanno solo i caricamenti e gli aggiornamenti dei titoli o delle descrizioni dei video.
-
Posizione del canale – L'API v2 ha utilizzato il tag
<yt:location>
per identificare la località dell'utente inserita nel profilo pubblico di YouTube del canale. Alcuni sviluppatori utilizzavano questo campo per associare un canale a un determinato paese, ma non è stato possibile utilizzare in modo coerente i dati del campo per questo scopo. -
Impostazione o recupero dei tag sviluppatore: l'API v2 supportava la capacità di associare parole chiave, o tag sviluppatore, a un video nel momento in cui quest'ultimo è stato caricato. I tag sviluppatore non venivano mostrati agli utenti di YouTube, ma i proprietari dei video potrebbero recuperare i video corrispondenti a un tag sviluppatore specifico.
L'API v3 fornirà una funzionalità simile, ma non identica. Nello specifico, uno sviluppatore potrà cercare i video caricati dalla sua applicazione. Per questa funzionalità, ogni video caricato viene 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 video.
-
Elencare i video per data di pubblicazione, numero di visualizzazioni o valutazione: nell'API v2, il parametro
orderby
ti consente di ordinare i video in una playlist in base a posizione, durata, data di pubblicazione, titolo e molti altri valori. Nell'API v3, gli elementi della playlist vengono generalmente ordinati in base alla posizione in ordine crescente e le altre opzioni di ordinamento non sono disponibili.Esistono alcune eccezioni. Un nuovo caricamento, un video preferito, un video che ti è piaciuto o un video guardato di recente vengono aggiunti automaticamente come primo elemento (
snippet.position
=0
) per i seguenti tipi di playlist. Pertanto, ciascuno di questi elenchi viene effettivamente ordinato dal più recente al meno recente, in base al numero di volte in cui gli elementi sono stati aggiunti all'elenco.- caricamenti dagli utenti
- video preferiti
- video piaciuti
- Cronologia visualizzazioni
Tuttavia, tieni presente che un nuovo elemento aggiunto alla playlist "Guarda più tardi" viene aggiunto come ultimo elemento dell'elenco, in modo che l'elenco venga effettivamente ordinato dal meno recente al più recente.
-
Elaborazione batch: l'API v3 supporta uno dei casi d'uso di elaborazione batch supportati dall'API v2. I metodi
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
evideos.list
dell'API v3 supportano tutti un parametroid
che può essere utilizzato per specificare un elenco delimitato da virgole di ID (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 nell'API precedente (v2) che verranno ritirate nell'attuale versione (v3).
-
4 marzo 2015
Questo aggiornamento contiene le seguenti modifiche:
-
I metodi
channelSections.delete
echannelSections.update
ora supportano il parametroonBehalfOfContentOwner
, che è già supportato per molti 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à è stata soggetta alle norme sul ritiro delle API.
-
La nuova proprietà
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
della risorsavideo
identifica i motivi che spiegano perché il video ha ricevuto la classificazione DJCQT (Brasile). -
L'API ora supporta i seguenti errori:
Tipo di errore Dettagli errore Descrizione notFound (404)
channelNotFound
Il metodo channels.update
restituisce questo errore se il parametroid
della richiesta specifica un canale non trovato.badRequest (400)
manualSortRequiredinvalidValue
I metodi playlistItems.insert
eplaylistItems.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'elementosnippet.position
dalla risorsa inviata nel corpo della richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi prima aggiornare l'impostazione di ordinamento della playlist impostandola su Manuale. È possibile regolare questa impostazione in Gestione video di YouTube.forbidden (403)
channelClosed
Il metodo playlists.list
restituisce questo errore se il parametrochannelId
della richiesta specifica un canale che è stato chiuso.forbidden (403)
channelSuspended
Il metodo playlists.list
restituisce questo errore se il parametrochannelId
della richiesta specifica un canale che è stato sospeso.forbidden (403)
playlistForbidden
Il metodo playlists.list
restituisce questo errore se il parametroid
della richiesta non supporta la richiesta o se quest'ultima non è autorizzata correttamente.notFound (404)
channelNotFound
Il metodo playlists.list
restituisce questo errore se il parametrochannelId
della richiesta specifica un canale non trovato.notFound (404)
playlistNotFound
Il metodo playlists.list
restituisce questo errore se il parametroid
della richiesta specifica una playlist non trovata.notFound (404)
videoNotFound
Il metodo videos.list
restituisce questo errore se il parametroid
della richiesta specifica un video non trovato.badRequest (400)
invalidRating
Il metodo videos.rate
restituisce questo errore se la richiesta contiene un valore imprevisto per il parametrorating
.
2 marzo 2015
Questo aggiornamento contiene le seguenti modifiche:
-
Il metodo
search.list
ora supporta il parametrorelevanceLanguage
, che ti consente di richiedere i risultati più pertinenti per una determinata lingua.Anche la guida alla migrazione dell'API di dati di YouTube (v3) è stata aggiornata per spiegare come utilizzare questo nuovo parametro. Il parametro consente di risolvere un divario di funzionalità esistente tra l'attuale versione dell'API (v3) e la versione precedente (v2), che è già stata deprecata.
-
Anche la guida alla migrazione dell'API di dati di YouTube (v3) è stata aggiornata per indicare il ritiro dei feed speciali e dei campi dei metadati forniti dall'API v2 per la descrizione di film, trailer, programmi televisivi, stagioni televisive ed episodi televisivi.
14 gennaio 2015
Questo aggiornamento contiene le seguenti modifiche:
-
La guida alla migrazione dell'API di dati di YouTube (v3) è stata aggiornata per spiegare come utilizzare l'API v3 per caricare video con JavaScript. Consulta la sezione Caricamento di un video per maggiori dettagli. Questa funzionalità è paragonabile alla funzionalità di caricamento basato su browser supportata dall'API v2. Tieni presente che questa modifica alla guida alla migrazione non riflette un cambiamento effettivo dell'API, ma piuttosto la disponibilità di un nuovo codice campione per il caricamento di video con JavaScript lato client.
Dato il supporto per il caricamento di video con la libreria client JavaScript e CORS, la guida alla migrazione non elenca più il caricamento basato su browser come funzionalità che potrebbe essere ritirata nell'API v3.
-
La documentazione per il metodo
videos.insert
è stata aggiornata in modo da includere il nuovo esempio di codice JavaScript descritto in precedenza. È stato aggiornato anche l'elenco di esempi di codice JavaScript per la YouTube Data API (v3).
11 novembre 2014
Questo aggiornamento contiene le seguenti modifiche:
-
Il costo della quota per una chiamata al metodo
search.list
è passato a 100 unità.Importante:in molti casi, puoi utilizzare altri metodi dell'API per recuperare informazioni a un costo di quota inferiore. Ad esempio, prendi in considerazione questi due modi per trovare i video caricati sul canale GoogleDevelopers.
-
Costo della quota: 100 unità
Chiama il metodo
search.list
e cercaGoogleDevelopers
. -
Costo della quota: 6 unità
Chiama il metodo
channels.list
per trovare l'ID canale corretto. Imposta il parametroforUsername
suGoogleDevelopers
e il parametropart
sucontentDetails
. Nella risposta dell'API, la proprietàcontentDetails.relatedPlaylists.uploads
specifica l'ID playlist per i video caricati sul canale.A questo punto, chiama il metodo
playlistItems.list
e imposta il parametroplaylistId
sull'ID acquisito e il parametropart
susnippet
.
-
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 devi prima attivare la funzionalità.disallowed
- Il canale non può caricare video di durata superiore a 15 minuti o non è idoneo.
Per ulteriori informazioni su questi valori, consulta la definizione della proprietà. Anche il Centro assistenza YouTube fornisce informazioni più dettagliate su questa funzionalità.
-
La proprietà
invideoPromotion.useSmartTiming
indica se la campagna promozionale del canale utilizza il "tempo intelligente". Questa funzionalità tenta di mostrare le promozioni in un punto del video in cui è più probabile che gli utenti facciano clic e meno che interrompano l'esperienza di visualizzazione. Questa funzionalità seleziona anche una singola promozione da mostrare su ciascun video.
-
-
Le definizioni delle proprietà
snippet.title
esnippet.categoryId
della risorsavideo
sono state aggiornate per chiarire il modo in cui l'API gestisce le chiamate al metodovideos.update
. Se chiami questo metodo per aggiornare la partesnippet
di una risorsavideo
, devi impostare un valore per entrambe le proprietà.Se provi ad aggiornare la parte
snippet
di una risorsavideo
e non imposti un valore per entrambe le proprietà, l'API restituisce un erroreinvalidRequest
. È stata aggiornata anche la descrizione dell'errore. -
La proprietà
contentDetails.contentRating.oflcRating
della risorsavideo
, che indica la classificazione di un video dall'Office of Film and Literature Classification della Nuova Zelanda, ora supporta due nuove classificazioni:oflcRp13
eoflcRp16
. che corrispondono rispettivamente alle valutazioniRP13
eRP16
. -
Il metodo
channelBanners.insert
ora supporta il seguente errore:Tipo di errore Dettagli errore Descrizione badRequest
bannerAlbumFull
L'album della grafica del canale YouTube del proprietario del canale contiene troppe immagini. Il proprietario del canale deve andare all'indirizzo http://photos.google.com, andare alla pagina degli album e rimuovere alcune dalle immagini dell'album.
12 settembre 2014
Questo aggiornamento contiene le seguenti modifiche:
-
Il costo della quota per una chiamata al metodo
search.list
è cambiato 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 Dettagli errore Descrizione badRequest
subscriptionLimitExceeded
L'abbonato identificato con la richiesta ha superato il limite di frequenza di abbonamento. Puoi tentare altri abbonamenti tra qualche ora.
12 agosto 2014
Questo aggiornamento contiene le seguenti modifiche:
-
Una nuova guida, intitolata Migrazione della tua applicazione all'API di dati di YouTube (v3), spiega come utilizzare la YouTube Data API (v3) per eseguire le funzionalità disponibili nella YouTube Data API (v2). L'API precedente è stata ufficialmente ritirata il 4 marzo 2014. La guida intende aiutarti a eseguire la migrazione delle applicazioni che utilizzano ancora l'API v2 alla versione più recente dell'API.
8 luglio 2014
Questo aggiornamento contiene le seguenti modifiche:
-
Il metodo
playlists.insert
ora supporta il seguente errore:Tipo di errore Dettagli errore Descrizione badRequest
maxPlaylistExceeded
Questo errore si verifica se non è possibile creare una playlist perché il canale ha già raggiunto il numero massimo di playlist consentito.
18 giugno 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La descrizione di ciascun metodo dell'API è stata aggiornata in modo da includere il costo della quota sostenuto da una chiamata a quel metodo. Analogamente, le definizioni dei parametri
part
sono state aggiornate per specificare il costo della quota di ogni parte recuperabile in una chiamata API. Ad esempio, una chiamata al metodosubscriptions.insert
ha un costo quota di circa 50 unità. La risorsasubscription
contiene anche tre parti (snippet
,contentDetails
esubscriberSnippet
) e ciascuna ha un costo di due unità.Tieni presente che i costi della quota possono cambiare senza preavviso.
-
La risorsa
video
ora supporta 43 nuovi sistemi di classificazione dei contenuti, che identificano le classificazioni ricevute dai video da varie agenzie nazionali di classificazione. I nuovi sistemi di classificazione supportati sono: Argentina, Austria, Belgio, Bulgaria, Cile (television), Cile (film), Repubblica Ceca, Colombia, Danimarca, Egitto, Estonia
28 maggio 2014
Questo aggiornamento contiene le seguenti modifiche:
-
Il metodo
search.list
ora supporta i parametrilocation
elocationRadius
, che ti consentono di cercare i video associati a una posizione geografica. Per poter recuperare i risultati in base alla posizione, una richiesta deve specificare un valore per entrambi i parametri e l'API restituirà un errore se la 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 località associata a un video può trovarsi dal centro dell'area affinché il video possa essere ancora incluso nei risultati di ricerca.
-
13 maggio 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La proprietà
invideoPromotion.items[]
della risorsachannel
è stata aggiornata in modo da notare che in genere è possibile impostare un solo articolo promosso per il canale. Se provi a inserire troppi articoli promossi, l'API restituirà un erroretooManyPromotedItems
, che ha un codice di stato HTTP400
. -
La risorsa
channelSection
ora può contenere informazioni su alcuni nuovi tipi di contenuti in primo piano. La proprietàsnippet.type
della risorsachannelSection
ora supporta i seguenti valori:postedPlaylists
: playlist che il proprietario del canale ha pubblicato nel feed attività del canalepostedVideos
: video che il proprietario del canale ha pubblicato nel feed attività del canalesubscriptions
: canali a cui il proprietario del canale è iscritto
-
La nuova proprietà
contentDetails.contentRating.ifcoRating
della risorsavideo
identifica la classificazione ricevuta da un video dall'Irish Film Classification Office. -
La definizione della proprietà
position.cornerPosition
della risorsawatermark
è stata aggiornata in modo da notare che la filigrana viene sempre visualizzata nell'angolo in alto a destra del player. -
La definizione del parametro
q
per il metodosearch.list
è stata aggiornata in modo da notare che il termine di query può utilizzare l'operatore booleano NOT (-
) per escludere i video associati a un determinato termine di ricerca. Il valore può anche utilizzare l'operatore booleano OR (|
) per trovare i video associati a uno dei vari termini di ricerca. -
La definizione della proprietà
pageInfo.totalResults
restituita in una risposta dell'API a una chiamatasearch.list
è stata aggiornata in modo da tenere presente che il valore è un'approssimazione e potrebbe non rappresentare un valore esatto. Inoltre, il valore massimo è 1.000.000. Non devi utilizzare questo valore per creare link di impaginazione. Utilizza invece i valori delle proprietànextPageToken
eprevPageToken
per determinare se mostrare i link di impaginazione. -
I metodi
watermarks.set
ewatermarks.unset
sono stati aggiornati in modo che l'API restituisca un codice di risposta204
HTTP per le richieste riuscite a questi metodi.
2 maggio 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova risorsa
i18nLanguage
identifica una lingua per l'applicazione supportata dal sito web di YouTube. La lingua dell'applicazione è detta anche lingua UI. 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 dell'IP. Un utente può anche selezionare manualmente la lingua di interfaccia utente desiderata dal piè di pagina del sito di YouTube.L'API supporta un metodo per elencare i linguaggi delle applicazioni supportati. Le lingue supportate possono essere utilizzate come valore del parametro
hl
quando si chiamano metodi API comevideoCategories.list
eguideCategories.list
. -
La nuova risorsa
i18nRegion
identifica un'area geografica che un utente di YouTube può selezionare come regione preferita per i contenuti. La regione di contenuti può essere definita anche impostazione internazionale dei contenuti. Per il sito web di YouTube, potrebbe essere selezionata automaticamente una regione di contenuti in base a euristiche quali il dominio YouTube o la posizione IP dell'utente. L'utente potrebbe anche selezionare manualmente l'area 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 comesearch.list
,videos.list
,activities.list
evideoCategories.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 primo piano. Ad esempio, una sezione potrebbe includere gli ultimi caricamenti, 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 delle sezioni del canale dell'utente autenticato specificando un ID canale specifico o un elenco di ID univoci di sezione del canale.
Anche la documentazione relativa agli errori è stata aggiornata per descrivere i messaggi di errore che l'API supporta specificamente per questi nuovi metodi.
-
La definizione dell'oggetto
fileDetails
della risorsavideo
è stata aggiornata per spiegare che l'oggetto verrà restituito solo se la proprietàprocessingDetails.fileDetailsAvailability
del video ha un valoreavailable
.Allo stesso modo, la definizione dell'oggetto
suggestions
della risorsavideo
è stata aggiornata per spiegare che l'oggetto verrà restituito solo se la proprietàprocessingDetails.tagSuggestionsAvailability
oprocessingDetails.editorSuggestionsAvailability
del video ha un valoreavailable
. -
La documentazione relativa ai metodi
videos.insert
evideos.update
è stata aggiornata per indicare che la proprietàstatus.publishAt
può essere impostata quando si chiamano questi metodi. -
La definizione dell'oggetto
invideoPromotion
della risorsachannel
è stata aggiornata per spiegare che l'oggetto può essere recuperato solo dal proprietario del canale. -
L'elenco di parametri del metodo
videos.rate
è stato aggiornato e indica che il metodo in questione non supporta effettivamente il parametroonBehalfOfContentOwner
. Si è trattato di un errore della documentazione poiché le richiestevideos.rate
che hanno impostato questo parametro restituiscono un errore500
.
31 marzo 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova proprietà
status.publishAt
della risorsavideo
ti consente di specificare la data e l'ora in cui è stata programmata la pubblicazione di un video privato. Questa proprietà può essere impostata solo se lo stato di privacy del video èprivate
e il video non è mai stato pubblicato. Questa nuova proprietà non è soggetta alle norme sul ritiro.
13 marzo 2014
Questo aggiornamento contiene le seguenti modifiche:
-
L'API ora supporta la parte
contentOwnerDetails
per le risorsechannel
. La nuova parte contiene i dati del canale che sono pertinenti per i partner di YouTube collegati al canale, tra cui l'ID del proprietario dei contenuti collegato al canale e la data e l'ora in cui il proprietario dei contenuti e il canale sono stati collegati. Tieni presente che questa nuova parte non è soggetta alle norme sul ritiro. -
La documentazione ora elenca la lunghezza massima di caratteri supportata per le seguenti proprietà:
Risorsa Proprietà Lunghezza massima channel
invideoPromotion.items[].customMessage
40 caratteri video
snippet.title
100 caratteri video
snippet.description
5000 byte video
snippet.tags
500 caratteri. Tieni presente che il valore della proprietà è un elenco e che le virgole tra gli elementi nell'elenco vengono conteggiate ai fini del limite. -
La proprietà
brandingSettings.watch.featuredPlaylistId
della risorsachannel
è stata deprecata. L'API restituirà un errore se tenti di impostarne il valore. -
Le seguenti proprietà della risorsa
video
sono state aggiunte all'elenco di valori che possono essere impostati durante l'inserimento o l'aggiornamento di un video: -
La documentazione relativa agli errori ora specifica il codice di risposta HTTP per ogni tipo di errore.
-
L'API ora supporta i seguenti errori:
Tipo di errore Dettagli 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 partebrandingSettings
di un canale e modificare il valore della proprietàbrandingSettings.channel.title
. Tieni presente che l'API non restituisce l'errore se ometti la proprietà.badRequest (400)
invalidRecentlyUploadedBy
Il metodo channels.update
restituisce questo errore se la proprietàinvideoPromotion.items[].id.recentlyUploadedBy
specifica un ID canale non valido.badRequest (400)
invalidTimingOffset
Il metodo channels.update
restituisce questo errore se la parteinvideoPromotion
specifica un offset di tempo non valido.badRequest (400)
tooManyPromotedItems
Il metodo channels.update
restituisce questo errore se la parteinvideoPromotion
specifica un numero di elementi promossi superiore a quello consentito.forbidden (403)
promotedVideoNotAllowed
Il metodo channels.update
restituisce questo errore se la proprietàinvideoPromotion.items[].id.videoId
specifica un ID video che non è possibile trovare o non può essere utilizzato come elemento promosso.forbidden (403)
websiteLinkNotAllowed
Il metodo channels.update
restituisce questo errore se la proprietàinvideoPromotion.items[].id.websiteUrl
specifica un URL non consentito.required (400)
requiredTimingType
Il metodo channels.update
restituisce questo errore se una richiesta non specifica le impostazioni di tempo predefinite relative al momento in cui YouTube deve mostrare un articolo promosso.required (400)
requiredTiming
Il metodo channels.update
deve specificare un oggettoinvideoPromotion.items[].timing
per ogni articolo promosso.required (400)
requiredWebsiteUrl
Il metodo channels.update
deve specificare una proprietàinvideoPromotion.items[].id.websiteUrl
per ogni articolo promosso.badRequest (400)
invalidPublishAt
Il metodo videos.insert
restituisce questo errore se nei metadati della richiesta è specificato un orario di pubblicazione pianificato non valido.
4 marzo 2014
Questo aggiornamento contiene le seguenti modifiche:
-
La versione 3 dell'API di dati di YouTube è ora soggetta alle norme sul ritiro descritte nei Termini di servizio delle API di YouTube. Tieni presente che la pagina che elenca le API soggette alle norme sul ritiro esclude in modo specifico alcune funzionalità dell'API v3 dall'utilizzo delle norme.
5 dicembre 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La documentazione del metodo
search.list
è stata aggiornata in modo da riflettere correttamente il fatto che non è necessario specificare un valore per un solo parametro di filtro quando si invia una richiesta di ricerca. Puoi invece 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 e tieni presente che devi impostare il valore del parametrotype
suvideo
se specifichi anche un valore per uno dei seguenti parametri:eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
Le dimensioni minime delle immagini dei banner del canale caricate sono state ridotte a 2048 x 1152 px. (In precedenza, le dimensioni minime erano pari a 2120 x 1192 px.) Inoltre, tieni presente che la documentazione delle risorse
channel
specifica le dimensioni massime di tutte le immagini banner fornite dall'API. Ad esempio, la dimensione massima dell'immaginebrandingSettings.image.bannerTvImageUrl
per le applicazioni televisive è 2120 x 1192 px, mentre l'immagine effettiva potrebbe essere 2048 x 1152 px. Il Centro assistenza YouTube fornisce ulteriori indicazioni per ottimizzare la grafica del canale per la visualizzazione su diversi tipi di dispositivi. -
Diverse definizioni di proprietà della risorsa
channel
sono state aggiornate in base alle seguenti informazioni:- Il valore della proprietà
brandingSettings.channel.description
ha una lunghezza massima di 1000 caratteri. - La proprietà
brandingSettings.channel.featuredChannelsTitle
ha una lunghezza massima di 30 caratteri. - La proprietà
brandingSettings.channel.featuredChannelsUrls[]
ora può elencare fino a 100 canali. - Il valore della proprietà
brandingSettings.channel.unsubscribedTrailer
, se impostato, deve specificare l'ID video di YouTube di un video pubblico o non in elenco di proprietà del proprietario del canale.
- Il valore della proprietà
-
Il metodo
channels.update
ora supporta gli aggiornamenti della proprietàinvideoPromotion.items[].promotedByContentOwner
. Quella proprietà indica se il nome del proprietario dei contenuti verrà mostrato al momento della 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 parametroonBehalfOfContentOwner
. -
I metodi
playlistItems.list
eplaylistItems.insert
ora supportano il parametroonBehalfOfContentOwner
, che è già supportato per molti altri metodi. -
La proprietà
contentDetails.contentRating.acbRating
ora può specificare una classificazione dall'Australian Classification Board (ACB) per i film o dall'Australian Communications and Media Authority (ACMA) per la programmazione televisiva per bambini. -
Le nuove proprietà
contentDetails.contentRating.catvRating
econtentDetails.contentRating.catvfrRating
identificano le classificazioni ricevute da un video in base al sistema di classificazione TV canadese e al sistema di classificazione Régie du cinéma in lingua francese, utilizzati rispettivamente in Québec. -
La nuova proprietà
snippet.assignable
della risorsavideoCategory
indica se è possibile associare i video aggiornati o i video appena caricati alla categoria video in questione. -
Sono stati aggiunti esempi di codice per i seguenti metodi:
activities.insert
(Vai)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Vai)search.list
(Vai)thumbnails.set
(Java)videos.insert
(Vai)
24 ottobre 2013
Questo aggiornamento contiene le seguenti modifiche:
-
L'API include due funzionalità aggiuntive progettate per aiutare a trovare e mettere in primo piano i contenuti trasmessi dal vivo:
La nuova proprietà
snippet.liveBroadcastContent
nei risultati di ricerca indica se una risorsa video o canale include contenuti trasmessi dal vivo. I valori validi della proprietà sonoupcoming
,active
enone
.-
La nuova proprietà
snippet.liveBroadcastContent
della risorsavideo
indica se il video è una trasmissione dal vivo attiva o in programma. Nell'elenco seguente sono indicati i possibili valori della proprietà:upcoming
– Il video è una trasmissione dal vivo non ancora iniziata.active
- Il video è una trasmissione dal vivo in corso.none
– Il video non è una trasmissione dal vivo in programma o attiva. Questo sarà il valore della proprietà per le trasmissioni completate che sono ancora visibili su YouTube.
-
La nuova proprietà
liveStreamingDetails
della risorsavideo
è un oggetto che contiene metadati relativi a una trasmissione video in diretta. Per recuperare questi metadati, includiliveStreamingDetails
nell'elenco delle parti della risorsa del valore del parametropart
. I metadati includono le seguenti nuove proprietà:liveStreamingDetails.actualStartTime
: l'ora in cui è iniziata la trasmissione. Questo valore sarà presente quando lo stato della trasmissione saràactive
.liveStreamingDetails.actualEndTime
: l'ora in cui la trasmissione è effettivamente terminata. (Questo valore sarà presente al termine della trasmissione).liveStreamingDetails.scheduledStartTime
: l'ora in cui è programmato l'inizio della trasmissione.liveStreamingDetails.scheduledEndTime
: l'ora di fine della trasmissione programmata. Se il valore della proprietà è vuoto o se la proprietà non è presente, la trasmissione è programmata per andare avanti a tempo indeterminato.liveStreamingDetails.concurrentViewers
– Il numero di persone che guardano la trasmissione in diretta.
Per recuperare questi metadati, includi
liveStreamingDetails
nel valore del parametropart
quando chiami il metodovideos.list
,videos.insert
ovideos.update
.
Il 1° ottobre 2013 sono state rilasciate altre due funzioni per identificare i contenuti trasmessi dal vivo: il parametro
eventType
del metodosearch.list
e la proprietàsnippet.liveBroadcastContent
del risultato di ricerca. -
-
Il metodo
videos.insert
ora supporta il parametronotifySubscribers
, che indica se YouTube deve inviare una notifica sul nuovo video agli utenti che si iscrivono al canale del video. Il valore predefinito del parametro èTrue
, che indica che gli iscritti riceveranno una notifica quando vengono caricati nuovi video. Tuttavia, il proprietario di un canale che carica molti video potrebbe preferire impostare il valore suFalse
per evitare di inviare una notifica relativa a ogni nuovo video agli iscritti del canale. -
L'elenco di proprietà che possono essere modificate durante la chiamata al metodo
channels.update
è stato aggiornato in modo da includere le proprietàinvideoPromotion.items[].customMessage
einvideoPromotion.items[].websiteUrl
. Inoltre, l'elenco è stato modificato per identificare le proprietàbrandingSettings
modificabili. Queste proprietàbrandingSettings
erano già modificabili, pertanto la modifica alla documentazione non riflette una modifica alle funzionalità esistenti dell'API. -
I metodi
playlists.insert
,playlists.update
eplaylists.delete
ora supportano il parametroonBehalfOfContentOwner
, che è già supportato per molti altri metodi. -
Il metodo
playlists.insert
ora supporta il parametroonBehalfOfContentOwnerChannel
, che è già supportato per molti altri metodi. -
La proprietà
contentDetails.contentRating.tvpgRating
della risorsavideo
ora supporta un valore dipg14
, che corrisponde a una valutazioneTV-14
. -
La definizione della proprietà
snippet.liveBroadcastContent
, che fa parte dei risultati di ricerca, è stata corretta in modo da riflettere il fatto chelive
è un valore di proprietà valido, maactive
non lo è. -
La proprietà
contentDetails.contentRating.mibacRating
della risorsavideo
ora supporta due valutazioni aggiuntive:mibacVap
(VAP) – I bambini devono essere accompagnati da un adulto.mibacVm6
(V.M.6) - Vietato ai minori di 6 anni.mibacVm12
(V.M.12) - Vietato ai minori di 12 anni.
-
La nuova proprietà
invideoPromotion.items[].promotedByContentOwner
della risorsachannel
indica se il nome del proprietario dei contenuti verrà mostrato quando viene visualizzata la promozione. Questo campo può essere impostato solo se la richiesta API che imposta il valore viene effettuata per conto del proprietario dei contenuti. Consulta il parametroonBehalfOfContentOwner
per saperne di più.
1 ottobre 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo oggetto
auditDetails
della risorsachannel
contiene i dati del canale che una rete multicanale (MCN) valuterebbe per stabilire se accettare o rifiutare un determinato canale. Tieni presente che qualsiasi richiesta API che recupera questa parte della risorsa deve fornire un token di autorizzazione contenente l'ambitohttps://www.googleapis.com/auth/youtubepartner-channel-audit
. Inoltre, qualsiasi token che utilizza questo ambito deve essere revocato quando la rete multicanale decide di accettare o rifiutare il canale o entro due settimane dalla data di emissione. -
La proprietà
invideoPromotion.items[].id.type
della risorsachannel
ora supporta un valore direcentUpload
, che indica che l'elemento promosso è il video caricato più di recente da un canale specificato.Per impostazione predefinita, il canale è uguale a quello per cui sono impostati i dati sulle promozioni in-video. Tuttavia, puoi promuovere l'ultimo video caricato da un altro canale impostando il valore della nuova proprietà
invideoPromotion.items[].id.recentlyUploadedBy
sull'ID canale del canale in questione. -
La risorsa
channel
contiene tre nuove proprietà,brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
ebrandingSettings.image.bannerTvHighImageUrl
, che specificano gli URL delle immagini banner che vengono visualizzate sulle pagine dei canali nelle applicazioni televisive. -
La nuova proprietà
snippet.liveBroadcastContent
nei risultati di ricerca indica se una risorsa video o canale include contenuti trasmessi dal vivo. I valori validi della proprietà sonoupcoming
,active
enone
.- Per una risorsa
video
, il valoreupcoming
indica che il video è una trasmissione dal vivo non ancora iniziata, mentre il valoreactive
indica che è una trasmissione dal vivo in corso. - Per una risorsa
channel
, il valoreupcoming
indica che il canale ha una trasmissione programmata non ancora iniziata, mentre il valoreacive
indica che il canale ha una trasmissione dal vivo in corso.
- Per una risorsa
-
Nella risorsa
watermark
, la proprietàtargetChannelId
è stata modificata da oggetto a stringa. Anziché contenere una proprietà secondaria che specifica l'ID canale YouTube del canale a cui rimanda l'immagine della filigrana, ora la proprietàtargetChannelId
specifica quel valore stesso. Di conseguenza, la proprietàtargetChannelId.value
della risorsa è stata rimossa. -
Il metodo
thumbnails.set
ora supporta il parametroonBehalfOfContentOwner
, che è già supportato per molti altri metodi. -
Il metodo
search.list
ora supporta il parametroeventType
, che limita la ricerca in modo da restituire solo eventi di trasmissione attivi, imminenti o completati. -
La nuova proprietà
contentDetails.contentRating.mibacRating
identifica la classificazione di un video ricevuta dal Ministero dei Beni e delle Attivita Culturali e del Turismo. -
L'API ora supporta i seguenti errori:
Tipo di errore Dettagli errore Descrizione badRequest
invalidImage
Il metodo thumbnails.set
restituisce questo errore se i contenuti dell'immagine forniti non sono validi.forbidden
videoRatingDisabled
Il metodo videos.rate
restituisce questo errore se il proprietario del video valutato ha disattivato le valutazioni.
27 agosto 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova risorsa
watermark
identifica un'immagine che viene visualizzata durante le riproduzioni dei video di un canale specifico. Puoi anche specificare un canale di destinazione a cui verrà collegata l'immagine, nonché dettagli sui tempi che determinano il momento in cui la filigrana verrà visualizzata durante le riproduzioni video e la durata della sua visibilità.Il metodo
watermarks.set
consente di caricare e impostare l'immagine della filigrana di un canale. Il metodowatermarks.unset
elimina l'immagine della filigrana di un canale.La documentazione sugli errori descrive i messaggi di errore supportati dall'API in modo specifico per i metodi
watermarks.set
ewatermarks.unset
. -
La nuova proprietà
statistics.hiddenSubscriberCount
della risorsachannel
contiene un valore booleano che indica se il numero di iscritti del canale è nascosto. Pertanto, il valore della proprietà èfalse
se il numero di iscritti del canale è visibile pubblicamente. -
Il metodo
playlists.list
ora supporta i parametrionBehalfOfContentOwner
eonBehalfOfContentOwnerChannel
. Entrambi i parametri sono già supportati per diversi altri metodi. -
Il metodo
videos.list
ora supporta il parametroregionCode
, che identifica la regione di contenuti per la quale deve essere recuperato un grafico. Questo parametro può essere utilizzato solo in combinazione con il parametrochart
. Il valore del parametro è un codice paese ISO 3166-1 alpha-2. -
L'
error documentation
descrive il nuovo errore di richiesta comune riportato di seguito, che potrebbe verificarsi per più metodi dell'API:Tipo di errore Dettagli 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 risorsachannel
ha le seguenti proprietà nuove e aggiornate:-
L'API ora supporta la possibilità di specificare un sito web come articolo in promozione. A questo scopo, imposta il valore della proprietà
invideoPromotion.items[].id.type
suwebsite
e utilizza la nuova proprietàinvideoPromotion.items[].id.websiteUrl
per specificare l'URL. Utilizza la nuova proprietàinvideoPromotion.items[].customMessage
anche per definire un messaggio personalizzato da mostrare per la promozione.I link possono indirizzare a siti web associati, siti di commercianti o siti di social network. Per saperne di più sull'attivazione dei link per i tuoi contenuti, consulta le istruzioni del Centro assistenza YouTube relative ai siti web associati e ai siti di commercianti.
Se aggiungi link promozionali, accetti che questi link non vengano utilizzati per reindirizzare il traffico a siti non autorizzati e che tali link rispettano le norme AdWords, le norme relative agli 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 in promozione durante la riproduzione video sono state ristrutturate:
-
L'oggetto
invideoPromotion.timing
è stato spostato ininvideoPromotion.items[].timing
. Questo oggetto ora ti consente di personalizzare i dati relativi ai tempi per ogni articolo in promozione nell'elencoinvideoPromotion.items[]
. -
Il nuovo oggetto
invideoPromotion.defaultTiming
specifica le impostazioni di tempo predefinite per la promozione. Queste impostazioni definiscono quando un articolo in promozione viene visualizzato durante la riproduzione di uno dei video del tuo canale. Puoi ignorare la tempistica predefinita per un determinato articolo promosso utilizzando l'oggettoinvideoPromotion.items[].timing
. -
La nuova proprietà
invideoPromotion.items[].timing.durationMs
specifica la quantità di tempo, in millisecondi, della visualizzazione della promozione. L'oggettoinvideoPromotion.defaultTiming
contiene anche un campodurationMs
che specifica la quantità predefinita di tempo di visualizzazione dell'articolo promosso.
-
-
Entrambe le proprietà
invideoPromotion.items[].type
einvideoPromotion.items[].videoId
sono state spostate nell'oggettoinvideoPromotion.items[].id
.
-
-
Il metodo
subscriptions.list
ora supporta i parametrionBehalfOfContentOwner
eonBehalfOfContentOwnerChannel
. 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 dayoutube#thumbnailListResponse
ayoutube#thumbnailSetResponse
. -
Sono stati aggiunti esempi di codice per i seguenti metodi:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
Tieni presente che è stato rimosso anche l'esempio Python per il metodo
playlistItems.insert
, poiché la funzionalità dimostrata ora è gestita dal metodovideos.rate
. -
La
error documentation
descrive il seguente nuovo errore nel contesto della richiesta, che potrebbe verificarsi per qualsiasi metodo API che supporti il parametro di richiestamine
:Tipo di errore Dettagli errore Descrizione badRequest
invalidMine
Il parametro mine
non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner di YouTube. Devi rimuovere il parametromine
, autenticarti come utente di YouTube rimuovendo il parametroonBehalfOfContentOwner
o agire come uno dei canali del partner fornendo il parametroonBehalfOfContentOwnerChannel
, se disponibile per il metodo chiamato.
8 agosto 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La sezione Utilizzo delle quote della guida Iniziare a utilizzare l'API di dati di YouTube è stata aggiornata per riflettere la modifica del costo della quota di un caricamento video da circa 16.000 unità a circa 1600 unità.
30 luglio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
In una risorsa
channelBanner
, il valore della proprietàkind
è cambiato dayoutube#channelBannerInsertResponse
ayoutube#channelBannerResource
. Questa risorsa viene restituita in risposta a una richiestachannelBanners.insert
. -
La nuova proprietà
brandingSettings.channel.profileColor
della risorsachannel
specifica un colore in evidenza che completa i contenuti del canale. Il valore della proprietà è un simbolo di cancelletto (#
) seguito da una stringa esadecimale di sei caratteri, ad esempio#2793e6
. -
L'API ora supporta la possibilità di specificare se l'iscrizione riguarda tutte le attività di un canale o solo per i nuovi caricamenti. La nuova proprietà
contentDetails.activityType
della risorsasubscription
identifica i tipi di attività per i quali l'abbonato riceverà una notifica. I valori validi della proprietà sonoall
euploads
. -
Il metodo
videos.list
supporta nuovi parametri per il recupero di un grafico dei video più popolari su YouTube:- Il parametro
chart
identifica il grafico da recuperare. Attualmente, l'unico valore supportato èmostPopular
. Tieni presente che il parametrochart
è un parametro di filtro, il che significa che non può essere utilizzato nella stessa richiesta di altri parametri di filtro (id
emyRating
). - Il parametro
videoCategoryId
identifica la categoria di video per la quale deve essere recuperato il grafico. Questo parametro può essere utilizzato solo in combinazione con il parametrochart
. Per impostazione predefinita, i grafici non sono limitati a una determinata categoria.
- Il parametro
-
La nuova proprietà
topicDetails.relevantTopicIds[]
della risorsavideo
fornisce un elenco di ID argomento di Freebase pertinenti al video o ai suoi contenuti. Gli argomenti di questi argomenti potrebbero essere menzionati nel video o apparire nel video. -
La proprietà
recordingDetails.location.elevation
della risorsavideo
è stata rinominata inrecordingDetails.location.altitude
e la relativa proprietàfileDetails.recordingLocation.location.elevation
è stata rinominatafileDetails.recordingLocation.location.altitude
. -
L'oggetto
contentDetails.contentRating
della risorsavideo
specifica le classificazioni ricevute da un video in base a diversi schemi di classificazione, incluse 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 valutato. Tieni presente che, per le classificazioni MPAA, viene spesso utilizzata la classificazione "Senza classificazione" per identificare le versioni non tagliate dei film per i quali la versione tagliata del film ha ricevuto una classificazione ufficiale. -
La nuova proprietà
contentDetails.contentRating.ytRating
della risorsavideo
identifica i contenuti soggetti a limiti di età. Il valore della proprietà saràytAgeRestricted
se YouTube ha identificato nel video contenuti non appropriati 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 metodochannels.list
è stato ritirato. Utilizza il metodosubscriptions.list
e il relativo parametromySubscribers
per recuperare un elenco degli iscritti al canale dell'utente autenticato. -
I metodi
channelBanners.insert
,channels.update
,videos.getRating
evideos.rate
ora supportano il parametroonBehalfOfContentOwner
. Questo parametro indica che l'utente autenticato agisce per conto del proprietario dei contenuti specificato nel valore parametro. -
La documentazione del metodo
channels.update
è stata aggiornata in modo da riflettere il fatto che questo metodo può essere utilizzato per aggiornare l'oggettobrandingSettings
della risorsachannel
e le relative proprietà figlio. La documentazione ora elenca anche l'elenco aggiornato delle proprietà che puoi impostare per l'oggettoinvideoPromotion
della risorsachannel
. -
Il
error documentation
descrive i seguenti nuovi errori:Tipo di errore Dettagli errore Descrizione forbidden
accountDelegationForbidden
Questo errore non è specifico per un particolare metodo dell'API. Indica che l'utente autenticato non è autorizzato ad agire per conto dell'Account Google specificato. forbidden
authenticatedUserAccountClosed
Questo errore non è specifico per un particolare metodo dell'API. Indica che l'account YouTube dell'utente autenticato è stato chiuso. Se l'utente agisce per conto di un altro Account Google, questo errore indica che l'altro account è stato chiuso. forbidden
authenticatedUserAccountSuspended
Questo errore non è specifico per un particolare metodo dell'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 per un particolare metodo dell'API. Indica che il server API non è in grado di identificare il canale associato alla richiesta API. Se la richiesta è autorizzata e utilizza il parametro onBehalfOfContentOwner
, devi impostare anche il parametroonBehalfOfContentOwnerChannel
.forbidden
cmsUserAccountNotFound
Questo errore non è specifico per un particolare metodo dell'API. L'utente CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato. notFound
contentOwnerAccountNotFound
Questo errore non è specifico per un particolare metodo dell'API. Impossibile trovare l'account del proprietario dei contenuti specificato. badRequest
invalidPart
Questo errore non è specifico per un particolare metodo dell'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 non è stato possibile trovare il video che stai tentando di aggiornare. Controlla il valore della proprietàid
nel corpo della richiesta per assicurarti che sia corretto.
10 giugno 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo parametro
forUsername
del metodochannels.list
ti consente di recuperare informazioni su un canale specificando il suo nome utente YouTube. -
Il metodo
activities.list
ora supporta il parametroregionCode
, 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 attività. -
Le risorse playlist ora contengono la proprietà
snippet.tags
. La proprietà verrà restituita solo agli utenti autorizzati che recuperano dati sulle proprie playlist. Gli utenti autorizzati possono anche impostare i tag delle playlist quando chiamano i metodiplaylists.insert
oplaylists.update
. -
Il parametro
onBehalfOfContentOwner
, che in precedenza era supportato per i metodichannels.list
esearch.list
, ora è supportato anche per i metodivideos.insert
,videos.update
evideos.delete
. Tieni presente che, quando questo parametro viene utilizzato in una chiamata al metodovideos.insert
, nella richiesta deve essere specificato anche un valore per il nuovo parametroonBehalfOfContentOwnerChannel
, che identifica il canale a cui verrà aggiunto il video. Il canale deve essere collegato al proprietario dei contenuti specificato dal parametroonBehalfOfContentOwner
.Il parametro indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube CMS che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. L'account CMS con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato.
Questo parametro è destinato ai partner della rete di contenuti che possiedono e gestiscono molti canali YouTube diversi. Il parametro consente ai partner di eseguire l'autenticazione una volta sola e ottenere l'accesso a tutti i dati relativi a video e canali, senza dover fornire credenziali di autenticazione per ogni singolo canale.
Nello specifico, per quanto riguarda questa versione, il parametro ora consente a un partner della rete di contenuti di inserire, aggiornare o eliminare video in qualsiasi canale YouTube di sua proprietà.
-
Il
error documentation
descrive i seguenti nuovi errori:Tipo di errore Dettagli errore Descrizione forbidden
insufficientCapabilities
Questo errore non è specifico per un particolare metodo dell'API. Indica che l'utente CMS che chiama l'API non dispone di autorizzazioni sufficienti per eseguire l'operazione richiesta. Questo errore è associato all'uso del parametro onBehalfOfContentOwner
, che è supportato da diversi metodi dell'API.unauthorized
authorizationRequired
Il metodo activities.list
restituisce questo errore quando la richiesta utilizza il parametrohome
ma non è autorizzata in modo adeguato. -
Nella risorsa
channels
, la proprietàinvideoPromotion.channelId
è stata rimossa perché l'ID canale è già specificato utilizzando la proprietàid
della risorsa. -
La nuova guida Utilizzo degli ID canale spiega in che modo l'API utilizza gli ID canale. La guida potrebbe 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 sul presupposto che ogni canale YouTube ha un nome utente univoco, cosa che non è più richiesta.
22 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo metodo
channelBanners.insert
consente di caricare un'immagine banner che può essere successivamente impostata come immagine banner per un canale utilizzando la nuova proprietàbrandingSettings.image.bannerExternalUrl
della risorsachannel
. -
La documentazione sul metodo
channels.update
è stata aggiornata per elencare le proprietà che possono essere modificate quando si chiama il metodo. -
La documentazione delle risorse
video
non elenca piùunspecified
come valore di proprietà valido per le proprietàsuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
esuggestions.editorSuggestions[]
. -
Il parametro
maxResults
del metodovideos.list
ora ha un valore predefinito di5
. -
L'
error documentation
ora elenca gli errori per i metodichannelBanners.insert
esubscriptions.list
. Elenca inoltre diversi nuovi errori per il metodochannels.update
.
14 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Le pagine autonome ora elencano esempi di codice per Java, .NET, PHP e Ruby.
-
La pagina che elenca gli esempi di codice Python ora include esempi per l'aggiunta di un abbonamento, la creazione di una playlist e l'aggiornamento di un video.
10 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
YouTube non identifica più funzionalità e servizi API sperimentali. Ora forniamo un elenco di API di YouTube soggette alle norme sul ritiro.
8 maggio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Le risorse del canale ora supportano l'oggetto
inVideoPromotion
, che racchiude le informazioni su una campagna promozionale associata al canale. Un canale può utilizzare una campagna promozionale in-video per visualizzare le miniature di un video sponsorizzato all'interno del video player durante le riproduzioni dei video del canale.Puoi recuperare questi dati includendo
invideoPromotion
nel valore parametropart
in una richiestachannels.list
. -
Il nuovo metodo
channels.update
può essere utilizzato per aggiornare i dati delle campagne promozionali in-video di un canale. Tieni presente che il metodo supporta solo gli aggiornamenti della parteinvideoPromotion
della risorsachannel
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 dispone di uno di questi link dispone già di un'identità pubblica su YouTube, che è un prerequisito per diverse azioni, come il caricamento di video. -
Le risorse dell'abbonamento ora supportano la parte
subscriberSnippet
. L'oggetto incapsula contiene dati snippet per il canale dell'abbonato. -
L'API ora supporta il metodo
videos.getRating
, che recupera le valutazioni assegnate dall'utente autenticato a un elenco di uno o più video. -
Il nuovo parametro
myRating
del metodovideos.list
ti consente di recuperare un elenco di video che gli utenti autenticati hanno ottenuto una valutazione pari alike
odislike
.I parametri
myRating
eid
sono ora considerati parametri di filtro, il che significa che una richiesta API deve specificare esattamente uno dei parametri. In precedenza, il parametroid
era un parametro obbligatorio per questo metodo.Il metodo restituisce un errore
forbidden
per le richieste che tentano di recuperare informazioni sulle classificazioni dei video ma non sono autorizzate a farlo. -
Con l'introduzione del parametro
myRating
, è stato aggiornato anche il metodovideos.list
in modo da supportare l'impaginazione. Tuttavia, tieni presente che i parametri di paging sono supportati solo per le richieste che utilizzano il parametromyRating
. Le informazioni e i parametri di Paging non sono supportati per le richieste che utilizzano il parametroid
.-
Il parametro
maxResults
specifica il numero massimo di video che l'API può restituire nel set di risultati, mentre il parametropageToken
identifica una pagina specifica del set di risultati che vuoi recuperare. -
La risorsa
youtube#videoListResponse
, che viene restituita in risposta a una richiestavideos.list
, ora contiene l'oggettopageInfo
, che contiene dettagli come il numero totale di risultati e il numero di risultati inclusi nell'attuale set di risultati. La risorsayoutube#videoListResponse
può includere anche le proprietànextPageToken
eprevPageToken
, ciascuna delle quali fornisce un token utilizzabile per recuperare una pagina specifica nel set di risultati.
-
-
Il metodo
videos.insert
supporta i seguenti nuovi parametri:autoLevels
- Imposta questo valore di questo parametro sutrue
per indicare a YouTube di migliorare automaticamente l'illuminazione e il colore del video.stabilize
- Imposta questo valore di parametro sutrue
per indicare a YouTube di regolare il video rimuovendo i tremori dovuti ai movimenti della videocamera.
-
La proprietà
channelTitle
è stata aggiunta asnippet
per le seguenti risorse:playlistItem
- La proprietà specifica il nome del canale che ha aggiunto l'elemento della playlist.playlist
- La proprietà specifica il nome del canale che ha creato la playlist.subscription
- La proprietà specifica il nome del canale a cui è iscritto.
-
Sono stati aggiunti esempi di codice per i seguenti metodi:
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
Il nuovo parametro
mySubscribers
del metodosubscriptions.list
ti consente di recuperare un elenco degli abbonati degli utenti attualmente autenticati. Questo parametro può essere utilizzato solo in una richiesta autorizzata correttamente.Nota: questa funzionalità intende sostituire il parametro
mySubscribers
attualmente supportato per il metodochannels.list
. Questo parametro verrà ritirato. -
In una risorsa
video
, il valore della proprietàunspecified
non è più possibile per nessuna delle seguenti proprietà: -
Le richieste API che contengono un parametro imprevisto ora restituiscono un errore
badRequest
, il cui motivo segnalato èunexpectedParameter
. -
L'errore restituito dal metodo
playlistItems.insert
quando la playlist contiene già il numero massimo di elementi consentiti è stato aggiornato. Ora l'errore viene segnalato comeforbidden
e la causa dell'errore èplaylistContainsMaximumNumberOfVideos
.
19 aprile 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Il nuovo metodo
videos.rate
consente a un utente di impostare una valutazione pari alike
odislike
o rimuovere una valutazione da un video.Anche la documentazione relativa agli errori è stata aggiornata per elencare gli errori che l'API potrebbe restituire in risposta a una chiamata al metodo
videos.rate
. -
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 per un video su YouTube e impostarla per un video.Anche la documentazione relativa agli errori è stata aggiornata per elencare gli errori che l'API potrebbe restituire in risposta a una chiamata al metodo
thumbnails.set
.Tieni presente che questa modifica non influisce sulle risorse esistenti che restituiscono immagini in miniatura. Le immagini in miniatura vengono restituite in queste risorse come in precedenza, anche se la documentazione ora elenca i nomi delle diverse dimensioni delle miniature che l'API potrebbe restituire.
-
La nuova parte
brandingSettings
della risorsachannel
identifica le impostazioni, il testo e le immagini della pagina canale e delle pagine di visualizzazione dei video del canale. -
La risorsa
playlistItem
contiene le seguenti nuove proprietà:-
Il nuovo oggetto
status
incapsula le informazioni sullo stato dell'elemento della playlist, mentre la proprietàstatus.privacyStatus
identifica lo stato di privacy dell'elemento della playlist.
-
-
La risorsa
video
contiene le seguenti nuove proprietà:-
La proprietà
status.publicStatsViewable
indica se le statistiche estese sul video sulla pagina di visualizzazione sono visibili pubblicamente. Per impostazione predefinita, queste statistiche sono visibili e statistiche come il numero di visualizzazioni e le valutazioni di un video saranno comunque visibili pubblicamente anche se il valore di questa proprietà è impostato sufalse
. Puoi impostare il valore di questa proprietà quando chiami il metodovideos.insert
ovideos.update
. -
L'oggetto
contentDetails.contentRating
racchiude le valutazioni ricevute dal video in base a vari schemi di classificazione. L'elenco che segue identifica i sistemi di classificazione supportati e fornisce un link alla proprietà associata a ciascun sistema di classificazione. Le definizioni delle proprietà identificano i valori di classificazione supportati per ogni sistema.Paese Sistema di classificazione Proprietà Stati Uniti Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
Stati Uniti TV Parental Guidelines contentDetails.contentRating.tvpgRating
Australia Australian Classification Board (ACB) contentDetails.contentRating.acbRating
Brasile Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Canada Sistema di classificazione video domestico canadese (CHVRS) contentDetails.contentRating.chvrsRating
Francia Centre national du cinéma et de l'image animée (Ministero francese della cultura) contentDetails.contentRating.fmocRating
Germania FSK (Selbstkontrolle der Filmwirtschaft) contentDetails.contentRating.fskRating
Gran Bretagna BBFC (British Board of Film Classification) contentDetails.contentRating.bbfcRating
India Certificazione del Central Board of Film (CBFC) contentDetails.contentRating.cbfcRating
Giappone 映倫管理委員전 (EIRIN) contentDetails.contentRating.eirinRating
Corea 영상물등니용용회 (KMRB) contentDetails.contentRating.kmrbRating
Messico Direzione generale della radio, della televisione e della cinematografia (RTC) contentDetails.contentRating.rtcRating
Nuova Zelanda Office of Film and Literature Classification contentDetails.contentRating.oflcRating
Russia Registro nazionale dei film della Federazione Russa contentDetails.contentRating.russiaRating
Spagna Instituto de la Cinematografía y de las Artes AudioVIs (ICAA) contentDetails.contentRating.icaaRating
-
-
La documentazione del metodo
playlistItems.update
è stata aggiornata in modo da 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 la ricerca al solo recupero dei video dell'utente autenticato. -
Il parametro
order
ora supporta la possibilità di ordinare i risultati in ordine alfabetico 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 Dettagli errore Descrizione badRequest
invalidCategoryId
La proprietà snippet.categoryId
specifica un ID categoria non valido. Utilizza il metodovideoCategories.list
per recuperare le categorie supportate.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
I metadati della richiesta specificano una classificazione del videogioco non valida. badRequest
invalidVideoMetadata
I metadati della richiesta non sono validi. -
Il parametro
onBehalfOfContentOwner
è stato rimosso dall'elenco dei parametri supportati per i metodivideos.update
evideos.delete
.
12 marzo 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La proprietà
channelTitle
è stata aggiunta asnippet
per le seguenti risorse: -
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 per recuperare solo i programmi. -
Il parametro
videoType
consente di limitare la ricerca dei video per recuperare tutti i video o solo per recuperare solo i film o solo le puntate di programmi.
-
-
La definizione della parte
recordingDetails
della risorsavideo
è stata aggiornata in modo da notare che l'oggetto verrà restituito per un video solo se sono stati impostati i dati di geolocalizzazione o la durata di registrazione del video. -
Il metodo
playlistItems.update
ora restituisce un erroreinvalidSnippet
, che viene restituito se la richiesta API non specifica uno snippet valido. -
Diversi metodi dell'API supportano nuovi parametri destinati esclusivamente ai partner per i contenuti di YouTube. I partner per i contenuti di YouTube includono studi cinematografici e televisivi, case discografiche e altri creator di contenuti che rendono i loro contenuti disponibili su YouTube.
-
Il parametro
onBehalfOfContentOwner
indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube CMS che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. L'account CMS con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato.Questo parametro è destinato ai partner della rete di contenuti che possiedono e gestiscono molti canali YouTube diversi. Il parametro consente ai partner di eseguire l'autenticazione una volta sola e ottenere l'accesso a tutti i dati relativi a video e canali, senza dover fornire credenziali di autenticazione per ogni singolo canale.
I metodi
channels.list
,search.list
,videos.delete
,videos.list
evideos.update
supportano tutti questo parametro. -
Il parametro
managedByMe
, supportato dal metodochannels.list
, indica all'API di restituire tutti i canali di proprietà del proprietario dei contenuti specificato dal parametroonBehalfOfContentOwner
. -
Il parametro
forContentOwner
, supportato dal metodosearch.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 parametroonBehalfOfContentOwner
.
-
25 febbraio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
L'API supporta diverse nuove parti e proprietà per le risorse
video
:-
Le nuove parti
fileDetails
,processingDetails
esuggestions
forniscono informazioni ai proprietari dei video in merito ai loro video caricati. Questi dati sono molto utili nelle applicazioni che consentono il caricamento di video e includono quanto segue:- stato e avanzamento dell'elaborazione
- Errori o altri problemi riscontrati durante l'elaborazione di un video
- disponibilità di immagini in miniatura
- Suggerimenti per migliorare la qualità del video o dei metadati
- dettagli relativi al file originale caricato su YouTube
Tutte queste parti possono essere recuperate solo dal proprietario del video. L'elenco seguente descrive brevemente le nuove parti e la documentazione della risorsa
video
definisce tutte le proprietà contenute in ogni parte.-
L'oggetto
fileDetails
contiene informazioni sul file video caricato su YouTube, tra cui risoluzione, durata, codec audio e video, velocità in bit dello stream e altro ancora. -
L'oggetto
processingProgress
contiene informazioni sull'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 finisca di elaborare il video. Questa parte indica inoltre se sono disponibili per il video diversi tipi di dati o contenuti, come i dettagli del file o le miniature.Questo oggetto è progettato per essere sottoposto a polling, in modo che l'utente che ha caricato il video possa monitorare l'avanzamento dell'elaborazione del file video caricato da YouTube.
-
L'oggetto
suggestions
contiene suggerimenti che identificano le 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 in alta definizione.caption
- Indica se sono disponibili sottotitoli per il video.licensedContent
– Indica se il video include contenuti che sono stati rivendicati da un partner per i contenuti di YouTube.
-
La parte
status
contiene due nuove proprietà. I proprietari dei video possono impostare 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 sonocreativeCommon
eyoutube
.
-
-
La definizione del parametro
part
è stata aggiornata per i metodivideos.list
,videos.insert
evideos.update
in modo da elencare le parti appena aggiunte descritte in precedenza e la parterecordingDetails
, che è stata inavvertitamente omessa. -
La nuova proprietà
contentDetails.googlePlusUserId
della risorsachannel
specifica l'ID profilo Google+ associato al canale. Questo valore può essere utilizzato per generare un link al profilo Google+. -
Ogni oggetto miniatura immagine ora specifica la larghezza e l'altezza dell'immagine. Al momento le immagini in miniatura vengono restituite nelle risorse
activity
,channel
,playlist
,playlistItem
,search result
,subscription
evideo
. -
playlistItems.list
ora supporta il parametrovideoId
, che può essere utilizzato insieme al parametroplaylistId
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 è presente 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 risorsachannel
è stata rimossa. La proprietàid
della risorsa fornisce lo stesso valore.
30 gennaio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
La nuova pagina error elenca gli errori che l'API può restituire. La pagina include errori generali, che potrebbero verificarsi per diversi metodi dell'API, nonché errori specifici del metodo.
16 gennaio 2013
Questo aggiornamento contiene le seguenti modifiche:
-
Ora sono disponibili esempi di codice per i metodi e i linguaggi mostrati nell'elenco che segue:
activities.insert
- JavaplaylistItems.insert
- PythonplaylistItems.list
: Java, JavaScript, PHP, Python, Rubyplaylists.insert
: Java, JavaScript, Pythonsearch.list
: Java, JavaScript, Python, Rubyvideos.insert
- Java
-
Una risorsa
activity
ora può segnalare un'azionechannelItem
, che si verifica quando YouTube aggiunge un video a un canale YouTube generato automaticamente. YouTube identifica tramite un algoritmo gli argomenti che hanno una presenza significativa sul suo sito web e genera automaticamente i canali per questi argomenti. -
I seguenti parametri
search.list
sono stati aggiornati:- Il parametro
q
non è più designato come filtro, il che significa che ... - Il parametro
relatedToVideo
è stato rinominatorelatedToVideoId
. - Il parametro
published
è stato sostituito con due nuovi parametri,publishedAfter
epublishedBefore
, descritti di seguito.
- Il parametro
-
Il metodo
search.list
supporta i seguenti nuovi parametri:Nome del parametro Valore Descrizione channelId
string
Restituisci le risorse create dal canale specificato. publishedAfter
datetime
Restituisci le risorse create dopo l'intervallo di tempo specificato. publishedBefore
datetime
Restituisci le risorse create prima dell'orario specificato. regionCode
string
Restituisci le risorse per il paese specificato. videoCategoryId
string
Filtra i risultati di ricerca dei video in modo da includere solo i video associati alla categoria video specificata. videoEmbeddable
string
Filtra i risultati di ricerca dei video in modo da includere solo quelli che possono essere riprodotti in un player incorporato in una pagina web. Imposta il valore del parametro su true
per recuperare solo i video incorporabili.videoSyndicated
string
Filtra i risultati di ricerca dei video in modo che includano solo i video che possono essere riprodotti al di fuori di YouTube.com. Imposta il valore parametro su true
per recuperare solo i video distribuiti in syndication. -
Diverse risorse dell'API supportano nuove proprietà. La tabella seguente identifica le risorse e le loro nuove proprietà:
Risorsa Nome proprietà Valore Descrizione activity
contentDetails.playlistItem.playlistItemId
string
L'ID elemento della playlist che YouTube ha assegnato per identificare in modo univoco l'elemento nella playlist. activity
contentDetails.channelItem
object
Un oggetto contenente 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 inoltre esattamente una delle numerose proprietà (videoId
,playlistId
e così via) che specifica l'ID che identifica in modo univoco quella risorsa.channel
status
object
Questo oggetto racchiude informazioni sullo stato di privacy del canale. channel
status.privacyStatus
string
Lo stato della privacy del canale. I valori validi sono private
epublic
.playlist
contentDetails
object
Questo oggetto contiene metadati relativi ai contenuti della playlist. playlist
contentDetails.itemCount
unsigned integer
Il numero di video contenuti nella playlist. playlist
player
object
Questo oggetto contiene informazioni che useresti per riprodurre la playlist in un player incorporato. playlist
player.embedHtml
string
Un tag <iframe>
che incorpora un video player che riproduce la playlist.video
recordingDetails
object
Questo oggetto racchiude informazioni che identificano o descrivono il luogo e l'ora in cui il video è stato registrato. video
recordingDetails.location
object
Questo oggetto contiene informazioni di geolocalizzazione associate al video. video
recordingDetails.location.latitude
double
Latitudine in gradi. video
recordingDetails.location.longitude
double
Longitudine in gradi. video
recordingDetails.location.elevation
double
Altitudine sopra la Terra, in metri. video
recordingDetails.locationDescription
string
Una descrizione testuale della località in cui il video è stato registrato. video
recordingDetails.recordingDate
datetime
La data e l'ora in cui il video è stato registrato. Il valore è specificato nel formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
). -
La documentazione relativa a diversi metodi dell'API ora identifica le proprietà che devono essere specificate nel corpo della richiesta o che vengono aggiornate in base ai valori nel corpo della richiesta. Nella tabella seguente sono elencati questi metodi e le proprietà obbligatorie o modificabili.
Nota:la documentazione relativa ad altri metodi potrebbe già elencare le proprietà obbligatorie e modificabili.
Metodo Proprietà activities.insert
Proprietà obbligatorie: snippet.description
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 provi a creare o aggiornare una playlist che avrebbe lo stesso titolo di una playlist già esistente nello stesso canale. -
Diversi metodi dell'API supportano nuovi tipi di errore. La tabella seguente identifica il metodo e i nuovi errori supportati:
Metodo Tipo di errore Dettagli 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 a eliminare l'elemento della playlist specificato. videoCategories.list
notFound
videoCategoryNotFound
Impossibile trovare la categoria del video identificata dal parametro id
. Utilizza il metodo videoCategories.list per recuperare un elenco di valori validi.