user リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Entra ユーザー アカウントを表します。 このリソースは、他のプロパティを渡すことができるオープン型です。 directoryObject から継承します。
user リソースを使用すると、アプリで、プライマリ Exchange メールボックスおよび Microsoft Entra プロファイル用の言語、および日付と時刻の形式のユーザー設定を行うことができます。 詳細については、「言語と地域の形式のユーザー設定」を参照してください。
パフォーマンス上の理由から、作成、取得、一覧表示の操作は、既定ではより一般的に使用されるプロパティのみを返します。 これらの既定のプロパティは、「プロパティ」セクションに記載されています。 既定では返されないプロパティを取得するには、そのプロパティを $select
OData クエリ オプションで指定します。
このリソースは以下をサポートしています。
メソッド
メソッド | 戻り値の型 | 説明 |
---|---|---|
List | user コレクション | ユーザー オブジェクトのリストを取得します。 |
Create | user | 新しいユーザー オブジェクトを作成します。 |
Get | user | ユーザー オブジェクトのプロパティと関係を読み取ります。 |
Update | user | ユーザー オブジェクトを更新します。 |
Delete | None | ユーザー オブジェクトを削除します。 |
Get delta | user コレクション | ユーザーに対する増分の変更を取得します。 |
[パスワードの変更] | なし | 自分のパスワードを更新します。 |
パスワードの検証 | passwordValidationInformation | 組織のパスワード検証ポリシーに対してユーザーのパスワードを検証し、パスワードが有効かどうかを報告します。 |
サービスのプロビジョニングを再試行する | なし | ユーザー サービス プロビジョニングを再試行します。 |
外部ユーザーを内部メンバー ユーザーに変換する | user | 外部認証されたユーザーを内部メンバー ユーザーに変換します。 |
すべての更新トークンを無効にする | user | アプリケーションに発行されたユーザーの更新トークンをすべて無効にします。 使用しないでください。 代わりに、user: revokeSignInSessions メソッドを使用します。 |
サインイン セッションを取り消す | なし | signInSessionsValidFromDateTime ユーザー プロパティを現在の日時にリセットすることで、アプリケーションに発行されたすべての更新トークンとセッション トークンを失効にします。 この操作により、ユーザーは強制的にこれらのアプリケーションに再度サインインされます。 この方法は invalidateAllRefreshTokens を置き換えるものです。 |
個人データをエクスポートする | なし | 組織ユーザーのデータをエクスポートするために、会社の管理者が行ったデータ ポリシーの操作要求を送信します。 |
AI の相互作用 | ||
すべてのエンタープライズ対話を取得する | aiInteraction コレクション | Copilot と Copilot の両方の応答に対するユーザー プロンプトを含む、すべてのMicrosoft 365 Copilot操作データを取得します。 |
App role assignments | ||
List | appRoleAssignment コレクション | ユーザーに割り当てられているアプリとアプリの役割を取得します。 |
追加する | appRoleAssignment | ユーザーにアプリの役割を割り当てます。 |
Remove | なし | ユーザーからアプリの役割の割り当てを削除します。 |
List appRoleAssignedResources | servicePrincipal コレクション | ユーザーが直接またはグループ メンバーシップを使用してアプリ の役割の割り当てを持っているアプリを取得します。 |
Calendar | ||
List calendars | Calendar collection | 予定表オブジェクトのコレクションを取得します。 |
Create calendar | Calendar | 予定表コレクションへの投稿により、新しい予定表を作成します。 |
予定表グループを一覧表示する | CalendarGroup collection | CalendarGroup オブジェクトのコレクションを取得します。 |
予定表グループを作成する | CalendarGroup | calendarGroups コレクションへの投稿により、新しい CalendarGroup を作成します。 |
List events | event コレクション | ユーザーのメールボックス内のイベント オブジェクトの一覧を取得します。 一覧には、単一インスタンスの会議と定期的なマスターが含まれています。 |
Create event | event | event コレクションへの投稿によって、新しいイベントを作成します。 |
会議の日時を検索する | meetingTimeSuggestionsResult | 出席者の空き時間情報、場所、または時間の制約に基づいて、集まる時間と場所を見つけます。 |
会議室を検索する | emailaddress.md コレクション | ユーザーのテナント内、または特定の部屋のリスト内のすべての会議を取得します。 |
会議室一覧を検索する | emailaddress.md コレクション | テナントで定義された部屋の一覧を取得します。 |
空き時間スケジュールを取得する | scheduleInformation | 指定された期間のユーザー、配布リスト、またはリソース (部屋または備品) のコレクションの空き時間情報を取得します。 |
予定表ビューを一覧表示する | event コレクション | event オブジェクトのコレクションを取得します。 |
通知ビュー | Reminder collection | 指定した開始時刻と終了時刻内の予定表のアラームの一覧を返します。 |
クラウド ライセンス | ||
使用権限を一覧表示する | microsoft.graph.cloudLicensing.usageRight コレクション | ユーザーに付与された usageRight オブジェクトの一覧を取得します。 |
使用状況を正しく取得する | microsoft.graph.cloudLicensing.usageRight | ユーザーに付与された usageRight オブジェクトのプロパティとリレーションシップを取得します。 |
クラウド PC | ||
クラウド PC の一覧表示 | cloudPC コレクション | サインインしているユーザーに起因する cloudPC デバイスを一覧表示します。 |
Get launch info | cloudPCLaunchInfo | サインインしているユーザーの cloudPCLaunchInfo を取得します。 |
委任された権限の付与 | ||
委任されたアクセス許可の付与を一覧表示する | oAuth2PermissionGrant コレクション | クライアント アプリケーションがユーザーの代わりに API にアクセスできるようにするために付与された委任されたアクセス許可の一覧を取得します。 |
Directory objects | ||
ID で取得する | String collection | ID のリストで指定されたディレクトリ オブジェクトを返します。 |
ディレクトリ オブジェクトのデルタを取得する | directoryObject コレクション | ユーザー、グループ、アプリケーション、サービス プリンシパルなどのディレクトリ オブジェクトの増分変更を取得します。 フィルター処理は、派生型の ID または派生型自体で必要です。 デルタ クエリの詳細については、「 デルタ クエリを使用して Microsoft Graph データの変更を追跡する」を参照してください。 |
メンバー グループをチェックする | String collection | グループの一覧内のメンバーシップを確認します。 チェックは推移的です。 |
メンバー グループを取得する | String コレクション | ユーザーがメンバーであるすべてのグループを返します。 チェックは推移的です。 |
メンバー オブジェクトを確認する | String collection | グループ、ディレクトリ ロール、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。 チェックは推移的です。 |
メンバー オブジェクトを取得する | String コレクション | ユーザーがメンバーになっているすべてのグループ、ディレクトリの役割、管理単位を返します。 チェックは推移的です。 |
推移的なレポートを取得する | 整数 | transitiveReports ナビゲーション プロパティから、ユーザーの推移的なレポート数を取得します。 |
作成されたオブジェクトを一覧表示する | directoryObject コレクション | そのユーザーにより作成されたディレクトリ オブジェクトを、createdObjects ナビゲーション プロパティから取得します。 |
所有されているデバイスを一覧表示する | directoryObject コレクション | ユーザーが所有しているデバイスを OwnedDevices ナビゲーション プロパティから取得します。 |
所有されているオブジェクトを一覧表示する | directoryObject コレクション | ユーザーが所有しているディレクトリ オブジェクトを ownedObjects ナビゲーション プロパティから取得します。 |
ユーザーによって所有されている削除済みグループを一覧表示する | directoryObject コレクション | 過去 30 日間にテナントで削除され、ユーザーによって所有されているグループを取得します。 |
登録されているデバイスを一覧表示する | directoryObject コレクション | そのユーザーについて登録されているデバイスを、RegisteredDevices ナビゲーション プロパティから取得します。 |
List scoped-role memberships | scopedRoleMembership コレクション | このユーザーのスコープ ロール管理単位のメンバーシップを取得します。 |
使用権限を一覧表示する | usageRight コレクション | ユーザーに付与されている使用権限のコレクションを取得します。 |
削除済みアイテムの一覧表示 | directoryObject コレクション | 過去 30 日間にテナントで削除されたユーザーを取得します。 |
削除済みアイテムの取得 | directoryObject コレクション | ID で削除されたユーザーを取得します。 |
削除済みアイテムの復元 | directoryObject コレクション | 過去 30 日間にテナントで削除されたユーザーを復元します。 |
アイテムを完全に削除する | directoryObject コレクション | テナントから削除されたユーザーを完全に削除します。 |
Drive | ||
Get drive | drive | Drive リソースのプロパティと関係を取得します。 |
List children | DriveItems | DriveItem の子リレーションシップで DriveItems のコレクションを返します。 |
Groups | ||
結合されたチームを一覧表示する | team コレクション | そのユーザーが直接のメンバーである Microsoft Teams のチームを、joinedTeams ナビゲーション プロパティから取得します。 |
所属を一覧表示する | directoryObject コレクション | そのユーザーが直接のメンバーであるグループ、ディレクトリ ロール、および管理単位を、memberOf ナビゲーション プロパティから取得します。 この操作は推移的ではありません。 |
推移的な所属を一覧表示する | directoryObject コレクション | 直接メンバーシップまたは推移的メンバーシップを通じてユーザーがメンバーになっているグループ、ディレクトリ ロール、および管理ユニットを取得します。 |
Insights | ||
List shared | sharedInsight コレクション | ユーザーと共有されているファイルのリストを返す計算された分析情報。 |
List trending | trending コレクション | ユーザーの周りで人気上昇中のアイテムのリストを返す計算された分析情報。 |
List used | usedInsight コレクション | ユーザーで使用されるファイルのリストを返す計算された分析情報。 |
ライセンスの管理 | ||
ライセンスを割り当てる | user | ユーザーのサブスクリプションを追加または削除します。 サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。 |
ライセンスの詳細を一覧表示する | licenseDetails コレクション | licenseDetails オブジェクトのコレクションを取得します。 |
ライセンスの割り当てを再処理する | user | ユーザーのサブスクリプション割り当てを再処理します。 |
メール フォルダーを一覧表示する | mailFolder コレクション | サインイン中のユーザーのルート フォルダーからメール フォルダー コレクションを取得します。 |
メール フォルダーを作成する | mailFolder | mailFolder コレクションへの投稿により、新しい mailFolder を作成します |
List messages | message コレクション | サインインしているユーザーのメールボックス内のすべてのメッセージを取得します。 |
メッセージの作成 | message | メッセージ コレクションへの投稿により、メッセージを作成します。 |
List overrides | inferenceClassificationOverride コレクション | ユーザーが設定した優先受信トレイのオーバーライドを取得して、特定の送信者からのメッセージを一定の方法で分類します。 |
オーバーライドを作成する | inferenceClassificationOverride | SMTP アドレスで示される送信者の優先受信トレイのオーバーライドを作成します。 |
List rules | messageRule コレクション | ユーザーの受信トレイに定義されているすべての messageRule オブジェクトを取得します。 |
ルールを作成する | messageRule | 条件とアクションのセットを指定して messageRule オブジェクトを作成します。 |
Send mail | なし | 要求本文に指定されたメッセージを送信します。 |
メールのヒントを取得する | mailTips コレクション | サインイン中のユーザーが利用できる、1 人または複数の受信者に対してのメール ヒントを返します。 |
Notes | ||
List notebooks | notebook コレクション | ノートブック オブジェクトの一覧を取得します。 |
Create notebook | notebook | 新しい OneNote のノートブックを作成します。 |
Org hierarchy | ||
Assign manager | なし | ユーザーのマネージャーを割り当てます。 |
Get manager | directoryObject | そのユーザーの上司であるユーザーまたは連絡先を、マネージャー ナビゲーション プロパティから取得します。 |
Remove manager | なし | ユーザーのマネージャーを削除します。 |
直属の部下を一覧表示する | directoryObject コレクション | そのユーザーの部下であるユーザーと連絡先を、directReports ナビゲーション プロパティから取得します。 |
Outlook settings | ||
Get user mailbox settings | mailboxSettings | ユーザーの mailboxSettings を取得します。 |
ユーザーのメールボックスの設定を更新する | mailboxSettings | ユーザーの 1 つの以上の mailboxSettings を有効化、構成、または無効化します。 |
List Outlook categories | outlookCategory コレクション | ユーザーに対して定義されているすべてのカテゴリを取得します。 |
Create Outlook category | outlookCategory | ユーザーのマスター カテゴリ リスト内に outlookCategory オブジェクトを作成します。 |
サポートされている言語を取得する | localeInfo コレクション | ユーザーに対してサポートされている (ユーザーのメールボックス サーバーで構成されている) ロケールと言語のリストを取得します。 |
サポートされているタイム ゾーンを取得する | timeZoneInformation コレクション | ユーザーに対してサポートされている (ユーザーのメールボックス サーバーで構成されている) タイム ゾーンのリストを取得します。 |
Exchange ID の翻訳 | convertIdResult コレクション | Outlook 関連リソースの ID の形式を変換します。 |
パスワードベースのシングル サインオン資格情報 | ||
Get | passwordSingleSignOnCredentialSet コレクション | 特定のユーザーのパスワード ベースのシングル サインオン資格情報のリストを取得します。 パスワードは返されず、代わりに、常に null または空の文字列として返されます。 |
Delete | なし | 特定のユーザーに関連付けられた特定のサービス プリンシパルのパスワード ベースのシングル サインオン資格情報を削除します。 |
People | ||
List | person | ユーザーとの関連 (ユーザーのコミュニケーションとコラボレーション パターン、およびビジネスのリレーションシップによって決まる) によって配列された人物オブジェクトの一覧を取得します。 |
個人用連絡先 | ||
List contacts | contact コレクション | サインイン中のユーザーの既定の連絡先フォルダーから連絡先コレクションを取得します。 |
Create contact | contact | 連絡先コレクションへの投稿により、新しい連絡先を作成します。 |
連絡先フォルダーを一覧表示する | contactFolder コレクション | サインイン中のユーザーの既定の連絡先フォルダー内で連絡先フォルダーのコレクションを取得します。 |
連絡先フォルダーを作成する | contactFolder | contactFolder コレクションへの投稿により、新しい contactFolder を作成します。 |
プロフィールの写真 | ||
Get | profilePhoto | 指定した profilePhoto またはそのメタデータ (profilePhoto プロパティ) を取得します。 |
Update | なし | サインイン ユーザー、または指定されたグループあるいは連絡先を含むテナント内の任意のユーザーの写真を更新します。 |
Delete | なし | サインイン ユーザー、または指定されたグループを含むテナント内の任意のユーザーの写真を削除します。 |
Planner | ||
お気に入りのプランを一覧表示する | plannerPlan コレクション | ユーザーがお気に入りとしてマークした plannerPlans の一覧を取得します。 |
最近のプランを一覧表示する | plannerPlan コレクション | ユーザーが最近表示した plannerPlans の一覧を取得します。 |
List tasks | plannerTask コレクション | ユーザーに割り当てられている Planner タスクを取得します。 |
Update settings | なし | plannerUser オブジェクトのプロパティを更新します。 |
Profile | ||
Get | profile | 特定のユーザーのプロファイル オブジェクトのプロパティと関係を取得します。 |
Delete | なし | ユーザーのアカウントからプロファイル オブジェクトを削除します。 |
Sponsors | ||
Assign | なし | ユーザーにスポンサーを割り当てます。 |
List | directoryObject コレクション | このユーザーのスポンサーであるユーザーとグループを取得します。 |
Remove | なし | ユーザーのスポンサーを削除します。 |
招待元の一覧 | directoryObject | 指定したユーザーをテナントに招待したユーザーまたはサービス プリンシパルを取得します。 |
Teamwork | ||
ユーザーのインストールされたアプリを一覧表示する | userScopeTeamsAppInstallation コレクション | ユーザーのパーソナル スコープ内にインストールされているアプリを一覧表示します。 |
ユーザー用にインストールされているアプリを取得する | userScopeTeamsAppInstallation | ユーザーのパーソナル スコープ内にインストールされている指定のアプリを一覧表示します。 |
ユーザーのアプリを追加する | なし | ユーザーのパーソナル スコープ内にアプリを追加 (インストール) します。 |
ユーザーのアプリを削除する | なし | ユーザーのパーソナル スコープ内からアプリを削除 (アンインストール) します。 |
ユーザーのインストールされたアプリをアップグレードする | なし | ユーザーのパーソナル スコープ内にインストールされたアプリを最新バージョンにアップグレードします。 |
ユーザーとアプリの間でチャットを行う | Chat | ユーザーとアプリの間に 1 対 1 のチャットが表示されます。 |
権限付与の表示 | resourceSpecificPermissionGrant コレクション | ユーザーのすべてのリソース固有のアクセス許可を一覧表示します。 |
To-do tasks | ||
List tasks | todoTask コレクション | 指定されたリスト内のすべての todoTask リソースを取得します。 |
Create task | todoTask | 指定したタスク リストに todoTask を作成します。 |
List task lists | todoTaskList コレクション | ユーザーのメールボックス内のすべてのタスク リストを取得します。 |
Create task list | todoTaskList | ユーザーのメールボックスに To Do タスク リストを作成します。 |
User settings | ||
Get | userSettings | ユーザーおよび組織の設定オブジェクトを読み取ります。 |
Update | userSettings | 設定オブジェクトのプロパティを更新します。 |
プロパティ
重要
$filter
および $search
クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual
と $count
に使用する場合にのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
プロパティ | 型 | 説明 |
---|---|---|
aboutMe | String | ユーザーが自分自身について記述する、フリー フォームのテキスト入力フィールド。 $select でのみ返されます。 |
accountEnabled | Boolean | アカウントが有効な場合は true であり、それ以外の場合は false です。 このプロパティは、ユーザーの作成時に必要です。 $filter (eq 、ne 、not 、および in ) をサポートします。 |
ageGroup | ageGroup | ユーザーの年齢グループを設定します。 使用できる値: null 、Minor 、NotAdult 、および Adult 。 詳細については、「法的年齢グループ プロパティの定義」を参照してください。 $filter (eq 、ne 、not 、および in ) をサポートします。 |
assignedLicenses | assignedLicense コレクション | 継承された (グループ ベースの) ライセンスを含む、ユーザーに割り当てられているライセンス。 このプロパティは、直接割り当て済みライセンスと継承済みライセンスを区別しません。
licenseAssignmentStates プロパティを使用して、直接割り当て済みライセンスと継承済みライセンスを識別します。 null 許容ではありません。 $filter (eq 、not 、/$count eq 0 、/$count ne 0 ) をサポートします。 |
assignedPlans | assignedPlan collection | ユーザーに割り当てられているプラン。 読み取り専用です。 null 許容ではありません。$filter (eq と not ) をサポートします。 |
authorizationInfo | authorizationInfo | Azure AD 以外の環境でユーザーを識別および認証するために使用できる識別子。 このプロパティは、ユーザーがオンプレミスの Active Directory デプロイまたはフェデレーション アクセスにアクセスするために使用するスマートカード ベースの証明書の識別子を格納できます。 また、Common Access Card (CAC) に関連付けられたサブジェクト代替名 (SAN) を格納するためにも使用できます。 Null 許容型。$filter (eq と startsWith ) をサポートします。 |
birthday | DateTimeOffset | ユーザーの誕生日。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 単位です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 $select でのみ返されます。 |
businessPhones | String collection | ユーザーの電話番号。 このプロパティに設定できる番号は 1 つだけです。 オンプレミス ディレクトリから同期しているユーザーの場合は読み取り専用です。 $filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
city | String | ユーザーがいる都市。 最大文字数は 128 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
cloudLicensing | microsoft.graph.cloudLicensing.userCloudLicensing | ユーザーとクラウド ライセンス リソースの関係。 |
cloudRealtimeCommunicationInfo | cloudRealtimeCommunicationInfo | ユーザーに関連する Microsoft リアルタイム通信情報。 $filter (eq 、ne 、not ) をサポートします。 |
CompanyName | String | ユーザーが関連付けられた会社のオフィスの名前。 このプロパティは、外部ユーザーが所属する会社を記述するのに役立ちます。 最大の長さは 64 文字です。$filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
consentProvidedForMinor | consentProvidedForMinor | 未成年者について同意を得ているかどうかを設定します。 使用できる値: null 、Granted 、Denied 、および NotRequired 。 詳細については、「法的年齢グループ プロパティの定義」を参照してください。 $filter (eq 、ne 、not 、および in ) をサポートします。 |
country | String | ユーザーがいる国または地域。たとえば、US や UK です。 最大文字数は 128 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
createdDateTime | DateTimeOffset | ユーザーが ISO 8601 形式および UTC で作成された日付と時刻。 値は変更できず、エンティティが作成されると自動的に設定されます。 Null 許容型。 オンプレミス ユーザーの場合、値は、Microsoft Entra ID で最初に作成された日時を表します。 2018 年 6 月より前に作成された一部のユーザー、および 2018 年 6 月より前に Microsoft Entra ID に同期されたオンプレミス ユーザーの場合、プロパティは null です。 読み取り専用です。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
creationType | String | ユーザー アカウントが次のいずれかの方法で作成されたかどうかを示します。
読み取り専用です。 $filter (eq 、ne 、not 、および in ) をサポートします。 |
customSecurityAttributes | customSecurityAttributeValue | ディレクトリ オブジェクトに割り当てられたカスタム セキュリティ属性の値を保持するオープン複合型。 Null 許容型。 でのみ返されます。 $select
$filter (eq 、ne 、not 、startsWith ) をサポートします。 フィルター値では、大文字と小文字が区別されます。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
deletedDateTime | DateTimeOffset | ユーザーが削除された日付と時刻。 $filter (eq 、ne 、not 、ge 、le と in ) をサポートします。 |
department | String | ユーザーが働いている部署の名前。 最大文字数は 64 文字です。$filter (eq 、ne 、 not 、 ge 、 le 、 in 、 および eq の null 値) をサポートします。 |
displayName | String | アドレス帳に表示されるユーザーの名前。 この値は通常、ユーザーの名前、ミドルネームのイニシャル、姓の組み合わせになります。 このプロパティはユーザーの作成時に必須です。更新時にクリアすることはできません。 最大文字数は 256 文字です。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値)、$orderby 、および $search をサポートします。 |
employeeHireDate | DateTimeOffset | ユーザーが採用された日時、または将来採用される場合に仕事を開始する予定の日時。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
employeeLeaveDateTime | DateTimeOffset | ユーザーが退職した日時または退職する予定の日時。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 詳細については、「ユーザーの employeeLeaveDateTime プロパティを構成する」を参照してください。 |
employeeId | String | 組織によりユーザーに割り当てられた従業員 ID。 最大長は 16 文字です。$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値) をサポートします。 |
employeeOrgData | employeeOrgData | ユーザーに関連付けられた組織データ (部署や costCenter など) を表します。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
employeeType | String | エンタープライズ ワーカーの種類を取得します。 たとえば、Employee 、Contractor 、Consultant 、または Vendor です。
$filter (eq 、ne 、not 、ge 、le 、in 、startsWith ) をサポートします。 |
externalUserConvertedOn | DateTimeOffset | ユーザーが外部から内部に変換された日時。 |
externalUserState | String |
invitation API を使用してテナントに招待された外部ユーザーの場合、このプロパティは招待されたユーザーの招待の状態を示します。 招待されたユーザーの状態は PendingAcceptance 、Accepted 、または null (その他のすべてのユーザー) です。 $filter (eq 、ne 、not 、in ) をサポートします。 |
externalUserStateChangeDateTime | String | externalUserState プロパティに対する最終変更のタイムスタンプを示します。 $filter (eq 、ne 、not 、in ) をサポートします。 |
faxNumber | String | ユーザーの Fax 番号。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値) をサポートします。 |
givenName | String | ユーザーの名。 最大文字数は 64 文字です。
$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値) をサポートします。 |
hireDate | DateTimeOffset | ユーザーの採用日付。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 単位です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 でのみ返されます。 $select 注: このプロパティは SharePoint Online に固有のものです。 ネイティブの employeeHireDate プロパティを使用して設定し、Microsoft Graph API を使用して採用日の値を更新することをお勧めします。 |
id | String | ユーザーの一意の識別子。 不透明な識別子として扱う必要があります。
directoryObject から継承されます。 null 許容ではありません。 読み取り専用です。 $filter (eq 、ne 、not 、in ) をサポートします。 |
identities | objectIdentity コレクション | このユーザー アカウントへのサインインに使用できる ID を表します。 ID は、Microsoft (ローカル アカウントとも呼ばれます)、組織、または Facebook、Google、Microsoft などのソーシャル ID プロバイダーによって提供され、ユーザー アカウントに関連付けられます。 同じ signInType 値を持つ複数のアイテムを含めることができます。 制限付き $filter (eq ) をサポートします。 |
imAddresses | String collection | ユーザーのインスタント メッセージ ボイス オーバー IP (VOIP) セッション開始プロトコル (SIP) のアドレス。 読み取り専用です。
$filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
infoCatalogs | String コレクション | ユーザーに割り当てられている情報セグメントを示します。
$filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
interests | String collection | ユーザーが自分の関心事を記述するリスト。 でのみ返されます。 $select |
isLicenseReconciliationNeeded | ブール型 | ユーザーが Exchange メールボックス ライセンスの割り当てを保留しているかどうかを示します。 読み取り専用です。 $filter (true の場合は eq のみ) をサポートします。 |
isManagementRestricted | ブール型 |
true ユーザーが制限付き管理管理単位のメンバーである場合。 既定値は、false です。 読み取り専用です。 制限付き管理管理単位のメンバーであるユーザーを管理するには、管理者または呼び出し元アプリに、制限付き管理管理単位のスコープでMicrosoft Entraロールを割り当てる必要があります。 |
isResourceAccount | Boolean | 使わないでください。今後の使用のために予約されています。 |
jobTitle | String | ユーザーの役職。 最大文字数は 128 文字です。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値) をサポートします。 |
lastPasswordChangeDateTime | DateTimeOffset | この Microsoft Entra ユーザーが最後にパスワードを変更した日付、またはパスワードが作成された日付のうち、最新のアクションが実行された日付。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 単位です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。 でのみ返されます。 $select |
legalAgeGroupClassification | legalAgeGroupClassification | エンタープライズ アプリケーションで使用され、ユーザーの法的年齢グループを示します。 このプロパティは読み取り専用で、ageGroup と consentProvidedForMinor プロパティに基づいて計算されます。 使用できる値: null 、MinorWithOutParentalConsent 、MinorWithParentalConsent 、MinorNoParentalConsentRequired 、NotAdult 、および Adult 。 詳細については、「法的年齢グループ プロパティの定義」を参照してください。 でのみ返されます。 $select |
licenseAssignmentStates | licenseAssignmentState コレクション | このユーザーへのライセンス割り当ての状態です。 また、直接割り当てられたライセンス、およびユーザーがグループ メンバーシップを通じて継承したライセンスも示します。 読み取り専用です。 でのみ返されます。 $select |
String | ユーザーの SMTP アドレス (たとえば、admin@contoso.com )。 このプロパティを変更すると、その値が SMTP アドレスとして表示されるように、ユーザーの proxyAddresses コレクションも更新されます。 このプロパティにアクセント記号は使用できません。 メモ: Azure AD B2C ユーザー プロファイル用にこのプロパティを更新することはお勧めしません。 代わりに otherMails プロパティを使用してください。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith 、 endsWith および eq の null 値) をサポートします。 |
|
mailboxSettings | mailboxSettings | サインイン ユーザーのプライマリ メールボックスの設定。 着信メッセージに対する自動応答を送信するための設定、ロケール、タイム ゾーンを 取得 または 更新 できます。 詳細については、「言語と地域の形式のユーザー設定」を参照してください。 でのみ返されます。 $select |
mailNickname | String | ユーザーの電子メール エイリアス。 ユーザーの作成時に、このプロパティを指定する必要があります。 最大文字数は 64 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
mobilePhone | String | ユーザーの主な携帯電話の番号。 オンプレミスディレクトリから同期しているユーザーの場合は読み取り専用です。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および null の eq 値)、および $search をサポートします。 |
mySite | String | ユーザーのサイトの URL。 でのみ返されます。 $select |
officeLocation | String | ユーザーの勤務先の場所。 最大文字数は 128 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
onPremisesDistinguishedName | String | オンプレミスの Active Directory distinguished name または DN が含まれています。 |
onPremisesDomainName | String | オンプレミス ディレクトリから同期されたオンプレミス domainFQDN (dnsDomainName とも呼ばれます) が含まれています。 |
onPremisesExtensionAttributes | onPremisesExtensionAttributes | ユーザーの extensionAttributes1 - 15 が含まれています。 これらの拡張属性は、Exchange カスタム属性 1-15 とも呼ばれます。 各属性には、最大 1024 文字を格納できます。 false ) の場合、これらのプロパティはユーザー オブジェクトの作成時または更新時に設定できます。 $filter (eq 、ne 、not 、in ) をサポートします。 |
onPremisesImmutableId | String | このプロパティは、オンプレミスの Active Directory ユーザー アカウントを Microsoft Entra ユーザー オブジェクトに関連付けます。 Graph で新しいユーザー アカウントを作成するとき、ユーザーの userPrincipalName (UPN) プロパティにフェデレーション ドメインを使用する場合は、このプロパティを指定する必要があります。
重要:$ と _ の文字は、このプロパティを指定するときには使用できません。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
onPremisesLastSyncDateTime | DateTimeOffset | オブジェクトがオンプレミス ディレクトリと前回、同期された日時を示します。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 単位です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
onPremisesProvisioningErrors | onPremisesProvisioningError コレクション | Microsoft 同期製品のプロビジョニング中に発生するエラーです。 $filter (eq 、not 、ge 、le ) をサポートします。 |
onPremisesSamAccountName | String | オンプレミス ディレクトリから同期されたオンプレミス sAMAccountName が含まれています。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith ) をサポートします。 |
onPremisesSecurityIdentifier | String | オンプレミスからクラウドに同期されたユーザーのオンプレミスのセキュリティ識別子 (SID) が含まれます。 "S-1-5-21-1180699209-877415012-3182824384-1006" などの SID 形式である必要があります。
$filter をサポートします (null 値を含む eq )。 |
onPremisesSipInfo | onPremisesSipInfo | ユーザーに関連するすべてのオンプレミス セッション開始プロトコル (SIP) 情報が含まれます。 読み取り専用です。 |
onPremisesSyncEnabled | Boolean |
true このユーザー オブジェクトが現在オンプレミスの Active Directory (AD) から同期されている場合。それ以外の場合、ユーザーは同期されず、Microsoft Entra ID で管理できます。 読み取り専用です。 $filter (eq 、ne 、not 、in 、および eq の null 値) をサポートします。 |
onPremisesUserPrincipalName | String | オンプレミス ディレクトリから同期されたオンプレミス userPrincipalName が含まれています。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith ) をサポートします。 |
otherMails | String collection | ユーザーの追加のメール アドレスの一覧 (例: ["bob@contoso.com", "Robert@fabrikam.com"] )。このプロパティにアクセント文字を含めることはできません。 $filter (eq 、not 、ge 、le 、in 、startsWith 、endsWith 、/$count eq 0 、/$count ne 0 ) をサポートします。 |
passwordPolicies | String | ユーザーのパスワード ポリシーを指定します。 この値は列挙値であり、可能な 1 つの値は DisableStrongPassword です。この場合は、既定のポリシーより弱いパスワードを指定できます。
DisablePasswordExpiration を指定することもできます。 2 つを一緒に指定できます。例: DisablePasswordExpiration, DisableStrongPassword 。 既定のパスワード ポリシーの詳細については、「Microsoft Entra パスワード ポリシー」を参照してください。 $filter (ne 、 not 、 および eq の null 値) をサポートします。 |
passwordProfile | passwordProfile | ユーザーのパスワード プロファイルを指定します。 プロファイルには、ユーザーのパスワードが含まれています。 このプロパティは、ユーザーの作成時に必要です。 プロファイルにあるパスワードは、passwordPolicies プロパティによって指定されている最小要件を満たす必要があります。 既定では、強力なパスワードが必要です。 $filter (eq 、ne 、not 、in 、および eq の null 値) をサポートします。 このプロパティを更新するには: |
pastProjects | String collection | ユーザーが過去のプロジェクトを列挙するリスト。 でのみ返されます。 $select |
postalCode | String | ユーザーの住所の郵便番号。 郵便番号は、ユーザーの国/地域に固有です。 アメリカ合衆国では、この属性には、ZIP コードが含まれます。 最大文字数は 40 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
preferredDataLocation | String | ユーザーの優先されるデータの場所。 詳細については、「OneDrive Online Multi-Geo」を参照してください。 |
preferredLanguage | String | ユーザーが設定する言語。 既定の言語形式は RFC 4646 に基づいています。 名前は、言語に関する ISO 639 の 2 文字のカルチャ コード (小文字) と、国や地域に関する ISO 3166 の 2 文字のサブカルチャ コード (大文字) の組み合わせです。 たとえば、"en-US" や "es-ES" です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
preferredName | String | ユーザーが設定する名前。 サポートされていません。 この属性は空の文字列を返します。 でのみ返されます。 $select |
provisionedPlans | ProvisionedPlan コレクション | ユーザーのために用意されたプラン。 読み取り専用です。 null 許容ではありません。
$filter (eq 、not 、ge 、le ) をサポートします。 |
proxyAddresses | String collection | 例: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] 。
mail プロパティを変更すると、その値が SMTP アドレスとして表示されるように、このコレクションも更新されます。 詳細については、「mail および proxyAddresses プロパティ」を参照してください。 先頭に SMTP (大文字) が付くプロキシ アドレスがプライマリ プロキシ アドレスで、先頭に smtp が付くプロキシ アドレスはセカンダリ プロキシ アドレスです。 Azure AD B2C アカウントの場合、このプロパティには一意のアドレスが 10 個までの制限があります。 Microsoft Graph では読み取り専用です。このプロパティは、Microsoft 365 管理センターからのみ更新できます。 null 許容ではありません。 $filter (eq 、not 、ge 、le 、startsWith 、endsWith 、/$count eq 0 、/$count ne 0 ) をサポートします。 |
refreshTokensValidFromDateTime | DateTimeOffset | この時点よりも前に発行された更新トークンとセッション トークン (セッション Cookie) はすべて無効であり、アプリケーションが無効な更新トークンまたはセッション トークンを使用して (Microsoft Graph などの API にアクセスする目的で) 代理アクセス トークンを取得しようとすると、エラーが発生します。 この状況が発生した、アプリケーションは承認されたエンドポイントを要求して、新しい更新トークンを取得する必要があります。 読み取り専用です。 リセットするには invalidateAllRefreshTokens を使用します。 |
responsibilities | String collection | ユーザーが自分の責任の範囲を列挙する一覧。 でのみ返されます。 $select |
schools | String collection | ユーザーが在籍した学校を列挙する一覧。 でのみ返されます。 $select |
securityIdentifier | 文字列 | Windows シナリオで使用されるユーザーのセキュリティ識別子 (SID)。 読み取り専用です。 既定で返されます。 $select および$filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
serviceProvisioningErrors | serviceProvisioningError コレクション | ユーザー オブジェクトからのプロパティまたはリンクに関する非一時的なサービス固有のエラーを記述するフェデレーション サービスによって発行されたエラー。 |
showInAddressList | Boolean | Microsoft Graph では使用しないでください。 Microsoft 365 管理センターを通じてこのプロパティを管理してください。 ユーザーを Outlook グローバル アドレス一覧に含めるかどうかを表します。 「既知の問題」を参照してください。 |
signInSessionsValidFromDateTime | DateTimeOffset | この時点よりも前に発行された更新トークンとセッション トークン (セッション Cookie) はすべて無効であり、アプリケーションが無効な更新トークンまたはセッション トークンを使用して (Microsoft Graph などの API にアクセスする目的で) 代理アクセス トークンを取得しようとすると、エラーが発生します。 この状況が発生した場合、アプリケーションは承認されたエンドポイントを要求して、新しい更新トークンを取得する必要があります。 読み取り専用です。 revokeSignInSessions を使用して再設定します。 |
skills | String collection | ユーザーが自分のスキルを列挙する一覧。 でのみ返されます。 $select |
signInActivity | signInActivity | 指定ユーザーの最後のサインイン日時とサインイン要求 ID を取得します。 読み取り専用です。 でのみ返されます。 $select
$filter (eq 、ne 、not 、ge 、le ) をサポートしますが、他のフィルター可能なプロパティと共にはサポートしません。 注: |
state | String | ユーザーの住所の都道府県。 最大文字数は 128 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
streetAddress | String | ユーザーの勤務先の番地。 最大文字数は 1024 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
surname | String | ユーザーの姓。 最大文字数は 64 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
usageLocation | String | 2 文字の国コード (ISO 規格 3166) 国におけるサービスの利用可能性を確認することが法的に義務付けられているため、ライセンスが割り当てられるユーザーには必須です。 たとえば、US 、JP 、GB などがあります。 null 許容ではありません。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
userPrincipalName | String | ユーザーのユーザー プリンシパル名 (UPN)。 UPN は、インターネット標準 RFC 822 に基づいた、インターネット スタイルのユーザーのサインイン名です。 規則では、これはユーザーの電子メール名にマップされる必要があります。 一般的な形式は alias@domain です。このドメインは、テナントの検証済みドメインのコレクション内に存在している必要があります。 このプロパティは、ユーザーの作成時に必要です。 テナントの検証済みドメインには、organization の verifiedDomains プロパティからアクセスできます。 このプロパティにアクセント文字を含めることはできません。 次の文字のみ使用することができます A - Z 、a - z 、0 - 9 、' . - _ ! # ^ ~ 。 使用できる文字の完全なリストについてはユーザー名 ポリシーを参照してください。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、endsWith ) と $orderby をサポートします。 |
userType | String | ディレクトリ内のユーザーの種類を分類するために使用できる文字列型 (String) の値。 使用可能な値は、 Member と Guest です。 $filter (eq 、ne 、not 、in 、および eq の null 値) をサポートします。
注:メンバー ユーザーとゲスト ユーザーのアクセス許可に関する詳細については、「Microsoft Entra ID での既定のユーザー アクセス許可とは?」を参照してください。 |
ヒント
ディレクトリ拡張と関連データは既定で返されます。スキーマ拡張と関連データは $select
でのみ返され、オープン拡張機能と関連データは $expand
でのみ返されます。
mail プロパティと proxyAddresses プロパティ
mail と proxyAddresses はいずれもメール関連のプロパティです。 proxyAddresses は、Microsoft Exchange Server にのみ関連するアドレスのコレクションです。 これは、1 つのメールボックスに関連付けされているユーザーのメール アドレスの一覧を格納するために使用されます。 mail プロパティは、ユーザーのサインインなどのさまざまな目的でユーザーのメール アドレスとして使用され、プライマリ プロキシ アドレスを定義します。
mail と proxyAddresses は、GET user API 経由で取得できます。 Update user API を使用して mail を更新できますが、Microsoft Graph を介して proxyAddresses を更新することはできません。 ユーザーの mail プロパティが更新されると、proxyAddresses の再計算がトリガーされ、新たに更新された mail がプライマリ プロキシ アドレスとして設定されますが、以下のようなシナリオは例外です。
- ユーザーが Microsoft Exchange を含むライセンスを持っている場合、ユーザーのすべてのプロキシ アドレスは、テナント上の検証済みドメインに属している必要があります。 検証済みドメインに属していないプロキシ アドレスは、通知されずに削除されます。
- ユーザーがゲストで、プライマリ プロキシ アドレスに
#EXT#
を持つゲスト ユーザーの UPN 文字列が含まれている場合、ユーザーのメールはプライマリ プロキシ アドレスに設定されません。 - ユーザーがゲストである場合、プロキシ アドレスを持っていなくてもユーザーのメールは削除されません。
proxyAddresses は、ディレクトリ オブジェクト (ユーザー、グループ、および組織の連絡先) 全体で一意です。 ユーザーの mail プロパティが別のオブジェクトの proxyAddresses の 1 つと競合する場合、mail の更新が失敗し、proxyAddresses プロパティも更新されません。
言語と地域の形式のユーザー設定
user リソースには、ユーザーの優先する言語、日付と時刻の形式、既定のタイムゾーン、およびプライマリ Exchange メールボックス専用のその他の設定を含む、mailboxSettings プロパティが含まれます。 これらの設定は、メール クライアントを対象としており、ユーザーに対してメールボックスがプロビジョニングされている場合のみ利用できます。 Outlook のメール、予定表、連絡先、または To Do タスクにのみ焦点を当てたシナリオでは、mailboxSettings を使用できます。
mailboxSettings に加えて、ユーザーは userSettings を使って、regionalAndLanguageSettings へのリレーションシップを含めます。これは、すべてのアプリケーションで使用できる、ユーザー設定された言語と地域の設定のスーパーセットで、ユーザーに最適な言語と地域の設定体験を提供します。 userSettings を使用すると、Microsoft Entra のユーザー プロファイルによって、同じユーザー設定を反映して、アプリ全体で一貫した操作性を実現できます。
法的年齢グループ プロパティの定義
ここでは、Microsoft Entra 管理者とエンタープライズ アプリケーション開発者が年齢関連の規制に準拠するために、3 つの年齢グループ プロパティ (legalAgeGroupClassification、ageGroup、および consentProvidedForMinor) を使用する方法を説明します。
- legalAgeGroupClassification プロパティは、読み取り専用です。 エンタープライズ アプリケーション開発者はこれを使用して、ユーザーの法的年齢グループに基づいてそのユーザーを適切に対処できるようにします。 これは、ユーザーの ageGroup および consentProvidedForMinor プロパティに基づいて計算されます。
- ageGroup と consentProvidedForMinor はオプションのプロパティであり、Microsoft Entra 管理者はこれらのプロパティを使用して、ユーザーの国または地域で施行されている年齢関連の規制に基づいてアカウントの使用が正しく行われるようにします。
たとえば、Cameron は英国の Holyport にある小学校でディレクトリを管理する管理者です。 学年の始まりに、英国の年齢関連の規制に基づき、入学書類を使用して未成年者の保護者から同意を得ます。 保護者から取得した同意により、未成年者のアカウントを Holyport スクールと Microsoft アプリが使用することが許可されます。 次に Cameron はすべてのアカウントを作成し、ageGroup を "minor" に、consentProvidedForMinor を "granted" に設定します。 これにより、生徒が使用するアプリケーションでは未成年に適していない機能が非表示になります。
legalAgeGroupClassification 値
メンバー | 説明 |
---|---|
null | 既定値。ユーザーに ageGroup が設定されていません。 |
MinorWithoutParentalConsent | (将来使用するために予約されています) |
MinorWithParentalConsent | 当該国または地域の年齢関連規制に基づいてユーザーが未成年と判断され、アカウントの管理者が保護者から適切な同意を得ています。 |
Adult | ユーザーは当該国または地域の年齢関連規制に基づいて成人と判断されています。 |
NotAdult | ユーザーは追加の年齢関連規制がある国または地域 (米国、英国、欧州連合、韓国など) におり、ユーザーの年齢は未成年と成人の間です (国または地域での規定に基づく)。 通常、規制対象の国では 10 代の若者は notAdult とみなされます。 |
MinorNoParentalConsentRequired | ユーザーは未成年ですが、年齢関連の規制のない国または地域にいます。 |
ageGroup 値
メンバー | 説明 |
---|---|
null | 既定値。ユーザーに ageGroup が設定されていません。 |
マイナー | ユーザーは未成年として扱われます。 |
NotAdult | ユーザーは法的規制のある国 (米国、英国、欧州連合、または韓国) におり、ユーザーの年齢は未成年者の年齢の上限 (国に応じて異なる) を超えているが成人の年齢の下限 (国または地域に基づき規定されている) 未満です。 したがって基本的に 10 代の若者は規制対象の国では notAdult とみなされます。 |
Adult | ユーザーは成人として扱われます。 |
consentProvidedForMinor 値
メンバー | 説明 |
---|---|
null | 既定値。ユーザーに consentProvidedForMinor が設定されていません。 |
Granted | ユーザーがアカウントを所有することについて同意が得られています。 |
Denied | ユーザーがアカウントを所有することについて同意が得られていません。 |
NotRequired | ユーザーは、同意を必要としない場所にいます。 |
リレーションシップ
リレーションシップ | 型 | 説明 |
---|---|---|
activities | userActivity コレクション | デバイス間におけるユーザーのアクティビティ。 読み取り専用です。 Null 許容型。 |
agreementAcceptances | agreementAcceptance コレクション | 利用規約に対するユーザー承認状態。 読み取り専用です。 Null 許容型。 |
appRoleAssignments | appRoleAssignment コレクション | ユーザーがアプリに対して付与されているアプリの役割を表します。
$expand をサポートします。 |
認証 | authentication | ユーザーに対してサポートされている認証方法。 |
calendar | calendar | ユーザーの標準予定表。 読み取り専用です。 |
calendarGroups | calendarGroup コレクション | ユーザーの予定表グループ。 読み取り専用です。 Null 許容型。 |
calendarView | event コレクション | 予定表のカレンダー ビュー。 読み取り専用です。 Null 許容型。 |
calendars | calendar コレクション | ユーザーの予定表。 読み取り専用です。 Null 許容型。 |
contactFolders | contactFolder コレクション | ユーザーの連絡先フォルダー。 読み取り専用です。 Null 許容型。 |
contacts | contact コレクション | ユーザーの連絡先。 読み取り専用です。 Null 許容型。 |
createdObjects | directoryObject コレクション | ユーザーが作成したディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。 |
directReports | directoryObject コレクション | そのユーザーの部下であるユーザーと連絡先。 (マネージャー プロパティがこのユーザーに設定されている、ユーザーと連絡先。) 読み取り専用です。 Null 許容型。
$expand をサポートします。 |
ドライブ | drive | ユーザーの OneDrive。 読み取り専用です。 |
drives | drive コレクション | このユーザーが使用できるドライブのコレクション。 読み取り専用です。 |
events | event コレクション | ユーザーのイベント。 既定では、既定の予定表でイベントを表示します。 読み取り専用です。 Null 許容型。 |
extensions | extension コレクション | ユーザーに対して定義されているオープン拡張機能のコレクション。
$expand をサポートします。 Null 許容型。 |
inferenceClassification | inferenceClassification | 明示的な指定に基づく、ユーザーのメッセージの関連性の分類。明示的な指定は、推定される関連性や重要性より優先されます。 |
insights | itemInsights | 高度な分析と機械学習の手法を使用して計算された、職場または学校のドキュメント用の OneDrive などのユーザーとアイテム間のリレーションシップを表します。 読み取り専用です。 Null 許容型。 |
invitedBy | directoryObject | ユーザーを招待したユーザーまたはサービス プリンシパル。 |
joinedGroups | group コレクション | 読み取り専用です。 Null 許容型です。 |
mailFolders | mailFolder コレクション | ユーザーのメール フォルダー。 読み取り専用です。 Null 許容型。 |
manager | directoryObject | このユーザーの上司であるユーザーまたは連絡先。 読み取り専用です。
$expand をサポートします。 |
memberOf | directoryObject コレクション | ユーザーがメンバーになっているグループ、ディレクトリ ロール、および管理単位。 読み取り専用です。 Null 許容型。
$expand をサポートします。 |
joinedTeams | team コレクション | ユーザーがメンバーである Microsoft Teams のチーム。 読み取り専用です。 Null 許容型。 |
messages | message コレクション | メールボックスまたはフォルダー内のメッセージ。 読み取り専用です。 Null 許容型。 |
onenote | onenote | 読み取り専用です。 |
onlineMeetings | onlineMeeting コレクション | 会議に関する情報 (会議への参加に使用する URL、出席者リスト、説明など)。 |
outlook | outlookUser | ユーザーが使用できる選択的 Outlook サービス。 読み取り専用です。 Null 許容型。 |
ownedDevices | directoryObject コレクション | ユーザーが所有しているデバイス。 読み取り専用です。 Null 許容型。
$expand をサポートします。 |
ownedObjects | directoryObject コレクション | ユーザーが所有しているディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。
$expand 、$expand で入れ子になっている $select 、および $filter (/$count eq 0 、/$count ne 0 、/$count eq 1 、/$count ne 1 ) をサポートします。 |
pendingAccessReviewInstances | accessReviewInstance コレクション | レビュー担当者による承認待ちのアクセス レビューのリストを取得するためのナビゲーション プロパティ。 |
people | person コレクション | 読み取り専用です。 ユーザーに最も関連のある人。 コレクションは、ユーザーに対する関連 (ユーザーの通信、コラボレーション、およびビジネス リレーションシップによって決まる) を基準として配列されます。 ユーザーは、メール、連絡先、およびソーシャル ネットワークから情報を集約します。 |
permissionGrants | resourceSpecificPermissionGrant コレクション | ユーザーのすべてのリソース固有のアクセス許可を一覧表示します。 |
photo | profilePhoto | ユーザーのプロフィール写真。 読み取り専用。 |
photos | profilePhoto コレクション | さまざまなサイズのユーザーのプロフィール写真のコレクション。 読み取り専用です。 |
planner | plannerUser | ユーザーが使用可能な選択的プランナー サービス。 読み取り専用です。 Null 許容型。 |
profile | profile | テナント内のユーザーを説明するプロパティを表します。 |
registeredDevices | directoryObject コレクション | ユーザーについて登録されているデバイス。 読み取り専用です。 Null 許容型。
$expand をサポートし、最大 100 個のオブジェクトを返します。 |
scopedRoleMemberOf | scopedRoleMembership コレクション | このユーザーのスコープ ロール管理単位のメンバーシップ。 読み取り専用です。 Null 許容型。 |
セキュリティ | セキュリティ | Null 許容型。 |
settings | userSettings | 読み取り専用です。 Null 許容型。 |
ソリューション | userSolutionRoot | ユーザーのカスタム ソリューション エンティティを表します。 読み取り専用です。 Null 許容型。 |
スポンサー | directoryObject コレクション | テナント内のこのゲスト ユーザーの特権を担当し、ゲスト ユーザーの情報とアクセスを最新の状態に保つユーザーとグループ。 (HTTP メソッド: GET、POST、DELETE)。
$expand をサポートします。 |
チームワーク | userTeamwork | ユーザーが使用できる Microsoft Teams の機能のコンテナーです。 読み取り専用。 Null 許容型。 |
ToDo | todo | ユーザーが利用できる To Do サービスを表します。 |
transitiveMemberOf | directoryObject コレクション | ネストされたグループを含むグループ、およびユーザーがメンバーであるディレクトリ ロール。 Null 許容型。 |
transitiveReports | directoryObject コレクション | ユーザーの推移的なレポートです。 読み取り専用です。 |
usageRights | usageRight コレクション | ユーザーに付与されている使用権限を表します。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"aboutMe": "String",
"accountEnabled": true,
"ageGroup": "String",
"assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
"assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
"authorizationInfo": {
"@odata.type": "microsoft.graph.authorizationInfo"
},
"birthday": "String (timestamp)",
"businessPhones": ["String"],
"city": "String",
"cloudLicensing": { "@odata.type": "microsoft.graph.cloudLicensing.userCloudLicensing" },
"cloudRealtimeCommunicationInfo": {
"@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo"
},
"companyName": "String",
"consentProvidedForMinor": "String",
"country": "String",
"createdDateTime": "2019-02-07T21:53:13.067Z",
"creationType": "String",
"customSecurityAttributes": {
"@odata.type": "microsoft.graph.customSecurityAttributeValue"
},
"deletedDateTime": "String (timestamp)",
"department": "String",
"displayName": "String",
"employeeHireDate": "2020-01-01T00:00:00Z",
"employeeId": "String",
"employeeLeaveDateTime": "String (timestamp)",
"employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
"employeeType": "String",
"externalUserConvertedOn": "String (timestamp)",
"externalUserState": "PendingAcceptance",
"externalUserStateChangeDateTime": "2018-11-12T01:13:13Z",
"faxNumber": "String",
"givenName": "String",
"hireDate": "String (timestamp)",
"id": "String (identifier)",
"identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
"interests": ["String"],
"isLicenseReconciliationNeeded": false,
"isResourceAccount": false,
"jobTitle": "String",
"legalAgeGroupClassification": "String",
"licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
"mail": "String",
"mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
"mailNickname": "String",
"mobilePhone": "String",
"mySite": "String",
"officeLocation": "String",
"onPremisesDistinguishedName": "String",
"onPremisesDomainName": "String",
"onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
"onPremisesImmutableId": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
"onPremisesSamAccountName": "String",
"onPremisesSecurityIdentifier": "String",
"onPremisesSipInfo": {
"@odata.type": "microsoft.graph.onPremisesSipInfo"
},
"onPremisesSyncEnabled": true,
"onPremisesUserPrincipalName": "String",
"otherMails": ["String"],
"passwordPolicies": "String",
"passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
"pastProjects": ["String"],
"postalCode": "String",
"preferredDataLocation": "String",
"preferredLanguage": "String",
"preferredName": "String",
"provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
"proxyAddresses": ["String"],
"refreshTokensValidFromDateTime": "2019-02-07T21:53:13.084Z",
"responsibilities": ["String"],
"schools": ["String"],
"securityIdentifier": "String",
"serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
"showInAddressList": true,
"signInSessionsValidFromDateTime": "2019-02-07T21:53:13.084Z",
"skills": ["String"],
"state": "String",
"streetAddress": "String",
"surname": "String",
"usageLocation": "String",
"userPrincipalName": "String",
"userType": "String",
"calendar": {"@odata.type": "microsoft.graph.calendar"},
"calendarGroups": [{"@odata.type": "microsoft.graph.calendarGroup"}],
"calendarView": [{"@odata.type": "microsoft.graph.event"}],
"calendars": [{"@odata.type": "microsoft.graph.calendar"}],
"contacts": [{"@odata.type": "microsoft.graph.contact"}],
"contactFolders": [{"@odata.type": "microsoft.graph.contactFolder"}],
"createdObjects": [{"@odata.type": "microsoft.graph.directoryObject"}],
"directReports": [{"@odata.type": "microsoft.graph.directoryObject"}],
"drive": {"@odata.type": "microsoft.graph.drive"},
"drives": [{"@odata.type": "microsoft.graph.drive"}],
"insights": {"@odata.type": "microsoft.graph.itemInsights"},
"settings": {"@odata.type": "microsoft.graph.userSettings"},
"events": [{"@odata.type": "microsoft.graph.event"}],
"extensions": [{"@odata.type": "microsoft.graph.extension"}],
"inferenceClassification": {"@odata.type": "microsoft.graph.inferenceClassification"},
"mailFolders": [{"@odata.type": "microsoft.graph.mailFolder"}],
"manager": {"@odata.type": "microsoft.graph.directoryObject"},
"memberOf": [{"@odata.type": "microsoft.graph.directoryObject"}],
"joinedTeams": [{"@odata.type": "microsoft.graph.group"}],
"teamwork": {"@odata.type": "microsoft.graph.teamwork"},
"messages": [{ "@odata.type": "microsoft.graph.message"}],
"outlook": {"@odata.type": "microsoft.graph.outlookUser"},
"ownedDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
"photo": {"@odata.type": "microsoft.graph.profilePhoto"},
"photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
"profile": {"@odata.type": "microsoft.graph.profile"},
"registeredDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
"signInActivity": {"@odata.type": "microsoft.graph.signInActivity"}
}