Java  »  Articoli  »  Java API 

YouTube ci permette da sempre di includere i video sulle nostre pagine, ma le API di YouTube espandono il concetto di embedding dei contenuti e ci permettono di accedere e di riutilizzare le informazioni disponibili sul social network.

Grazie a questa libreria è possibile, ad esempio, accedere al profilo di un utente e visualizzare l'elenco dei suoi video preferiti, ricercare un video, commentarlo, votarlo oppure addirittura caricarne uno nuovo.

Troviamo le Data API su Google Code, disponibili per diverse piattaforme: Java, .NET, PHP e Python. Naturalmente in questo articolo esaminiamo le tecniche principali per Java, utilizzando alcuni snippet di codice.

Prima di utilizzare le API, dobbiamo richiedere un account Google, se non ne abbiamo già uno. Grazie al nostro account possiamo ottenere una developer key. Una volta inserito un nome (name) e un indirizzo internet di riferimento (website) sarà generata la chiave che useremo per comunicare con il servizio, come vedremo negli esempi.

Finalmente possiamo a scaricare l'ultima versione della libreria (attualmente la 1.40.3), comprensiva di documentazione ed esempi d'uso.

Adesso abbiamo tutto il necessario, iniziamo con qualche esempio pratico, preso dalla sezione Getting Started di Google Code. Per accedere alle informazioni, ci si può servire dei canali di servizio, detti FEED. Alcuni di questi feed sono protetti e richiedono l'autenticazione al servizio.

L'Autenticazione

Per la connessione al servizio è necessario creare un'istanza della classe com.google.gdata.client.youtube.YouTubeService. Il costruttore di tale classe riceve in ingresso le nostre credenziali di sviluppatori: il CLIENT_ID ed il DEVELOPER_KEY.

YouTubeService service = new YouTubeService(CLIENT_ID, DEVELOPER_KEY);

Nota: il CLIENT_ID corrisponde all'identificativo (name) che abbiamo utilizzato per generare la chiave.

Per effettuare l'autenticazione è necessario impostare il nome utente (o l'indirizzo e-mail) e la password. Per avviare l'autenticazione occorre invocare il metodo setUserCredentials(username, password). Questo metodo potrebbe sollevare l'eccezione GoogleService$InvalidCredentialsException, qualora le credenziali di accesso non fossero corrette.

try 
{
  service.setUserCredentials(USERNAME, PASSWORD);
}
catch (AuthenticationException e) 
{
  System.out.println("Impossibile eseguire l'autenticazione al sistema. Le credenziali non sono valide");
  e.printStackTrace();
}

Accedere al profilo di un utente

Per ad un profilo utente, abbiamo a disposizione il feed users.

http://gdata.youtube.com/feeds/api/users/username

L'ultima parte dell'URL, username, va sostituito con il nome dell'utente del quale si vuole richiedere il profilo. Sostituendo l'username con la parola default, si accede al profilo dell'utente autenticato.

Altri articoli

Altre guide

Altre newsletter