Workplace from Meta กำลังจะปิดตัวลง คุณจะสามารถใช้งาน Workplace ต่อไปได้จนถึงวันที่ 31 สิงหาคม 2025 โปรดไปที่ศูนย์ช่วยเหลือของเราเพื่อดูข้อมูลเพิ่มเติม

กลุ่ม

พาธ `/{group-id}`

แสดงถึงกลุ่ม Workplace โหนด /{group-id} จะส่งคืนกลุ่มเดี่ยว

กลุ่มที่มีหลายบริษัท

มีข้อพิจารณาที่เฉพาะเจาะจงที่ควรคำนึงถึงเมื่อเข้าถึงกลุ่มที่มีหลายบริษัท ได้แก่

แอพผสานการทำงานใดก็ตามที่ติดตั้งในบริษัทซึ่งเป็นส่วนหนึ่งของกลุ่มที่มีหลายบริษัทจะสามารถอ่านเนื้อหาของกลุ่มได้
กลุ่มที่มีหลายบริษัทจะมีรายชื่ออยู่ในชุมชนหรือกลุ่มต่างๆ ควบคู่ไปกับกลุ่มทั่วไป
- คุณสามารถใช้ช่องวัตถุประสงค์เพื่อระบุกลุ่มที่มีหลายบริษัทได้ โดยค่านี้จะตั้งค่าเป็น WORK_MULTI_COMPANY
ผู้อื่นจะสามารถสืบค้นสมาชิกในกลุ่มได้ด้วย แต่จะเห็นเฉพาะ id, name และ picture เท่านั้น หากเป็นแอพจากบริษัทอื่นที่ไม่ใช่บริษัทของผู้ใช้
การผสานการทำงานที่มีสิทธิ์การอนุญาตจัดการกลุ่มจะสามารถเพิ่มและลบสมาชิกในกลุ่มที่มีหลายบริษัทได้
- การผสานการทำงานจะสามารถเพิ่มและลบผู้ใช้ที่เป็นสมาชิกของชุมชนที่มีการติดตั้งการผสานการทำงานดังกล่าวเท่านั้น
- การผสานการทำงานจะสามารถเพิ่มและลบผู้ใช้ได้ต่อเมื่อผู้ดูแลกลุ่มคนใดคนหนึ่งเป็นสมาชิกของชุมชนที่มีการติดตั้งการผสานการทำงานดังกล่าวเท่านั้น
การผสานการทำงานที่มีสิทธิ์การอนุญาตจัดการเนื้อหาของกลุ่มจะสามารถลบเนื้อหาในกลุ่มที่มีหลายบริษัทได้ หากเข้าเกณฑ์อย่างใดอย่างหนึ่งต่อไปนี้
- เนื้อหาเป็นของสมาชิกในชุมชนแอพ หรือ
- สมาชิกในชุมชนแอพเป็นผู้ดูแลกลุ่ม
ในขณะนี้การเผยแพร่ไปยังกลุ่มที่มีหลายบริษัทยังไม่เปิดให้ใช้งาน
สามารถเลือกกลุ่มที่มีหลายบริษัทในการตั้งค่าขอบเขตของกลุ่มเพื่อการผสานการทำงานได้
ไม่สามารถกล่าวถึงบอทในกลุ่มที่มีหลายบริษัทได้

การอ่าน

คุณสามารถอ่านข้อมูลเกี่ยวกับกลุ่มได้โดยส่งคำขอ GET ของ API กราฟไปยัง /{group-id}

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

การอ่านโหนดของกลุ่มจะต้องใช้สิทธิ์การอนุญาตอ่านเนื้อหาของกลุ่ม

ช่อง

