Graph API-Version

Seiten-Feed

Verwende diesen Endpunkt, um eine Seite abzurufen und auf einer Seite zu posten. Der Seiten-Feed umfasst alle Interaktionen mit einer Facebook-Seite einschließlich: Beiträge und Links, die von dieser Seite veröffentlicht werden, sowie öffentiche Beiträge, in denen die Seite markiert wurde.

Siehe auch

Lesen

Die Beiträge einer Facebook-Seite.

Neue Seitenversion

Diese API wird für die neue Seitenversion unterstützt.

Anforderungen

Die Person, die den Zugriffsschlüssel anfordert, muss eine der folgenden Aufgaben auf der Seite ausführen können:

  • CREATE_CONTENT: Inhalt im Namen der Seite veröffentlichen
  • MANAGE: Seitenaufgaben zuweisen und verwalten
  • MODERATE:
    • Auf Beiträge im Namen der Seite antworten
    • Kommentare zu Seitenbeiträgen löschen
    • Wenn ein Instagram-Konto mit der Seite verknüpft ist: Inhalt von Facebook auf Instagram veröffentlichen, auf Kommentare antworten und diese löschen, Direktnachrichten senden, Geschäftskontakte synchronisieren und Werbeanzeigen erstellen

Zudem muss die App über folgende Berechtigungen verfügen:

Wenn du die Seite nicht besitzt oder verwaltest, benötigst du Folgendes:

Verwende bei Nutzung der Funktion „Zugriff auf öffentliche Seiteninhalte“ einen Zugriffsschlüssel für Systemnutzer, um Probleme durch Durchsatzratenbegrenzung zu vermeiden.

Beispielanfrage

Graph API Explorer
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
}];

Beispiel einer JSON-Antwort

{
  "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..."
  }
}

Einschränkungen

  • Abgelaufene Beiträge – Ist ein Beitrag abgelaufen, kannst du den Inhalt mit der Graph API nicht mehr sehen.
  • 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 Nutzer*innen-Informationen enthalten sind, es sei denn, du sendest die Anfrage mit einem Seiten-Zugriffsschlüssel.
  • Veröffentlichte Beiträge – Veröffentlichte und nicht veröffentlichte Beiträge werden zurückgegeben, wenn du eine Abfrage an den „/{page-id}/feed“-Endpunkt sendest. Verwende das Feld „is_published“, demit nur veröffentlichte Beiträge zurückgegeben werden.
  • 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-Beiträge – Um eine Liste der Video-Beiträge anzurufen, muss die Anfrage von einem Admin der Seite gestellt werden.
  • Reels – Verwende zum Abrufen einer Liste der Reels, die auf deiner Seite veröffentlicht wurden, die Page VideoReels-Edge.

Einschränkungen: Alle Beiträge (veröffentlichte und unveröffentlichte) werden im Feed-Endpunkt abgerufen. Der einzige Unterschied besteht darin, dass unveröffentlichte Beiträge nicht im tatsächlichen Feed ausgelistet werden. Es gibt jedoch ein „is_published“-Feld, das zum /feed-Endpunkt hinzugefügt werden kann, damit Entwickler*innen erkennen können, ob der im /feed-Endpunkt aufgelistete Beitrag veröffentlicht ist oder nicht.

Felder

NameTypBeschreibung
idstring

Die ID des Posts.

actionsobject

Handlungslinks für den Post, den Kommentar, die „Gefällt mir“-Angabe, das Teilen.

admin_creatorobject

Der Admin-Ersteller eines Seitenbeitrags. Falls die Seite nur einen Admin hat, werden keine Daten zurückgegeben. Hierfür sind ein Seiten-Zugriffsschlüssel und die Berechtigung business_management erforderlich.

idint

Die ID der Person, der App oder des Unternehmens.

namestring

Der Name der Person, der App oder des Unternehmens.

allowed_advertising_objectsstring

Die einzigen Ziele, unter denen dieser Beitrag beworben werden kann.

applicationobject

Informationen zu der App, von der dieser Beitrag veröffentlicht wurde.

attachmentsobject

Alle der Story zugewiesenen Attachments Informationen zu den attachments-Feldern findest du in der Referenz zum Story Attachment Node.

backdated_timefloat

Die rückdatierte Zeit für rückdatierten Beitrag. Für reguläre Beiträge wird dieses Feld auf Null gesetzt.

call_to_actionobject

Der Call to Action-Typ, der in beliebigen Seitenbeiträgen für Mobile App Engagement Ads verwendet wird.

contextobject

Der Call to Action-Typ, der in beliebigen Seitenbeiträgen für Mobile App Engagement Ads verwendet wird.

can_reply_privatelyboolean

Hiermit wird festgelegt, ob der Seitenaufruf eine private Antwort auf diesen Beitrag senden kann. Hierfür ist die Berechtigung read_page_mailboxes erforderlich.

caption

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet.

string

