Ritiro dell'API YouTube Data v2: domande frequenti

La mia applicazione si basa su commenti, sottotitoli codificati o altre funzionalità non presenti nell'API YouTube Data v3. Che cosa devo fare?

Per il momento puoi continuare a utilizzare l'API v2 per i commenti e il caricamento dei sottotitoli codificati dei video. A breve aggiungeremo questa funzionalità all'API v3. Anche se non abbiamo ancora date specifiche, rilasceremo questa funzionalità in modo che gli sviluppatori abbiano il maggior tempo possibile per eseguire la migrazione alla v3.

Per alcune altre funzionalità, man mano che YouTube continua a evolversi, non ci sarà una parità di funzionalità al 100% tra le API v2 e v3. Per ulteriori dettagli sulle funzionalità supportate nella v3, consulta la documentazione dell'API v3.

Nella versione 2, posso autenticarmi utilizzando un indirizzo email e una password tramite ClientLogin. Come faccio a eseguire la transizione a OAuth 2.0?

Consulta la nostra guida Migrazione da ClientLogin a OAuth 2.0.

In che modo la quota differisce nella v2 rispetto alla v3? Quali sono le somiglianze?

Sia la v2 sia la v3 utilizzano un sistema di quote basato sui costi in cui alcune operazioni (come i caricamenti) consumano una quantità maggiore di quota rispetto ad altre (come le ricerche).

La differenza più significativa tra i sistemi v2 e v3 è che v3 fornisce un pool di quote globale, cosa che v2 non faceva. In v2, le richieste effettuate con una singola chiave sviluppatore, ma provenienti da indirizzi IP distinti o da utenti autenticati distinti, non potevano causare errori di quota globali per quella chiave sviluppatore. Il peggio che poteva accadere era un errore di quota localizzato associato all'indirizzo IP o al canale YouTube.

Nella versione 3, esiste un pool di quote globale (di 50 milioni di unità al giorno) e tutte le chiamate API associate a un progetto specifico nella console per gli sviluppatori riducono la quota di questo pool. Pertanto, è teoricamente possibile che un singolo indirizzo IP o canale consumi tutta la quota associata a una registrazione API, il che potrebbe causare un'interruzione che influisce su altri utenti.

Tuttavia, puoi comunque proteggerti da un singolo utente che esaurisce il pool di quote globali. Questa documentazione pubblica spiega come definire e applicare limiti di frequenza più rigidi per utente.

L'API Data v2 supportava l'accesso anonimo all'API per query di sola lettura, come le ricerche di video. Perché devo registrarmi per effettuare chiamate di sola lettura nella versione 3?

L'API v3 è basata sull'infrastruttura moderna delle API di Google, in cui l'utilizzo di molte API diverse può essere collegato a una registrazione specifica della Developer Console. In questo modo, gli sviluppatori hanno una visione unificata delle tecnologie Google che utilizzano.

Per le chiamate API che accedono solo a dati disponibili pubblicamente, come le query di ricerca, i client API possono specificare una chiave API semplice quando effettuano una richiesta API. Le chiamate API che accedono ai dati privati degli utenti devono specificare i token OAuth 2.0.

Gli sviluppatori possono ottenere chiavi API semplici e le credenziali necessarie per generare token OAuth 2.0 nella console Google Developers. Gli sviluppatori possono anche provare l'API senza prima creare un progetto utilizzando Explorer API.

Posso continuare a utilizzare le stesse librerie client che ho utilizzato con la versione 2 dopo la migrazione alla versione 3?

L'API v3 è fondamentalmente diversa dalla v2 ed è disponibile un nuovo insieme di librerie client da utilizzare. Sono tutte disponibili all'indirizzo https://developers.google.com/youtube/v3/libraries e supportano l'autorizzazione OAuth 2.

In precedenza utilizzavo l'API YouTube Insight, che fa parte della versione 2. Qual è la mia alternativa?

Consigliamo a tutti gli sviluppatori di eseguire la migrazione dall'API YouTube Insight, ritirata separatamente a settembre 2013, alla nuova API YouTube Analytics.

Mi affido all'utilizzo dell'API GData (v1 o v2) per i feed RSS/Atom dei video di YouTube. Esiste un'alternativa una volta che non saranno più supportati?

Al momento non esiste un'alternativa diretta. Consigliamo di offrire agli utenti della tua applicazione la possibilità di gestire e recuperare i propri abbonamenti a YouTube utilizzando i metodi del servizio subscriptions dell'API YouTube Data v3.

Poiché utilizzo ancora alcune funzionalità della versione 2 che non sono ancora disponibili nella versione 3, devo accedere a entrambe le versioni dell'API nella stessa applicazione. Quali sono alcune best practice?

Puoi utilizzare il supporto OAuth 2.0 nelle librerie client v3 per ottenere token di autorizzazione che funzioneranno per le operazioni di scrittura sia nella v2 che nella v3. Qualsiasi token con ambito https://gdata.youtube.com o https://www.googleapis.com/auth/youtube funzionerà per entrambe le API.

Per le chiamate API che non richiedono token OAuth 2.0, ottieni una chiave API v3 da https://cloud.google.com/console e utilizzala sia per la v2 che per la v3.

Ti consigliamo di eseguire la migrazione della tua app per utilizzare l'API v3, se possibile, anche se devi ancora chiamare l'API v2 per alcune funzionalità. In questo modo, la tua app potrà utilizzare le funzionalità più solide offerte dalla versione 3. Inoltre, semplificherai i tuoi futuri sforzi di migrazione quando verranno rilasciate le funzionalità solo della versione 2 che verranno supportate nella versione 3.