Nous voici dans la deuxième partie de notre tutoriel sur la mise en œuvre de l’API Google+ en PHP. Le premier opus nous a permis de récupérer votre profil Google+ afin de l’afficher par exemple sur votre site, en fournissant une démonstration de l’implémentation sur notre plateforme. En implémentant cette fonctionnalité nous avons abordé le problème d’authentification, en récupérant une clé API. Ainsi, nous laisserons cette fonctionnalité de côté dans cette deuxième partie.

Qu’allons-nous faire alors ? Si vous êtes déjà allé sur la page développeur de l’API Google+ vous avez sans doute remarqué que celle-ci nous offre un autre service nommé « Activities ». Ce dernier va nous permettre de récupérer vos différentes activités Google+ et ainsi afficher votre flux sur votre site. A titre d’exemple, j’utilise le même principe afin de récupérer mes tweets et les afficher sur le blog dans la partie « + On en parle … » un peu plus bas.

Allez entrons directement dans le vif du sujet.

Récupérer la liste de vos publications

Comme je l’expliquais ci-dessus je ne vais pas reprendre la phase d’authentification, donc une fois la clé API récupérée, nous pouvons commencer à réaliser notre service pour récupérer les publications.

« Activities »

Le service « Activities » proposé par l’API permet de récupérer le flux de publications d’un profil Google+. Chaque personne a un identifiant unique (ID). Dans mon cas et dans la suite de ce tutoriel, l’identifiant de mon profil Google+ est : 116475369142621368056.

Ce service propose trois méthodes :

• list : Liste de toutes les activités pour l’utilisateur choisi
• get : Récupérer une activité
• search : Recherche une activité publique

Note : On pourra regretter d’avoir accès à une méthode update, qui nous permettrait de partager une activité.

Structure de données JSON

Une activité est représentée dans l’API Google+, tout comme pouvait l’être le profil dans la première partie, comme une structure de données JSON, comme indiqué ci-dessous. Voici l’ensemble des champs qu’une personne peut contenir :

Note : Vous pouvez également retrouver la structure complète des propriétés ici.

Nous voilà prêts à récupérer les informations !

Appel de la méthode list

Comme annoncé précédemment trois méthodes sont possibles. Nous allons commencer par utiliser la méthode activities.list et envoyer la requête HTTP afin de récupérer notre structure JSON.

Le principe est le même que pour la méthode people.get. Nous utilisons deux méthodes PHP. La première, file_get_contents() pour lire le fichier à partir de notre URL, la seconde json_decode(), pour récupérer la chaîne reçue encodée en JSON et la convertir en une variable PHP, afin de permettre de manipuler facilement les données.

Concernant l’URL de l’appel HTTP voici comment elle doit être construite :

https://www.googleapis.com/plus/v1/people/ID/activities/TYPEACTIVITE

avec :

• ID : Identifiant de l’utilisateur pour lequel on veut obtenir les activités. Note : La valeur spécifique « me » peut être utilisée pour signifier l’utilisateur authentifié. Cela exige une authentification en utilisant un jeton qui a été accordé par OAuth
• TYPEACTIVITE : Type de partage des activités. Pour le moment la seule valeur possible est public.

Avec ces informations nous sommes prêt à récupérer nos activités :

Note : Les deux informations que vous pouvez modifier dans ce code, c’est l’identifiant du profil (ici 116475369142621368056) et la clé de votre API (ici votre VOTRECLEAPI).

En fait, le résultat affiché ci-dessus n’est pas vraiment ce que l’on reçoit lors de l’appel. Pourquoi ? Tout simplement car ce dernier a été tronqué pour l’affichage. Ainsi je vous ai copié une seule activité au lieu des dix-neufs reçues. En effet, la structure retournée par l’API est assez « couteuse ».

Maintenant nous allons voir comment extraire les différentes informations d’une activité.

Extraction des informations nécessaires

Dans la structure de chaque activité on retrouve : un acteur (code), le type d’action publiée (verb) et l’objet (object). Par défaut, le verb est post, autrement dit un contenu publié dans le flux. Les autres possibilités sont checkin pour l’enregistrement à un emplacement, et part pour le partage d’une activité.

De plus, la valeur par défaut de l’objectType d’une note, c’est-à-dire le type de l’objet est note. La seconde possibilité est activity pour indiquer qu’il s’agit d’une activité Google+. Le texte de la note est précisé dans l’attribut content et les possibles photo, vidéo ou encore l’emplacement sont spécifiés dans un tableau attachments. La propriété access spécifie avec qui l’activité est partagée.

Note : Pour le moment on peut récupérer seulement les activités de type public.

En partant de cette analyse nous sommes prêts à récupérer les informations les plus utiles. Dans notre exemple, nous allons récupérer celles-ci :

