Fil de Page

Utilisez ce point de terminaison pour accéder à une Page et publier sur cette Page. Le Fil de Page regroupe toutes les interactions avec la Page Facebook : publications et liens publiés par cette Page, personnes ayant visité la Page et publications publiques dans lesquelles la Page a été identifiée.

Voir aussi

• Le point de terminaison /{page-post-id} vous permet de mettre à jour une publication de Page donnée.
• Le point de terminaison /{page-id}/taggedaffiche uniquement les publications publiques dans lesquelles la Page a été identifiée.

Lecture

Les publications d'une Page Facebook.

Nouvelle expérience de Page

Cette API est compatible avec la nouvelle version des Pages.

Conditions requises

La personne qui demande le token d’accès doit être en mesure d’effectuer l’une des tâches suivantes sur la Page :

• CREATE_CONTENT : publier du contenu sur la Page au nom de la Page
• MANAGE : affecter et gérer les tâches de la Page
• MODERATE

  • Répondre à des commentaires sur les publications de Page au nom de la Page
  • Supprimer des commentaires sur les publications de Page
  • Lorsqu’un compte Instagram est connecté à la Page, publier du contenu sur Instagram depuis Facebook, répondre à des commentaires et en supprimer, envoyer des messages directs, synchroniser les coordonnées de l’entreprise et créer des publicités.

Cette personne doit également avoir accordé les autorisations suivantes à l’application :

• L’autorisation pages_read_engagement
• L’autorisationpages_read_user_content

Si vous n’êtes pas propriétaire de la Page ou ne la gérez pas, vous aurez besoin de ce qui suit :

• Fonctionnalité d’accès au contenu public de la Page

Exemple de requête

GET /v21.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}/feed",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Exemple de réponse JSON

{
  "data": [
    {
      "created_time": "2019-05-17T16:24:04+0000",
      "message": "Become a Facebook developer!",
      "id": "{page-id}_2191966997525824"
    },
    {
      "created_time": "2019-02-26T21:35:42+0000",
      "message": "Hello world!",
      "id": "{page-id}_2072371269485398"
    },
...
    {
      "created_time": "2018-01-26T20:57:22+0000",
      "message": "Friday Funday!",
      "id": "{page-id}_1569752556413941"
    }
  ],
  "paging": {
    "cursors": {
      "before": "Q2c4U1pXNT...",
      "after": "Q2c4U1pXNT..."
    },
    "next": "https://graph.facebook.com/vX.X/{page-id}/feed?access_token={your-page-access-token}&pretty=0&limit=25&after=Q2c4U1pXNT..."
  }
}

Limites

• Publications expirées : si une publication a expiré, vous ne pourrez plus en afficher le contenu à l'aide de l’API Graph.
• Maximum de publications

  • L’API renverra environ 600 publications publiées et classées par an.
  • Vous pouvez uniquement lire un maximum de 100 publications de fil avec le champ limit. Si vous essayez de lire un nombre supérieur de publications, un message d’erreur vous informe que la limite est de 100.
• CTA sous forme de message : il est impossible d’accéder aux publications comportant des call-to-action sous forme de message et utilisant le token d’accès d’une autre Page, car les Pages ne peuvent s’envoyer de messages entre elles.
• Informations identifiables publiquement : les informations utilisateur ne figureront pas dans les réponses, sauf si la demande a été effectuée avec un token d’accès de Page.
• Publications publiées : les publications publiées et non publiées seront retournées lors de la demande du point de terminaison « /{page-id}/feed ». Utilisez le champ « is_published » pour retourner uniquement les publications publiées.
• Publications partagées : une publication de Page qui partage la publication d’une autre Page ou d’une autre personne peut ne pas être visible si la publication originale n’est pas visible avec le token d’accès utilisé.
• Publications identifiées : lorsque vous utilisez /{page-id}/tagged pour afficher les publications qui identifient cette Page, les résultats n’incluent les publications d’autres Pages que si ces dernières sont authentiques.
• Agents utilisateur : les agents utilisateur disponibles et autorisés pour ces appels d’API Graph sont soumis à des modifications sans préavis. Si vous rencontrez des difficultés, il vous faudra peut-être passer à une version plus récente de votre agent utilisateur.
• Publications vidéo : pour obtenir une liste de publications vidéo, la personne qui fait la demande doit être l’admin de la Page.
• Reels : pour obtenir une liste des reels publiés sur votre Page, utilisez l’arête Page VideoReels.

