user リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graphバージョンの API /beta は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、バージョン セレクターを 使用 します。

Azure Active Directory (Azure AD) のユーザー アカウントを表します。 directoryObject から継承します。

ユーザー リソースを使用すると、アプリで、プライマリ Exchange メールボックス、および Azure AD プロファイル用の言語、および日付と時刻の形式のユーザー設定を行うことができます。詳細については、「言語と地域の形式のユーザー設定」を参照してください。

パフォーマンス上の理由から、作成、取得、一覧表示の操作は、既定ではより一般的に使用されるプロパティのみを返します。 これらの既定のプロパティは、「プロパティ」セクションに記載されています。 既定では返されないプロパティを取得するには、そのプロパティを $select OData クエリ オプションで指定します。

このリソースは以下をサポートしています。

  • 拡張機能として、カスタム プロパティに独自のデータを追加します。
  • 変更通知を受信します。
  • デルタ関数を提供することにより、デルタ クエリを使用して、増分の追加、削除、更新を追跡します。

メソッド

メソッド 戻り値の型 説明
user のリスト user コレクション ユーザー オブジェクトのリストを取得します。
ユーザーを作成する user 新しいユーザー オブジェクトを作成します。
Get user user ユーザー オブジェクトのプロパティと関係を読み取ります。
Update user user ユーザー オブジェクトを更新します。
Delete user None ユーザー オブジェクトを削除します。
差分を取得する user コレクション ユーザーに対する増分の変更を取得します。
changePassword なし 自分のパスワードを更新します。
invalidateAllRefreshTokens なし アプリケーションに発行されたユーザーの更新トークンをすべて無効にします。
validatePassword passwordValidationInformation 組織のパスワード検証ポリシーに対してユーザーのパスワードを検証し、パスワードが有効かどうかを報告します。
アプリの役割の割り当て
appRoleAssignments を一覧表示する appRoleAssignment コレクション このユーザーに割り当てられているアプリとアプリの役割を取得します。
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 コレクション サインイン中のユーザーの既定の連絡先フォルダー内で連絡先フォルダーのコレクションを取得します。
ディレクトリ オブジェクト
activateServicePlan None 特定のユーザーに対して、特定のservicePlanIdおよびskuIdを使用してサービスをアクティブ化します。
assignLicense user ユーザーのサブスクリプションを追加または削除します。また、サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。
checkMemberGroups 文字列コレクション グループの一覧内のメンバーシップを確認します。チェックは推移的です。
checkMemberObjects String collection グループ、ディレクトリ ロール、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。チェックは推移的です。
exportPersonalData なし 組織ユーザーのデータをエクスポートするために、会社の管理者が行ったデータ ポリシーの操作要求を送信します。
getByIds 文字列コレクション ID のリストで指定されたディレクトリ オブジェクトを返します。
getMemberGroups String collection ユーザーがメンバーであるすべてのグループを返します。チェックは推移的です。
getMemberObjects String コレクション ユーザーがメンバーになっているすべてのグループ、ディレクトリ ロール、および管理単位を返します。チェックは推移的です。
transitiveReports を取得する 整数 transitiveReports ナビゲーション プロパティから、ユーザーの推移的なレポート数を取得します。
createdObjects を一覧表示する directoryObject collection そのユーザーにより作成されたディレクトリ オブジェクトを、createdObjects ナビゲーション プロパティから取得します。
licenseDetails を一覧表示する licenseDetails コレクション licenseDetails オブジェクトのコレクションを取得します。
ownedDevices を一覧表示する directoryObject collection そのユーザーにより所有されているデバイスを、OwnedDevices ナビゲーション プロパティから取得します。
List ownedObjects directoryObject collection そのユーザーにより所有されているディレクトリ オブジェクトを、ownedObjects ナビゲーション プロパティから取得します。
List registeredDevices directoryObject コレクション そのユーザーについて登録されているデバイスを、RegisteredDevices ナビゲーション プロパティから取得します。
スコープ ロール メンバーシップを一覧表示する scopedRoleMembership コレクション このユーザーのスコープ ロール管理単位のメンバーシップを取得します。
usageRights を一覧表示する usageRight コレクション ユーザーに付与されている使用権限のコレクションを取得します。
reprocessLicense user ユーザーのサブスクリプション割り当てを再処理します。
revokeSignInSessions なし signInSessionsValidFromDateTime ユーザー プロパティを現在の日時にリセットすることで、アプリケーションに発行されたすべての更新トークンとセッション トークンを失効にします。 これにより、ユーザーは強制的にアプリケーションに再度サインインします。 この方法は invalidateAllRefreshTokens を置き換えるものです。
ドライブ
ドライブを取得する drive Drive リソースのプロパティと関係を取得します。
子を一覧表示する DriveItems DriveItem の子リレーションシップで DriveItems のコレクションを返します。
グループ
参加チームのリストを作成する team コレクション そのユーザーが直接のメンバーである Microsoft Teams のチームを、joinedTeams ナビゲーション プロパティから取得します。
memberOf を一覧表示する directoryObject コレクション そのユーザーが直接のメンバーであるグループ、ディレクトリ ロール、および管理単位を、memberOf ナビゲーション プロパティから取得します。
推移的な memberOf を一覧表示する directoryObject コレクション ユーザーがメンバーになっているグループ、ディレクトリ ロール、および管理単位を一覧表示します。 この操作は推移的で、このユーザーが入れ子のメンバーになっているグループが含まれます。
分析情報
共有アイテムを一覧表示する sharedInsight コレクション ユーザーと共有されているファイルのリストを返す計算された分析情報。
人気上昇中を一覧表示する trending コレクション ユーザーの周りで人気上昇中のアイテムのリストを返す計算された分析情報。
使用アイテムを一覧表示する usedInsight コレクション ユーザーで使用されるファイルのリストを返す計算された分析情報。
メール
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](timezoneinformation.md collection) ユーザーに対してサポートされている (ユーザーのメールボックス サーバーで構成されている) タイム ゾーンのリストを取得します。
ユーザーのメールボックスの設定を取得する mailboxSettings ユーザーの mailboxSettings を取得します。
Outlook カテゴリを一覧表示する outlookCategory コレクション ユーザーに対して定義されているすべてのカテゴリを取得します。
Exchange ID を変換する convertIdResult コレクション Outlook 関連リソースの ID の形式を変換します。
ユーザーのメールボックスの設定を更新する mailboxSettings 1 人以上のユーザーの mailboxSettings を有効化、構成、または無効化します。
ユーザー
ユーザーを一覧表示する 人物 ユーザーとの関連 (ユーザーのコミュニケーションとコラボレーション パターン、およびビジネスのリレーションシップによって決まる) によって配列された人物オブジェクトの一覧を取得します。
写真
写真を取得する profilePhoto 指定した profilePhoto またはそのメタデータ (profilePhoto プロパティ) を取得します。
profilephoto を更新する なし サインイン ユーザー、または指定されたグループあるいは連絡先を含むテナント内の任意のユーザーの写真を更新します。
Planner
plannerUser を取得する plannerUser plannerUser オブジェクトのプロパティと関係を取得します。
favoritePlans を一覧表示する plannerPlan コレクション ユーザーがお気に入りとしてマークした plannerPlans の一覧を取得します。
recentPlans を一覧表示する plannerPlan コレクション ユーザーが最近表示した plannerPlans の一覧を取得します。
List tasks plannerTask コレクション ユーザーに割り当てられている Planner タスクを取得します。
plannerUser を更新する なし plannerUser オブジェクトのプロパティを更新します。
プロファイル
プロファイルを取得する profile 特定のユーザーのプロファイル オブジェクトのプロパティと関係を取得します。
プロファイルを削除する なし ユーザーのアカウントからプロファイル オブジェクトを削除します。
スキーマ拡張機能
スキーマ拡張機能の値を追加する なし スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。
チームワーク
ユーザーのインストールされたアプリを一覧表示する userScopeTeamsAppInstallation コレクション ユーザーのパーソナル スコープ内にインストールされているアプリを一覧表示します。
ユーザー用にインストールされているアプリを取得する userScopeTeamsAppInstallation ユーザーのパーソナル スコープ内にインストールされている指定のアプリを一覧表示します。
ユーザーのアプリを追加する なし ユーザーのパーソナル スコープ内にアプリを追加 (インストール) します。
ユーザーのアプリを削除する なし ユーザーのパーソナル スコープ内からアプリを削除 (アンインストール) します。
ユーザーのインストールされたアプリをアップグレードする なし ユーザーのパーソナル スコープ内にインストールされたアプリを最新バージョンにアップグレードします。
ユーザーとアプリの間でチャットを行う チャット ユーザーとアプリの間に 1 対 1 のチャットが表示されます。
To-Do タスク
タスクを作成する todoTask 指定したタスク リストに todoTask を作成します。
タスク リストを作成する todoTaskList ユーザーのメールボックスに To Do タスク リストを作成します。
タスクを一覧表示する todoTask コレクション 指定されたリスト内のすべての todoTask リソースを取得します。
タスク リストを一覧表示する todoTaskList コレクション ユーザーのメールボックス内のすべてのタスク リストを取得します。
ユーザーの設定
設定を取得する userSettings ユーザーおよび組織の設定オブジェクトを読み取ります。
設定をアップデートする userSettings 設定オブジェクトのプロパティを更新します。
Outlook タスク (廃止)
outlookTask を作成する (廃止) outlookTask ユーザーのメールボックスの既定のタスク グループ (マイ タスク) および既定のタスク フォルダー (タスク) に Outlook のタスクを作成します。
タスクを一覧表示する (廃止) outlookTask コレクション ユーザーのメールボックス内のすべての Outlook タスクを取得します。

