allowedMembers を一覧表示する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
共有チャネルにアクセスできる conversationMembers の一覧を取得します。
このメソッドは、チームから次の conversationMembers を返しません。
-
Guestロールを持つユーザー - テナントで外部認証されたユーザー
注:
サーバーから返されたメンバーシップ ID は、不透明な文字列として扱われる必要があります。 クライアントがこの ID を解析したり、推測したりしてはいけません。
メンバーシップの結果は、今後の応答で示されているように、さまざまなテナントのユーザーにマップできます。 クライアントは、すべてのメンバーが現在のテナントからのみであると想定しないでください。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | ChannelMember.Read.All | ChannelMember.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | ChannelMember.Read.All | ChannelMember.ReadWrite.All |
注: この API は、管理者のアクセス許可をサポートします。 Microsoft Teamsサービス管理者は、メンバーではないチームにアクセスできます。
HTTP 要求
GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}/allowedMembers
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための $select および $countOData クエリ パラメーター をサポートします。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で conversationMember オブジェクトのコレクションを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/teams/893075dd-2487-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/sharedWithTeams/893075dd-2487-5634-925f-022c42e20265/allowedMembers
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.conversationMember",
"id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ",
"roles": [
"owner"
],
"displayName": "Eric Solomon",
"userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
"email": "ericsol@fabrikam.com",
"tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
},
{
"@odata.type": "#microsoft.graph.conversationMember",
"id": "MmFiOWMFxTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ",
"roles": [
"user"
],
"displayName": "Caleb Foster",
"userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
"email": "calfos@fabrikam.com",
"tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
}
]
}