ชื่อช่อง	คำอธิบาย	ประเภทของข้อมูล
`id`	ID กลุ่ม	`string`
`cover`	ข้อมูลเกี่ยวกับรูปภาพหน้าปกของกลุ่ม	`CoverPhoto`
`cover_url`	URL ที่มีรูปภาพสำหรับรูปภาพหน้าปกของกลุ่ม	`string`
`description`	คำอธิบายโดยย่อเกี่ยวกับกลุ่ม	`string`
`icon`	URL สำหรับไอคอนของกลุ่ม	`url`
`is_workplace_default`	ระบุว่ากลุ่มนั้นเป็นกลุ่ม Workplace ตามค่าเริ่มต้นหรือไม่ (อ่านอย่างเดียว)	`boolean`
`is_community`	ระบุว่ากลุ่มนั้นเป็นชุมชนด้วยและสามารถประกอบด้วยกลุ่มอื่นๆ ได้หรือไม่ (อ่านอย่างเดียว)	`boolean`
`name`	ชื่อกลุ่ม	`string`
`owner`	สมาชิกที่สร้างกลุ่มนี้	`User`
`privacy`	การตั้งค่าความเป็นส่วนตัวของกลุ่ม ค่าที่เป็นไปได้: `CLOSED` `OPEN` `SECRET`	`string`
`updated_time`	เวลาที่อัพเดตกลุ่มครั้งล่าสุด ซึ่งรวมถึงการเปลี่ยนแปลงคุณสมบัติของกลุ่มและการเปลี่ยนแปลงโพสต์และความคิดเห็น	`datetime`
`archived`	ระบุว่ากลุ่มนั้นได้รับการจัดเก็บหรือไม่	`boolean`
`post_requires_admin_approval`	ระบุว่าการโพสต์ไปยังกลุ่มจะต้องได้รับการอนุมัติจากผู้ดูแลหรือไม่	`boolean`
`purpose`	ระบุวัตถุประสงค์ของกลุ่ม	`enum {WORK_ANNOUNCEMENT, WORK_FEEDBACK, WORK_TEAMWORK, WORK_SOCIAL, WORK_MULTI_COMPANY}` เลิกใช้แล้ว: `WORK_FOR_SALE, WORK_TEAM`
`post_permissions`	ระบุว่าโพสต์จะต้องได้รับการอนุมัติจากผู้ดูแลหรือไม่	`enum {NONE, ADMIN_ONLY}`
`join_setting`	ระบุวิธีที่สมาชิกใหม่จะเข้าร่วมกลุ่มได้	`enum {NONE, ANYONE, ADMIN_ONLY}`
`sorting_setting`	ระบุว่าลำดับของโพสต์ที่ส่งคืนสำหรับจุดเชื่อมโยง `/feed` จะตั้งค่าเริ่มต้นเป็น `CHRONOLOGICAL`	`enum {RECENT_ACTIVITY, CHRONOLOGICAL}`
`is_official_group`	ระบุว่ากลุ่มนั้นเป็นกลุ่ม Workplace อย่างเป็นทางการหรือไม่ ไอคอนกลุ่มอย่างเป็นทางการจะปรากฏคู่กับชื่อของกลุ่มอย่างเป็นทางการในผลิตภัณฑ์	`boolean`

การเผยแพร่

คุณไม่สามารถเผยแพร่โดยใช้จุดเชื่อมโยงนี้ได้ หากต้องการสร้างกลุ่ม ให้เผยแพร่ไปยังจุดเชื่อมโยง /community/groups

การลบ

คุณไม่สามารถลบกลุ่มโดยใช้โหนดนี้ได้ การลบสมาชิกคนสุดท้ายของกลุ่มออกจะเป็นการลบกลุ่มนั้นโดยอัตโนมัติ

การอัพเดต

คุณสามารถอัพเดตกลุ่มได้โดยส่งคำขอ POST ของ API กราฟไปยัง /{group-id} และส่งค่าสำหรับช่องที่จะอัพเดตไว้ในเนื้อหาคำขอ

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

การอัพเดตโหนดของกลุ่มจะต้องใช้สิทธิ์การอนุญาตจัดการกลุ่ม

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

