チャットのメンバーを一覧表示します。
名前空間: microsoft.graph
このメソッドはフェデレーションをサポートします。 1 対 1 のチャットの場合、要求の開始元のテナントに少なくとも 1 人のチャット メンバーが属している必要があります。 グループ チャットの場合、要求が開始されるテナント内のユーザーがチャットを開始する必要があります。
注:
サーバーから返されたメンバーシップ ID は、不透明な文字列として扱われる必要があります。 クライアントがこれらのリソース ID を解析したり、推測したりしてはいけません。
メンバーシップの結果は、応答に示されているように、将来的に別のテナントのユーザーにマップされる可能性があります。 クライアントは、すべてのメンバーが現在のテナントからのメンバーのみであると想定しないでください。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Chat.ReadBasic | ChatMember.ReadWrite、Chat.Read、Chat.ReadWrite、ChatMember.Read |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | ChatMember.Read.All | ChatMember.ReadWrite.All、Chat.Manage.Chat、Chat.Read.All、Chat.ReadBasic.All、Chat.ReadWrite.All、ChatMember.Read.Chat |
HTTP 要求
GET /chats/{chat-id}/members
GET /users/{user-id | user-principal-name}/chats/{chat-id}/members
オプションのクエリ パラメーター
この操作は、応答をカスタマイズする OData クエリ パラメーターをサポートしていません。
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で conversationMember オブジェクトのリストを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/me/chats/19:09ddc990-3821-4ceb-8019-24d39998f93e_48d31887-5fad-4d73-a9f5-3c356e68a038@unq.gbl.spaces/members
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('48d31887-5fad-4d73-a9f5-3c356e68a038')/chats('19%3A09ddc990-3821-4ceb-8019-24d39998f93e_48d31887-5fad-4d73-a9f5-3c356e68a038%40unq.gbl.spaces')/members",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MCMjMCMjZGNkMjE5ZGQtYmM2OC00YjliLWJmMGItNGEzM2E3OTZiZTM1IyMxOTowOWRkYzk5MC0zODIxLTRjZWItODAxOS0yNGQzOTk5OGY5M2VfNDhkMzE4ODctNWZhZC00ZDczLWE5ZjUtM2MzNTZlNjhhMDM4QHVucS5nYmwuc3BhY2VzIyM0OGQzMTg4Ny01ZmFkLTRkNzMtYTlmNS0zYzM1NmU2OGEwMzg=",
"roles": [
"owner"
],
"displayName": "Megan Bowen",
"visibleHistoryStartDateTime": "2021-11-25T01:56:31.313Z",
"userId": "48d31887-5fad-4d73-a9f5-3c356e68a038",
"email": "MeganB@contoso.com",
"tenantId": "dcd219dd-bc68-4b9b-bf0b-4a33a796be35"
}
]
}