/{object-id}/likes

Questo riferimento descrive il segmento /likes comune a più nodi dell'API Graph. La struttura e le operazioni sono le stesse per ogni nodo. I seguenti oggetti hanno un segmento /likes:

Lettura

Restituisce la lista di persone che hanno messo "Mi piace" a questo oggetto. Durante la lettura dei Mi piace su un oggetto Page o User, questo endpoint restituisce una lista delle Pagine a cui quella Pagina o quell'utente ha messo "Mi piace".

Usa il campo likes di un oggetto per conoscere il numero di Mi piace.

Nuova esperienza della Pagina

La nuova esperienza della Pagina supporta gli endpoint /likes per i seguenti oggetti:

Requisiti

• Gli stessi requisiti richiesti per visualizzare l'oggetto sono richiesti per visualizzare i Mi piace su quell'oggetto.

Limitazioni

• Per i Mi piace ai post sono disponibili solo i conteggi aggregati utilizzando total_count con il parametro summary.
• I conteggi delle reazioni like includono sia le reazioni "Mi piace" che le reazioni "abbraccio".
• total_count rappresenta il numero approssimativo di Mi piace; tuttavia, il numero effettivo restituito potrebbe essere diverso a seconda delle impostazioni sulla privacy.
• Gli endpoint GET /{group-post-id}/likes e GET /{post-id}/likes sono stati rimossi nella v8.0+ e lo saranno in tutte le versioni il 2 novembre 2020.

Campi

Esempio d'uso

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

Esempio di risposta

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

Pubblicazione

Come un oggetto.

Nuova esperienza della Pagina

La nuova esperienza della Pagina supporta gli endpoint /likes per i seguenti oggetti:

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

Autorizzazioni

• Token d'accesso della Pagina richiesto da un utente che può eseguire l'attività CREATE_CONTENT sulla Pagina
• Autorizzazione pages_manage_engagement

Limitazioni

• La Pagina deve anche poter mettere Mi piace all'oggetto (tramite API o su Facebook.com).
• La Pagina non deve aver messo già Mi piace all'oggetto.
• Se la pagina ha già reagito a un oggetto (Wow, Sigh), allora sarà possibile mettere "Mi piace", ma la reazione non cambierà.
• Il Mi piace alla recensione di una Pagina non è supportato.

Campi

Non sono necessari campi per aggiungere Mi piace.

Risposta

In caso di azione eseguita correttamente, l'app riceve la seguente risposta:

{
  "success": true
}

Aggiornamento

Non puoi eseguire questa operazione su questo endpoint.

Eliminazione

Elimina i Mi piace sugli oggetti Pagina usando questo endpoint.

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

Autorizzazioni

• Token d'accesso alla Pagina richiesto da un utente che può eseguire attività MODERATE sulla Pagina
• Autorizzazione pages_manage_engagement

Limitazioni

• Un utente o una Pagina può eliminare solo i propri likes.
• All'oggetto deve essere già stato messo Mi piace.
• L'eliminazione del Mi piace alla recensione di una Pagina non è supportata.

Campi

Non ci sono campi per questo endpoint.

Risposta

In caso di azione eseguita correttamente, l'app riceve la seguente risposta:

{
  "success": true
}