Der Bildtext in einem Beitrag, der unter name erscheint. caption muss eine tatsächliche URL sein und genau der URL und dem zugehörigen Werbetreibenden bzw. Unternehmen entsprechen, der/das durch Klicken auf die URL aufgerufen wird.

child_attachmentsobject

Sub-Teilen eines Teilen-Beitrags mit mehreren Links

created_timefloat

Der Zeitpunkt, zu dem der Beitrag ursprünglich veröffentlicht wurde. Bei einem Beitrag über ein Lebensereignis ist dies das Datum und die Uhrzeit des Lebensereignisses.

description

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet. Verwende stattdessen attachments{description}.

string

Eine Beschreibung eines Links im Beitrag (wird unter caption angezeigt).

feed_targetingobject

Objekt, das Feed-Targeting für diesen Beitrag steuert. Bei allen in diesen Gruppen erhöht sich die Wahrscheinlichkeit, dass sie diesen Beitrag sehen. Bei anderen ist die Wahrscheinlichkeit nicht so hoch, aber es kann dennoch sein, dass sie den Beitrag sehen. Es kann eine beliebige Zahl der hier angezeigten Targeting-Felder verwendet werden, aber kein Feld ist obligatorisch (gilt nur für Seiten).

age_maxint

Höchstalter

age_minint

Muss mindestens 13 sein. Der Standardwert lautet 0

citiesint

Werte für das Targeting von Städten. Verwende type von adcity für die Suche von Targeting-Optionen und verwende den zurückgegebenen key zur Angabe.

college_yearsint

Array von Integer-Werten für das Abschlussjahr an der Hochschule.

countriesstring

Werte für das Targeting von Ländern. Du kannst bis zu 25 Länder angeben. Verwende Ländercodes im ISO 3166-Format.

education_statusesint

Array von Integer-Werten für das Targeting auf Grundlage des Ausbildungsgrads. Verwende 1 für Schüler (High School), 2 für Studenten und 3 für Absolventen (oder lokalisierte Entsprechungen).

gendersint

Targetiere ein bestimmtes Geschlecht. 1 für alle männlichen Betrachter und 2 für alle weiblichen. Bei der Standardeinstellung richtet sich das Targeting an beide Geschlechter.

interested_in

Veraltet.

intGibt an, dass das Targeting anhand der Informationen im Feld „interessiert an“ des Nutzerprofils erfolgt. Du kannst den Integer-Wert 1 für „Männlich“ und 2 für „Weiblich“ angeben. Standardmäßig werden alle Typen berücksichtigt. Beachte, dass Targeting anhand des Felds „interessiert an“ aufgrund lokaler Gesetze in den meisten europäischen Ländern und Kanada nicht zur Verfügung steht.
interestsint

Eine oder mehrere Seiten-IDs für das Targeting von Seiten-Fans. Über den Seitentyp erhältst du mögliche IDs als Targeting-Optionen. Zur Festlegung kannst du die zurückgegebene ID verwenden.

localesint

Targeting-Gebietsschemata. Verwende type von adlocale für die Suche von Targeting-Optionen und verwende den zurückgegebenen key zur Angabe.

regionsarray

Werte von Targeting-Regionen. Verwende type von adregion für die Suche von Targeting-Optionen und verwende den zurückgegebenen key zur Angabe.

relationship_statusesint

Array von Integer-Werten für das Targeting auf der Grundlage des Beziehungsstatus. Verwende 1 für „Ledig“, 2 für „In einer Beziehung“, 3 für „Verheiratet“ und 4 für „Verlobt“. Standardmäßig werden alle Typen berücksichtigt.

from

object

Der name und die id der Seite, der Gruppe oder des Ereignisses, die bzw. das den Beitrag erstellt hat. Wenn du dieses Feld mit einem Nutzer-Zugriffsschlüssel liest, wird nur der aktuelle Nutzer zurückgegeben.

full_picturestring

URL zu einer Vollformat-Version des im Beitrag veröffentlichten Fotos bzw. die aus einem Link im Beitrag entnommen wurde. Wenn die größte Abmessung des Fotos 720 Pixel übersteigt, wird die Größe so geändert, dass der Wert von 720 Pixeln nicht überschritten wird.

iconstring

Ein Link zu einem Symbol, das für den Beitragstyp steht.

instagram_eligibilityenum{}

Hiermit wird festgelegt, ob der Beitrag auf Instagram hervorgehoben werden kann. Es wird der „enum“-Wert eligible zurückgegeben, wenn eine Hervorhebung möglich ist. Ansonsten wird ein „enum“-Wert mit der Begründung für die nicht mögliche Hervorhebung zurückgegeben.

  • ineligible_caption_mentions_not_allowed
  • ineligible_caption_too_long
  • ineligible_media_aspect_ratio
  • ineligible_media_dimension
  • ineligible_media_square_aspect_ratio
  • ineligible_media_square_dimension
  • ineligible_post_type
  • ineligible_unknown_error
  • ineligible_video_length
