Workplace

กลุ่ม

พาธ /{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

เมื่อใส่อีเมลไว้ใน URL สำหรับคำขอ ให้ตรวจสอบว่าอีเมลนั้นได้รับการเข้ารหัส URL แล้ว ตัวอย่าง: michael@example.com จะกลายเป็น 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}