API กราฟ
เวอร์ชันของ API กราฟ

ความรู้สึกที่มีต่ออ็อบเจ็กต์

ข้อมูลอ้างอิงนี้จะอธิบายจุดเชื่อมโยง /reactions ซึ่งพบได้บ่อยในโหนด API กราฟหลายโหนด โดยโครงสร้างและการดำเนินการของแต่ละโหนดจะเป็นแบบเดียวกัน อ็อบเจ็กต์ต่อไปนี้มีจุดเชื่อมโยง /reactions:

การอ่าน

รับความรู้สึกเกี่ยวกับอ็อบเจ็กต์

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับความรู้สึกต่อเพจและโพสต์ที่ข้อมูลเชิงลึก

ประสบการณ์การใช้งานเพจแบบใหม่

ระบบรองรับตำแหน่งข้อมูลนี้สำหรับประสบการณ์การใช้งานเพจแบบใหม่

ข้อกำหนด

แอพการตลาด

  • ads_management
  • pages_read_engagement
  • pages_show_list

แอพการจัดการเพจ

  • pages_show_list

ตัวอย่างคำขอ

ตัวอย่างต่อไปนี้เป็นคำขอ GET จากผู้ใช้ที่ได้แสดงความรู้สึกต่ออ็อบเจ็กต์ของตนเอง

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();

การตอบกลับแบบ JSON

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

หากผู้ใช้หรือเพจไม่ได้แสดงความรู้สึกต่ออ็อบเจ็กต์ที่มีการสืบค้น data จะว่างเปล่า

ตัวอย่างต่อไปนี้เป็นคำขอ GET สำหรับความรู้สึกทั้งหมดที่มีต่ออ็อบเจ็กต์

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();

การตอบกลับแบบ JSON หากผู้ใช้หรือเพจแสดงความรู้สึกต่ออ็อบเจ็กต์ของตน

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

การตอบกลับแบบ JSON หากผู้ใช้หรือเพจไม่ได้แสดงความรู้สึกต่ออ็อบเจ็กต์ของตน

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

ผู้ใช้หรือเพจสามารถสืบค้นได้เฉพาะความรู้สึกของตนเองเท่านั้น โดยจะไม่สามารถสืบค้นความรู้สึกของผู้ใช้หรือเพจอื่นๆ ได้เนื่องจากเหตุผลด้านความเป็นส่วนตัว

จำนวนความรู้สึก "ถูกใจ" จะรวมทั้งความรู้สึก "ถูกใจ" และ "ห่วงใย"

พารามิเตอร์

ชื่อคำอธิบาย

type

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

ประเภทความรู้สึกที่เพจหรือผู้ใช้แสดงต่ออ็อบเจ็กต์

ช่อง

การอ่านจากจุดเชื่อมโยงนี้จะส่งคืนผลลัพธ์ในรูปแบบ JSON

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

data

โปรไฟล์ของเพจหรือผู้ใช้ที่ทำการสืบค้น (หากเพจหรือผู้ใช้ได้แสดงความรู้สึกต่ออ็อบเจ็กต์ที่ถูกสืบค้น) และรายการประเภทความรู้สึก:

ช่องคำอธิบาย

type

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

ประเภทความรู้สึกที่เพจหรือผู้ใช้แสดงต่ออ็อบเจ็กต์

สำหรับความรู้สึกต่อโพสต์ จุดเชื่อมโยงนี้จะไม่ส่งคืนโปรไฟล์ยกเว้นผู้ใช้ปัจจุบัน หากอ่านด้วยโทเค็นการเข้าถึงผู้ใช้

ดูจำนวนความรู้สึกแต่ละรายการ

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();

ตัวอย่าง JSON ที่ส่งคืนมา

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

paging

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับการแบ่งหน้าที่เอกสารประกอบเกี่ยวกับการแบ่งหน้าของ API กราฟ การเพิ่ม limit(0) ไปยัง reactions จะเป็นการนำ paging ออกจากเอาต์พุต

summary

ข้อมูลแบบผลรวมเกี่ยวกับจุดเชื่อมโยงนั้นๆ เช่น จำนวน ระบุช่องเพื่อดึงข้อมูลในพารามิเตอร์การสรุป (เช่น summary=total_count)

ช่องคำอธิบาย

total_count

int32 ที่ไม่มีเครื่องหมายกำกับ

จำนวนความรู้สึกทั้งหมด

viewer_reaction

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

ประเภทความรู้สึกที่เพจหรือผู้ใช้แสดงต่ออ็อบเจ็กต์

รหัสข้อผิดพลาด

ข้อผิดพลาดคำอธิบาย

100

พารามิเตอร์ไม่ถูกต้อง

การสร้าง

ไม่รองรับการดำเนินการนี้

การอัพเดต

ไม่รองรับการดำเนินการนี้

การลบ

ระบบไม่สนับสนุนการดำเนินการนี้