Thành viên

Đường dẫn /{member-id}

Biểu thị một đối tượng người dùng là thành viên của cộng đồng hoặc nhóm Workplace.

Đường dẫn /community/members

Trả về danh sách tất cả tài khoản người dùng hiện tại. Cần có quyền Quản lý hồ sơ công việc.

Lọc dựa trên external_id

Để lọc người dùng dựa trên ID bên ngoài, hãy sử dụng thông số external_ids và chuyển danh sách các ID bên ngoài của người dùng mong muốn, được phân tách bằng dấu phẩy.

Đường dẫn /community/organization_members

Trả về danh sách người dùng. Cần có quyền Đọc thành viên nhóm. Các tài khoản người dùng đang hoạt động sẽ được liệt kê theo mặc định. Bạn có thể dùng thông số URL inactive=1 để hiển thị những tài khoản người dùng bị vô hiệu hóa.

Đọc

Trả về một đối tượng Người dùng biểu thị một người dùng Workplace. Có thể truy cập thông qua ID Workplace của thành viên hoặc địa chỉ email mà thành viên đó sử dụng khi đăng nhập vào Workplace.

• /{member_id}
• /{email_address}

Quyền

Bạn cần có quyền Đọc hồ sơ công việc hoặc Quản lý tài khoản để đọc thông tin về thành viên. Nếu một Tiện ích tích hợp đang sử dụng quyền Quản lý tài khoản và nằm trong phạm vi của các nhóm cụ thể, tiện ích tích hợp đó sẽ không thể truy cập một số trường Thành viên.

Trường

Đăng

Hãy xem API Quản lý tài khoản (Đồ thị)

Xóa

Hãy xem API Quản lý tài khoản (Đồ thị)

Cập nhật

Hãy xem API Quản lý tài khoản (Đồ thị)

Cạnh

Ví dụ

Truy xuất thông tin về một thành viên cộng đồng

Lấy tên và địa chỉ email của một thành viên cụ thể.

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

Lấy ID của một thành viên từ địa chỉ email của họ

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

Liệt kê các thành viên công ty dựa trên id bên ngoài của người dùng

GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com

Liệt kê các thành viên công ty, kể cả những tài khoản bị vô hiệu hóa

GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com

Lấy các sự kiện của một thành viên:

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

Truy xuất thông tin về Người quản lý và Cấp dưới của người dùng

Lấy cấp dưới của một thành viên cụ thể

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

Lấy người quản lý của một thành viên cụ thể

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

Truy xuất tin nhắn dành cho một thành viên

Lấy cuộc trò chuyện của một thành viên, bao gồm cả tin nhắn, người gửi và file đính kèm:

Cần có mã tiện ích tích hợp tùy chỉnh có quyền Đọc tất cả tin nhắn:

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

Lấy ID chuỗi trò chuyện của một thành viên theo chuỗi trò chuyện:

Cần có mã tiện ích tích hợp tùy chỉnh có quyền Đọc tất cả tin nhắn:

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

Lấy các tin nhắn của một ID chuỗi trò chuyện cụ thể, dành cho người dùng cụ thể:

Cần có mã tiện ích tích hợp tùy chỉnh có quyền Đọc tất cả tin nhắn:

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

Lấy cuộc trò chuyện của một trang bot, kể cả tin nhắn và file đính kèm:

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

Xóa một tin nhắn cụ thể trong hộp thư của thành viên bằng mã tiện ích tích hợp tùy chỉnh:

Cần có mã tiện ích tích hợp tùy chỉnh có quyền Xóa tin nhắn chat

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

Lấy ngày và giờ mà một thành viên được mời và xác nhận tài khoản của họ:

Cần có mã tiện ích tích hợp tùy chỉnh có quyền Quản lý tài khoản:

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

Lấy ngày và giờ mà tài khoản của thành viên bị vô hiệu hóa:

Cần có mã tiện ích tích hợp tùy chỉnh có quyền Quản lý tài khoản:

GET graph.facebook.com
      /{member-id}?fields=account_deactivate_time

Đăng xuất một người dùng khỏi Workplace

Cần có mã truy cập có quyền Đăng xuất:

POST graph.facebook.com
      /{member-id}/logout

Đặt ảnh đại diện

Cần có mã truy cập có quyền Quản lý hồ sơ công việc. Hỗ trợ cả URL file và tải file lên trong yêu cầu.

POST graph.facebook.com
      /{member-id}/profile_pictures?
      image_url={...}&
      caption={...}

POST graph.facebook.com
      /{member-id}/profile_pictures?
      caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png

Thêm số điện thoại của thành viên

Cần có mã truy cập có quyền Quản lý hồ sơ công việc.

POST graph.facebook.com
      /{member-id}/phones?
      type={...}&
      primary={...}&
      number={...}

Lấy kỹ năng của thành viên

Cần có mã truy cập có quyền Đọc hồ sơ công việc.

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

Thêm kỹ năng

Cần có mã truy cập có quyền Quản lý hồ sơ công việc.

POST graph.facebook.com
      /{member-id}/skills?name={...}

Gỡ kỹ năng

Cần có mã truy cập có quyền Quản lý hồ sơ công việc.

DELETE graph.facebook.com
      /{member-id}/skills?name={...}

Lấy huy hiệu của thành viên

Cần có mã truy cập có quyền Đọc hồ sơ công việc.

GET graph.facebook.com
      /{member-id}/badges?fields=id,name,description,icon,category

Trao một huy hiệu tích hợp sẵn cho người dùng

Cần có mã truy cập có quyền Quản lý huy hiệu. Hãy xem tài liệu về cộng đồng để biết cách liệt kê các huy hiệu có sẵn và ID tương ứng.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_champion

Trao một huy hiệu tùy chỉnh cho người dùng

Cần có mã truy cập có quyền Quản lý huy hiệu. Hãy xem tài liệu về cộng đồng để biết cách liệt kê các huy hiệu có sẵn và ID tương ứng. Lưu ý rằng # trong URL cần được mã hóa URL.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_custom#{badge_id}

Vô hiệu hóa thành viên

Cần có mã truy cập có quyền Cấp phép tài khoản người dùng.

POST graph.facebook.com
      /{member-id}?active=false

Xóa thành viên

Cần có mã truy cập có quyền Cấp phép tài khoản người dùng.

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

Lấy trạng thái công việc tuyến đầu của người dùng

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