/{object-id}/likes

Esta referência descreve a borda /likes que é comum em vários nós da Graph API. A estrutura e as operações são as mesmas em todos os nós. Os seguintes objetos têm uma borda /likes:

Leitura

Retorna a lista de pessoas que curtiram o objeto. Ao ler curtidas em um objeto Página ou Usuário, o ponto de extremidade retorna uma lista de páginas curtidas por essa Página ou esse Usuário.

Use o campo likes de um objeto para obter o número de curtidas.

Nova experiência de Página

Os seguintes objetos do ponto de extremidade /likes são compatíveis com a nova experiência de Página:

Requisitos

• Os mesmos requisitos exigidos para visualizar o objeto são necessários para a visualização de curtidas nesse objeto.

Limitações

• Somente contagens agregadas que usam total_count com o parâmetro summary estão disponíveis para curtidas em publicações.
• A contagem da reação like inclui as reações "Curtir" e "Força".
• total_count representa o número aproximado de curtidas, mas o número real retornado pode ser diferente, dependendo das configurações de privacidade.
• Os pontos de extremidade GET /{group-post-id}/likes e GET /{post-id}/likes foram descontinuados na versão 8.0 e posteriores. Além disso, o uso desses pontos será suspenso em todas as versões em 2 de novembro de 2020.

Campos

Exemplo de uso

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

Exemplo de resposta

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

Publicar

É a curtida em um objeto.

Nova experiência de Página

Os seguintes objetos do ponto de extremidade /likes são compatíveis com a nova experiência de Página:

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

Permissões

• Um token de acesso à Página solicitado por uma pessoa que pode executar a tarefa CREATE_CONTENT na Página
• A permissão pages_manage_engagement

Limitações

• A Página também pode curtir o objeto (seja pela API ou pelo site Facebook.com).
• A Página não pode ter curtido o objeto anteriormente.
• Se a Página já tiver reagido a um objeto (Uau, Triste), uma curtida será bem-sucedida, mas a reação não será alterada.
• Não há compatibilidade com curtidas na avaliação da Página.

Campos

Nenhum campo é necessário para adicionar curtidas.

Resposta

Se o processo for bem-sucedido, o aplicativo receberá a seguinte resposta:

{
  "success": true
}

Atualização

Não é possível executar essa operação no ponto de extremidade.

Excluir

Exclua curtidas em objetos Página usando esse ponto de extremidade.

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

Permissões

• Um token de acesso à Página solicitado por uma pessoa que pode executar a tarefa MODERATE na Página
• A permissão pages_manage_engagement

Limitações

• Os Usuários e as Páginas só podem excluir as próprias likes.
• O objeto precisa já ter sido curtido.
• Não há compatibilidade com a exclusão de curtidas na avaliação da Página.

Campos

Não há campos para esse ponto de extremidade.

Resposta

Se o processo for bem-sucedido, o aplicativo receberá a seguinte resposta:

{
  "success": true
}