• published : Date de publication. Cet attribut produit un timestamp conforme à la norme RFC 3339. C’est le seul attribut qui nécessite une conversion en PHP. Pour cela, nous allons utiliser la fonction date(DATE_ATOM) qui produit un timestamp au format RFC 3339.

• id : L’identifiant

• url : L’URL du lien

• actor.displayName : Le nom de l’acteur qui a publié l’activité

• object.content : Le titre

• object.replies : Le nombre de commentaires

• object.plusoners : Le nombre de « +1 »

• object.resharers : Le nombre de partage

Affichage de la structure

Nous venons de récupérer toute notre structure, nous avons juste à afficher les informations. Voici un exemple d’affichage :

Note : Vous pourrez le retrouver en visualisant la démo et en téléchargeant les sources.

Appel de la méthode get

Contrairement au service « People » proposé par l’API Google+, nous disposons d’une deuxième méthode. Cette dernière nous permet de récupérer une et une seule activité à partir de son identifiant (id).

Pour l’appeler c’est très simple il suffit de construire l’URL comme suit :

https://www.googleapis.com/plus/v1/activities/ID

avec :

• ID : Identifiant de l’activité que l’on souhaite récupérer

Avec cette information nous sommes prêts à récupérer notre activité :

En cas de succès, cette méthode renvoie une ressource « activité » dans le corps de la réponse, autrement dit la même chose que précédemment. En revanche, nous n’aurons pas besoin de réaliser une boucle sur les résultats, car seule l’activité demandée sera retournée. Hum… heureusement 🙂

Au moment où j’avais terminé cet article en tant que brouillon, il n’y avait que deux méthodes : list et get. Or, Google a annoncé avant-hier de nouvelles fonctionnalités dans leur API. En outre, on peut désormais accéder aux résultats de recherche au sein des activités publiques, ainsi que de la liste des utilisateurs via les méthodes activities.search et people.search.

Donc allons-y, complétons cet article avec la méthode search du service « Activities ».

Appel de la méthode search

La dernière méthode ajoutée par Google nous permet de rechercher des activités publiques. Si l’ensemble des résultats retournés sont de trop grandes tailles, ils seront paginés. Pour obtenir les résultats de recherche les plus récents, n’utilisez pas le paramètre pageToken plus vieux que cinq minutes. Au lieu de cela, redémarrez la pagination en répétant la demande initiale, en omettant le paramètre pageToken.

Pour l’appeler c’est très simple il suffit de construire l’URL comme suit :

https://www.googleapis.com/plus/v1/activities

avec pour paramètre GET principal :

• maxResults : Le nombre maximum d’activités à inclure dans la réponse, utilisé pour la pagination
• orderBy : Spécifie la façon de retourner les résultats de recherche. Les valeurs acceptables sont : best (en fonction de la pertinence) et recent (date de publication)
• pageToken : Le token de continuation, utilisé pour les grands résultats
• query : Texte de la chaîne de recherche

En cas de succès, cette méthode renvoie un corps de réponse avec la structure suivante :

Avec ces informations nous sommes prêts à récupérer nos résultats de recherche :

Nous donnant un résultat comme ceci (volontairement tronqué) :

Cette deuxième partie s’achève ! Puisque Google a gentiment mis à jour son API, vous aurez le droit à une troisième partie, sur comment utiliser l’API pour récupérer les commentaires. De plus en plus intéressant non ?

[samples id= »6632″]

Conclusion

Ces deux tutoriels (première partie ici) nous ont permis de mettre en oeuvre rapidement et facilement l’API Google+ précédemment sortie.
Ainsi, vous avez vu comment récupérer les informations nécessaires à l’affichage de votre profil Google+ et y associer vos activités, autrement dit vos publications faites sur le service social.

Comme vous pouvez le voir, aucune connaissance particulière n’est demandée pour réaliser facilement une petite application ou un plugin. D’ailleurs, nous devrions voir très prochainement de multiples services implémentant cette API.

Seule chose que l’on peut noter et qui reste très contraignante, c’est l’absence de méthode permettant de mettre à jour son profil mais également de publier une activité dans son flux. Même si l’on devrait y avoir accès prochainement pour le moment l’utilité de l’API semble restreinte.

Je pense que l’annonce de cette API permet aux développeurs de commencer à développer pour la plateforme de développement Google+. J’espère réellement voir les caractéristiques ajoutées prochainement afin que les développeurs puissent travailler rapidement à l’élaboration d’un client Google+ !

Espérons que les googlers sauront faire évoluer l’API rapidement pour permettre de tels usages, et à de vraies applications utiles d’émerger.

Et vous, avez-vous déjà mis en œuvre cette API ? Un projet déjà lancé ? Qu’avez-vous pensé de ces deux tutoriels ? Répondent-ils à vos attentes ? Venez répondre à ces questions dans la partie commentaires…