Version API du graphe

`/{object-id}/likes`

Cette référence décrit l’arête /likes qui est commune à plusieurs nœuds de l’API Graph. La structure et les opérations sont similaires pour chaque nœud. Les objets suivants possèdent une arête /likes :

Lecture

Renvoie la liste des personnes qui ont aimé cet objet. Lorsque vous lisez les mentions « J’aime » sur un objet Page ou Utilisateur, ce point de terminaison renvoie une liste des pages aimées par cette Page ou cet Utilisateur.

Utilisez le champ likes d’un objet pour obtenir le nombre de mentions « J’aime ».

Nous vous recommandons d’utiliser le point de terminaison /object/reactions pour récupérer le nombre de mentions « J’aime », si disponible.

Nouvelle expérience de Page

La nouvelle version des Pages accepte les objets suivants pour le point de terminaison /likes :

Utilisateur

Conditions requises

Les conditions requises pour visualiser l’objet lui-même sont nécessaires pour visualiser les mentions « J’aime » de cet objet.

Limitations

Seuls les comptages globaux utilisant total_count avec le paramètre summary sont disponibles pour les mentions « J’aime » de publication.
Le nombre de réactions like inclut à la fois les réactions « J’aime » et « Solidaire ».
total_count représente le nombre approximatif de mentions « J’aime », cependant, le nombre réel renvoyé peut être différent en fonction des paramètres de confidentialité.
Les points de terminaison GET /{group-post-id}/likes et GET /{post-id}/likes sont obsolètes dans les versions v8.0 et ultérieures, ainsi que dans toutes les versions depuis le 2 novembre 2020.

Champs

Nom de propriété	Description	Type
`total_count`	Nombre total de mentions « J’aime la Page » émanant d’utilisateurs ou de pages sur l’objet. Pour obtenir la valeur de retour de ce champ, vous devez inclure le paramètre et la valeur `summary=true` dans votre requête.	`int32`

Exemple d’utilisation

Exemple de requête

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

Exemple de réponse

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

Publication

Ajout d’une mention J’aime sur un objet.

Nouvelle expérience de Page

La nouvelle version des Pages accepte les objets suivants pour le point de terminaison /likes :

Album
Commentaire
Publication de Page

POST /v25.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
}];

Autorisations

Token d’accès de Page demandé par une personne autorisée à effectuer la tâche CREATE_CONTENT sur la Page
Autorisation pages_manage_engagement

Limitations

La Page doit également pouvoir aimer l’objet (que ce soit via API ou sur Facebook.com).
La page ne doit pas avoir appliqué de mention « J’aime » à l’objet.
Si la Page a déjà réagi à un objet (étonnement, tristesse), une mention « J’aime » aboutira, mais la réaction ne changera pas.
L’attribution de mentions « J’aime » n’est pas possible sur un passage en revue de Page.

Champs

Aucun champ n’est obligatoire pour l’ajout de mentions « J’aime ».

Réponse

En cas de réussite, votre application reçoit la réponse suivante :

{
  "success": true
}

Mise à jour

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

Suppression

Supprimez les mentions « J’aime » sur les objets Page utilisant ce point de terminaison.

DELETE /v25.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
}];

Autorisations

Token d’accès de Page demandé par une personne autorisée à effectuer la tâche MODERATE sur la Page
Autorisation pages_manage_engagement

Limitations

Un Utilisateur ou une Page peut supprimer ses propres likes uniquement.
Une ou plusieurs mentions « J’aime » doivent avoir été appliquées à l’objet.
La suppression de mentions « J’aime » n’est pas possible sur un passage en revue de Page.

Champs

Il n’existe pas de champs pour ce point de terminaison.

Réponse

En cas de réussite, votre application reçoit la réponse suivante :

{
  "success": true
}