is_eligible_for_promotionboolean

Gibt an, dass ein Beitrag nicht beworben werden kann.

is_expiredboolean

Ob der Beitrag über einen verstrichenen Ablaufzeitpunkt verfügt.

is_hiddenboolean

Hiermit wird festgelegt, ob dieser Beitrag als verborgen markiert wird (gilt nur für Seiten). Wenn du einen Beitrag verbirgst, ist er in der Chronik einer Seite nicht mehr zu sehen, wohl aber an anderen Orten in Facebook, z. B. in einem Link.

is_instagram_eligiblestring

Hiermit wird festgelegt, ob dieser Beitrag auf Instagram hervorgehoben werden kann.

is_popularboolean

Ob der Beitrag beliebt ist. Basiert auf der Tatsache, ob die Gesamtzahl der Handlungen als Prozentsatz der Reichweite einen bestimmten Schwellenwert überschreitet.

is_publishedboolean

Hiermit wird angegeben, ob ein geplanter Beitrag veröffentlicht wurde (gilt nur für geplante Seitenbeiträge, bei Nutzerbeiträgen und sofort veröffentlichten Beiträgen lautet der Wert stets true). Beachte, dass bei Seitenbeiträgen, die im Rahmen der Erstellung von Werbeanzeigen erstellt wurden, dieser Wert immer false ist.

is_sphericalboolean

Ob es sich bei dem Beitrag um einen sphärischen Videobeitrag handelt.

link

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet.

Verwende stattdessen attachments{unshimmed_url}.

string

Der Link, der mit diesem Beitrag verknüpft ist.

messagestring

Die Statusnachricht im Beitrag.

message_tagsarray

Ein Array von mit message markierten Profilen. Wenn du dieses Feld mit einem Nutzer-Zugriffsschlüssel liest, wird nur der aktuelle Nutzer zurückgegeben.

lengthint

Die Länge des Tag-Textes inUnicode-Codepunkten.

idstring

Die ID des mit Tags markierten Profils.

namestring

Der für die Markierung des Profils verwendete Text.

offsetint

Die Position des ersten Zeichens des Tag-Textes in der message, angegeben in Unicode-Codepunkten.

typeenum{}

Der Typ des markierten Profils: user, page oder group.

name

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet.

Verwende stattdessen attachments{title}.

string

Der Name des link.

object_id

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet.

Verwende stattdessen attachments{target{id}}.

string

Die ID von hochgeladenen Fotos oder Videos, die an den Beitrag angehängt sind.

parent_idstring

Die ID eines übergeordneten Beitrags für diesen Beitrag (falls vorhanden). Wenn du beispielsweise eine Story vom Typ „Deine Seite wurde in einem Beitrag erwähnt“ hast, ist die parent_id der ursprüngliche Beitrag, in dem die Erwähnung zu finden ist.

permalink_urlstring

Die permanente statische URL zum Beitrag auf www.facebook.com. Beispiel: https://www.facebook.com/FacebookForDevelopers/posts/10153449196353553.

placestring

ID des mit diesem Beitrag verknüpften Standorts.

privacyobject

Die Privatsphäre-Einstellungen für den Beitrag.

allowstring

Wenn value gleich CUSTOM ist, ist dies eine kommagetrennte Liste mit den IDs der Nutzer und (gegebenenfalls) der Freundeslisten, die den Beitrag sehen können.

denystring

Wenn value gleich CUSTOM ist, ist dies eine kommagetrennte Liste mit den IDs der Nutzer und (gegebenenfalls) der Freundeslisten, die den Beitrag nicht sehen können.

descriptionstring

Text, in dem die Privatsphäre-Einstellungen erläutert werden, wie sie in Facebook angezeigt werden.

friendsenum{}

Wenn value gleich CUSTOM ist, geht daraus hervor, welche Gruppe von Freunden den Beitrag sehen kann. Die folgenden Werte sind möglich:

  • ALL_FRIENDS
  • FRIENDS_OF_FRIENDS
  • SOME_FRIENDS
valueenum{}

Die tatsächliche Privatsphäre-Einstellung. Die folgenden Werte sind möglich:

  • ALL_FRIENDS
  • CUSTOM
  • EVERYONE
  • FRIENDS_OF_FRIENDS
  • SELF
promotable_idstring

Die ID des für die Promotion von Stories zu verwendenden Beitrags, wenn die Story selbst nicht hervorgehoben werden kann.

promotion_eligibility

Veraltet. Siehe is_eligible_for_promotion

booleanGibt an, ob ein Beitrag beworben werden kann.
promotion_status

Veraltet. Siehe is_eligible_for_promotion

stringDer Status der Promotion. Hierfür sind die Berechtigungen von Seiten-Admins erforderlich. Mögliche Werte:
activeDie Promotion ist zurzeit aktiv.
draftDie Promotion befindet sich noch im Entwurfsmodus.
extendableDie Promotion-Kampagne ist beendet, kann aber neu gestartet werden.
finishedDie Promotion wurde beendet.
inactiveKeine aktive Promotion.
ineligible

