Informations de base
Il est intéressant de récupérer ces informations dans le but de créer une application.
Pour bien comprendre la démarche, il faut savoir qu'il existe deux manières d'avoir accès aux conversations d'un groupe Facebook : à travers une application qu'il faut créer et programmer (il faut alors passer par de nombreuses étapes : création de l'app, autorisation de l'app, etc...)
soit à travers l'outil Graph API Explorer.
L'outil Graph API Explorer est déjà une application Facebook, il n'est donc pas nécessaire d'en créer une et elle permet d'interroger simplement l'API Facebook Open Graph.
A savoir : pour récolter les conversations d'un groupe Facebook il est nécessaire d'être membre de ce groupe.
Comment fonctionne l'outil Graph API Explorer
Explication rapide :
Toutes les données sur Facebook sont organisées sous forme de graphe.
Un utilisateur (vous par exemple), votre page, votre mur, les publications de la page, un commentaire de post, une photo, un groupe Facebook, tout est représenté par un "nœud" dans graphe.
Un graphe c'est un peu comme un arbre :
Sauf que tous les nœuds peuvent être interconnectés :
Comment accéder à ses propres données sur Facebook
Pour que les développeurs puissent créer des applications qui interagissent en profondeur avec ce réseau social, Facebook donne accès à son graphe à travers l'url : https://graph.facebook.com/
A partir de cette url, une application peut interroger n'importe quelle donnée, la modifier, la supprimer ou valider une action (par exemple placer un "J'aime"). Attention : L'application n'a accès qu'aux informations qui lui sont autorisées.
Petit exemple :
Pour voir les données de la page Gralon sur Facebook, il suffit d'interroger l'url : https://graph.facebook.com/gralon
L'url nous renvoie les informations concernant la page Gralon au format JSON on y retrouve notamment son ID :
"id": "102820093106689",
L'ID est très important car sur Facebook Open Graph on accède à une donnée grâce à son ID.
Pour pouvoir accéder à une page grace à son alias, ici Gralon, il faut que la page Fan ait atteint un certain nombre de fans, sinon l'alias ne sera pas reconnu et il faudra utiliser l'id pour la retrouver dans Open Graph.
Astuce : Si vous ne connaissez pas l'id de votre ressource (page, groupe etc..) vous pouvez le trouver dans le code source de la page, par exemple pour la page gralon il suffit de chercher la chaine : "type":"ent:page","uid": dans le code source pour tomber sur l'id : 102820093106689.
Pour avoir les informations de la page Gralon on aurait dû entrer l'url :
https://graph.facebook.com/102820093106689/
Maintenant si on veut voir les publications de la page Gralon il faut compléter l'url avec le mot clé feed :
https://graph.facebook.com/gralon/feed
On obtient alors la réponse suivante : "An access token is required to request this resource."
Cela signifie que nous n'avons pas le droit d’accéder à ces informations. Explications : nous avions précédemment accès aux informations de la page car celles-ci sont publiques ; par contre les posts sont privés, il faut être abonné à cette page pour pouvoir les consulter, Facebook nous demande alors de lui prouver qu'on a le droit d'accéder à cette ressource, cette autorisation est sous la forme d'un TOKEN.
Le token Facebook
Pour accéder à une donnée privée sur Facebook, il faut que Facebook sache qui la demande : on doit être authentifié et il faut que le propriétaire de cette donnée nous ait donné l'autorisation d'y accéder.
Souvenez-vous quand vous avez ajouté une application ou un jeu à votre mur Facebook, avant d'accepter s'affiche la liste des autorisations demandées par l'application (par exemple : lire votre mur, écrire sur votre mur, voir la liste de vos amis etc...). Une fois que vous avez accepté, l'application se connecte à Facebook avec ses identifiants et sa clé secrète ensuite Facebook lui transmet un jeton. Ce jeton est un long code à rajouter lorsque l'on fait une demande sur https://graph.facebook.com/ , avec ce jeton Facebook sait identifier l'application qui exécute la requête et peut vérifier si celle-ci a effectivement droit d’accéder aux données demandées.
En anglais un jeton se dit Token
Du coup pour accéder aux posts de la page Facebook de Gralon il faudra completer sur l'url avec l'access_token :
https://graph.facebook.com/gralon/feed access_token=Mon_Jeton_d'autorisation
Récupérer toutes les publications d'un groupe Facebook grâce à Graph API Explorer
Facebook met à disposition des développeurs un outil pour faire des tests :
https://developers.facebook.com/tools/explorer
Il faut se connecter avec son identifiant Facebook pour s'y rendre.
Cet outil permet de tester les requêtes sur le graphe (c'est à dire les urls du type https://graph.facebook.com/gralon/feed access_token=Mon_Jeton_d'autorisation)
Il permet aussi de créer un Token facilement.
(1) En haut de la page on peut voir "Access Token" (ou jeton d’accès). Il y a déjà un Token par défaut. Mais il y a la possibilité d'en demander un autre. Le Token par défaut est produit à partir de vos identifiants (rappelez-vous, vous les avez entrés pour accéder à cet outil) il a des droits basiques, c'est-à-dire qu'il donne accès uniquement aux données de l'utilisateur.
(2) En dessous il y a une barre d'url où l'on peut choisir GET (obtenir une info), POST (créer, modifier une info, effectuer une action) ou DELETE (effacer une info). On fait de la consultation on restera donc sur GET.
Dans le champ de droite on va pouvoir mettre notre url de requête graphe.
(3) Le résultat de la requête au format JSON
Notation des commandes :
xxxxxx <---- ce qu'il faudra copier dans le champ texte à droite de GET (2)
-> xxxx <---- le résultat (3)
1ère étape :
me
-> C'est une des requêtes les plus simples elle permet d'avoir ses propres informations, vous êtes évidemment autorisé à les consulter.
2ème étape :
me/groups
-> le résultat obtenu en (3) c'est la liste des groupes Facebook auxquels (me) je suis inscris avec leurs IDs respectifs (justement nous aurons besoin de l'ID du groupe Facebook que nous allons interroger).
Je choisis l'ID du groupe Facebook qui m'intéresse par exemple : 128078847281123 (celui-ci est faux).
3ème étape :
128078847281123
-> je vois toutes les infos du groupe
4ème étape :
128078847281123/feed
-> je ne vois rien :( c'est vide... En fait c'est juste que mon jeton ne me permet pas d'accéder aux posts/conversations du group. Rappelez vous, le jeton par défaut n'a accès qu'à mes données. Il faut que je demande un nouveau Token, je clique sur "Get Acess Token".
Dans l'onglet "User data permission" je coche "user_groups" et je valide avec "Get Acess Token" pour rajouter ses droits.
Cela devrait m'ouvrir une fenêtre avec ma Photo de profil et le nom de l'app Explorer, on valide et c'est bon (quand on valide on cree un token avec les droits user_groups et user_friends valable 1H)
Maintenant réessayons :
4ème étape bis :
128078847281594/feed
-> on doit voir les derniers posts
et on peut d'ailleurs y accéder directement avec l'url :
https://graph.facebook.com/128078847281594/feed access_token=Mon_Jeton_d'Acces (1)
On remplace juste "Mon_Jeton_d'Acces" par le long code qui se situe en haut de la page Explorer.
Il n'y a que les dernières publications mais on peut demander à en avoir plus en utilisant la variable "limit" :
Exemple : pour avoir les 50 plus récents :128078847281594/feed limit=50
Il y a aussi un systeme de pagination qui permet de demander les 50 suivants à partir de l'id du dernier post que l'ont voit
Il y a bien d'autres fonctions, je vous invite à rechercher dans la documentation en ligne de Facebook Open Graph.
Astuce : Si vous partagez l'url contenant le token à quelqu'un, il pourra accéder à la ressource en question le temps de vie du token : 1h max.
On peut à tout moment invalider le token en cliquant sur la croix de suppression à droite du token (1) sur la page explorer.
Si le jeton est invalide l'url n'accédera plus aux données demandées.
Que faire des résultats trouvés par l'outil Graph API Explorer
Pour les débrouillards, vous pourrez vous amuser à rendre la lecture des informations récoltées beaucoup plus attrayante en créant une application qui décodera le format JSON de manière élégante !
Une video d'exemple :
Un lien vers un tutoriel pour transformer les données Json en HTML5 + Css :
http://tutorialzine.com/2011/03/custom-facebook-wall-jquery-graph/
Graph Api Explorer permet de tester les requêtes à l'api open graph de Facebook, si vous voulez réellement utiliser l'API Open Graph pour récupérer des informations ou poster de manière automatique, il est recommandé de fabriquer votre propre application Facebook.
