Premiers pas

Ce guide explique comment recevoir des données du graphe social de Facebook.

Avant de commencer

Vous aurez besoin des éléments suivants :

• vous inscrire en tant que développeur·se Meta ;
• une application Meta destinée aux tests (pas besoin du code de votre application pour la créer) ;
• l’outil Explorateur de l’API Graph ouvert dans une autre fenêtre de navigation ;
• des connaissances de base sur la structure du graphe social Meta, disponibles dans notre guide Présentation de l’API Graph.

Votre première requête

Étape 1. Ouvrir l’outil Explorateur de l’API Graph

Ouvrez l’Explorateur de l’API Graph dans une nouvelle fenêtre de navigateur. Vous pourrez ainsi exécuter les différents exemples présentés dans ce tutoriel.

L’explorateur se charge avec une requête par défaut utilisant la méthode GET, la version la plus récente de l’API Graph, le nœud /me, les champs id et name dans le champ de la chaîne de requête, et votre application Facebook.

Étape 2. Générer un token d’accès

Cliquez sur le bouton Générer un token d’accès. Une fenêtre Connectez-vous avec Facebook apparaît. Il s’agit de votre application qui vous demande l’autorisation de récupérer votre nom et votre photo de profil auprès de Facebook.

Ce processus vient de notre produit Facebook Login qui permet à une personne de se connecter à une application avec ses identifiants Facebook. Avec Facebook Login, l’application peut demander à une personne l’autorisation d’accéder à ses données Facebook, et la personne peut autoriser ou refuser cet accès. Votre nom et votre photo de profil sont publics afin que d’autres personnes puissent vous trouver sur Facebook. Ainsi, l’exécution de cette requête ne nécessite aucun autre élément. Cliquez sur Continuer en tant que... Un token d’accès utilisateur est créé. Ce token contient plusieurs informations telles que l’application qui effectue la requête, la personne qui utilise l’application pour effectuer une requête, la validité du token d’accès (qui expire au bout d’une heure environ), l’heure d’expiration et les données que l’application est autorisée à demander. Dans cette requête, l’autorisation porte sur public_profile qui inclut votre nom et votre photo de profil.

Cliquez sur l’icône ronde d’information à côté du token d’accès pour afficher des informations le concernant.

Étape 3. Envoyer la requête

Cliquez sur le bouton Envoyer dans le coin supérieur droit.

Résultat attendu

Dans la Fenêtre de réponse, vous verrez une réponse JSON contenant votre identifiant utilisateur Facebook et votre nom.

Si vous supprimez ?fields=id,name dans le champ de la chaîne de requête, puis cliquez sur Envoyer, vous obtiendrez le même résultat que précédemment, car name et id sont les champs du nœud Utilisateur qui sont renvoyés par défaut.

Votre seconde requête

Étape 1. Ajoutons un champ

Nous allons créer une requête un peu plus complexe que la première, en y ajoutant le champ email. Deux options s’offrent à vous pour ajouter des champs :

• Cliquez sur le menu déroulant de recherche dans la Visionneuse de champ de nœud, à gauche de la fenêtre de réponse.
• Commencez à saisir des caractères dans le champ de la chaîne de requête.

Ajoutez le champ email, puis cliquez sur Envoyer.

Résultat attendu

L’appel n’a pas échoué, mais seuls les champs name et id ont été renvoyés, accompagnés d’un message de débug. Cliquez sur le lien (Afficher) pour débuguer la requête.

Pratiquement tous les nœuds et champs nécessitent une autorisation spécifique permettant d’y accéder. Le message de débug vous indique que vous devez autoriser l’application à accéder à l’adresse e-mail que vous avez enregistrée dans votre compte Facebook.

Étape 2. Ajouter une autorisation

Dans le panneau de droite, sous Autorisations, cliquez sur le menu déroulant Ajouter une autorisation. Cliquez sur Autorisations des données utilisateur, puis sélectionnez e-mail. Générer un nouveau token d’accès utilisateur Comme vous avez modifié la portée du token d’accès, vous devez en créer un nouveau. Cliquez sur Générer un token d’accès. Comme pour la première requête, vous devez autoriser votre application à accéder à votre e-mail dans la boîte de dialogue Facebook Login. Une fois le nouveau token créé, cliquez sur Envoyer. Cette fois, tous les champs de votre requête seront renvoyés.

Liens dans la réponse

Notez que les valeurs id renvoyées dans la fenêtre de réponse sont des liens. Ces liens peuvent représenter des nœuds comme Utilisateur, Page ou Publication. Si vous cliquez sur un lien, l’ID associé remplace le contenu du champ de la chaîne de requête. Vous pouvez alors exécuter des requêtes sur ce nœud. Sachant que ce nœud est relié au nœud parent, à savoir une publication d’un·e utilisateur·ice, vous n’aurez peut-être pas besoin d’ajouter des autorisations. Vous pouvez dès à présent cliquer sur un ID de publication, car nous allons l’utiliser dans le prochain exemple.

Remarque : certains ID sont la combinaison de l’ID parent suivi d’une autre chaîne ID. Par exemple, l’ID d’une publication d’un·e utilisateur·ice ressemblera à ceci : 1028223264288_102224043055529, où 1028223264288 est l’ID de l’utilisateur·ice.

Observation d’une arête

Le nœud Utilisateur ne comporte pas beaucoup d’arêtes pouvant renvoyer des données. L’accès à des objets utilisateur ne peut être autorisé que par l’utilisateur·ice qui possède ces objets. De manière générale, un·e utilisateur·ice est propriétaire des objets qu’il ou elle crée.

Par exemple, pour une de vos publications, vous pouvez voir diverses informations comme sa date de création, le texte, les photos et les liens partagés dans la publication, ainsi que le nombre de réactions provoquées par cette publication. Si vous commentez votre publication, vous pourrez récupérer ce commentaire, mais si une autre personne la commente, vous ne verrez pas son commentaire ni qui l’a publié.

Récupération du code de votre requête

L’explorateur est un outil qui vous permet de tester des requêtes. Une fois que vous avez obtenu la réponse souhaitée, vous pouvez récupérer le code à insérer dans le code votre application. En bas de la fenêtre de réponse, cliquez sur Obtenir le code. L’explorateur génère des codes Android, iOS, JavaScript, PHP et cURL. Le code est présélectionné. Donc, vous n’avez plus qu’à le copier et à le coller.

Nous vous recommandons d’implémenter le SDK Facebook pour votre application. Ce SDK inclut Facebook Login, ce qui permet à votre application de demander des autorisations et d’obtenir des tokens d’accès.

En savoir plus

Vous pouvez tester n’importe quelle requête (Utilisateurs, Pages, Groupes, etc.) avec l’Explorateur de l’API Graph. Consultez la référence de chaque nœud ou arête pour déterminer quel type d’autorisation et de token d’accès est requis.