conversationMembers を一覧表示する

  • [アーティクル]

名前空間: microsoft.graph

chat または channel のすべての会話メンバーを一覧表示します。

注:

サーバーから返されたメンバーシップ 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/{id}/members

オプションのクエリ パラメーター

この操作は、応答をカスタマイズする OData クエリ パラメーターをサポートしていません。

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で conversationMember オブジェクトのリストを返します。

例

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/v1.0/chats/19:9ef2dcdf14ba44cbae25c2f5d53171ba@thread.v2/members

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A9ef2dcdf14ba44cbae25c2f5d53171ba%40thread.v2')/members",
    "@odata.count": 4,
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjMCMjOGQyMzc2NTAtY2RjMS00MGUxLTg5OWMtNTYwMWUwNTVmM2ZlIyMxOTo5ZWYyZGNkZjE0YmE0NGNiYWUyNWMyZjVkNTMxNzFiYUB0aHJlYWQudjIjIzE3ZTk1MjZjLTIyODYtNDFhMS1hZWViLTRiYWRlZTc2NjA2Mw==",
            "roles": [
                "owner"
            ],
            "displayName": "SA-TeamsAdconnect",
            "visibleHistoryStartDateTime": "2022-04-25T11:52:22.765Z",
            "userId": "17e9526c-2286-41a1-aeeb-4badee766063",
            "email": "SA-TeamsAdconnect@contoso.com",
            "tenantId": "8d237650-cdc1-40e1-899c-5601e055f3fe"
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjMCMjOGQyMzc2NTAtY2RjMS00MGUxLTg5OWMtNTYwMWUwNTVmM2ZlIyMxOTo5ZWYyZGNkZjE0YmE0NGNiYWUyNWMyZjVkNTMxNzFiYUB0aHJlYWQudjIjIzM3MjBiNWE3LTg1NzktNDM0My05NmJmLTQzNDIxNGQ2NTI2ZA==",
            "roles": [
                "owner"
            ],
            "displayName": "Mhamdi Wafa",
            "visibleHistoryStartDateTime": "2022-04-25T11:52:22.765Z",
            "userId": "3720b5a7-8579-4343-96bf-434214d6526d",
            "email": "wmhamdi@rtladconnect.com",
            "tenantId": "8d237650-cdc1-40e1-899c-5601e055f3fe"
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjMCMjZGNkMjE5ZGQtYmM2OC00YjliLWJmMGItNGEzM2E3OTZiZTM1IyMxOTo5ZWYyZGNkZjE0YmE0NGNiYWUyNWMyZjVkNTMxNzFiYUB0aHJlYWQudjIjIzQ4ZDMxODg3LTVmYWQtNGQ3My1hOWY1LTNjMzU2ZTY4YTAzOA==",
            "roles": [
                "owner"
            ],
            "displayName": "Megan Bowen",
            "visibleHistoryStartDateTime": "2022-04-25T11:52:22.765Z",
            "userId": "48d31887-5fad-4d73-a9f5-3c356e68a038",
            "email": "MeganB@contoso.com",
            "tenantId": "dcd219dd-bc68-4b9b-bf0b-4a33a796be35"
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjMCMjOGQyMzc2NTAtY2RjMS00MGUxLTg5OWMtNTYwMWUwNTVmM2ZlIyMxOTo5ZWYyZGNkZjE0YmE0NGNiYWUyNWMyZjVkNTMxNzFiYUB0aHJlYWQudjIjIzcxZjJjYzdmLTQwYWYtNDhkOS05ZDk2LTVhYTMzYjkxYmRkOA==",
            "roles": [
                "owner"
            ],
            "displayName": "Berrahal Mariem [RTL-AdConnect]",
            "visibleHistoryStartDateTime": "2022-04-25T11:59:47.226Z",
            "userId": "71f2cc7f-40af-48d9-9d96-5aa33b91bdd8",
            "email": "mberrahal@rtladconnect.com",
            "tenantId": "8d237650-cdc1-40e1-899c-5601e055f3fe"
        }
    ]
}