Limites : toutes les publications (publiées et non publiées) seront extraites vers le point de terminaison du fil. La seule différence concerne les publications non publiées qui ne seront pas listées dans le fil physique. Cependant, il existe un champ is_published qui peut être ajouté au point de terminaison /feed pour indiquer aux équipes chargées du développement si la publication listée dans ce point de terminaison est ou non publiée.

Champs

curl -i -X GET \
 "https://graph.facebook.com/{your-page-id}/feed
    ?fields=is_eligible_for_promotion,promotable_id
        &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_eligible_for_promotion,promotable_id");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"fields": @"is_eligible_for_promotion,promotable_id",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'GET',
  {"fields":"is_eligible_for_promotion,promotable_id"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-page-id}/feed?fields=is_eligible_for_promotion,promotable_id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

{
  "data": [
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943344825721377",
      "id": "1353269864728879_1943344825721377"
    },
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943313139057879",
      "id": "1353269864728879_1943378089051384"
    },
    {
      "is_eligible_for_promotion": false,
      "promotable_id": "1353269864728879_1942095249179668",
      "id": "1353269864728879_1942095249179668"
    },
...

Publication

Vous pouvez publier sur des Pages à l’aide de cette arête. Les champs link ou message doivent être fournis.

Nouvelle expérience de Page

Cette API est compatible avec la nouvelle version des Pages.

Conditions requises

Si vous pouvez effectuer la tâche CREATE_CONTENT sur la Page, vous aurez besoin de ce qui suit :

• Un token d’accès de Page
• L’autorisation pages_manage_posts
• L’autorisation pages_read_engagement
• L’autorisation pages_show_list

Les publications se fondront parfaitement dans la Page.

Autorisations

• Token d’accès de Page demandé par une personne autorisée à effectuer

  Tâche CREATE_CONTENT

  sur la Page interrogée

• Autorisation pages_manage_posts

Remarque : si l’utilisateur·ice ou l’application ne peut pas voir l’URL de link, la publication échouera.

