user リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、バージョン セレクターを使用します。
Microsoft Entra ユーザー アカウントを表します。 このリソースは、他のプロパティを渡すことができるオープン型です。 directoryObject から継承します。
ユーザー リソースを使用すると、ユーザーのプライマリ Exchange メールボックスとMicrosoft Entra プロファイルの言語と日付/時刻形式のユーザー設定をアプリで指定できます。 詳細については、「 言語と地域形式のユーザー設定」を参照してください。
パフォーマンス上の理由から、作成、取得、一覧表示の操作は、既定ではより一般的に使用されるプロパティのみを返します。 これらの既定のプロパティは、「プロパティ」セクションに記載されています。 既定で返されないプロパティを取得するには、OData クエリ オプションでプロパティを $select
指定します。
このリソースは以下をサポートしています。
メソッド
メソッド | 戻り値の型 | 説明 |
---|---|---|
user のリスト | user コレクション | ユーザー オブジェクトのリストを取得します。 |
ユーザーを作成する | user | 新しいユーザー オブジェクトを作成します。 |
Get user | user | ユーザー オブジェクトのプロパティと関係を読み取ります。 |
Update user | user | ユーザー オブジェクトを更新します。 |
Delete user | None | ユーザー オブジェクトを削除します。 |
差分を取得する | user コレクション | ユーザーに対する増分の変更を取得します。 |
changePassword | なし | 自分のパスワードを更新します。 |
invalidateAllRefreshTokens | なし | アプリケーションに発行されたユーザーの更新トークンをすべて無効にします。 |
validatePassword | passwordValidationInformation | 組織のパスワード検証ポリシーに対してユーザーのパスワードを検証し、パスワードが有効かどうかを報告します。 |
アプリの役割の割り当て | ||
appRoleAssignments を一覧表示する | appRoleAssignment コレクション | ユーザーが割り当てられているアプリとアプリロールを取得します。 |
appRoleAssignedResources を一覧表示する | servicePrincipal コレクション | ユーザーが直接またはグループ メンバーシップを使用してアプリ ロールの割り当てを持っているアプリを取得します。 |
appRoleAssignment を追加する | appRoleAssignment | ユーザーにアプリ ロールを割り当てます。 |
appRoleAssignment を削除する | なし | ユーザーからアプリ ロールの割り当てを削除します。 |
Calendar | ||
予定表を作成する | Calendar | 予定表コレクションへの投稿により、新しい予定表を作成します。 |
Create calendarGroup | CalendarGroup | calendarGroups コレクションへの投稿により、新しい CalendarGroup を作成します。 |
イベントを作成する | event | event コレクションへの投稿によって、新しいイベントを作成します。 |
findMeetingTimes | meetingTimeSuggestionsResult | 出席者の空き時間情報、場所、または時間の制約に基づいて、集まる時間と場所を見つけます。 |
findRooms | emailaddress.md コレクション | ユーザーのテナントまたは特定の会議室リスト内のすべての会議室を取得します。 |
findRoomLists | emailaddress.md コレクション | テナントで定義された部屋の一覧を取得します。 |
getSchedule | scheduleInformation | 指定した期間のユーザー、配布リスト、またはリソース (会議室または機器) のコレクションの空き時間情報を取得します。 |
予定表を一覧表示する | Calendar collection | 予定表オブジェクトのコレクションを取得します。 |
List calendarGroups | CalendarGroup collection | CalendarGroup オブジェクトのコレクションを取得します。 |
calendarView を一覧表示する | event コレクション | event オブジェクトのコレクションを取得します。 |
イベントを一覧表示する | event コレクション | ユーザーのメールボックス内のイベント オブジェクトの一覧を取得します。 一覧には、単一インスタンスの会議と定期的なマスターが含まれています。 |
reminderView | Reminder collection | 指定した開始時刻と終了時刻内の予定表のアラームの一覧を返します。 |
連絡先 | ||
Create contact | contact | 連絡先コレクションへの投稿により、新しい連絡先を作成します。 |
Create ContactFolder | contactFolder | contactFolder コレクションへの投稿により、新しい contactFolder を作成します。 |
連絡先を一覧表示する | contact コレクション | サインイン中のユーザーの既定の連絡先フォルダーから連絡先コレクションを取得します。 |
List contactFolders | contactFolder コレクション | サインイン中のユーザーの既定の連絡先フォルダー内で連絡先フォルダーのコレクションを取得します。 |
ディレクトリ オブジェクト | ||
assignLicense | user | ユーザーのサブスクリプションを追加または削除します。 サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。 |
exportPersonalData | なし | 組織のユーザーのデータをエクスポートするために会社の管理者によって行われたデータ ポリシー操作要求を送信します。 |
getByIds | String collection | ID のリストで指定されたディレクトリ オブジェクトを返します。 |
checkMemberGroups | String collection | グループの一覧内のメンバーシップを確認します。 チェックは推移的です。 |
checkMemberObjects | String collection | グループ、ディレクトリ ロール、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。 チェックは推移的です。 |
getMemberGroups | String コレクション | ユーザーがメンバーになっているすべてのグループを返します。 チェックは推移的です。 |
getMemberObjects | String collection | ユーザーがメンバーになっているすべてのグループ、ディレクトリ ロール、および管理単位を返します。 チェックは推移的です。 |
transitiveReports を取得する | 整数 | transitiveReports ナビゲーション プロパティから、ユーザーの推移的なレポート数を取得します。 |
createdObjects を一覧表示する | directoryObject collection | そのユーザーにより作成されたディレクトリ オブジェクトを、createdObjects ナビゲーション プロパティから取得します。 |
licenseDetails を一覧表示する | licenseDetails コレクション | licenseDetails オブジェクトのコレクションを取得します。 |
ownedDevices を一覧表示する | directoryObject collection | ownedDevices ナビゲーション プロパティから、ユーザーが所有するデバイスを取得します。 |
List ownedObjects | directoryObject コレクション | ownedObjects ナビゲーション プロパティから、ユーザーが所有するディレクトリ オブジェクトを取得します。 |
List registeredDevices | directoryObject コレクション | そのユーザーについて登録されているデバイスを、RegisteredDevices ナビゲーション プロパティから取得します。 |
スコープ ロール メンバーシップを一覧表示する | scopedRoleMembership コレクション | このユーザーのスコープ ロール管理単位のメンバーシップを取得します。 |
usageRights を一覧表示する | usageRight コレクション | ユーザーに付与されている使用権限のコレクションを取得します。 |
reprocessLicense | user | ユーザーのサブスクリプション割り当てを再処理します。 |
revokeSignInSessions | なし | signInSessionsValidFromDateTime ユーザー プロパティを現在の日時にリセットすることで、アプリケーションに発行されたすべてのユーザーの更新トークンとセッション トークンを取り消します。 この操作により、ユーザーはそれらのアプリケーションに再度サインインするように強制されます。 この方法は invalidateAllRefreshTokens を置き換えるものです。 |
削除されたユーザーを一覧表示する | directoryObject collection | 過去 30 日間にテナントで削除されたユーザーを取得します。 |
削除されたユーザーを取得する | directoryObject コレクション | ID で削除されたユーザーを取得します。 |
削除されたユーザーを復元する | directoryObject collection | 過去 30 日間にテナントで削除されたユーザーを復元します。 |
ユーザーを完全に削除する | directoryObject collection | テナントから削除されたユーザーを完全に削除します。 |
Drive | ||
ドライブを取得する | drive | Drive リソースのプロパティと関係を取得します。 |
子を一覧表示する | DriveItems | DriveItem の子リレーションシップで DriveItems のコレクションを返します。 |
グループ | ||
参加チームのリストを作成する | team コレクション | そのユーザーが直接のメンバーである Microsoft Teams のチームを、joinedTeams ナビゲーション プロパティから取得します。 |
memberOf を一覧表示する | directoryObject コレクション | そのユーザーが直接のメンバーであるグループ、ディレクトリ ロール、および管理単位を、memberOf ナビゲーション プロパティから取得します。 この操作は推移的ではありません。 |
transitiveMemberOf を一覧表示する | directoryObject コレクション | 直接メンバーシップまたは推移的メンバーシップを通じてユーザーがメンバーになっているグループ、ディレクトリ ロール、および管理ユニットを取得します。 |
分析情報 | ||
共有アイテムを一覧表示する | sharedInsight コレクション | ユーザーと共有されているファイルのリストを返す計算された分析情報。 |
人気上昇中を一覧表示する | trending コレクション | ユーザーの周りで人気上昇中のアイテムのリストを返す計算された分析情報。 |
使用アイテムを一覧表示する | usedInsight コレクション | ユーザーで使用されるファイルのリストを返す計算された分析情報。 |
メール | ||
inferenceClassificationOverride を作成する | inferenceClassificationOverride | SMTP アドレスで示される送信者の優先受信トレイのオーバーライドを作成します。 |
Create mailFolder | mailFolder | mailFolder コレクションへの投稿により、新しい mailFolder を作成します |
メッセージの作成 | message | メッセージ コレクションへの投稿により、メッセージを作成します。 |
messageRule を作成する | messageRule | 条件とアクションのセットを指定して messageRule オブジェクトを作成します。 |
getMailTips | mailTips コレクション | サインイン中のユーザーが利用できる、1 人または複数の受信者に対してのメール ヒントを返します。 |
mailFolders を一覧表示する | mailFolder コレクション | サインイン中のユーザーのルート フォルダーからメール フォルダー コレクションを取得します。 |
List messages | message コレクション | サインインしているユーザーのメールボックス内のすべてのメッセージを取得します。 |
オーバーライドを一覧表示する | inferenceClassificationOverride コレクション | 特定の送信者からのメッセージを特定の方法で分類するためにユーザーが設定した優先優先受信トレイを取得します。 |
ルールの一覧表示 | messageRule コレクション | ユーザーの受信トレイに定義されているすべての messageRule オブジェクトを取得します。 |
メールを送信する | なし | 要求本文に指定されたメッセージを送信します。 |
注 | ||
ノートブックを作成する | notebook | 新しい OneNote のノートブックを作成します。 |
ノートブックを一覧表示する | notebook コレクション | ノートブック オブジェクトの一覧を取得します。 |
オープン拡張機能 | ||
オープン拡張機能を作成する | openTypeExtension | オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。 |
オープン拡張機能を取得する | openTypeExtension コレクション | 拡張機能の名前で識別されるオープン拡張機能を取得します。 |
組織階層 | ||
マネージャーを割り当てる | なし | ユーザーのマネージャーを割り当てます。 |
マネージャーを取得する | directoryObject | そのユーザーの上司であるユーザーまたは連絡先を、マネージャー ナビゲーション プロパティから取得します。 |
マネージャーの削除 | なし | ユーザーのマネージャーを削除します。 |
List directReports | directoryObject collection | そのユーザーの部下であるユーザーと連絡先を、directReports ナビゲーション プロパティから取得します。 |
Outlook 設定 | ||
Outlook カテゴリを作成する | outlookCategory | ユーザーのマスター カテゴリ リスト内に outlookCategory オブジェクトを作成します。 |
supportedLanguages を取得する | localeInfo コレクション | ユーザーに対してサポートされている (ユーザーのメールボックス サーバーで構成されている) ロケールと言語のリストを取得します。 |
supportedTimeZones を取得する | timeZoneInformation コレクション | ユーザーに対してサポートされている (ユーザーのメールボックス サーバーで構成されている) タイム ゾーンのリストを取得します。 |
ユーザーのメールボックスの設定を取得する | mailboxSettings | ユーザーの mailboxSettings を取得します。 |
Outlook カテゴリを一覧表示する | outlookCategory コレクション | ユーザーに対して定義されているすべてのカテゴリを取得します。 |
Exchange ID を変換する | convertIdResult コレクション | Outlook 関連リソースの ID の形式を変換します。 |
ユーザーのメールボックスの設定を更新する | mailboxSettings | ユーザーに対して 1 つ以上の mailboxSettings を有効、構成、または無効にします。 |
ユーザー | ||
ユーザーを一覧表示する | 人物 | ユーザーとの関連 (ユーザーのコミュニケーションとコラボレーション パターン、およびビジネスのリレーションシップによって決まる) によって配列された人物オブジェクトの一覧を取得します。 |
写真 | ||
写真を取得する | profilePhoto | 指定した profilePhoto またはそのメタデータ (profilePhoto プロパティ) を取得します。 |
profilephoto を更新する | なし | サインインしているユーザーや指定したグループや連絡先など、テナント内のすべてのユーザーの写真を更新します。 |
profilephoto を削除する | なし | サインインしているユーザーや指定したグループを含む、テナント内のすべてのユーザーの写真を削除します。 |
Planner | ||
plannerUser を取得する | plannerUser | plannerUser オブジェクトのプロパティと関係を取得します。 |
favoritePlans を一覧表示する | plannerPlan コレクション | ユーザーがお気に入りとしてマークした plannerPlans の一覧を取得します。 |
recentPlans を一覧表示する | plannerPlan コレクション | ユーザーが最近表示した plannerPlans の一覧を取得します。 |
List tasks | plannerTask コレクション | ユーザーに割り当てられている Planner タスクを取得します。 |
plannerUser を更新する | なし | plannerUser オブジェクトのプロパティを更新します。 |
プロファイル | ||
プロファイルを取得する | profile | 特定のユーザーのプロファイル オブジェクトのプロパティと関係を取得します。 |
プロファイルを削除する | なし | ユーザーのアカウントからプロファイル オブジェクトを削除します。 |
スキーマ拡張機能 | ||
スキーマ拡張機能の値を追加する | なし | スキーマ拡張定義を作成し、それを使用してカスタム型指定データをリソースに追加します。 |
スポンサー | ||
スポンサーの割り当て | なし | ユーザーにスポンサーを割り当てます。 |
スポンサーを一覧表示する | directoryObject collection | このユーザーのスポンサーであるユーザーとグループを取得します。 |
スポンサーを削除する | なし | ユーザーのスポンサーを削除します。 |
チームワーク | ||
ユーザーのインストールされたアプリを一覧表示する | userScopeTeamsAppInstallation コレクション | ユーザーのパーソナル スコープ内にインストールされているアプリを一覧表示します。 |
ユーザー用にインストールされているアプリを取得する | userScopeTeamsAppInstallation | ユーザーのパーソナル スコープ内にインストールされている指定のアプリを一覧表示します。 |
ユーザーのアプリを追加する | なし | ユーザーのパーソナル スコープ内にアプリを追加 (インストール) します。 |
ユーザーのアプリを削除する | なし | ユーザーのパーソナル スコープ内からアプリを削除 (アンインストール) します。 |
ユーザーのインストールされたアプリをアップグレードする | なし | ユーザーのパーソナル スコープ内にインストールされたアプリを最新バージョンにアップグレードします。 |
ユーザーとアプリの間でチャットを行う | チャット | ユーザーとアプリの間に 1 対 1 のチャットが表示されます。 |
ユーザーとアプリの間でチャットを行う | チャット | ユーザーとアプリの間に 1 対 1 のチャットが表示されます。 |
権限付与の表示 | resourceSpecificPermissionGrant コレクション | ユーザーのすべての リソース固有のアクセス許可 許可を一覧表示 します。 |
To-Do タスク | ||
タスクを作成する | todoTask | 指定したタスク リストに todoTask を作成します。 |
タスク リストを作成する | todoTaskList | ユーザーのメールボックスに To Do タスク リストを作成します。 |
タスクを一覧表示する | todoTask コレクション | 指定されたリスト内のすべての todoTask リソースを取得します。 |
タスク リストを一覧表示する | todoTaskList コレクション | ユーザーのメールボックス内のすべてのタスク リストを取得します。 |
ユーザーの設定 | ||
設定を取得する | userSettings | ユーザーおよび組織の設定オブジェクトを読み取ります。 |
設定をアップデートする | userSettings | 設定オブジェクトのプロパティを更新します。 |
Outlook タスク (廃止) | ||
outlookTask を作成する (廃止) | outlookTask | ユーザーのメールボックスの既定のタスク グループ (マイ タスク) および既定のタスク フォルダー (タスク) に Outlook のタスクを作成します。 |
タスクを一覧表示する (廃止) | outlookTask コレクション | ユーザーのメールボックス内のすべての Outlook タスクを取得します。 |
クラウド PC | ||
cloudPC を一覧表示する | cloudPC コレクション | サインインしているユーザーに起因する cloudPC デバイスを一覧表示します。 |
起動情報を取得する | cloudPCLaunchInfo | サインインしているユーザーの cloudPCLaunchInfo を取得します。 |
プロパティ
重要
$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識別子を格納できます。 また、共通アクセス カード (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 値) をサポートします。 |
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 で表します。 プロパティは、null 2018 年 6 月より前に作成され、オンプレミス ユーザーが 2018 年 6 月より前に Microsoft Entra ID に同期された一部のユーザーを対象とします。 読み取り専用です。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
creationType | String | ユーザー アカウントが次のいずれかの方法で作成されたかどうかを示します。
読み取り専用です。 $filter (eq 、ne 、not 、および in ) をサポートします。 |
customSecurityAttributes | customSecurityAttributeValue | ディレクトリ オブジェクトに割り当てられたカスタム セキュリティ属性の値を保持するオープン複合型。 Null 許容型。 $select でのみ返されます。 $filter (eq 、ne 、not 、startsWith ) をサポートします。 フィルター値では、大文字と小文字が区別されます。 |
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 | ユーザーがorganizationを終了または終了する日時。 このプロパティを読み取るために、呼び出し元のアプリに User-LifeCycleInfo.Read.All アクセス許可が割り当てられている必要があります。 このプロパティを記述するには、呼び出し元のアプリに User.Read.All アクセス許可と User-LifeCycleInfo.ReadWrite.All アクセス許可が割り当てられている必要があります。 委任されたシナリオでこのプロパティを読み取るために、管理者には、ライフサイクル ワークフロー管理者、グローバル 閲覧者、またはグローバル管理者のいずれかのMicrosoft Entraロールが必要です。 委任されたシナリオでこのプロパティを記述するには、管理者に グローバル管理者 ロールが必要です。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 詳細については、「 ユーザーの employeeLeaveDateTime プロパティを構成する」を参照してください。 |
employeeId | String | 組織によりユーザーに割り当てられた従業員 ID。 最大長は 16 文字です。$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値) をサポートします。 |
employeeOrgData | employeeOrgData | ユーザー organization関連付けられているデータ (除算や costCenter など) を表します。 $filter (eq 、ne 、not 、ge 、le 、in ) をサポートします。 |
employeeType | String | エンタープライズ ワーカーの種類を取得します。 たとえば、Employee 、Contractor 、Consultant 、または Vendor です。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith ) をサポートします。 |
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 ) をサポートします。 |
ID | objectIdentity コレクション | このユーザー アカウントへのサインインに使用できる ID を表します。 ID は、Microsoft (ローカル アカウントとも呼ばれます)、組織、または Facebook、Google、Microsoft などのソーシャル ID プロバイダーによって提供され、ユーザー アカウントに関連付けることができます。 同じ signInType 値を持つ複数の項目を含む場合があります。 $filter (eq ) (null 値を含む) をサポートします。signInType が userPrincipalName でない場合のみ。 |
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 メールボックス ライセンスの割り当てを保留しているかどうかを示します。 読み取り専用です。 ( eq のみtrue ) をサポートします$filter 。 |
isManagementRestricted | ブール型 | true ユーザーが制限付き管理管理単位のメンバーである場合は、管理する制限付き管理単位をスコープとするロールが必要です。 既定値は、false です。 読み取り専用です。 制限付き管理単位のメンバーであるユーザーを管理するには、呼び出し元のアプリに Directory.Write.Restricted アクセス許可を割り当てる必要があります。 委任されたシナリオの場合、管理者は、制限された管理単位スコープでサポートされているロールを明示的に割り当てる必要もあります。 |
isResourceAccount | ブール値 | 使わないでください。今後の使用のために予約されています。 |
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 、NotAdult MinorNoParentalConsentRequired 、および Adult 。 詳細については、 法的年齢グループのプロパティ定義に関するページを参照してください。 $select でのみ返されます。 |
licenseAssignmentStates | licenseAssignmentState コレクション | このユーザーへのライセンス割り当ての状態です。 また、直接割り当てられているライセンスと、ユーザーがグループ メンバーシップを通じて継承したライセンスも示します。 読み取り専用です。 $select でのみ返されます。 |
String | ユーザーの SMTP アドレス (たとえば、admin@contoso.com )。 このプロパティを変更すると、ユーザーの proxyAddresses コレクションも更新され、値が SMTP アドレスとして含まれます。 このプロパティにはアクセント文字を含めることはできません。 メモ: 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 、startsWith in le および の値) と eq $search をnull サポートします。 |
mySite | String | ユーザーのサイトの URL。 $select でのみ返されます。 |
officeLocation | String | ユーザーの勤務先の場所。 最大文字数は 128 文字です。 $filter (eq 、 ne 、 not 、 ge 、 le 、 in 、 startsWith と eq の null 値) をサポートします。 |
onPremisesDistinguishedName | String | オンプレミスの Active Directory distinguished name または DN が含まれています。 このプロパティは、オンプレミス ディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID に同期しているお客様にのみ設定されます。 読み取り専用です。 |
onPremisesDomainName | String | オンプレミス ディレクトリから同期されたオンプレミス domainFQDN (dnsDomainName とも呼ばれます) が含まれています。 このプロパティは、オンプレミス ディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID に同期しているお客様にのみ設定されます。 読み取り専用です。 |
onPremisesExtensionAttributes | onPremisesExtensionAttributes | ユーザーの extensionAttributes1 - 15 が含まれています。 これらの拡張属性は、Exchange カスタム属性 1-15 とも呼ばれます。 false ユーザー オブジェクトの作成または更新中にこれらのプロパティを設定できます。 $filter (eq 、ne 、not 、in ) をサポートします。 |
onPremisesImmutableId | String | このプロパティは、オンプレミスの Active Directory ユーザー アカウントをMicrosoft Entra ユーザー オブジェクトに関連付けます。 ユーザーの (UPN) プロパティにフェデレーション ドメインを使用している場合は、Graph で新しいユーザー userPrincipalName アカウントを作成するときに、このプロパティを指定する必要があります。 メモ:$および _ 文字は、このプロパティを指定するときに使用できません。 $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 が含まれています。 このプロパティは、オンプレミス ディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID に同期しているお客様にのみ設定されます。 読み取り専用です。$filter (eq 、ne 、not 、ge 、le 、in 、startsWith ) をサポートします。 |
onPremisesSecurityIdentifier | String | オンプレミスからクラウドに同期されたユーザーのオンプレミス セキュリティ識別子 (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 が含まれています。 このプロパティは、オンプレミス ディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID に同期しているお客様にのみ設定されます。 読み取り専用です。 $filter (eq 、ne 、not 、ge 、le 、in 、startsWith ) をサポートします。 |
otherMails | String collection | ユーザーの追加のメール アドレスの一覧 (例: ["bob@contoso.com", "Robert@fabrikam.com"] )。注: このプロパティにはアクセント文字を含めることはできません。 ( eq 、not ge 、endsWith le /$count ne 0 in /$count eq 0 startsWith ) をサポートします。$filter |
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"] 。 メール プロパティを変更すると、このコレクションも更新され、値が 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 、) をサポートしますが、ge ne not 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 | ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (Member 、Guest など)。 $filter (eq 、 ne 、 not 、 in 、 および eq の null 値) をサポートします。 メモ:メンバーおよびゲスト ユーザーのアクセス許可の詳細については、「Microsoft Entra ID の既定のユーザーアクセス許可とは」を参照してください。 |
ヒント
ディレクトリ拡張機能と関連するデータは既定で返されます。スキーマ拡張機能と関連するデータは でのみ $select
返されます。開いている拡張機能と関連するデータは、 でのみ $expand
返されます。
mail プロパティと proxyAddresses プロパティ
mail と proxyAddresses はいずれもメール関連のプロパティです。 proxyAddresses は、Microsoft Exchange サーバーにのみ関連するアドレスのコレクションです。 これは、1 つのメールボックスに関連付けされているユーザーのメール アドレスの一覧を格納するために使用されます。 mail プロパティは、ユーザーのサインインなど、さまざまな目的でユーザーのメール アドレスとして使用され、プライマリ プロキシ アドレスを定義します。
mail と proxyAddresses は 、GET ユーザー API を使用して取得できます。 ユーザー API の更新を使用してメールを更新できますが、Microsoft Graph を使用して proxyAddresses を更新することはできません。 ユーザーの メール プロパティが更新されると、 proxyAddresses の再計算がトリガーされ、次のシナリオを除き、新しく更新されたメールがプライマリ プロキシ アドレスに設定されます。
- ユーザーが Microsoft Exchange を含むライセンスを持っている場合、ユーザーのすべてのプロキシ アドレスは、テナント上の検証済みドメインに属している必要があります。 検証済みドメインに属していないプロキシ アドレスは、通知されずに削除されます。
- ユーザーがゲストであり、プライマリ プロキシ アドレスに ゲスト ユーザー UPN 文字列が含まれている場合、ユーザーのメールはプライマリ プロキシ アドレスに
#EXT#
設定されません。 - ユーザーがゲストである場合、プロキシ アドレスを持たなくなった場合でも、ユーザーのメールは削除されません。
proxyAddresses は、ディレクトリ オブジェクト (ユーザー、グループ、および組織の連絡先) 全体で一意です。 ユーザーの メール プロパティが別のオブジェクトの proxyAddresses の 1 つと競合する場合、 メール の更新が失敗し、 proxyAddresses プロパティも更新されません。
言語と地域の形式のユーザー設定
ユーザー リソースには、 ユーザー の優先言語、日付と時刻の書式設定、既定のタイム ゾーン、およびプライマリ 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管理者によって使用される省略可能なプロパティです。
たとえば、キャメロンは英国のホーリーポートの小学校のディレクトリの管理者です。 学年の初めに、彼は英国の年齢関連の規制に基づいて未成年者の両親から同意を得るために入学書類を使用しています。 保護者から同意を得た場合、未成年者のアカウントを Holyport School と 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 collection | ユーザーが作成したディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。 |
directReports | directoryObject collection | そのユーザーの部下であるユーザーと連絡先。 (マネージャー プロパティを持つユーザーと連絡先がこのユーザーに設定されています)。読み 取り 専用。 Null 許容型。 $expand をサポートします。 |
ドライブ | drive | ユーザーの OneDrive。 読み取り専用です。 |
drives | drive コレクション | このユーザーが使用できるドライブのコレクション。 読み取り専用です。 |
events | event コレクション | ユーザーのイベント。 既定では、既定の予定表の下にイベントが表示されます。 読み取り専用です。 Null 許容型。 |
extensions | extension コレクション | ユーザーに対して定義されているオープン拡張機能のコレクション。 $expand をサポートします。 Null 許容型。 |
inferenceClassification | inferenceClassification | 推定された関連性または重要度をオーバーライドする明示的な指定に基づくユーザーのメッセージの関連性分類。 |
insights | itemInsights | 読み取り専用です。 Null 許容型。 |
joinedGroups | group コレクション | 読み取り専用です。 Null 許容型です。 |
mailFolders | mailFolder コレクション | ユーザーのメール フォルダー。 読み取り専用です。 Null 許容型。 |
manager | directoryObject | このユーザーの上司であるユーザーまたは連絡先。 読み取り専用です。 (HTTP メソッド: GET、PUT、DELETE。)。 $expand をサポートします。 |
memberOf | directoryObject コレクション | ユーザーがメンバーであるグループ、ディレクトリ ロール、および管理単位。 読み取り専用です。 Null 許容型。 $expand をサポートします。 |
joinedTeams | team コレクション | ユーザーがメンバーになっている Microsoft Teams チーム。 読み取り専用です。 Null 許容型。 |
messages | message コレクション | メールボックスまたはフォルダー内のメッセージ。 読み取り専用です。 Null 許容型。 |
onenote | onenote | 読み取り専用です。 |
onlineMeetings | onlineMeeting コレクション | 会議に関する情報(会議への参加に使用する URL、出席者リスト、説明など)。 |
outlook | outlookUser | ユーザーが使用できる選択的 Outlook サービス。 読み取り専用です。 Null 許容型。 |
ownedDevices | directoryObject collection | ユーザーが所有するデバイス。 読み取り専用です。 Null 許容型。 $expand をサポートします。 |
ownedObjects | directoryObject collection | ユーザーが所有するディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。 、 で$expand 入れ子にされ、(/$count eq 0 $filter 、、、/$count ne 1 /$count eq 1 /$count ne 0 ) をサポートします$expand $select 。 |
pendingAccessReviewInstances | accessReviewInstance コレクション | レビュー担当者による承認待ちのアクセス レビューの一覧を取得するナビゲーション プロパティ。 |
people | person コレクション | 読み取り専用です。 ユーザーに最も関連のある人。 コレクションは、ユーザーとの関連性によって順序付けられます。これは、ユーザーのコミュニケーション、コラボレーション、およびビジネス関係によって決定されます。 人は、メール、連絡先、ソーシャル ネットワークからの情報を集計します。 |
permissionGrants | resourceSpecificPermissionGrant コレクション | ユーザーのすべてのリソース固有のアクセス許可許可を一覧表示します。 |
photo | profilePhoto | ユーザーのプロフィール写真。 読み取り専用。 |
photos | profilePhoto コレクション | さまざまなサイズのユーザーのプロフィール写真のコレクション。 読み取り専用です。 |
planner | plannerUser | ユーザーが使用可能な選択的プランナー サービス。 読み取り専用です。 Null 許容型。 |
profile | profile | テナント内のユーザーを説明するプロパティを表します。 |
registeredDevices | directoryObject collection | ユーザーについて登録されているデバイス。 読み取り専用です。 Null 許容型。 $expand 最大 100 個のオブジェクトをサポートし、返します。 |
scopedRoleMemberOf | scopedRoleMembership コレクション | このユーザーのスコープ ロール管理単位のメンバーシップ。 読み取り専用です。 Null 許容型。 |
セキュリティ | セキュリティ | Null 許容型。 |
settings | userSettings | 読み取り専用です。 Null 許容型。 |
スポンサー | directoryObject collection | テナント内のこのゲスト ユーザーの特権を担当するユーザーとグループは、ゲスト ユーザーの情報とアクセスを更新したままにします。 (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",
"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",
"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"}
}