プロパティ

重要

$filter および $search クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。 詳細については、「Azure AD ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。

プロパティ 型 説明
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 コレクション 継承された (グループ ベースの) ライセンスを含む、ユーザーに割り当てられているライセンス。

null 許容ではありません。 $filter (eq と NOT) をサポートします。
assignedPlans assignedPlan collection ユーザーに割り当てられているプラン。読み取り専用です。null 許容ではありません。

$filter (eq と NOT) をサポートします。
birthday DateTimeOffset ユーザーの誕生日。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です

$select でのみ返されます。
businessPhones String collection ユーザーの電話番号。このプロパティに設定できるのは 1 つの数字のみです。

オンプレミス ディレクトリから同期しているユーザーの場合は読み取り専用です。 $filter (eq と NOT) をサポートします。
city String ユーザーがいる都市。最大文字数は 128 文字です。

$filter (eq、 ne、 NOT、 ge、 le、 in、 startsWith と eq の null値) をサポートします。
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 ユーザーが作成された日付と時刻。 値は変更できず、エンティティが作成されると自動的に設定されます。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 プロパティは、Null 許容型です。 Null 値は、ユーザーには正確な作成時刻が特定できないことを示します。 読み取り専用です。

$filter (eq、ne、NOT、ge、le、in) をサポートします。
creationType String ユーザー アカウントが次のいずれかの方法で作成されたかどうかを示します。
  • 通常の学校または仕事用アカウントとして (null)。
  • 外部アカウントとして (Invitation)。
  • Azure Active Directory B2C テナントのローカル アカウントとして (LocalAccount)。
  • 電子メール検証を使用して内部ユーザーによるセルフサービス サインアップを通じて行います (EmailVerified)。
  • ユーザー フローの一部であるリンクを介してサインアップする外部ユーザーによるセルフサービス サインアップを通じて (SelfServiceSignUp)。