POST /v21.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+message

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{page-id}/feed',
    array (
      'message' => 'This is a test message',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}/feed",
    "POST",
    {
        "message": "This is a test message"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test message");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test message",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Réponse

{"id":"post-id"}

Ce point de terminaison prend en charge la lecture après écriture et peut immédiatement renvoyer tous les champs issus des opérations de lecture.

Exemple d’outil d’explorateur de graphique

Effectuez des tests dans l’outil d’explorateur de graphique en utilisant POST {page-id}/feed :

Champs

POST /v21.0/page-id/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+activity&og_action_type_id=383634835006146&og_object_id=136050896551329&og_icon_id=609297155780549

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/page-id/feed',
    array (
      'message' => 'This is a test activity',
      'og_action_type_id' => '383634835006146',
      'og_object_id' => '136050896551329',
      'og_icon_id' => '609297155780549',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/page-id/feed",
    "POST",
    {
        "message": "This is a test activity",
        "og_action_type_id": "383634835006146",
        "og_object_id": "136050896551329",
        "og_icon_id": "609297155780549"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test activity");
params.putString("og_action_type_id", "383634835006146");
params.putString("og_object_id", "136050896551329");
params.putString("og_icon_id", "609297155780549");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/page-id/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test activity",
  @"og_action_type_id": @"383634835006146",
  @"og_object_id": @"136050896551329",
  @"og_icon_id": @"609297155780549",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/page-id/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Publications de Page non publiées

Nous prenons en charge les types de publications de page non publiées suivantes :

Les publications de Page non publiées sont traitées comme les publications de Page publiées, sauf qu’elles ne s’affichent pas dans /feed.

Pour afficher la liste des publications de Page non publiées, interrogez le champ is_published.

curl -i -X GET \
 "https://graph.facebook.com/{page-id}/feed
 ?fields=is_published
 &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_published");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{page-id}/feed"
           parameters:@{ @"fields": @"is_published",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{page-id}/feed',
  'GET',
  {"fields":"is_published"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed?fields=is_published',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Pour consulter une publication sur Facebook.com, vous pouvez vous rendre sur https://www.facebook.com/{post-id} afin de voir la plupart des types de publication ou récupérer le champ actions de la publication, contenant l’URL à laquelle un utilisateur ou une utilisatrice peut aimer ou commenter la publication.

Publication de Page call-to-action

Vous pouvez améliorer vos publications de Page de lien grâce aux boutons de call-to-action. Le champ call_to_action suivant peut être ajouté aux nouvelles publications de Page de lien.

Image de publication de Page de lien personnalisée

Publiez un lien vers une Page comportant une image de lien personnalisé. La pièce jointe de la story rend une image récupérée à partir du lien. Il est actuellement possible d’écraser cette image en renseignant un paramètre picture facultatif avec une URL dirigeant vers une nouvelle image. Le paramètre thumbnail offre une fonctionnalité similaire, à la différence que ce paramètre accepte un fichier image local importé sur Facebook dans l’appel de l’API.

Autorisations

• Un token d’accès de Page est requis.
• Le lien doit appartenir à la Page qui publie.

Limites

• Le paramètre thumbnail n’est disponible que pour les publications de lien sur les Pages Facebook.
• Le paramètre thumbnail prévaut sur le paramètre picture. Si les deux sont fournis, le paramètre picture n’est pas utilisé.
• Le paramètre thumbnail accepte des images avec l’extension .jpg, .jpeg, .gif ou .png.
• Le paramètre thumbnail n’est pas pris en charge dans les demandes par lots.

Publication d’un lien vers une Page

Publiez un lien vers une Page en envoyant une demande POST à l’arête /page/feed. Définissez le paramètre publish sur 1 pour publier la publication immédiatement ou sur 0 pour créer une publication à publier ultérieurement.

Exemple de requête

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become%20a%20Facebook%20developer!
  &link=https%3A%2F%2Fdevelopers.facebook.com
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Exemple de réponse

{"id":"{post-id}"}

Association d’une publication de Page à un call-to-action

Le champ call_to_action indique l’action appropriée et le lien pertinent. Ce lien doit être le même que le paramètre link de la publication de Page. Dans cet appel, title, description, caption et picture sont facultatifs, et, s’ils ne sont pas fournis, Facebook lit les propriétés équivalentes à partir des métadonnées Open Graph du lien. Si la page web associée n’a pas de métadonnées Open Graph, Facebook essaie de deviner ces propriétés en extrayant le contenu de la page web.

Exemple de requête

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become a Facebook developer!
  &link=https://developers.facebook.com
  &call_to_action={"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\",\"call_to_action\":\"{\\\"type\\\":\\\"SIGN_UP\\\",\\\"value\\\":{\\\"link\\\":\\\"https://developers.facebook.com\\\"}}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",@"call_to_action": @"{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1","call_to_action":"{\"type\":\"SIGN_UP\",\"value\":{\"link\":\"https://developers.facebook.com\"}}"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1',
      'call_to_action' => '{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Exemple de réponse

{"id":"{post-id}"}

Association d’une publication à une image importée personnalisée

Utilisation d’un fichier local :

curl -F 'link=http://www.example.com' \
     -F 'thumbnail=@/local/path/to/file/on/hard/drive/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Valeur renvoyée

{"id":"post-id"}

Utilisation d’une image via une URL :

curl -F 'link=http://www.example.com' \
     -F 'picture=https://www.example.com/path/to/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Valeur renvoyée

{"id":"post-id>"}

Publication de Page de photo

Consultez notre documentation de référence : Nœuds photo pour en savoir plus.

Publication de Page de vidéo

Consultez notre documentation de référence : Vidéos de Page pour en savoir plus.

Statistiques de publication de Page

Consultez notre documentation de référence : Statistiques de publication de Page pour en savoir plus.

Mise à jour

Vous ne pouvez pas effectuer de mise à jour à l’aide de cette arête, mais vous pouvez mettre à jour les publications via le nœud /{post-id}.

Suppression

Vous ne pouvez pas effectuer de suppression à l’aide de cette arête, mais vous pouvez supprimer des publications via le nœud /{post-id}.