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

กลุ่ม

กลุ่ม Facebook

การอ่าน

ส่งกลับข้อมูลเกี่ยวกับอ็อบเจ็กต์ของกลุ่มเดี่ยว หากต้องการรับรายชื่อกลุ่มผู้ดูแลผู้ใช้ ให้ใช้จุดเชื่อมโยง /user/groups แทน

Graph API Explorer
GET /v19.0/{group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}',
    '{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(
    "/{group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

สิทธิ์การอนุญาต

  • groups_access_member_info - เพื่อให้แอพได้รับข้อมูลสมาชิกที่เนื้อหาของกลุ่ม
  • publish_to_groups - เพื่อให้แอพโพสต์เนื้อหาลงในกลุ่มในนามของผู้ใช้

สำหรับกลุ่มสาธารณะและกลุ่มปิด

โทเค็นการเข้าถึงของผู้ใช้

สำหรับกลุ่มลับ

โทเค็นการเข้าถึงของผู้ใช้สำหรับผู้ดูแลกลุ่ม

คำเตือน

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

ช่องกรอกข้อมูล

ชื่อคุณสมบัติ คำอธิบาย ประเภท

id

ID กลุ่ม

string

cover

ข้อมูลเกี่ยวกับรูปภาพหน้าปกของกลุ่ม

CoverPhoto

id

ID ของรูปภาพที่แสดงรูปภาพหน้าปกนี้

string

source

URL ไปยังรูปภาพที่แสดงรูปภาพหน้าปกนี้

string

offset_y

การชดเชยแบบแนวตั้งในหน่วยพิกเซลของรูปภาพจากด้านล่าง

int

offset_x

การชดเชยแบบแนวนอนในหน่วยพิกเซลของรูปภาพจากด้านซ้าย

int

description

คำอธิบายสั้นๆ เกี่ยวกับกลุ่ม

string

email

ที่อยู่อีเมลเพื่ออัพโหลดเนื้อหาลงในกลุ่ม สามารถใช้ได้เฉพาะสมาชิกปัจจุบันของกลุ่มเท่านั้น

string

icon

URL สำหรับไอคอนของกลุ่ม

string

member_count

จำนวนสมาชิกในกลุ่ม

int

member_request_count

จำนวนคำขอเป็นสมาชิกที่ค้างอยู่ ต้องใช้โทเค็นการเข้าถึงของผู้ดูแล Group.we โดยจะส่งคืนจำนวนคำขอเป็นสมาชิกเมื่อมีจำนวนที่ค้างอยู่มากกว่า 50 คำขอเท่านั้น

int

name

ชื่อกลุ่ม

string

owner

เลิกใช้ในเวอร์ชั่น 9.0 ขึ้นไป จะเลิกใช้กับทุกเวอร์ชั่นในวันที่ 9 กุมภาพันธ์ 2021

User | Page

parent

พาเรนต์ของกลุ่มนี้ หากมี

Group | Page

permissions

สิทธิ์การอนุญาตที่ผู้ใช้ได้รับสำหรับแอพที่ติดตั้งในกลุ่ม

string

privacy

การตั้งค่าความเป็นส่วนตัวของกลุ่ม ค่าที่เป็นไปได้คือ CLOSED, OPEN และ SECRET ต้องใช้โทเค็นการเข้าถึงของผู้ดูแลกลุ่ม

string

updated_time

ครั้งล่าสุดที่อัพเดตกลุ่ม (รวมถึงการเปลี่ยนคุณสมบัติของกลุ่ม โพสต์ และการแสดงความคิดเห็น) ต้องใช้โทเค็นการเข้าถึงของผู้ดูแลกลุ่ม

datetime

การสร้าง

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

การอัพเดต

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

การลบ

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

จุดเชื่อมโยง

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

/admins

จุดเชื่อมโยงนี้ถูกเลิกใช้เมื่อวันที่ 4 เมษายน 2018

/albums

อัลบั้มรูปภาพที่เป็นของกลุ่ม

/docs

เอกสารที่เป็นของกลุ่ม

/events

งานกิจกรรมที่เป็นของกลุ่ม

/feed

ฟีดของโพสต์ที่เป็นของกลุ่ม

/files

ไฟล์ที่เป็นของกลุ่ม

/live_videos

วิดีโอถ่ายทอดสดที่เป็นของกลุ่ม

/members

จุดเชื่อมโยงนี้ถูกเลิกใช้เมื่อวันที่ 4 เมษายน 2018

/photos

รูปภาพที่เป็นของกลุ่ม

/videos

วิดีโอที่เป็นของกลุ่ม