สมาชิก

พาธ `/{member-id}`

แสดงถึงอ็อบเจ็กต์ผู้ใช้ในฐานะสมาชิกของชุมชนหรือกลุ่ม Workplace

การอ่าน

ส่งคืนอ็อบเจ็กต์ผู้ใช้รายการเดียวซึ่งแสดงถึงผู้ใช้ Workplace คุณสามารถเข้าถึงได้ผ่านทาง Workplace ID ของสมาชิกหรืออีเมลที่สมาชิกใช้เมื่อเข้าสู่ระบบ Workplace

/{member_id}
/{email_address}

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

การอ่านข้อมูลเกี่ยวกับสมาชิกจำเป็นต้องใช้สิทธิ์การอนุญาตอ่านเนื้อหาทั้งหมดหรือสิทธิ์การอนุญาตจัดการบัญชีอย่างใดอย่างหนึ่ง

ช่อง

ชื่อช่อง	คำอธิบาย	ประเภท
`id`	ID บัญชีผู้ใช้ของบุคคลนี้	`string`
`first_name`	ชื่อของผู้ใช้	`string`
`last_name`	นามสกุลของผู้ใช้	`string`
`email`	อีเมลหลักของผู้ใช้ ซึ่งใช้เป็นชื่อผู้ใช้บน Workplace ด้วย	`string`
`title`	ตำแหน่งงานบน Workplace ของผู้ใช้	`string`
`department`	ชื่อแผนกบน Workplace ของผู้ใช้ กรณีที่ตั้งค่าผ่าน API การจัดการบัญชี	`string`
`employee_number`	ผู้ใช้จะได้รับการกำหนดตัวระบุที่เป็นตัวเลขหรือตัวระบุที่มีทั้งตัวเลขและตัวอักษร ซึ่งมักจะเรียงตามลำดับการจ้างหรือความเกี่ยวข้องกับองค์กร	`string`
`primary_phone`	หมายเลขโทรศัพท์หลักที่ระบุไว้ของผู้ใช้ แผนที่ไปยังข้อมูล `phoneNumbers` ที่ทำเครื่องหมายเป็น `primary` ใน API การจัดการบัญชี	`string`
`primary_address`	ที่อยู่หลักที่ระบุไว้ของผู้ใช้ แผนที่ไปยังข้อมูล `addresses` ที่ทำเครื่องหมายเป็น `primary` ใน API การจัดการบัญชี	`string`
`picture`	รูปโปรไฟล์ของผู้ใช้	`url`
`link`	ลิงก์ไปยังโปรไฟล์ของผู้ใช้	`url`
`locale`	รูปแบบภาษาของผู้ใช้	`string`
`name`	ชื่อนามสกุลของผู้ใช้	`string`
`name_format`	ชื่อของผู้ใช้ซึ่งจัดรูปแบบให้สามารถรองรับการเรียงลำดับในภาษาจีน ภาษาญี่ปุ่น หรือภาษาเกาหลีได้อย่างถูกต้อง	`string`
`account_invite_time`	เวลาที่เชิญบัญชีในรูปแบบ UTC	`datetime`
`account_claim_time`	เวลาที่ขอรับสิทธิ์บัญชีในรูปแบบ UTC	`datetime`
`impersonate_token`	โทเค็นการเข้าถึงสมาชิกซึ่งช่วยให้การผสานการทำงานสามารถทำการเรียกใช้ในนามของผู้ใช้ที่เฉพาะเจาะจงได้ จำเป็นต้องใช้สิทธิ์การอนุญาต Impersonate Impersonate เป็นสิทธิ์การอนุญาตที่เลิกใช้แล้ว ห้ามสร้างฟังก์ชั่นการทำงานใหม่โดยใช้สิทธิ์การอนุญาตนี้ คุณไม่สามารถเพิ่มสิทธิ์การอนุญาตนี้ในการผสานการทำงานแบบกำหนดเองได้อีกต่อไป	`string`
`about`	เนื้อหาของช่องคำอธิบายตัวเองในโปรไฟล์ผู้ใช้	`string`
`frontline`	ข้อมูลเกี่ยวกับสถานะบุคลากรหน้างานของผู้ใช้	`object` (โปรดดูตัวอย่างด้านล่าง)