Der Beitrag kann nicht beworben werden. Hier erfährst du, warum der Beitrag eventuell die Voraussetzungen nicht erfüllt.

pausedDie Promotion ist unterbrochen.
pendingDie Promotion wird noch geprüft.
rejectedDie Promotion wurde im Prüfprozess abgelehnt.
propertiesobject

Eine Liste der Eigenschaften von angehängten Videos, z. B. die Dauer.

namestring

Der Name der Eigenschaft.

textstring

Der Wert der Eigenschaft.

hrefstring

Jeder mit der Eigenschaft verknüpfte Link.

sheduled_publish_timefloat

Der UNIX-Zeitstempel für die geplante Veröffentlichung für den Beitrag.

sharesobject

Die Häufigkeit, mit der dieser Beitrag geteilt wurde. In dieser Zahl sind unter Umständen auch gelöschte Beiträge und Beiträge, die du aus Datenschutzgründen nicht sehen kannst, enthalten.

source

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet.

Verwende stattdessen attachments{media{source}}.

string

Eine URL zu einer an den Beitrag angehängten Flash- oder Videodatei.

status_typeenum{}

Der Typ eines Status-Updates. Die folgenden Werte sind möglich:

  • added_photos
  • added_video
  • app_created_story
  • approved_friend
  • created_event
  • created_group
  • created_note
  • mobile_status_update
  • published_story
  • shared_story
  • tagged_in_photo
  • wall_post
storystring

Text von Stories, der nicht absichtlich von Nutzern generiert wird, wie zum Beispiel beim Hinzufügen eines Fotos generierter Text. Die Migration vom Typ „Neueste Aktivitäts-Stories berücksichtigen“ muss in deiner App aktiviert sein, damit dieses Feld abgerufen wird.

story_tagsarray

Liste der Tags in der Beitragsbeschreibung.

subscribedboolean

Ob ein Benutzer den Beitrag abonniert hat.

targetingobject

Objekt, das die Zielgruppe für diesen Inhalt einschränkt. Nur Zielgruppen aus den vorliegenden demografischen Angaben können diesen Inhalt sehen. Die demografischen Angaben ergänzen sich. Jeder neu hinzugefügte Wert fügt der Gesamt-Zielgruppe eine Zielgruppe hinzu. Mit diesen Werten werden keine auf Seitenebene festgelegten demografischen Beschränkungen überschrieben.

countriesstring

Werte von Targeting-Ländern als Ländercodes im ISO 3166-Format.

localesint

Targeting-Gebietsschemata. Targeting-Optionen des Typs adlocale können zurückgegeben werden.

regionslist<int>

Werte für Targeting-Regionen. Targeting-Optionen des Typs adregion können zurückgegeben werden.

citieslist<int>

Werte für ausgeschlossene Orte. Targeting-Optionen des Typs adcity können zurückgegeben werden.

to

object

In diesem Beitrag erwähnte oder angesprochene Profile. Wenn du dieses Feld mit einem Nutzer-Zugriffsschlüssel liest, wird nur der aktuelle Nutzer zurückgegeben.

type

Wird ab Version 3.3 nicht mehr für Seitenbeiträge verwendet.

Verwende stattdessen attachments{media_type}. Wenn es keine attachments oder media_type=link gibt, ist der Wert identisch wie bei type=status.

enum{}

Ein String, der den Objekttyp dieses Beitrags angibt. enum-Werte beinhalten Folgendes:

  • link
  • offer
  • photo
  • status
  • video
updated_timefloat

Der Zeitpunkt des letzten Beitrag-Updates, das erfolgt, wenn ein Beitrag erstellt oder bearbeitet wird oder wenn ein Nutzer einen Beitrag kommentiert, ausgedrückt als UNIX-Zeitstempel.

video_buying_eligibilityarray

Hiermit wird festgelegt, ob der Beitrag mit verschiedenen Video-Kaufoptionen hervorgehoben werden kann. Wenn das Video hervorgehoben werden kann, wird eine leere Liste zurückgegeben. Andernfalls wird eine Liste mit Gründen dafür zurückgegeben, dass ein Beitrag nicht hervorgehoben werden kann.

with_tags

object

Profile, die so markiert sind, dass sie zum Herausgeber des Beitrags gehören. Wenn du dieses Feld mit einem Nutzer-Zugriffsschlüssel liest, wird nur der aktuelle Nutzer zurückgegeben.


Dieser Endpunkt kann ab dem 30. April 2019 nicht mehr in der Version 3.3 und höher der Graph API und Marketing API verwendet werden. Apps, die diesen Endpunkt in den letzten 90 Tagen verwendet haben, können ihn bis zum 30. Juni 2019 weiterhin mit den App-Versionen 3.2 und älter verwenden. Apps, die diesen Endpunkt in den letzten 90 Tagen nicht verwendet haben, können ihn ab dem 30. April 2019 nicht mehr verwenden.

Promotable-IDs

Wenn Beiträge gefunden werden, die hervorgehoben werden können, musst du zum Erstellen von Anzeigen die promotable_id verwenden. In den meisten Fällen ist diese ID mit der post_id identisch. Das trifft aber nicht immer zu. Hinweis: Sobald ein Beitrag hervorgehoben wurde, kannst du ihn nur noch bearbeiten, wenn du Zugriff auf das verbundene Werbekonto hast.

Beispielanfrage

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();

Beispielantwort

{
  "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"
    },
...

In unserem Hilfebereich findest du Informationen dazu, warum ein Beitrag unter Umständen nicht beworben wird.

Informationen zu allen verfügbaren Beitragsfeldern findest du in unserem Beitragsreferenzdokument.

Veröffentlichung

Du kannst Seiten mit diesem Edge veröffentlichen. Es muss link oder message angegeben werden.

Neue Seitenversion

Diese API wird für die neue Seitenversion unterstützt.

Anforderungen

Zum Ausführen der CREATE_CONTENT-Aufgabe benötigst du Folgendes:

Beiträge werden an die übrigen Beiträge dieser Seite angepasst.

Berechtigungen

Hinweis: Wenn der Betrachter bzw. die App die URL von link nicht sehen können, schlägt die Veröffentlichung des Beitrags fehl.

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
}];

Antwort

{"id":"post-id"}

Dieser Endpunkt unterstützt read-after-write. Außerdem können beliebige bei Lesevorgängen zurückgegebene Felder sofort ausgegeben werden.

Beispiel für das Graph Explorer-Tool

Teste im Graph Explorer-Tool mit POST {page-id}/feed:

Felder

NameTypBeschreibung
actionsarray

Die mit dem Beitrag verknüpften Handlungs-Links.

linkstring

Die URL des Handlungs-Links selbst.

namestring

Der Name oder die Bezeichnung des Handlungs-Links.

backdated_timefloat

Gibt einen Zeitpunkt in der Vergangenheit an, auf den dieser Beitrag rückdatiert wird.

backdated_time_granularityenum{year, month, day, hour, minute}

Steuert die Anzeige eines rückdatierten Beitrags. Wählst du beispielsweise month, werden Beiträge mit 2 months ago anstatt mit einem genauen Datum angezeigt.

child_attachments

object

Zur Angabe mehrerer Links im Beitrag. Mindestens 2 und höchstens 5 Objekte. Falls du

multi_share_optimized

auf „true“ festlegst, kannst du maximal 10 Objekte hochladen, aber Facebook zeigt die Top 5 an.

descriptionstring

Wird zur Anzeige eines Preises, eines Rabatts oder einer Webseiten-Domain verwendet. Wenn du keinen Wert angibst, wird der Inhalt von der verknüpften Seite extrahiert und verwendet. Eingaben in diesem Feld werden in der Regel nach 30 Zeichen abgeschnitten.

image_hashstring

Hash eines Vorschaubilds, das dem Link aus deiner Anzeigenbildbibliothek zugewiesen ist (Seitenverhältnis von 1:1 und mindestens 458 x 458 Pixel für die beste Anzeige). picture oder image_hash muss angegeben werden.

linkstring

Die URL eines mit dem Beitrag zu verknüpfenden Links. Dieses Feld ist erforderlich.

namestring

Der Titel der Link-Vorschau. Wenn dieser nicht angegeben wird, wird der Titel der verknüpften Seite verwendet. Die Eingabe in diesem Feld wird in der Regel nach 35 Zeichen abgeschnitten. Es wird empfohlen, einen eindeutigen name festzulegen, da in Facebook-Interfaces Handlungen angezeigt werden, die für das name-Feld erfasst werden.

picturestring

Eine URL, die das dem Link zugewiesene Vorschaubild festlegt (Seitenverhältnis von 1:1 und mindestens 458 x 458 Pixel für die beste Anzeige). picture oder image_hash muss angegeben werden.

feed_targetingobject

Objekt, das Feed-Targeting für diesen Inhalt steuert. Alle Personen in dieser Gruppe sehen diesen Inhalt mit einer größeren Wahrscheinlichkeit. Bei allen nicht in dieser Gruppe enthaltenen Personen ist die Wahrscheinlichkeit geringer, sie können ihn aber unter Umständen trotzdem sehen. Alle der hier aufgeführten Targeting-Felder können verwendet werden, aber es sind keine erforderlich.

age_maxint

Höchstalter. Muss 65 oder niedriger sein.

age_minint

Muss mindestens 13 sein. Standardwert ist 0.

college_yearsint[]

Array von Integer-Werten für das Abschlussjahr an der Hochschule.

education_statusesint[]

