Premiers pas

Ce document explique comment appeler l’API Pages pour publier des contenus sur votre Page.

Avant de commencer

Vous aurez besoin des éléments suivants :

• Une Page Facebook ; il peut s’agir d’une Page publiée ou non publiée sur laquelle vous pouvez effectuer la tâche CREATE_CONTENT.
• Un token d’accès de Page pour la Page.
• Les autorisations suivantes :

  • pages_manage_metadata
  • pages_manage_posts
  • pages_manage_read_engagement
  • pages_show_list

Recommandations

Étape 1. Obtenir l’ID de votre Page

Pour obtenir la liste des ID et des tokens d’accès de Page des Pages Facebook sur lesquelles vous pouvez effectuer une tâche, envoyez une requête GET au point de terminaison /user_id/accounts, où user_id est votre identifiant utilisateur·ice.

Exemple de requête

curl -i -X GET "https://graph.facebook.com/v21.0/user_id/accounts?access_token=user_access_token"

Si la requête aboutit, votre application reçoit la réponse JSON suivante qui contient un tableau d’objets. Chaque objet contient des informations sur une Page spécifique, notamment le nom, l’ID, un token d’accès de Page de courte durée, les tâches que vous pouvez effectuer sur la Page, etc. :

{
  "data": [
    {
      "access_token": "page_access_token",
      "category": "Internet Company",
      "category_list": [
        {
          "id": "2256",
          "name": "Internet Company"
        }
      ],
      "name": "Name of this Page",
      "id": "page_id",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT"
      ]
    },
...

Étape 2. Ajouter une publication

Pour ajouter une publication, envoyez une requête POST au point de terminaison /page_id/feed, où page_id est l’ID de la Page sur laquelle vous ajoutez la publication : définissez le paramètre message sur le contenu du message et le paramètre access_token sur le token d’accès de Page :

Exemple de requête

curl -X POST "https://graph.facebook.com/v21.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "access_token":"page_access_token",
         }'

Votre publication sera immédiatement ajoutée.

Si la requête aboutit, votre application reçoit la réponse JSON suivante avec l’ID de la publication :

{
  "id": "page_post_id" 
}

Consultez votre Page Facebook pour voir la publication.

Étape 3. Vérifier votre publication

Pour vérifier que la publication a été ajoutée à votre Page, envoyez une requête GET au point de terminaison /page_id/feed :

Exemple de requête

      curl -i -X GET "https://graph.facebook.com/v21.0/page_id/feed?access_token=page_access_token"

Si la requête aboutit, votre application reçoit la réponse JSON suivante avec un tableau d’objets. Chaque objet comprend l’ID de publication, le contenu du message et l’heure de création de la publication :

{
  "data": [
    {
      "created_time": "2020-03-25T17:33:34+0000",
      "message": "Hello World!",
      "id": "422575694827569_917077345377399"  
    },
...
  ]
}

Utiliser Graph Explorer

L’outil Graph Explorer est une interface d’utilisation qui vous permet d’utiliser les API Facebook sans ajouter de code à votre application ou site Web. Vous pouvez sélectionner les autorisations, obtenir des tokens d’accès, tester les méthodes GET, POST et DELETE, et obtenir des extraits de code de ces requêtes pour Android, iOS, JavaScript, PHP et cURL.

Toutefois, vous devez fournir un ID d’application Facebook pour utiliser Graph Explorer.

Étape 1. Obtenir l’ID de votre page

Sélectionnez les autorisations pages_manage_metadata, pages_manage_posts, pages_manage_read_engagement et pages_show_list, si elles sont disponibles dans le menu déroulant Autorisations, configurez la requête GET avec le point de terminaison /me/accounts dans la fenêtre de la requête, puis cliquez sur Envoyer.

Cliquez sur l’ID de votre Page, affiché juste en dessous de son nom, pour déplacer l’ID dans la fenêtre de la requête.

Étape 2. Publier des contenus à partir de la Page

Dans le menu Utilisateur ou Page, sélectionnez le token d’accès de votre Page. Ensuite, choisissez la méthode POST pour envoyer une requête au point de terminaison /{page-id}/feed. Enfin, sous Params, sélectionnez l’option message pour le paramètre key et saisissez le texte de votre publication dans value. Cliquez sur Soumettre.

Si la requête aboutit, Graph Explorer affiche l’ID de la publication de Page.

Consultez votre Page Facebook pour voir la publication.

Étape 3. vérifier votre publication

Envoyez une requête GET au point de terminaison /page-id/feed.

Si la requête aboutit, Graph Explorer affiche l’heure de création, le contenu et l’ID de Page de la publication.

Prochaines étapes

Découvrez comment obtenir des informations sur votre Page Facebook et comment les mettre à jour, notamment les détails de Page, les tokens d’accès, les utilisateur·ices bloqué·es et les recommandations utilisateur·ice, à l’aide du guide Gérer votre Page Facebook.

Apprenez à publier des liens, des photos, et des vidéos sur votre Page.

Voir aussi