ชื่อจุดเชื่อมโยง	คำอธิบาย
`/admins`	ผู้ดูแลกลุ่ม Workplace การเพิ่มและการลบผู้ดูแลที่รองรับบน Workplace โปรดดูตัวอย่างด้านล่าง
`/albums`	อัลบั้มรูปภาพในกลุ่ม Workplace
`/auto_membership_rules`	กฎในการเพิ่มสมาชิกเข้ากลุ่มโดยอัตโนมัติ
`/docs`	เอกสารในกลุ่ม Workplace
`/events`	เหตุการณ์ในกลุ่ม Workplace
`/feed`	โพสต์ในกลุ่ม Workplace ซึ่งจัดเรียงลงในฟีด
`/files`	ไฟล์ที่แชร์ลงในกลุ่ม Workplace
`/member_requests`	คำขอเป็นสมาชิกที่รอดำเนินการสำหรับกลุ่มที่ได้เปิดใช้งานการอนุมัติสมาชิกไว้
`/members`	สมาชิกของกลุ่ม Workplace จุดเชื่อมโยงนี้จะให้ข้อมูลดังต่อไปนี้ ผู้ดูแล: แสดงหากบุคคลนี้เป็นผู้ดูแลกลุ่ม เข้าร่วมแล้ว: แสดงเมื่อผู้ใช้รายนี้เข้าร่วมกลุ่มแล้ว ผู้ควบคุม: แสดงหากบุคคลนี้เป็นผู้ควบคุมของกลุ่ม added_by: แสดงผู้ที่เพิ่มผู้ใช้รายนี้เข้ากลุ่ม
`/moderators`	ผู้ควบคุมของกลุ่ม Workplace
`/pinned_posts`	โพสต์ที่ปักหมุดไว้ในกลุ่ม
`/groups`	แสดงรายการกลุ่มย่อย (มีผลกับกลุ่มซึ่งเป็นชุมชนด้วยเท่านั้น)

ตัวอย่าง

รับข้อมูล ID กลุ่ม, ชื่อ, สถานะการจัดเก็บ และความเป็นส่วนตัว:

GET graph.facebook.com
  /{group-id}?fields=id,name,archived,privacy

จัดเก็บกลุ่ม:

POST graph.facebook.com
  /{group-id}?archive=true

รับข้อมูลสมาชิกในกลุ่มพร้อมด้วยชื่อ, ID และวันที่เข้าร่วม:

GET graph.facebook.com
  /{group-id}/members?fields=name,id,joined

เรียกดูผู้ดูแลและผู้ควบคุมของกลุ่มในการเรียกใช้เพียงครั้งเดียว:

GET graph.facebook.com
  /{group-id}?fields=admins,moderators

เรียกดูเอกสารของกลุ่ม:

GET graph.facebook.com
  /{group-id}/docs

รับข้อมูลโพสต์ของกลุ่ม:

GET graph.facebook.com
  /{group-id}/feed

รับข้อมูลโพสต์ของกลุ่มตามลำดับที่อัพเดตล่าสุด:

GET graph.facebook.com
  /{group-id}/feed?sorting_setting=RECENT_ACTIVITY

พารามิเตอร์

sorting_setting

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

รับข้อมูลโพสต์ของกลุ่ม รวมถึงไฟล์แนบเพิ่มเติม เช่น วิดีโอ, รูปภาพ, ไฟล์ หรือโพลล์:

GET graph.facebook.com
  /{group-id}/feed?fields=attachments

ตัวเลือกโพลล์จะเรียงในลำดับมากไปหาน้อยตามจำนวนโหวตของแต่ละตัวเลือก

รับข้อมูลรายชื่อสมาชิกในกลุ่ม พร้อมด้วยวันที่เข้าร่วม:

GET graph.facebook.com
  /{group-id}/members?fields=name,joined

เพิ่มสมาชิกเข้ากลุ่มด้วย ID:

POST graph.facebook.com
  /{group-id}/members/{member-id}

เพิ่มสมาชิกเข้ากลุ่มด้วยอีเมล:

POST graph.facebook.com
  /{group-id}/members?email=michael%40example.com

เมื่อใส่อีเมลไว้ใน URL สำหรับคำขอ ให้ตรวจสอบว่าอีเมลนั้นได้รับการเข้ารหัส URL แล้ว ตัวอย่าง: michael@example.com จะกลายเป็น michael%40example.com

การลบสมาชิกคนสุดท้ายออกจากกลุ่มจะเป็นการกำหนดเวลาเพื่อลบกลุ่มนั้น

ลบสมาชิกออกจากกลุ่มด้วย ID:

DELETE graph.facebook.com
  /{group-id}/members/{member-id}