読み取り専用です。
$filter (eq、ne、NOT、および 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) をサポートします。
employeeId String 組織によりユーザーに割り当てられた従業員 ID。

$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) をサポートします。
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 でのみ返されます。
isResourceAccount Boolean 使わないでください。今後の使用のために予約されています。
jobTitle String ユーザーの役職。 最大文字数は 128 文字です。

$filter(eq、 ne、 NOT、 ge、 le、 in、 startsWith、および eqの null 値) をサポートします。
lastPasswordChangeDateTime DateTimeOffset この Azure AD ユーザーが最後にパスワードを変更した時刻またはパスワードが作成された時刻で、いずれの場合も、最後にアクションが実行された日付。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 でのみ返されます。
mail String ユーザーの SMTP アドレス (たとえば、admin@contoso.com)。 このプロパティを変更すると、その値が SMTP アドレスとして表示されるように、ユーザーの proxyAddresses コレクションも更新されます。 Azure AD B2C アカウントの場合、このプロパティは一意の SMTP アドレスを使用して最大 10 回まで更新することができます。 このプロパティにアクセント記号は使用できません。

$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 と eq の 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 が含まれています。このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。読み取り専用です。
onPremisesDomainName String オンプレミス ディレクトリから同期されたオンプレミスのdomainFQDN (dnsDomainName とも呼ばれます) が含まれています。このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。読み取り専用。
onPremisesExtensionAttributes onPremisesExtensionAttributes ユーザーの extensionAttribute 1 ～ 15 が含まれています。 個々の拡張属性は選択もフィルター処理もできないことに注意してください。 onPremisesSyncEnabled ユーザーの場合、このプロパティ セットの権限ソースはオンプレミスで、読み取り専用です。 クラウド専用ユーザー (onPremisesSyncEnabled が false) の場合、これらのプロパティは作成時または更新時に設定される可能性があります。 これらの拡張属性は、Exchange カスタム属性 1-15 とも呼ばれます。