การเผยแพร่

คุณไม่สามารถทำการเผยแพร่โดยใช้โหนดนี้

การลบ

คุณไม่สามารถทำการลบโดยใช้โหนดนี้

การอัพเดต

คุณไม่สามารถทำการอัพเดตโดยใช้โหนดนี้ แต่คุณสามารถอัพเดตหรือปิดใช้งานบัญชีได้โดยใช้ API การจัดการบัญชี

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

ชื่อจุดเชื่อมโยง	คำอธิบาย
`/events`	เหตุการณ์เกี่ยวกับผู้ใช้รายนี้ ตามค่าเริ่มต้นแล้ว จะไม่รวมเหตุการณ์ที่ผู้ใช้ปฏิเสธหรือไม่ได้ตอบกลับ
`/feed`	ฟีดของโพสต์ (รวมถึงการอัพเดตสถานะ) และลิงก์ที่ผู้ใช้รายนี้เผยแพร่
`/conversations`	ข้อความ Workplace ของผู้ใช้หรือหน้าบอท จำเป็นต้องใช้สิทธิ์การอนุญาตอ่านข้อความทั้งหมด
`/managers`	ผู้จัดการ (คนเดียวหรือหลายคน) ที่ระบุไว้ของผู้ใช้
`/reports`	ผู้อยู่ใต้บังคับบัญชาที่ระบุไว้ของผู้ใช้
`/picture`	รูปโปรไฟล์ของสมาชิก
`/groups`	กลุ่มที่เชื่อมโยงกับสมาชิก

ตัวอย่าง

การดึงข้อมูลเกี่ยวกับสมาชิกในชุมชน

รับข้อมูลชื่อและอีเมลของสมาชิกที่กำหนด

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com

รับข้อมูล ID ของสมาชิกจากอีเมล

GET /{email_address} HTTP/1.1
Host: graph.facebook.com

รับข้อมูลเหตุการณ์ของสมาชิก

GET graph.facebook.com
      /{member-id}/events

การดึงข้อมูลเกี่ยวกับผู้จัดการและผู้อยู่ใต้บังคับบัญชาของผู้ใช้

รับข้อมูลผู้อยู่ใต้บังคับบัญชาของสมาชิกที่กำหนด

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com

รับข้อมูลผู้จัดการของสมาชิกที่กำหนด

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

การดึงข้อความของสมาชิก

รับข้อมูลการสนทนาของสมาชิก โดยรวมถึงข้อความ ผู้ส่ง และไฟล์แนบ:

จำเป็นต้องใช้โทเค็นการผสานการทำงานแบบกำหนดเองที่มีสิทธิ์การอนุญาตอ่านข้อความทั้งหมด:

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}

รับข้อมูล ID ของเธรดการสนทนาของสมาชิกตามเธรด:

GET graph.facebook.com
      /{member-id}/conversations

รับข้อความสำหรับ ID ของเธรดที่กำหนดของผู้ใช้ที่กำหนด:

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}

รับข้อมูลการสนทนาในหน้าบอท โดยรวมถึงข้อความและไฟล์แนบ:

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

นามแฝง /me จะชี้ไปยังหน้าบอทเมื่อใช้งานโทเค็นการผสานการทำงานแบบกำหนดเอง

รับข้อมูลวันที่และเวลาที่สมาชิกได้รับเชิญและขอรับสิทธิ์บัญชีของตนเอง:

จำเป็นต้องใช้โทเค็นการผสานการทำงานแบบกำหนดเองที่มีสิทธิ์การอนุญาตจัดการบัญชี:

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

ระบบจะแสดงช่องเหล่านี้ในกรณีที่สมาชิกได้รับเชิญหรือขอรับสิทธิ์บัญชีของตนเองแล้วเท่านั้น

ลบข้อความที่ต้องการในกล่องข้อความของสมาชิกโดยใช้โทเค็นการผสานการทำงานแบบกำหนดเอง:

จำเป็นต้องใช้โทเค็นการผสานการทำงานแบบกำหนดเองที่มีสิทธิ์การอนุญาตลบข้อความแชท

DELETE graph.facebook.com
      /{message-id}?user={user-id}

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

รับข้อมูลสถานะบุคลากรหน้างานของผู้ใช้

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }