Graph API
Graph API-Version

Objektreaktionen

In dieser Referenz wird die /reactions-Edge beschrieben, die mehrere Graph API-Nodes gemeinsam haben. Die Struktur und die Vorgänge sind für jeden Node gleich. Die folgenden Objekte verfügen über eine /reactions-Edge:

Lesen

Reaktionen zu einem Objekt erhalten

Zeige Insights an, um weitere Informationen zu Seiten- oder Beitragsreaktionen zu erhalten.

Neue Seitenversion

Dieser Endpunkt wird für die neue Seitenversion unterstützt.

Anforderungen

Marketing-Apps

  • ads_management
  • pages_read_engagement
  • pages_show_list

Seitenverwaltungs-Apps

  • pages_show_list

Beispielanfrage

Es folgt ein Beispiel für eine GET-Anfrage, die von einem Nutzer gestellt wird, der auf sein eigenes Objekt reagiert hat.

curl -i -X GET \
 "https://graph.facebook.com/your-post-id/reactions?access_token=your-user-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-post-id/reactions",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-post-id/reactions"
           parameters:nil
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-post-id/reactions',
  'GET',
  {},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-post-id/reactions',
    '{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();

Die JSON-Antwort

{ "data": [ { "id": "your-user-id", "name": "Your Name", "type": "HAHA" } ], "paging": { "cursors": { "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR", "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD" } } }

Wenn der Nutzer oder die Seite nicht auf das abgefragte Objekt reagiert hat, ist data leer.

Es folgt ein Beispiel für eine GET-Anfrage für die Gesamtreaktionen auf ein Objekt.

curl -i -X GET \
 "https://graph.facebook.com/your-post-id
   ?fields=reactions.summary(total_count)
   &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-post-id",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-post-id"
           parameters:@{ @"fields": @"reactions.summary(total_count)",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-post-id',
  'GET',
  {"fields":"reactions.summary(total_count)"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-post-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();

Die JSON-Antwort, wenn der Nutzer oder die Seite auf das eigene Objekt reagiert hat.

{ "reactions": { "data": [ { "id": "your-user-id", "name": "Your Name", "type": "HAHA" } ], "paging": { "cursors": { "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR", "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD" } }, "summary": { "total_count": 28 } }, "id": "your-post-id" }

Die JSON-Antwort, wenn der Nutzer oder die Seite nicht auf das eigene Objekt reagiert hat.

{ "reactions": { "data": [ ], "paging": { "cursors": { "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR", "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD" } }, "summary": { "total_count": 28 } }, "id": "your-post-id" }

Ein Nutzer oder eine Seite kann nur die eigenen Reaktionen abfragen. Aus Datenschutzgründen sind die Reaktionen anderer Nutzer oder Seiten nicht verfügbar.

In den „Gefällt mir“-Reaktionszahlen sind sowohl „Gefällt mir“- als auch „Wichtig“-Reaktionen enthalten.

Parameter

NameBeschreibung

type

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

Die Art von Reaktion, mit der eine Seite oder ein Nutzer ein Objekt gekennzeichnet hat

Felder

Beim Lesen von dieser Edge wird ein mit JSON formatiertes Ergebnis zurückgegeben.

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

data

Das Profil der Seite oder des Nutzers, die bzw. der die Abfrage ausführt, wenn die Seite oder der Benutzer auf das abgefragte Objekt reagiert haben, und eine Liste von Reaktionsarten:

FeldBeschreibung

type

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

Die Art von Reaktion, mit der eine Seite oder ein Nutzer ein Objekt gekennzeichnet hat

Für Reaktionen auf Beiträge muss diese Edge nur dann ein Profil für den aktuellen Benutzer zurückgeben, wenn zum Lesen ein Nutzer-Zugriffsschlüssel verwendet wurde.

Die Anzahl einzelner Reaktionen anzeigen

curl -i -X GET \
 "https://graph.facebook.com/your-object-id
   ?fields=reactions.type(LOVE).limit(0).summary(total_count)
   &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-object-id",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.type(LOVE).limit(0).summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-object-id"
           parameters:@{ @"fields": @"reactions.type(LOVE).limit(0).summary(total_count)",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-object-id',
  'GET',
  {"fields":"reactions.type(LOVE).limit(0).summary(total_count)"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-object-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();

JSON-Beispielantwort

{ "reactions": { "data": [ ], "summary": { "total_count": 3498 } }, "id": "your-object-id" }

paging

Weitere Informationen zu Paginierung findest du in der Paging-Dokumentation zur Graph API. Wenn limit(0) zu reactions hinzugefügt wird, wird paging aus der Ausgabe entfernt.

summary

Aggregierte Informationen zur Edge, etwa Anzahlen. Gibt die Felder an, die im Summary-Parameter abgerufen werden sollen (etwa summary=total_count).

FeldBeschreibung

total_count

nicht signierte int32

Gesamtanzahl der Reaktionen

viewer_reaction

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

Die Art von Reaktion, mit der eine Seite oder ein Nutzer ein Objekt gekennzeichnet hat

Fehlercodes

FehlerBeschreibung

100

Ungültiger Parameter

Erstellen

Dieser Vorgang wird nicht unterstützt.

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.