メンバー

パス`/{member-id}`

Workplaceコミュニティまたはグループのメンバーとしてのユーザーオブジェクトを表します。

読み取り

Workplaceユーザーを表す単一のUserオブジェクトを返します。メンバーの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`	特定の人に割り当てられた数字または英数字のID (通常、就職順または組織との関わりに基づく)。	`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`	人またはボットページの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"
    }