Array von Integer-Werten für das Targeting auf Grundlage des Ausbildungsgrads. Verwende 1 für Schüler*innen (High School), 2 für Student*innen und 3 für Absolvent*innen (oder lokalisierte Entsprechungen).

genderslist<unsigned int32>

Hiermit kannst du ein bestimmtes Geschlecht ansprechen. 1 für alle männlichen Betrachter und 2 für alle weiblichen. Standardmäßig werden beide Geschlechter angesprochen.

geo_locationsobject

Mit diesem Objekt kannst du eine Reihe verschiedener geografischer Standorte angeben. Informationen zu diesem Objekt findest du in unserem Targeting-Leitfaden.

interestsint[]

Eine oder mehrere IDs zur Targetierung von Fans. Verwende type=audienceinterest, um mögliche IDs als Targeting-Optionen zu erhalten, und verwende die zurückgegebene ID zur Angabe.

localesint

Targeting-Gebietsschemata. Verwende type von adlocale für die Suche von Targeting-Optionen und verwende den zurückgegebenen key zur Angabe.

relationship_statuseslist<unsigned int32>

Array von Integer-Werten für das Targeting auf der Grundlage des Beziehungsstatus. Verwende 1 für „Ledig“, 2 für „In einer Beziehung“, 3 für „Verheiratet“ und 4 für „Verlobt“. Standardmäßig werden alle Typen berücksichtigt.

linkstring

Die URL eines mit dem Beitrag zu verknüpfenden Links. link oder message muss angegeben werden. Unten werden zusätzliche link zugewiesene Felder angezeigt. Einschränkungen findest du im Abschnitt zu benutzerdefinierten Links.

descriptionstring

Hiermit wird die Beschreibung in der Link-Vorschau überschrieben.

namestring

Hiermit wird der Titel der Link-Vorschau überschrieben.

picturestring

Hiermit wird das mit dem Link verknüpfte Vorschaubild bestimmt.

thumbnailfile

Das von dir hochgeladene mit dem Link verknüpfte Vorschaubild.

messagestring

Der Hauptteil des Beitrags. In der Nachricht dürfen Facebook-Seiten erwähnt werden: @[page-id]

multi_share_end_cardBoolean

Falls das Feld auf false festgelegt ist, wird die Endkarte eines Carousel Link-Beitrags nicht angezeigt, wenn child_attachments verwendet wird. Der Standardwert ist true.

multi_share_optimizedBoolean

Falls das Feld auf true festgelegt ist und nur wenn der Beitrag in einer Anzeige verwendet wird, wählt Facebook die Reihenfolge der Links in child_attachments automatisch aus. Andernfalls wird die ursprüngliche Reihenfolge von child_attachments beibehalten. Der Standardwert ist „true“.

object_attachmentstring

Die Facebook-ID für ein vorhandenes Bild in den Fotoalben der Person, das als Miniaturbild verwendet werden soll. Die Person muss Eigentümer*in des Fotos sein. Außerdem darf das Foto nicht Teil eines Nachrichtenanhangs sein.

placestring

Seiten-ID eines mit diesem Beitrag verknüpften Standorts.

publishedBoolean

Gibt an, ob eine Story zu diesem neu veröffentlichten Objekt angezeigt wird. Der Standardwert lautet true, was bedeutet, dass die Story im Feed angezeigt wird. Dieses Feld wird nicht unterstützt (not), wenn der Parameter für Handlungen verwendet wird. Nicht veröffentlichte Beiträge können in Anzeigen verwendet werden.

scheduled_publish_timetimestamp

Unix-Zeitstempel, der angibt, wann der Beitrag live gehen soll. Muss ein Datum sein, das zwischen 10 Minuten und 75 Tagen nach dem Zeitpunkt der API-Anfrage liegt.

tagscsv[string]

Kommagetrennte Liste der Nutzer-IDs von in diesem Beitrag markierten Personen. Du kannst in diesem Feld nur Angaben vornehmen, wenn du auch Angaben unter place machst.

targetingobject

Objekt zum Einschränken der Zielgruppe für diesen Inhalt. Alle nicht in dieser Demografie enthaltenen Personen können diesen Inhalt nicht sehen. Hiermit werden keine eventuell vorhandenen demografischen Einschränkungen auf Seitenebene überschrieben:

age_minint

Der Wert kann 13, 15, 18, 21 oder 25 sein.

geo_locationsobject

Mit diesem Objekt kannst du eine Reihe verschiedener geografischer Standorte angeben. Informationen zu diesem Objekt findest du in unserem Targeting-Leitfaden.

Einem Seitenbeitrag ein Gefühl oder eine Aktivität hinzufügen

Füge ein Gefühl oder eine Aktivität und ein Symbol zu einem Seitenbeitrag hinzu. og_action_type_id und og_object_id sind für das Posten eines Gefühls oder einer Aktivität erforderlich. og_icon_id ist optional. Wird sie jedoch nicht verwendet, wird basierend auf der og_object_id automatisch ein Symbol verwendet.

