Thursday, September 15, 2011

Getting Started on the Google+ API

E ora sarà dura battaglia a facebook!
Google apre le sue prime API per utilizzare la piattaforma Google+.
E' cosa dell'ultimissima ora, mi è appena arrivata comunicazione proprio da G!

Due i punti di partenza.
Un post su http://googleplusplatform.blogspot.com/, con descrizione delle prime (ridotte) funzionalità.
E il nuovo sito per gli sviluppatori per Google+ Platform: https://developers.google.com/+/

Ma veniamo a cosa possiamo fare, per adesso, con queste prime API.
Traduco, più o meno liberamente, alcuni passi base dal post ufficiale.

Let ' S Go Public!

Questo rilascio iniziale di API è focalizzato solo sui dati pubblici: consente di leggere le informazioni che le persone hanno condiviso pubblicamente su Google +.
Ad esempio, se si desidera ottenere le informazioni del mio profilo, è possibile utilizzare il metodo people.get inviando una richiesta HTTP, con l'id del mio utente:

GET https://www.googleapis.com/plus/v1/people/100661704413873131754?key=yourAPIKey

La riposta è un output JSON:

{
 "kind": "plus#person",
 "id": "100661704413873131754",
 "displayName": "Giorgio Guerrieri",
 "tagline": "Chi cerca trova",
 "gender": "male",
 "aboutMe": "",
 "url": "https://plus.google.com/100661704413873131754",
 "image": {
  "url": "https://lh6.googleusercontent.com/-Nx4ziEjmuQM/AAAAAAAAAAI/AAAAAAAAAAA/FVoLqNofkR8/photo.jpg"
 },
 "urls": [
  {
   "value": "http://giorgioguerrieri.blogspot.com"
  },
  {
   "value": "http://www.flickr.com/photos/gguerrieri/"
  },
  {
   "value": "http://www.facebook.com/giorgioguerrieri1977"
  },
  {
   "value": "http://twitter.com/ggorgos"
  },
  {
   "value": "http://www.flickr.com/people/gguerrieri/"
  },
  {
   "value": "https://plus.google.com/100661704413873131754",
   "type": "profile"
  },
  {
   "value": "https://www.googleapis.com/plus/v1/people/100661704413873131754",
   "type": "json"
  }
 ],
 "organizations": [
  {
   "name": "Liceo Scientifico Leonardo Da Vinci, Genova",
   "type": "school"
  },
  {
   "name": "CAP spa",
   "title": "Developer",
   "type": "work"
  }
 ],
 "placesLived": [
  {
   "value": "Genova",
   "primary": true
  }
 ]
}

Analogamente, è possibile ottenere un elenco dei post più recenti (immessi con visibilità Pubblica), utilizzando il metodo activities.list

GET https://www.googleapis.com/plus/v1/people/100661704413873131754/activities/public?key=yourAPIKey

Facile facile. Così sembra.

Ad ogni modo, non è molto diverso da quello che siamo abituati a fare con Google Maps, per esempio.
E, allo stesso modo, serve un API Key, che si può generare da questo sito https://code.google.com/apis/console/.

Interessante, infine, la sezione Download del sito https://developers.google.com/+/downloads che mette a disposizione progetti demo e sopratutto librerie per molti linguaggi comunemente utilizzati per il web.
(Manco a dirlo, la versione .NET è in beta, eh eh)

Beh, resisto alla tentazione di buttarmi su queste API e vado a nanna che è meglio!