API Graph
Version API du graphe

Page Published Posts

Lecture

All published posts by the page.

Nouvelle version des Pages

This endpoint is supported for Nouvelle version des Pages.

Feature Permissions

NomDescription
Accès au contenu public de la PageThis feature permission may be required.

Exemple

Graph API Explorer
GET /v21.0/{page-id}/published_posts 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}/published_posts',
    '{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}/published_posts",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/published_posts",
    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}/published_posts"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Pour apprendre à utiliser l’API Graph, consultez notre guide Utiliser l’API Graph.

Limitations

  • 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 partagées : une publication de Page qui partage la publication d’une autre Page ou d’un autre utilisateur peut ne pas être visible si la publication initiale 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 problèmes, vous souhaiterez peut-être passer à une version plus récente de votre agent utilisateur particulier.
  • Publications vidéo : le champ source de /page/feed et /page/posts sera uniquement renvoyé pour les vidéos appartenant à une Page, si l’utilisateur faisant la demande est un administrateur de la Page qui les détient.

Paramètres

Ce point de terminaison n’a aucun paramètre.

Champs

La lecture à partir de cette arête renverra un résultat au format JSON :

{
    "data": [],
    "paging": {},
    "summary": {}
}

data

Une liste de nœuds PagePost.

paging

Pour plus de détails à propos de la pagination, voir Guide de l’API Graph.

summary

Informations agrégées relatives à l’arête, par exemple le nombre. Indiquez les champs à récupérer dans le paramètre récapitulatif (par exemple récapitulatif=total_count).

ChampDescription
total_count
unsigned int32

The approximate total number of published posts within the specified time window, requires since parameter to be specified

Error Codes

ErreurDescription
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
200Permissions error
100Invalid parameter
190Invalid OAuth 2.0 Access Token
210User not visible
283That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
104Incorrect signature
3001Invalid query
2500Error parsing graph query

Création

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Mise à jour

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Suppression

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.