$filter (eq、 NOT、 ge、 le、in、および< eqの null値)をサポートします。
onPremisesImmutableId String このプロパティは、オンプレミスの Active Directory ユーザー アカウントを Azure AD ユーザー オブジェクトに関連付けるために使用します。Graph で新しいユーザー アカウントを作成するとき、ユーザーの userPrincipalName (UPN) プロパティにフェデレーション ドメインを使用する場合は、このプロパティを指定する必要があります。注: $ と _ の文字は、このプロパティを指定する場合には使用できません。

$filter (eq、ne、NOT、ge、le、in) をサポートします。
onPremisesLastSyncDateTime DateTimeOffset オブジェクトがオンプレミス ディレクトリと前回、同期された日時を示します。例："2013-02-16T03:04:54Z"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 が含まれています。このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。読み取り専用です。

$filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。
onPremisesSecurityIdentifier String オンプレミスからクラウドに同期されたユーザーのオンプレミスのセキュリティ識別子 (SID) が含まれます。 読み取り専用です。 $filter （eq） の null 値をサポートしています。
onPremisesSyncEnabled Boolean このオブジェクトがオンプレミスのディレクトリから同期される場合は true、このオブジェクトが最初にオンプレミスのディレクトリから同期されていて、今後は同期しない場合は false、このオブジェクトがオンプレミスのディレクトリから 1 度も同期されたことがない場合は null (既定値)。読み取り専用です。

$filter (eq、 ne、 NOT、 in、 および eq の null 値) をサポートします。
onPremisesUserPrincipalName String オンプレミス ディレクトリから同期されたオンプレミス userPrincipalName が含まれています。このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。読み取り専用です。

$filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。
otherMails String collection ユーザーの追加のメール アドレスの一覧 (例: ["bob@contoso.com", "Robert@fabrikam.com"])。
注: このプロパティにアクセント記号は使用できません。

$filter (eq、NOT、ge、le、in、startsWith) をサポートします。
passwordPolicies String ユーザーのパスワード ポリシーを指定します。この値は列挙値であり、可能な 1 つの値は DisableStrongPassword です。この場合は、既定のポリシーより脆弱なパスワードを指定できます。DisablePasswordExpiration を指定することもできます。2 つを一緒に指定することもできます。例: DisablePasswordExpiration, DisableStrongPassword。既定のパスワード ポリシーの詳細については、「Azure AD パスワード ポリシー」を参照してください。

$filter (ne、 NOT、 および eq の null 値) をサポートします。
passwordProfile passwordProfile ユーザーのパスワード プロファイルを指定します。 プロファイルには、ユーザーのパスワードが含まれています。 このプロパティは、ユーザーの作成時に必要です。 プロファイルにあるパスワードは、passwordPolicies プロパティによって指定されている最小要件を満たす必要があります。 既定では、強力なパスワードが必要です。 注: Azure B2C テナントの場合は、forceChangePasswordNextSignIn プロパティを false に設定し、代わりにカスタム ポリシーとユーザー フローを使用して、最初のログオン時にパスワードのリセットを強制する必要があります。 「最初のログオン時にパスワードを強制的にリセットする」を参照してください。

$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 ユーザーが設定する言語。ISO 639-1 コードに従う必要があります。たとえば en-US です。

$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"]。 Azure AD B2C アカウントの場合、このプロパティには一意のアドレスが 10 個までの制限があります。読み取り専用で、null 許容ではありません。

$filter (eq、NOT、ge、le、startsWith) をサポートします。
refreshTokensValidFromDateTime DateTimeOffset この時点よりも前に発行された更新トークンとセッション トークン (セッション Cookie) はすべて無効であり、アプリケーションが無効な更新トークンまたはセッション トークンを使用して (Microsoft Graph などの API にアクセスする目的で) 代理アクセス トークンを取得しようとすると、エラーが発生します。 この状況が発生した場合、アプリケーションは承認エンドポイントに対してリクエストを発行して新しいトークンを取得する必要があります。 読み取り専用です。 リセットするには invalidateAllRefreshTokens を使用します。
responsibilities String collection ユーザーが自分の責任の範囲を列挙する一覧。

$select でのみ返されます。
schools String collection ユーザーが在籍した学校を列挙する一覧。