Felder

Name Beschreibung

og_action_type_id

Eine Handlung, d. h., Fühlen, Ansehen usw.

og_icon_id

Ein Symbol, das vielleicht den Handlungstyp repräsentiert, d. h., ein lächelndes Gesicht, ein Filmsymbol usw.

og_object_id

Das Ziel der Handlung, d. h., Glück, Film usw. Hierbei kann es sich um ein vordefiniertes Objekt oder um eine beliebige page_id handeln.

Beispielbeitrag

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
}];

Die Antwort ist die post_id.

Unveröffentlichte Seitenbeiträge

Wir unterstützen die folgenden Typen unveröffentlichter Seitenbeiträge:

BeitragstypBeschreibung

Link

Ein Link-Seitenbeitrag ist die effektivste Möglichkeit, um Links auf deiner Webseite zu teilen. Er ermöglicht eine optimale Ersetzung von Bild und zusätzlichem Text.
Hinweis: Ein Link zu einem YouTube-Video ist ein Link-Seitenbeitrag.

Foto

Ein Fotoseitenbeitrag mit einer Textbeschreibung und einem optionalen Link als Teil der Beschreibung.

Beitrag

Ein Seitenbeitrag mit einer Textbeschreibung.

Video

Ein Videoseitenbeitrag mit einer optionalen Textbeschreibung

Unveröffentlichte Seitenbeiträge werden wie veröffentlichte Seitenbeiträge behandelt mit der Ausnahme, dass sie nicht im /feed angezeigt werden.

Frage für eine Liste mit unveröffentlichten Seitenbeiträgen das Feld is_published ab.

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();

Zur Anzeige eines Beitrags auf Facebook.com kannst du für die meisten Beitragstypen zu https://www.facebook.com/{post-id} navigieren oder das Feld actions des Beitrags abrufen, das die URL enthält, unter der ein Nutzer für den Beitrag eine „Gefällt mir“-Angabe machen oder einen Kommentar eingeben kann.

Call_to_action für Seitenbeitrag

Du kannst deine Link-Seitenbeiträge mit Call to Action-Buttons optimieren. Das folgende call_to_action-Feld kann neuen Link-Seitenbeiträgen hinzugefügt werden.

NameTypBeschreibung

call_to_action

object

Objekt, das einen Call to Action-Button festlegt. Dies sollte die Handlung sein, die Personen ausführen sollen, wenn sie deinen Beitrag sehen. Mit einem Klick auf diesen Button werden Personen zu dem von dir festgelegten Link weitergeleitet.

type

string

Legt den Text für den Call to Action-Button fest. Einer der unterstützten Werte:

BOOK_TRAVEL. Call to Action wird als „Jetzt buchen“ angezeigt.

BUY_NOW. Call to Action wird als „Jetzt kaufen“ angezeigt. Wird nur für Desktop App Ads für virtuelle Waren verwendet.

CALL_NOW. Call to Action wird als „Jetzt anrufen“ angezeigt. Wird nur für Local Awareness Ads verwendet.

DOWNLOAD. Call to Action wird als „Download“ angezeigt.

GET_DIRECTIONS. Call to Action wird als „Wegbeschreibung anzeigen“ angezeigt. Das Feld link muss Koordinaten enthalten. Wird nur für Local Awareness Ads verwendet.

GET_QUOTE. Call to Action wird als „Angebot anfordern“ für Leadgenerierung angezeigt.

INSTALL_APP. Call to Action wird als „Jetzt installieren“ angezeigt.

INSTALL_MOBILE_APP. Call-to-Action wird als „Jetzt installieren“ angezeigt. Wird nur für Mobile App Ads verwendet.

LEARN_MORE. Call to Action wird als „Mehr dazu“ angezeigt.

LIKE_PAGE. Call to Action wird als „Gefällt mir“ angezeigt. Wird nur für Anzeigen im „Gefällt mir“-Ziel verwendet.

LISTEN_MUSIC. Call to Action wird als „Musik hören“ angezeigt.

MESSAGE_PAGE. Call to Action wird als „Nachricht senden“ angezeigt. Wird nur für Local Awareness Ads verwendet.

NO_BUTTON. Es wird kein Call to Action angezeigt.

OPEN_LINK. Call to Action wird als „Link öffnen“ angezeigt. Wird nur für Anzeigen im Webseiten-Klicks-Ziel verwendet.

PLAY_GAME. Call to Action wird als „Spielen“ angezeigt. Wird nur für Desktop App Ads verwendet.

SHOP_NOW. Call to Action wird als „Jetzt einkaufen“ angezeigt. Wird nur für Anzeigen im Webseiten-Conversions-Ziel verwendet.

SIGN_UP. Call to Action wird als „Registrieren“ angezeigt.

SUBSCRIBE. Call to Action wird als „Abonnieren“ für Leadgenerierung angezeigt.

