Phiên bản API Đồ thị

`/{object-id}/likes`

Tài liệu tham khảo này mô tả cạnh /likes được dùng phổ biến cho nhiều nút API Đồ thị. Cấu trúc và hoạt động của mỗi nút đều như nhau. Dưới đây là các đối tượng có cạnh /likes:

Đọc

Trả về danh sách những người đã thích đối tượng này. Khi đọc lượt thích trên một đối tượng Trang hoặc Người dùng, điểm cuối này sẽ trả về danh sách những trang mà Trang hoặc Người dùng đó đã thích.

Hãy sử dụng trường likes của một đối tượng để lấy số lượt thích.

Bạn nên sử dụng điểm cuối /object/reactions để lấy số lượt thích (nếu có).

Trải nghiệm Trang mới

Trải nghiệm Trang mới hỗ trợ điểm cuối /likes của các đối tượng sau:

Người dùng

Yêu cầu

Để xem lượt thích trên đối tượng, bạn cần phải đáp ứng các yêu cầu như khi xem đối tượng đó.

Các giới hạn

Lượt thích Bài viết chỉ có số liệu tổng hợp dùng total_count với thông số summary.
Số lượt bày tỏ cảm xúc like bao gồm cả cảm xúc "thích" lẫn cảm xúc "thương thương".
total_count biểu thị số lượt thích ước tính. Tuy nhiên, con số thực tế được trả về có thể khác tùy theo cài đặt quyền riêng tư.
Các điểm cuối GET /{group-post-id}/likes và GET /{post-id}/likes sẽ ngừng hoạt động trong phiên bản 8.0 trở lên và sẽ không còn được dùng trong tất cả các phiên bản kể từ ngày 02/11/2020.

Trường

Tên thuộc tính	Mô tả	Loại
`total_count`	Tổng số lượt thích của Người dùng và Trang trên đối tượng đó. Để trường này được trả về, bạn phải thêm thông số và giá trị `summary=true` vào yêu cầu của mình.	`int32`

Ví dụ về cách sử dụng

Yêu cầu mẫu

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

Phản hồi mẫu

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

Đăng

Thích một đối tượng.

Trải nghiệm Trang mới

Trải nghiệm Trang mới hỗ trợ điểm cuối /likes của các đối tượng sau:

Album
Bình luận
Bài viết trên Trang

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

Quyền

Mã truy cập Trang mà một người yêu cầu. Người này có thể thực hiện tác vụ CREATE_CONTENT trên Trang đó
Quyền pages_manage_engagement

Các giới hạn

Trang cũng phải có khả năng thích đối tượng đó (dù qua API hay trên Facebook.com).
Trang phải chưa thích đối tượng đó.
Nếu Trang đã bày tỏ cảm xúc về một đối tượng (wow, buồn), lượt thích sẽ thành công nhưng cảm xúc đó sẽ không thay đổi.
Không hỗ trợ thao tác thích bài đánh giá về Trang.

Trường

Không cần trường nào để thêm lượt thích.

Phản hồi

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi sau đây:

{
  "success": true
}

Cập nhật

Bạn không thể thực hiện thao tác này trên điểm cuối này.

Xóa

Xóa lượt thích trên các đối tượng Trang bằng điểm cuối này.

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

Quyền

Mã truy cập Trang mà một người yêu cầu. Người này có thể thực hiện tác vụ MODERATE trên Trang đó
Quyền pages_manage_engagement

Các giới hạn

Người dùng hoặc Trang chỉ có thể xóa likes của chính mình.
Đối tượng phải nhận được lượt thích.
Không hỗ trợ thao tác xóa lượt thích bài đánh giá về Trang.

Trường

Không có trường nào cho điểm cuối này.

Phản hồi

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi sau đây:

{
  "success": true
}