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"
}
]
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示