$select でのみ返されます。
showInAddressList Boolean Outlook グローバル アドレス一覧にこのユーザーが含まれている必要がある場合は true であり、それ以外の場合は false です。 設定されていない場合は、true として扱われます。 招待マネージャーから招待されたユーザーの場合、このプロパティは false に設定されます。

$filter (eq、ne、NOT、in) をサポートします。
signInSessionsValidFromDateTime DateTimeOffset この時点よりも前に発行された更新トークンとセッション トークン (セッション Cookie) はすべて無効であり、アプリケーションが無効な更新トークンまたはセッション トークンを使用して (Microsoft Graph などの API にアクセスする目的で) 代理アクセス トークンを取得しようとすると、エラーが発生します。 この状況が発生した場合、アプリケーションは承認エンドポイントに対してリクエストを発行して新しいトークンを取得する必要があります。 読み取り専用です。 revokeSignInSessions を使用して再設定します。
skills String collection ユーザーが自分のスキルを列挙する一覧。

$select でのみ返されます。
signInActivity signInActivity 特定のユーザーのサインインの最後のサインイン日と要求 ID を取得します。読み取り専用。

$select でのみ返されます。 $filter (eq、ne、NOT、ge、le) をサポートしますが、 は他のフィルター可能なプロパティと共にサポートしません。 注: このプロパティの詳細については、Azure AD Premium P1/P2 ライセンスと AuditLog.Read.All アクセス許可が必要です。

注: このプロパティの取得には 既知の問題があります。
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 プロパティからアクセスできます。
注: このプロパティにアクセント記号は使用できません。

$filter (eq、ne、NOT、ge、le、in、startsWith、endsWith) と $orderByをサポートします。
userType String ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (Member、Guest など)。

$filter (eq、 ne、 NOT、 in、 および eq の null 値) をサポートします。 注: メンバー ユーザーとゲスト ユーザーのアクセス許可に関する詳細については、「Azure Active Directory で既定のユーザー アクセス許可とは?」を参照してください。

ここでは、Azure AD 管理者とエンタープライズ アプリケーション開発者が年齢関連の規制に準拠するために、3 つの年齢グループ プロパティ (legalAgeGroupClassification、ageGroup、および consentProvidedForMinor) を使用する方法を説明します。

  • legalAgeGroupClassification プロパティは、読み取り専用です。 これは、エンタープライズ アプリケーション開発者が、ユーザーの法的年齢グループに基づいてそのユーザーを適切に対処できるようにするために使用します。 ユーザーの ageGroup および consentProvidedForMinor プロパティに基づいて計算されます。
  • 年齢グループ と consentProvidedForMinor はオプションのプロパティであり、Azure AD 管理者はこれらのプロパティを使用して、ユーザーの国または地域で施行されている年齢関連の規制に基づいてアカウントの使用が正しく行われるようにします。

例: Cameron は英国の Holyport にある小学校でディレクトリを管理する管理者です。 学年の始まりに、英国の年齢関連の規制に基づき、入学書類を使用して未成年者の保護者から同意を得ます。 保護者から取得した同意により、未成年者のアカウントを Holyport スクールと Microsoft アプリが使用することが許可されます。 次に Cameron はすべてのアカウントを作成し、ageGroup を "minor" に、consentProvidedForMinor を "granted" に設定します。 これにより、生徒が使用するアプリケーションでは未成年に適していない機能が非表示になります。

legalAgeGroupClassification 値

メンバー 説明
null 既定値。ユーザーに ageGroup が設定されていません。
minorWithoutParentalConsent (将来使用するために予約されています)
minorWithParentalConsent 当該国または地域の年齢関連規制に基づいてユーザーが未成年と判断され、アカウントの管理者が保護者から適切な同意を得ています。
adult 当該国または地域の年齢関連規制に基づいて成人と判断されたユーザー。
notAdult 追加の年齢関連規制がある国または地域 (米国、英国、欧州連合、韓国など) にいるユーザーであり、ユーザーの年齢が未成年と成人の間です (国または地域での規定に基づく)。通常、規制対象の国では 10 代の若者は notAdult とみなされます。
minorNoParentalConsentRequired ユーザーは未成年ですが、年齢関連の規制のない国または地域にいます。

ageGroup 値

メンバー 説明
null 既定値。ユーザーに ageGroup が設定されていません。
minor ユーザーは未成年として扱われます。
notAdult ユーザーは法的規制のある国 (米国、英国、欧州連合、または韓国) の出身であり、ユーザーの年齢は未成年者の年齢の上限 (国に応じて異なる) を超えていて、成人の年齢の下限 (国または地域の規定に基づく) 未満です。したがって基本的に 10 代の若者は規制対象の国では notAdult とみなされます。
adult ユーザーは成人として扱われます。