ลบสมาชิกออกจากกลุ่มด้วยอีเมล:

DELETE graph.facebook.com
  /{group-id}/members?email=michael%40example.com

เลื่อนระดับสมาชิกเป็นผู้ดูแลของกลุ่ม:

POST graph.facebook.com
  /{group-id}/admins/{user-id}

ลดระดับผู้ดูแลเป็นสมาชิกของกลุ่ม:

DELETE graph.facebook.com
  /{group-id}/admins/{user-id}

สร้างเหตุการณ์ใหม่ในกลุ่ม:

POST graph.facebook.com
  /{group-id}/events
  ?name=New+Event
  &start_time=2017-03-02T14:00:04+00:00
  &end_time=2017-03-02T15:00:04+00:00
  &description=Test+Description
  &location=Boardroom

อัพโหลดรูปภาพใหม่ (ผ่านไบนารี) ไปยังกลุ่ม:

POST graph.facebook.com
  /{group-id}/photos?source={image-data}

อัพโหลดรูปภาพใหม่ (ผ่าน URL) ไปยังกลุ่ม:

POST graph.facebook.com
  /{group-id}/photos?url={image-data}

สร้างโพสต์ของกลุ่มด้วยไฟล์แนบที่เป็นรูปภาพและวิดีโอ:

POST graph.facebook.com
  /{group-id}/feed?attached_media=[{"media_fbid":"{photo-id}"},{"media_fbid":"{photo-id}"}]

พารามิเตอร์

attached_media

ใช้สำหรับรูปภาพและวิดีโอ โดยที่อาร์เรย์ของ media_fbids อยู่ในวงเล็บ รองรับรูปแบบรูปภาพดังต่อไปนี้ ได้แก่ .jpeg, .bmp, .png, .gif, .tiff ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบรูปภาพได้ที่นี่ ดูไฟล์วิดีโอที่รองรับได้ที่นี่ หากต้องการรับ media_fbids สำหรับรูปภาพ โปรดเผยแพร่รูปภาพที่ยังไม่ได้เผยแพร่ไปยัง https://graph.facebook.com/me/photos ก่อน ตามที่อธิบายไว้ในเอกสารประกอบที่นี่ และหากต้องการรับ media_fbids สำหรับวิดีโอ (รวมถึงไฟล์ GIF แบบเคลื่อนไหว) โปรดเผยแพร่วิดีโอไปยัง https://graph.facebook.com/me/videos?no_story=true ก่อน

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

สร้างโพสต์ของกลุ่มด้วยไฟล์แนบที่เป็นไฟล์:

POST graph.facebook.com
  /{group-id}/feed?files=[{file-id},{file-id}]

พารามิเตอร์

files

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

เอกสาร: .pdf, .csv, .tsv, .docx, .pptx, .xlsx
รูปภาพ: .jpeg, .png
วิดีโอ: .mp4
ไฟล์ที่จัดเก็บ: .rar, .zip

หากต้องการรับ file_ids โปรดเผยแพร่ไฟล์ไปยัง https://graph.facebook.com/group_file_revisions ก่อน คุณอาจเผยแพร่ไฟล์ต้นทางภายในเครื่องจากคอมพิวเตอร์ของคุณก็ได้

คุณไม่สามารถรวมพารามิเตอร์ attached_media และ files ในการเรียก API ครั้งเดียวกันได้ การดำเนินการนี้เลียนแบบลักษณะในช่องเขียนของกลุ่ม ซึ่งมีตัวเลือกแยกจากกันสำหรับอัพโหลด "รูปภาพ/วิดีโอ" และ "ไฟล์"

อัพเดตสิทธิ์การอนุญาตในการโพสต์ การตั้งค่าการเข้าร่วม การตั้งค่าวัตถุประสงค์ และการตั้งค่าหลังการอนุมัติ

POST graph.facebook.com
  /{group-id}/?post_permissions=NONE&join_setting=ADMIN_ONLY&purpose=WORK_SOCIAL&post_requires_admin_approval=false

รับข้อมูลความรู้สึกและความคิดเห็นในโพสต์ที่ปักหมุดไว้

GET graph.facebook.com
  /{group-id}/pinned_posts?fields=reactions,comments

