次の方法で共有


チャットのメンバーを一覧表示します。

名前空間: 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"
        }
    ]
}