consentProvidedForMinor 値

メンバー 説明
null 既定値。ユーザーに consentProvidedForMinor が設定されていません。
granted ユーザーがアカウントを所有することについて同意が得られています。
denied ユーザーがアカウントを所有することについて同意が得られていません。
notRequired ユーザーは、同意を必要としない場所にいます。

リレーションシップ

リレーションシップ 型 説明
agreementAcceptances agreementAcceptance コレクション 利用規約に対するユーザー承認状態。読み取り専用。Null 許容型です。
appRoleAssignments appRoleAssignment コレクション ユーザーがアプリに対して付与されているアプリの役割を表します。$expand をサポートします。
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 コレクション ユーザーに対して定義されているオープン拡張機能のコレクション。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 読み取り専用です。
outlook outlookUser ユーザーが使用できる選択的 Outlook サービス。読み取り専用です。null 許容型です。
ownedDevices directoryObject collection ユーザーが所有しているデバイス。読み取り専用です。Null 許容型。$expand をサポートします。
ownedObjects directoryObject コレクション ユーザーが所有しているディレクトリ オブジェクト。読み取り専用です。Null 許容型。$expand をサポートします。
pendingAccessReviewInstances accessReviewInstance レビュー担当者による承認待ちのアクセス レビューのリストを取得するためのナビゲーション プロパティ。
people person コレクション 読み取り専用。ユーザーに最も関連のある人。コレクションは、ユーザーに対する関連 (ユーザーの通信、コラボレーション、およびビジネス リレーションシップによって決まる) を基準として配列されます。person は、メール、連絡先、およびソーシャル ネットワークのすべてからの情報の集約です。
photo profilePhoto ユーザーのプロフィール写真。読み取り専用です。
photos Photo コレクション 読み取り専用です。Null 許容型。
planner plannerUser ユーザーが使用できる選択的 Planner サービス。読み取り専用です。null 許容型です。
profile profile テナント内のユーザーを説明するプロパティを表します。
registeredDevices directoryObject collection ユーザーについて登録されているデバイス。読み取り専用です。Null 許容型。$expandのサポート。
scopedRoleMemberOf scopedRoleMembership コレクション このユーザーのスコープ ロール管理単位のメンバーシップ。読み取り専用です。null 許容型です。
settings userSettings 読み取り専用。Null 許容型。
チームワーク userTeamwork ユーザーが使用できる Microsoft Teams の機能のコンテナー。読み取り専用です。null 許容型です。
ToDo todo ユーザーが利用できる To Do サービスを表します。
transitiveReports directoryObject コレクション ユーザーの推移的なレポートです。読み取り専用です。
usageRight usageRight コレクション ユーザーに付与されている使用権限を表します。

言語と地域の形式のユーザー設定

ユーザー リソースには、ユーザーの優先する言語、日付と時刻の形式、既定のタイムゾーン、およびプライマリ Exchange メールボックス専用のその他の設定を含む、mailboxSettings プロパティが含まれます。 これらの設定は、メール クライアントを対象としており、ユーザーに対してメールボックスがプロビジョニングされている場合のみ利用できます。 Outlook のメール、予定表、連絡先、またはタスクにのみ焦点を当てたシナリオでは、mailboxSettings を使用することができます。

mailboxSettings に加えて、ユーザー は userSettings を使って、regionalAndLanguageSettings へのリレーションシップを含めます。これは、すべてのアプリケーションで使用できる、ユーザー設定された言語と地域の設定のスーパーセットで、ユーザーに最適な言語と地域の設定体験を提供します。 userSettings を使用すると、Azure AD のユーザー プロファイルによって、同じユーザー設定を反映して、アプリ全体で一貫した操作性を実現することができます。

JSON 表記

以下は、リソースの JSON 表記です

{
  "aboutMe": "String",
  "accountEnabled": true,
  "ageGroup": "String",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "birthday": "String (timestamp)",
  "businessPhones": ["String"],
  "city": "String",
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "2019-02-07T21:53:13.067Z",
  "creationType": "String",
  "deletedDateTime": "String (timestamp)",
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "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"],
  "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",
  "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"],
  "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"},
  "profile": {"@odata.type": "microsoft.graph.profile"},
  "registeredDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"}
}

関連項目