ระบุว่ากลุ่มเป็นชุมชนด้วยหรือไม่

GET graph.facebook.com
  /{group-id}?fields=is_community

รับกฎการเป็นสมาชิกในกลุ่ม

GET graph.facebook.com
  /{group-id}/auto_membership_rules

ตัวอย่างการตอบกลับ (JSON):

{
  "data": [
    {
      "conditions": [
        {
          "field": "TITLE",
          "operator": "CONTAINS",
          "values": [
            "sales"
          ]
        }
      ],
      "id": RULE_ID
    }
  ],
  ...
}

ลบกฎในการรับสมาชิกเข้ากลุ่ม

DELETE graph.facebook.com
  /RULE_ID

ใช้กฎการเป็นสมาชิกในกลุ่ม

POST graph.facebook.com
  /{group-id}/auto_membership_rules

ตัวอย่างเพย์โหลด:

{
    "conditions": [
        {
            "field": "LOCATION",
            "operator": "CONTAINS",
            "values": ["London", "San Francisco"]
        }
    ]
  }

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

รับข้อมูล ID กลุ่มและสถานะของกลุ่มทางการ:

GET graph.facebook.com
  /{group-id}?fields=id,is_official_group

อัพเดตสถานะของกลุ่มทางการ:

POST graph.facebook.com
  /{group-id?is_official_group={FALSE | TRUE}

กลุ่ม

พาธ /{group-id}

กลุ่มที่มีหลายบริษัท

การอ่าน

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

ช่อง

การเผยแพร่

การลบ

การอัพเดต

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

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

ตัวอย่าง

รับข้อมูล ID กลุ่ม, ชื่อ, สถานะการจัดเก็บ และความเป็นส่วนตัว:

จัดเก็บกลุ่ม:

รับข้อมูลสมาชิกในกลุ่มพร้อมด้วยชื่อ, ID และวันที่เข้าร่วม:

เรียกดูผู้ดูแลและผู้ควบคุมของกลุ่มในการเรียกใช้เพียงครั้งเดียว:

เรียกดูเอกสารของกลุ่ม:

รับข้อมูลโพสต์ของกลุ่ม:

รับข้อมูลโพสต์ของกลุ่มตามลำดับที่อัพเดตล่าสุด:

รับข้อมูลโพสต์ของกลุ่ม รวมถึงไฟล์แนบเพิ่มเติม เช่น วิดีโอ, รูปภาพ, ไฟล์ หรือโพลล์:

รับข้อมูลรายชื่อสมาชิกในกลุ่ม พร้อมด้วยวันที่เข้าร่วม:

เพิ่มสมาชิกเข้ากลุ่มด้วย ID:

เพิ่มสมาชิกเข้ากลุ่มด้วยอีเมล:

ลบสมาชิกออกจากกลุ่มด้วย ID:

ลบสมาชิกออกจากกลุ่มด้วยอีเมล:

เลื่อนระดับสมาชิกเป็นผู้ดูแลของกลุ่ม:

ลดระดับผู้ดูแลเป็นสมาชิกของกลุ่ม:

สร้างเหตุการณ์ใหม่ในกลุ่ม:

อัพโหลดรูปภาพใหม่ (ผ่านไบนารี) ไปยังกลุ่ม:

อัพโหลดรูปภาพใหม่ (ผ่าน URL) ไปยังกลุ่ม:

สร้างโพสต์ของกลุ่มด้วยไฟล์แนบที่เป็นรูปภาพและวิดีโอ:

สร้างโพสต์ของกลุ่มด้วยไฟล์แนบที่เป็นไฟล์:

รับข้อมูลความรู้สึกและความคิดเห็นในโพสต์ที่ปักหมุดไว้

ระบุว่ากลุ่มเป็นชุมชนด้วยหรือไม่

รับกฎการเป็นสมาชิกในกลุ่ม

ลบกฎในการรับสมาชิกเข้ากลุ่ม

ใช้กฎการเป็นสมาชิกในกลุ่ม

รับข้อมูล ID กลุ่มและสถานะของกลุ่มทางการ:

อัพเดตสถานะของกลุ่มทางการ:

พาธ `/{group-id}`