USE_APP. Call to Action wird als „App verwenden“ angezeigt.

USE_MOBILE_APP. Wird nur für Mobile App Ads verwendet.

WATCH_MORE. Call to Action wird als „Mehr ansehen“ angezeigt.

WATCH_VIDEO. Call to Action wird als „Video ansehen“ angezeigt.

Bild für Seitenbeitrag mit benutzerdefiniertem Link

Posten eines Links in einer Seite mit einem angepassten Link-Bild. Mit dem Anhang der Story wird ein von dem Link abgerufenes Bild dargestellt. Aktuell kann dieses Bild durch Bereitstellung eines optionalen picture-Parameters mit einer URL zu einem neuen Bild überschrieben werden. Der thumbnail-Parameter bietet eine ähnliche Funktionalität mit dem entscheidenden Unterschied, dass der Parameter eine lokale Bilddatei annimmt, die im API-Aufruf in Facebook hochgeladen wird.

Berechtigungen

  • Es wird ein Seiten-Zugriffsschlüssel benötigt.
  • Der Link muss der veröffentlichenden Seite gehören.

Überprüfe den Eigentümer im ownership_permissions{can_customize_link_posts}-Feld auf dem URL-Node. Du musst diesen Endpunkt anrufen, bevor du neue Links veröffentlichst. Ohne diesen Schritt funktionieren Seitenbeiträge für benutzerdefinierte Links für Links ohne Scraping nicht. Weitere Informationen findest du in unserem Leitfaden zu Linkeigentum. Für die Versionen 2.10 und niedriger sind picture, name, thumbnail und description veraltet. caption ist für alle Versionen veraltet.

ParameterTypBeschreibung

description

String

Die Beschreibung des Links (wird unter der Linkunterschrift angezeigt). Wenn nicht angegeben, wird dieses Feld automatisch mit Informationen befüllt, die von dem Link ausgelesen werden – für gewöhnlich der Titel der Seite.

name

String

Der Name des Linkanhangs. Dieses Feld wird automatisch mit Informationen befüllt, die von dem Link ausgelesen werden.

picture

String

URL für das Bild. Bild wird aus der in picture angegebenen URL übernommen

thumbnail

file

Hochzuladende Bilddatei. Nimmt .jpg.jpeg.gif oder .png an. Bild wird aus der in thumbnail hochgeladenen Datei übernommen

Einschränkungen

  • Der thumbnail-Parameter ist nur für Link-Beiträge auf Facebook-Seiten verfügbar.
  • Der thumbnail-Parameter hat Vorrang vor dem picture-Parameter. Werden beide angegeben, wird der picture-Parameter nicht genutzt.
  • Der thumbnail-Parameter nimmt Bilder mit der Erweiterung .jpg.jpeg.gif oder .png an.
  • Der thumbnail-Parameter wird in Batch-Anfragen nicht unterstützt.

Posten eines Links auf einer Seite

Poste einen Link auf einer Seite, indem du eine POST-Anfrage an die /page/feed-Edge sendest. Lege für den publish-Parameter 1 fest, um den Beitrag sofort zu veröffentlichen, oder 0, um einen unveröffentlichten Beitrag zu erstellen, der zu einem späteren Zeitpunkt veröffentlicht werden soll.

Beispielanfrage

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();

Beispielantwort

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

Link-Seitenbeitrag mit Call to Action

Im Feld call_to_action werden die dazugehörige Handlung und der entsprechende Link angegeben. Der Link muss mit dem link-Parameter des Seitenbeitrags identisch sein. In diesem Aufruf sind title, description, caption und picture optional. Erfolgt keine Angabe, liest Facebook die entsprechenden Eigenschaften aus den Open Graph-Metadaten des Links. Enthält die verknüpfte Webseite keine Open Graph-Metadaten, versucht Facebook diese Eigenschaften durch Scraping des Webseiteninhalts zu erraten.

Beispielanfrage

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();

Beispielantwort

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

Link-Beitrag mit benutzerdefiniertem hochgeladenem Bild

Verwenden einer lokalen Datei:

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

Rückgabewert

{"id":"post-id"}

Verwenden eines Bilds über 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

Rückgabewert

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

Foto-Seitenbeitrag

Besuche unsere Foto-Node-Referenz, um weitere Informationen zu erhalten.

Video-Seitenbeitrag

Besuche unsere Seiten-Video-Referenz, um weitere Informationen zu erhalten.

Seitenbeitrags-Insights

Besuche unsere Seitenbeitrags-Insights-Referenz, um weitere Informationen zu erhalten.

Aktualisieren

Du kannst mit dieser Edge nicht aktualisieren, aber du kannst Beiträge mit Hilfe des Nodes //{post-id} aktualisieren.

Löschen

Du kannst mit dieser Edge nicht löschen, aber du kannst Beiträge mit Hilfe des Nodes //{post-id} löschen.