API Đồ thị
Phiên bản API Đồ thị

Lượt bày tỏ cảm xúc với đối tượng

Tài liệu tham khảo này mô tả cạnh /reactions đượ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. Các đối tượng sau có cạnh /reactions:

Đọc

Lấy lượt bày tỏ cảm xúc với một đối tượng.

Xem Thông tin chi tiết để biết thêm thông tin về lượt bày tỏ cảm xúc với bài viết hoặc trên Trang.

Trải nghiệm Trang mới

Điểm cuối này được hỗ trợ cho Trải nghiệm Trang mới.

Yêu cầu

Ứng dụng marketing

  • ads_management
  • pages_read_engagement
  • pages_show_list

Ứng dụng quản lý Trang

  • pages_show_list

Ví dụ về yêu cầu

Sau đây là ví dụ về yêu cầu GET của Người dùng đã bày tỏ cảm xúc với đối tượng của chính họ.

curl -i -X GET \
 "https://graph.facebook.com/your-post-id/reactions?access_token=your-user-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-post-id/reactions",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-post-id/reactions"
           parameters:nil
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-post-id/reactions',
  'GET',
  {},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-post-id/reactions',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Phản hồi JSON

{ "data": [ { "id": "your-user-id", "name": "Your Name", "type": "HAHA" } ], "paging": { "cursors": { "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR", "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD" } } }

Nếu Người dùng hoặc Trang chưa bày tỏ cảm xúc với đối tượng đang được truy vấn, data sẽ trống.

Sau đây là ví dụ về yêu cầu GET để biết tổng lượt bày tỏ cảm xúc với một đối tượng.

curl -i -X GET \
 "https://graph.facebook.com/your-post-id
   ?fields=reactions.summary(total_count)
   &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-post-id",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-post-id"
           parameters:@{ @"fields": @"reactions.summary(total_count)",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-post-id',
  'GET',
  {"fields":"reactions.summary(total_count)"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-post-id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Phản hồi JSON nếu Người dùng hoặc Trang đã bày tỏ cảm xúc với đối tượng của chính họ.

{ "reactions": { "data": [ { "id": "your-user-id", "name": "Your Name", "type": "HAHA" } ], "paging": { "cursors": { "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR", "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD" } }, "summary": { "total_count": 28 } }, "id": "your-post-id" }

Phản hồi JSON nếu Người dùng hoặc Trang chưa bày tỏ cảm xúc với đối tượng của chính họ.

{ "reactions": { "data": [ ], "paging": { "cursors": { "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR", "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD" } }, "summary": { "total_count": 28 } }, "id": "your-post-id" }

Người dùng hoặc Trang chỉ có thể truy vấn lượt bày tỏ cảm xúc của chính mình. Họ không thể truy vấn lượt bày tỏ cảm xúc của Người dùng hoặc Trang khác để đảm bảo quyền riêng tư.

Số lượt bày tỏ cảm xúc "thích" bao gồm cả lượt "thích" lẫn lượt "thương thương".

Thông số

TênMô tả

type

liệt kê {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

Loại lượt bày tỏ cảm xúc của Trang hoặc Người dùng đối với một đối tượng.

Trường thông tin

Khi đọc cạnh này, bạn sẽ nhận được kết quả ở định dạng JSON

{ "data": [], "paging": {}, "summary": {} }

data

Trang cá nhân của Trang hoặc Người dùng chạy truy vấn (nếu Trang hoặc Người dùng bày tỏ cảm xúc với đối tượng được truy vấn) và danh sách các loại lượt bày tỏ cảm xúc:

Trường thông tinMô tả

type

liệt kê {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

Loại lượt bày tỏ cảm xúc của Trang hoặc Người dùng đối với một đối tượng.

Đối với lượt bày tỏ cảm xúc với Bài viết, trong trường hợp đọc bằng mã truy cập người dùng, cạnh này chỉ trả về Trang cá nhân của người dùng hiện tại.

Xem số lượt của từng loại hành động bày tỏ cảm xúc

curl -i -X GET \
 "https://graph.facebook.com/your-object-id
   ?fields=reactions.type(LOVE).limit(0).summary(total_count)
   &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-object-id",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.type(LOVE).limit(0).summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-object-id"
           parameters:@{ @"fields": @"reactions.type(LOVE).limit(0).summary(total_count)",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-object-id',
  'GET',
  {"fields":"reactions.type(LOVE).limit(0).summary(total_count)"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-object-id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Ví dụ về phản hồi JSON

{ "reactions": { "data": [ ], "summary": { "total_count": 3498 } }, "id": "your-object-id" }

paging

Để biết thêm thông tin chi tiết về cách phân trang, hãy xem tài liệu về cách phân trang của API Đồ thị. Nếu bạn thêm limit(0) vào reactions, kết quả sẽ không được paging.

summary

Thông tin tổng hợp về cạnh, chẳng hạn như số lượng. Chỉ định các trường thông tin cần tìm nạp trong thông số tóm tắt (chẳng hạn như summary=total_count).

Trường thông tinMô tả

total_count

int32 không có chữ ký

Tổng số lượt bày tỏ cảm xúc

viewer_reaction

liệt kê {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

Loại lượt bày tỏ cảm xúc của Trang hoặc Người dùng đối với một đối tượng.

Mã lỗi

LỗiMô tả

100

Thông số không hợp lệ

Tạo

Hoạt động này không được hỗ trợ.

Cập nhật

Hoạt động này không được hỗ trợ.

Xóa

Hoạt động này không được hỗ trợ.