/{object-id}/likes

Diese Referenz beschreibt die /likes-Edge, über die mehrere Graph API Nodes verfügen. Die Struktur und die Vorgänge sind für jeden Node gleich. Die folgenden Objekte verfügen über eine /likes-Edge:

Lesen

Gibt eine Liste der Personen wieder, die dieses Objekt mit „Gefällt mir“ markiert haben. Beim Lesen von „Gefällt mir“-Angaben auf einer Seite oder zu einem Nutzerobjekt gibt dieser Endpunkt eine Liste der Seiten zurück, die von dieser Seite oder diesem Nutzer mit „Gefällt mir“ markiert wurden.

Verwende das Feld likes eines Objekts, um die Anzahl der „Gefällt mir“-Angaben abzurufen.

Neue Seitenversion

Folgende Objekte für /likes-Endpunkte werden für die neue Seitenversion unterstützt:

Anforderungen

• Dieselben Anforderungen, die zur Anzeige des Objekts erforderlich sind, sind auch für die Anzeige von „Gefällt mir“-Angaben für dieses Objekt erforderlich.

Einschränkungen

• Für „Gefällt mir“-Angaben für Beiträge sind nur aggregierte Anzahlen mit total_count mit dem summary-Parameter verfügbar.
• In den like-Reaktionszahlen sind sowohl „Gefällt mir“- als auch „Wichtig“-Reaktionen enthalten.
• total_count stellt die ungefähre Anzahl an „Gefällt mir“-Angaben dar, die tatsächliche Anzahl der zurückgegebenen Ergebnisse fällt je nach Privatsphäre-Einstellungen möglicherweise anders aus.
• Die Endpunkte GET /{group-post-id}/likes und GET /{post-id}/likes sind ab v8.0 und in allen Versionen ab 2. November 2020 veraltet.

Felder

Verwendungsbeispiel

curl -i -X GET "https://graph.facebook.com/{object-id}
  ?fields=likes.summary(true)
  &access_token={access-token}"

Beispielantwort

  {
  "likes": {
    "data": [
      {
        "name": "Bill the Cat",
        "id": "155111347875779",
        "created_time": "2017-06-18T18:21:04+0000"
      },
      {
        "name": "Calvin and Hobbes",
        "id": "257573197608192",
        "created_time": "2017-06-18T18:21:02+0000"
      },
      {
        "name": "Berkeley Breathed's Bloom County",
        "id": "108793262484769",
        "created_time": "2017-06-18T18:20:58+0000"
      }
    ],
    "paging": {
      "cursors": {
        "before": "Nzc0Njg0MTQ3OAZDZD",
        "after": "NTcxODc1ODk2NgZDZD"
      },
      "next": "https://graph.facebook.com/vX.X/me/likes?access_token=user-access-token&pretty=0&summary=true&limit=25&after=NTcxODc1ODk2NgZDZD"
    },
    "summary": {
      "total_count": 136
    }
  },
  "id": "user-id"
}

Veröffentlichen

Objekt mit „Gefällt mir“ markieren.

Neue Seitenversion

Folgende Objekte für /likes-Endpunkte werden für die neue Seitenversion unterstützt:

POST /v19.0/{object-id}/likes HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{object-id}/likes',
    array (),
    '{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(
    "/{object-id}/likes",
    "POST",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

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

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

Berechtigungen

• Einen Seiten-Zugriffsschlüssel, der von einer Person angefordert wurde, die auf der Seite die CREATE_CONTENT-Aufgabe ausführen kann.
• Die pages_manage_engagement-Berechtigung

Einschränkungen

• Die Seite muss auch das Objekt mit „Gefällt mir“ markieren können (über API oder auf Facebook.com).
• Das Objekt muss von der Seite nicht bereits mit „Gefällt mir“ markiert sein.
• Hat die Seite bereits auf ein Objekt reagiert (Wow, traurig), ist die „Gefällt mir“ Angabe erfolgreich, aber die Reaktion ändert sich nicht.
• Eine Seitenbewertung kann nicht mit „Gefällt mir“ markiert werden.

Felder

Zum Hinzufügen von „Gefällt mir“-Angaben sind keine Felder erforderlich.

Antwort

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese Antwort:

{
  "success": true
}

Aktualisieren

Diesen Vorgang kannst du nicht für diesen Endpunkt ausführen.

Löschen

Lösche „Gefällt mir“-Angaben für Seitenobjekte mit diesem Endpunkt.

DELETE /v19.0/{object-id}/likes HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->delete(
    '/{object-id}/likes',
    array (),
    '{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(
    "/{object-id}/likes",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

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

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

Berechtigungen

• Einen Seiten-Zugriffsschlüssel, der von einer Person angefordert wurde, die auf der Seite die MODERATE-Aufgabe ausführen kann.
• Die pages_manage_engagement-Berechtigung

Einschränkungen

• Ein Nutzer oder eine Seite kann nur die eigenen likes löschen.
• Das Objekt muss bereits mit „Gefällt mir“ markiert sein.
• Eine Seitenbewertung kann nicht gelöscht werden.

Felder

Für diesen Endpunkt sind keine Felder vorhanden.

Antwort

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese Antwort:

{
  "success": true
}