名前空間: microsoft.graph.teamsAdministration
テナント に 属するすべての Teams ユーザーのユーザー構成を取得します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | TeamsUserConfiguration.Read.All | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | TeamsUserConfiguration.Read.All | 注意事項なし。 |
HTTP 要求
GET /admin/teams/userConfigurations
オプションのクエリ パラメーター
このメソッドは、 $select、 $filter、 $top、 $expand、 $orderBy OData クエリ パラメーターをサポートし、応答をカスタマイズするのに役立ちます。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文の microsoft.graph.teamsAdministration.teamsUserConfiguration オブジェクトのコレクションを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/admin/teams/userConfigurations
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#admin/teams/userConfigurations",
"id": "5c802b19-3600-83f1-1767-7b9edc7f38ab",
"userPrincipalName": "AdeleV@contoso.com",
"tenantId": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"effectivePolicyAssignments": [
{
"policyType": "TeamsCallingPolicy",
"policyAssignment": {
"displayName": "AllOn",
"assignmentType": "group",
"policyId": "f7593e81-772a-4455-88a3-fc9e5ebc1e4a",
"groupId": "75ae6229-35fe-4b01-ae7f-7c50439d239c"
}
},
{
"policyType": "TeamsMeetingPolicy",
"policyAssignment": {
"displayName": "CustomPolicy",
"assignmentType": "direct",
"policyId": "J93PmFHwFcLZhWfYcBlv9pn-hG-kUWkcxmkDvpwgacw"
}
}
],
"telephoneNumbers": [
{
"telephoneNumber": "+13235533696",
"assignmentCategory": "primary"
}
],
"isEnterpriseVoiceEnabled": false,
"featureTypes": [
"Teams",
"CallingPlan"
],
"accountType": "user",
"createdDateTime": "2025-01-07T09:08:50.9115993Z",
"modifiedDateTime": "2025-01-07T09:08:50.9115993Z"
}
]
}