Graph API-Version

Page Published Posts

Wird gelesen

All published posts by the page.

Neue Seitenversion

This endpoint is supported for Neue Seitenversion.

Feature Permissions

NameBeschreibung
Zugriff auf öffentliche Inhalte von SeitenThis feature permission may be required.

Beispiel

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
}];
Weitere Informationen zur Verwendung der Graph API findest du in unserem Graph API-Leitfaden.

Einschränkungen

  • Maximale Anzahl der Beiträge
    • Mit der API werden rund 600 in einer Rangfolge sortierte veröffentlichte Beiträge pro Jahr zurückgegeben.
    • Du kannst höchstens 100 Feed-Beiträge mit dem limit-Feld lesen. Falls du versuchst mehr zu lesen, erhältst du eine Fehlermeldung, dass 100 nicht überschritten werden dürfen.
  • Nachrichten-CTA: Auf Beiträge mit Nachrichten-CTAs kann jedoch nicht über den Zugriffsschlüssel einer anderen Seite zugegriffen werden, da Seiten keine Nachrichten an andere Seiten senden können.
  • Öffentlich identifizierbare Informationen: Beachte, dass in Antworten keine Nutzerinformationen enthalten sind, es sei denn, du sendest die Anfrage mit einem Seiten-Zugriffsschlüssel.
  • Geteilte Beiträge: Ein Seitenbeitrag, mit dem ein Beitrag einer anderen Seite oder Person geteilt wird, wird möglicherweise nicht angezeigt, wenn der ursprüngliche Beitrag mit dem verwendeten Zugriffsschlüssel nicht angezeigt wird.
  • Markierte Beiträge: Wenn du zur Anzeige der Beiträge, die diese Seite markieren, /{page-id}/tagged verwendest, werden in den Ergebnissen nur Beiträge aus anderen Seiten aufgeführt, wenn diese Seiten authentisch sind.
  • Nutzer-Agenten: Die für diese Graph API-Aufrufe verfügbaren Nutzer-Agenten können jederzeit ohne Vorankündigung geändert werden. Sollten Probleme auftreten, empfiehlt sich möglicherweise der Wechsel zu einer neueren Version deines Nutzer-Agenten.
  • Video-Posts: Das source-Feld für /page/feed und /page/posts wird nur für Videos im Eigentum der Seite zurückgegeben, wenn der anfragende Nutzer ein Administrator der entsprechenden Seite ist.

Parameter

Dieser Endpunkt hat keine Parameter.

Felder

Beim Lesen dieses Edge wird ein Ergebnis im JSON-Format ausgegeben:

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

data

Eine Liste von PagePost-Nodes.

paging

Weitere Informationen zur Paginierung findest du im Graph API-Leitfaden.

summary

Gesammelte Informationen zum Edge (z. B. Aufrufe). Gib im Parameter „summary“ an, welche Felder einbezogen werden sollen (z. B. summary=total_count).

FeldBeschreibung
total_count
unsigned int32

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

Error Codes

FehlerBeschreibung
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

Wird erstellt

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.

Wird aktualisiert

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.

Wird gelöscht

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.