成員

路徑 `/{member-id}`

將用戶物件表示成 Workplace 社群或社團的成員。

讀取

傳回表示 Workplace 用戶的單一用戶物件。可以藉由成員的 Workplace 編號或成員登入 Workplace 時使用的電子郵件地址來存取。

/{member_id}
/{email_address}

權限

欄位

欄位名稱	說明	類型
`id`	此用戶的用戶帳號編號。	`string`
`first_name`	用戶的名字。	`string`
`last_name`	用戶的姓氏。	`string`
`email`	用戶的主要電子郵件地址，也用作他們在 Workplace 上的用戶名稱。	`string`
`title`	用戶在 Workplace 上的職稱。	`string`
`department`	用戶在 Workplace 上所屬的部門（若是透過帳號管理 API 來設定）。	`string`
`employee_number`	指派給用戶的數值或英數字元識別資料，通常是根據聘用順序或與組織的關係。	`string`
`primary_phone`	用戶主要列出的電話號碼。對應至帳號管理 API 上標示為 `primary` 的 `phoneNumbers` 項目。	`string`
`primary_address`	用戶主要列出的地址。對應至帳號管理 API 上標示為 `primary` 的 `addresses` 項目	`string`
`picture`	用戶的大頭貼照。	`url`
`link`	用戶個人檔案的連結。	`url`
`locale`	用戶的地區設定。	`string`
`name`	用戶的全名。	`string`
`name_format`	用戶的姓名經過格式化，以正確處理中文、日文或韓文排序。	`string`
`account_invite_time`	UTC 格式的帳號邀請時間。	`datetime`
`account_claim_time`	UTC 格式的帳號領取時間。	`datetime`
`impersonate_token`	成員存取權杖，可讓整合工具代表特定用戶發出呼叫。需要假冒權限。假冒為廢棄權限。請勿使用此權限建置新功能。無法再將此權限新增到自訂整合中。	`string`
`about`	用戶個人檔案中個人簡介欄位的內容。	`string`
`frontline`	用戶第一線狀態的相關資訊	`object`（請參閱下方範例）

發佈

您不能使用此節點進行發佈。

刪除

您不能使用此節點進行刪除。

更新

您不能使用此節點進行更新。使用帳號管理 API 可更新或停用帳號。

關係連線

關係連線名稱	說明
`/events`	此用戶的事件。預設不包含用戶已拒絕或未回覆的事件。
`/feed`	此用戶發佈的貼文動態（包括近況更新）和連結。
`/conversations`	用戶或 Bot 頁面的 Workplace 訊息。需要「讀取所有訊息」權限
`/managers`	用戶列出的主管。
`/reports`	用戶列出的部屬。
`/picture`	成員的大頭貼照。
`/groups`	與成員相關聯的社團。

範例

擷取社群成員的相關資訊

取得給定成員的姓名和電子郵件地址。

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

從成員的電子郵件地址取得成員的編號

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}

依照對話串取得成員的對話串編號：

需要具有讀取所有訊息權限的自訂整合權杖：

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

針對給定的用戶取得給定對話串編號的訊息：

需要具有讀取所有訊息權限的自訂整合權杖：

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

取得 Bot 頁面的對話，包括訊息和附件：

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

使用自訂整合權杖時，/me 別名會指向 Bot 的頁面

取得成員受邀及領取帳號的日期和時間：

需要具有管理帳號權限的自訂整合權杖：

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"
    }

成員

路徑 /{member-id}

讀取

權限

欄位

發佈

刪除

更新

關係連線

範例

擷取社群成員的相關資訊

取得給定成員的姓名和電子郵件地址。

從成員的電子郵件地址取得成員的編號

取得成員的事件：

擷取用戶的主管和部屬相關資訊

取得給定成員的部屬

取得給定成員的主管

擷取成員的訊息

取得成員的對話，包括訊息、傳送者和附件：

依照對話串取得成員的對話串編號：

針對給定的用戶取得給定對話串編號的訊息：

取得 Bot 頁面的對話，包括訊息和附件：

取得成員受邀及領取帳號的日期和時間：

使用自訂整合權杖來刪除成員收件匣中的特定訊息：

取得用戶的第一線狀態

路徑 `/{member-id}`