user リソースの種類user resource type

重要: Microsoft Graph のベータ版 (/beta) の API はプレビュー中であるため、変更されることがあります。Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. 実稼働アプリケーションでの、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

Azure AD ユーザー アカウントを表します。directoryObject から継承します。Represents an Azure AD user account. Inherits from directoryObject.

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

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
user のリストList users user コレクションuser collection ユーザー オブジェクトのリストを取得します。Get a list of user objects.
ユーザーを作成するCreate user useruser 新しいユーザー オブジェクトを作成します。Create a new user object.
Get userGet user useruser ユーザー オブジェクトのプロパティと関係を読み取ります。Read properties and relationships of user object.
Update userUpdate user useruser ユーザー オブジェクトを更新します。Update user object.
Delete userDelete user なしNone ユーザー オブジェクトを削除します。Delete user object.
List messagesList messages Message collectionMessage collection サインインしているユーザーのメールボックス内のすべてのメッセージを取得します。Get all the messages in the signed-in user's mailbox.
Create MessageCreate Message MessageMessage メッセージのコレクションへの投稿には、メッセージを作成します。Create a Message by posting to the messages collection.
List mailFoldersList mailFolders MailFolder collectionMailFolder collection サインイン中のユーザーのルート フォルダーからメール フォルダー コレクションを取得します。Get the mail folder collection under the root folder of the signed-in user.
Create mailFolderCreate mailFolder MailFolderMailFolder mailFolder コレクションへの投稿により、新しい MailFolder を作成します。Create a new MailFolder by posting to the mailFolders collection.
sendMailsendMail NoneNone 要求本文に指定されたメッセージを送信します。Send the message specified in the request body.
List eventsList events Event collectionEvent collection ユーザーのメールボックス内のイベント オブジェクトの一覧を取得します。一覧には、単一インスタンスの会議と定期的なマスターが含まれています。Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
イベントを作成するCreate event EventEvent Event コレクションへの投稿によって、新しいイベントを作成します。Create a new Event by posting to the events collection.
List calendarsList calendars Calendar collectionCalendar collection 予定表オブジェクトのコレクションを取得します。Get a Calendar object collection.
Create calendarCreate calendar CalendarCalendar 予定表コレクションへの投稿により、新しい予定表を作成します。Create a new Calendar by posting to the calendars collection.
List calendarGroupsList calendarGroups CalendarGroup collectionCalendarGroup collection CalendarGroup オブジェクトのコレクションを取得します。Get a CalendarGroup object collection.
Create calendarGroupCreate calendarGroup CalendarGroupCalendarGroup calendarGroups コレクションへの投稿により、新しい CalendarGroup を作成します。Create a new CalendarGroup by posting to the calendarGroups collection.
List calendarViewList calendarView Event collectionEvent collection イベント オブジェクトのコレクションを取得します。Get an Event object collection.
List contactsList contacts Contact collectionContact collection サインイン中のユーザーの既定の連絡先フォルダーから連絡先コレクションを取得します。Get a contact collection from the default Contacts folder of the signed-in user.
Create ContactCreate Contact ContactContact 連絡先コレクションに投稿することにより、新しい連絡先を作成します。Create a new Contact by posting to the contacts collection.
List contactFoldersList contactFolders ContactFolder collectionContactFolder collection サインイン中のユーザーの既定の連絡先フォルダー内の連絡先フォルダーのコレクションを取得します。Get the contact folder collection in the default Contacts folder of the signed-in user.
Create ContactFolderCreate ContactFolder ContactFolderContactFolder contactFolder コレクションに投稿することにより、新しい ContactFolder を作成します。Create a new ContactFolder by posting to the contactFolders collection.
List directReportsList directReports directoryObject collectiondirectoryObject collection そのユーザーの部下であるユーザーと連絡先を、directReports ナビゲーション プロパティから取得します。Get the users and contacts that report to the user from the directReports navigation property.
List managerList manager directoryObjectdirectoryObject そのユーザーの上司であるユーザーまたは連絡先を、マネージャー ナビゲーション プロパティから取得します。Get the user or contact that is this user's manager from the manager navigation property.
List memberOfList memberOf directoryObject コレクションdirectoryObject collection グループ、ディレクトリの役割、およびユーザーが所属するグループのナビゲーション プロパティからの直接のメンバーになっている管理の単位を取得します。Get the groups, directory roles, and administrative units that the user is a direct member of from the memberOf navigation property.
[推移的な所属するグループ] ボックスの一覧](../api/user-list-transitivememberof.md)List transitive memberOf directoryObject コレクションdirectoryObject collection グループ、ディレクトリの役割、およびメンバーであるユーザーの管理の単位を一覧表示します。List the groups, directory roles, and administrative units that the user is a member of. この操作では、推移的では、ユーザーの入れ子にされたメンバーであるグループが含まれています。This operation is transitive and includes the groups that the user is a nested member of.
参加チームのリストを作成するList joinedTeams グループコレクションgroups collection ユーザーが joinedTeams のナビゲーション プロパティからの直接のメンバーであるマイクロソフトのチームを取得します。Get the Microsoft Teams that the user is a direct member of from the joinedTeams navigation property.
List ownedDevicesList ownedDevices directoryObject collectiondirectoryObject collection そのユーザーにより所有されているデバイスを、OwnedDevices ナビゲーション プロパティから取得します。Get the devices that are owned by the user from the ownedDevices navigation property.
List ownedObjectsList ownedObjects directoryObject collectiondirectoryObject collection そのユーザーにより所有されているディレクトリ オブジェクトを、ownedObjects ナビゲーション プロパティから取得します。Get the directory objects that are owned by the user from the ownedObjects navigation property.
List plannerTasksList plannerTasks plannerTask コレクションplannerTask collection ユーザーに割り当てられている plannerTasks を取得します。Get plannerTasks assigned to the user.
List registeredDevicesList registeredDevices directoryObject collectiondirectoryObject collection RegisteredDevices のナビゲーション プロパティからユーザーの登録されているデバイスを取得します。Get the devices that are registered for the user from the registeredDevices navigation property.
スコープ ロール メンバーシップの一覧List scoped-role memberships scopedRoleMembership コレクションscopedRoleMembership collection このユーザーの管理単位メンバーシップのスコープからロールを取得します。Get the scoped-role administrative units memberships for this user.
List createdObjectsList createdObjects directoryObject collectiondirectoryObject collection そのユーザーにより作成されたディレクトリ オブジェクトを、createdObjects ナビゲーション プロパティから取得します。Get the directory objects created by the user from the createdObjects navigation property.
リスト agreementAcceptancesList agreementAcceptances agreementAcceptanceコレクションagreementAcceptance collection 使用条件の一覧にユーザーの承認ステータスを取得します。Get a list of terms of use acceptance statuses of the user.
assignLicenseassignLicense useruser ユーザーのサブスクリプションを追加または削除します。また、サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。Add or remove subscriptions for the user. You can also enable and disable specific plans associated with a subscription.
licenseDetails を一覧表示するList licenseDetails licenseDetails コレクションlicenseDetails collection licenseDetails オブジェクトのコレクションを取得します。Get a licenseDetails object collection.
checkMemberGroupscheckMemberGroups String コレクションString collection グループの一覧内のメンバーシップを確認します。チェックは推移的です。Check for membership in a list of groups. The check is transitive.
findmeetingtimesfindmeetingtimes meetingTimeCandidatemeetingTimeCandidate 検索の時間と場所を満たすためには、出席者の空き時間、場所、時間の制約に基づいています。Find time and locations to meet based on attendee availability, location, or time constraints.
findRoomListsfindRoomLists emailaddress.mdコレクションemailaddress.md collection テナントで定義された部屋の一覧を取得します。Get the room lists defined in a tenant.
findRoomsfindRooms emailaddress.mdコレクションemailaddress.md collection すべての会議室ユーザーのテナントや、特定の場所] ボックスの一覧を取得します。Get all the meeting rooms in the user's tenant or in a specific room list.
getMailTipsgetMailTips mailTips コレクションmailTips collection サインイン中のユーザーが利用できる、1 人または複数の受信者に対してのメール ヒントを返します。Return the MailTips of one or more recipients as available to the signed-in user.
getMemberGroupsgetMemberGroups String コレクションString collection ユーザーがメンバーであるすべてのグループを返します。チェックは推移的です。Return all the groups that the user is a member of. The check is transitive.
getMemberObjectsgetMemberObjects String コレクションString collection すべてのグループ、ディレクトリの役割、およびメンバーであるユーザーの管理の単位を取得します。Return all the groups, directory roles, and administrative units that the user is a member of. チェック、推移的です。The check is transitive.
invalidateAllRefreshTokensinvalidateAllRefreshTokens なしNone RefreshTokensValidFromDateTimeユーザーのプロパティを現在の日付と時刻にリセットすることで、アプリケーションに発行されたすべてのユーザーの更新し、セッション トークンを無効にします。Invalidates all the user's refresh and session tokens issued to applications, by resetting the refreshTokensValidFromDateTime user property to the current date-time. これは、それらのアプリケーションをもう一度サインインするユーザーを強制します。This forces the user to sign in to those applications again.
reminderViewreminderView Reminder collectionReminder collection 指定した開始時刻と終了時刻内の予定表のアラームの一覧を返します。Return a list of calendar reminders within the start and end times specified.
deltadelta user コレクションuser collection ユーザーに対する増分の変更を取得します。Get incremental changes for users.
Outlook の識別子を変換します。Translate Outlook identifiers convertIdResult リソースの種類のコレクションconvertIdResult resource type collection 形式との間、Outlook に関連するリソースの識別子を変換します。Translate identifiers of Outlook-related resources between formats.
オープン拡張機能Open extensions
オープン拡張機能を作成するCreate open extension openTypeExtensionopenTypeExtension オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。Create an open extension and add custom properties to a new or existing resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 拡張機能の名前で識別されるオープン拡張機能を取得します。Get an open extension identified by the extension name.
スキーマ拡張機能Schema extensions
スキーマ拡張機能の値を追加するAdd schema extension values スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。Create a schema extension definition and then use it to add custom typed data to a resource.

プロパティProperties

プロパティProperty Type 説明Description
aboutMeaboutMe StringString ユーザーが自分自身について記述する、フリー フォームのテキスト入力フィールド。A freeform text entry field for the user to describe themselves.
accountEnabledaccountEnabled BooleanBoolean アカウントが有効な場合は true。そうでない場合は false。このプロパティは、ユーザーの作成時に必要です。$filter をサポートします。true if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter.
ageGroupageGroup StringString ユーザーの年齢グループを設定します。Sets the age group of the user. 使用できる値: nullminornotAdultadultAllowed values: null, minor, notAdult and adult. 詳細については法律の年齢グループのプロパティの定義を参照してください。Refer to the legal age group property definitions for further information.
assignedLicensesassignedLicenses assignedLicense collectionassignedLicense collection ユーザーに割り当てられているライセンス。null 許容ではありません。The licenses that are assigned to the user. Not nullable.
assignedPlansassignedPlans assignedPlan コレクションassignedPlan collection ユーザーに割り当てられているプラン。読み取り専用です。null 許容ではありません。The plans that are assigned to the user. Read-only. Not nullable.
birthdaybirthday DateTimeOffsetDateTimeOffset ユーザーの誕生日。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
citycity StringString ユーザーがいる都市。$filter をサポートします。The city in which the user is located. Supports $filter.
companyNamecompanyName StringString ユーザーが関連付けられている会社名。The company name which the user is associated. 読み取り専用です。Read-only.
consentProvidedForMinorconsentProvidedForMinor StringString 未成年者の同意が取得されたかどうかを設定します。Sets whether consent has been obtained for minors. 使用できる値: nullgranteddeniednotRequiredAllowed values: null, granted, denied and notRequired. 詳細については法律の年齢グループのプロパティの定義を参照してください。Refer to the legal age group property definitions for further information.
countrycountry StringString 国/地域のユーザーが存在します。たとえば、「米国」または「大阪府」です。The country/region in which the user is located; for example, "US" or "UK". $filter をサポートします。Supports $filter.
deletedDateTimedeletedDateTime DateTimeOffsetDateTimeOffset 日付と時刻、ユーザーが削除されました。The date and time the user was deleted.
departmentdepartment StringString ユーザーが働いている部門の名前。$filter をサポートします。The name for the department in which the user works. Supports $filter.
displayNamedisplayName StringString アドレス帳に表示されるユーザーの名前。The name displayed in the address book for the user. この値は、通常、ユーザーの名、ミドル ネームの最初と最後の名の組み合わせです。This value is usually the combination of the user's first name, middle initial, and last name. このプロパティはユーザーの作成時に必須です。更新時にクリアすることはできません。This property is required when a user is created and it cannot be cleared during updates. $filter および $orderby をサポートします。Supports $filter and $orderby.
[社員コード]employeeId StringString 組織がユーザーに割り当てられている従業員の識別子です。The employee identifier assigned to the user by the organization. $filter をサポートします。Supports $filter.
externalUserStateexternalUserState StringString 招待 APIを使用してテナントに招待された外部ユーザーに対しては、このプロパティは、招待されたユーザーの招待の状態を表します。For an external user invited to the tenant using the invitation API, this property represents the invited user's invitation status. 'PendingAcceptance' または '' を招待するユーザーの状態は、またはnullの他のすべてのユーザー用です。For invited users, the state can be 'PendingAcceptance' or 'Accepted', or null for all other users. $Filter でサポートされている値をサポートしています。Supports $filter with the supported values. 例: $filter=externalUserState eq 'PendingAcceptance'For example: $filter=externalUserState eq 'PendingAcceptance'.
externalUserStateChangeDateTimeexternalUserStateChangeDateTime StringString ExternalUserState プロパティには、最新の変更のタイムスタンプを表示します。Shows the timestamp for the latest change to the externalUserState property.
変更を保存faxNumber StringString ユーザーの fax 番号です。The fax number of the user.
givenNamegivenName StringString ユーザーの名。$filter をサポートします。The given name (first name) of the user. Supports $filter.
hireDatehireDate DateTimeOffsetDateTimeOffset ユーザーの採用日付。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
idid StringString ユーザーの一意の識別子。directoryObject から継承されます。キー。null 許容ではありません。読み取り専用です。The unique identifier for the user. Inherited from directoryObject. Key. Not nullable. Read-only.
interestsinterests String コレクションString collection ユーザーが自分の関心事を記述する一覧。A list for the user to describe their interests.
jobTitlejobTitle StringString ユーザーの役職。$filter をサポートします。The user’s job title. Supports $filter.
legalAgeGroupClassificationlegalAgeGroupClassification StringString エンタープライズ ・ アプリケーションで使用すると、ユーザーの法的な年齢グループを決定します。Used by enterprise applications to determine the legal age group of the user. このプロパティは読み取り専用と演算に基づくageGroupconsentProvidedForMinorのプロパティです。This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. 使用できる値: nullminorWithOutParentalConsentminorWithParentalConsentminorNoParentalConsentRequirednotAdultadultAllowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. 参照してください詳細については法律の年齢グループのプロパティの定義。)Refer to the legal age group property definitions for further information.)
licenseAssignmentStateslicenseAssignmentStates licenseAssignmentStateコレクションlicenseAssignmentState collection このユーザーのライセンスの割り当ての状態です。State of license assignments for this user. 読み取り専用です。Read-only.
mailmail StringString ユーザーの SMTP アドレス (たとえば、"jeff@contoso.onmicrosoft.com")。読み取り専用。$filter をサポートします。The SMTP address for the user, for example, "jeff@contoso.onmicrosoft.com". Read-Only. Supports $filter.
mailboxSettingsmailboxSettings mailboxSettingsmailboxSettings サインイン ユーザーのプライマリ メールボックスの設定。Settings for the primary mailbox of the signed-in user. 着信メッセージ、ロケール、およびタイム ゾーンへの自動返信を送信するための更新取得または設定ができます。You can get or update settings for sending automatic replies to incoming messages, locale, and time zone.
mailNicknamemailNickname StringString ユーザーの電子メール エイリアス。ユーザーの作成時に、このプロパティを指定する必要があります。$filter をサポートします。The mail alias for the user. This property must be specified when a user is created. Supports $filter.
mobilePhonemobilePhone StringString ユーザーの主な携帯電話の番号。The primary cellular telephone number for the user.
mySitemySite StringString ユーザーの個人用サイトの URL。The URL for the user's personal site.
officeLocationofficeLocation StringString ユーザーの勤務先の場所。The office location in the user's place of business.
onPremisesDistinguishedNameonPremisesDistinguishedName StringString オンプレミスの Active Directory が含まれていますdistinguished nameまたはDNContains the on-premises Active Directory distinguished name or DN. プロパティは Azure AD 接続経由で Active Directory を Azure に、オンプレミスのディレクトリが同期しているお客様に対してのみ設定されます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
onPremisesDomainNameonPremisesDomainName StringString 設置が含まれていますdomainFQDN、設置ディレクトリからの同期をとりますとも呼ばれます。Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. プロパティは Azure AD 接続経由で Active Directory を Azure に、オンプレミスのディレクトリが同期しているお客様に対してのみ設定されます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
onPremisesExtensionAttributesonPremisesExtensionAttributes OnPremisesExtensionAttributesOnPremisesExtensionAttributes ユーザーの extensionAttributes 1-15 が含まれています。Contains extensionAttributes 1-15 for the user. 個々 の拡張属性は、フィルターも選択可能なことに注意してください。Note that the individual extension attributes are neither selectable nor filterable. onPremisesSyncEnabledユーザーは、この一連のプロパティは読み取り専用で、マスター設置します。For an onPremisesSyncEnabled user, this set of properties is mastered on-premises and is read-only. クラウド専用のユーザー (、onPremisesSyncEnabledは)、これらのプロパティは作成時に設定するか、更新します。For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update.
onPremisesImmutableIdonPremisesImmutableId StringString Azure AD ユーザー オブジェクトには、オンプレミス Active Directory ユーザー アカウントを関連付けるにはこのプロパティを使用します。This property is used to associate an on-premises Active Directory user account to their Azure AD user object. ユーザーのフェデレーション ドメインを使用している場合は、グラフに新しいユーザー アカウントを作成するときは、このプロパティを指定する必要がありますuserPrincipalName(UPN) のプロパティです。This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user’s userPrincipalName (UPN) property. 重要な:****$ 、このプロパティを指定する場合、 _ 文字を使用できません。Important: The $ and _ characters cannot be used when specifying this property. $filter をサポートします。Supports $filter.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset オブジェクトがオンプレミス ディレクトリと前回、同期された日時を示します。例:"2013-02-16T03:04:54Z"Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'読み取り専用です。Indicates the last time at which the object was synced with the on-premises directory; for example: "2013-02-16T03:04:54Z". The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only.
onPremisesProvisioningErrorsonPremisesProvisioningErrors onPremisesProvisioningErrorコレクションonPremisesProvisioningError collection 提供処理中に同期の Microsoft 製品を使用するときのエラーです。Errors when using Microsoft synchronization product during provisioning.
onPremisesSamAccountNameonPremisesSamAccountName StringString 設置が含まれていますsAMAccountName設置ディレクトリと同期します。Contains the on-premises sAMAccountName synchronized from the on-premises directory. プロパティは Azure AD 接続経由で Active Directory を Azure に、オンプレミスのディレクトリが同期しているお客様に対してのみ設定されます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier StringString オンプレミスからクラウドに同期されたユーザーのオンプレミスのセキュリティ識別子 (SID) が含まれます。読み取り専用です。Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean このオブジェクトがオンプレミスのディレクトリから同期される場合は true、このオブジェクトが最初にオンプレミスのディレクトリから同期されていて、今後は同期しない場合は false、このオブジェクトがオンプレミスのディレクトリから 1 度も同期されたことがない場合は null (既定値)。読み取り専用true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Read-only
onPremisesUserPrincipalNameonPremisesUserPrincipalName StringString 設置が含まれていますuserPrincipalName設置ディレクトリと同期します。Contains the on-premises userPrincipalName synchronized from the on-premises directory. プロパティは Azure AD 接続経由で Active Directory を Azure に、オンプレミスのディレクトリが同期しているお客様に対してのみ設定されます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
otherMailsotherMails StringString ユーザーの他の電子メール アドレスの一覧例: ["bob@contoso.com", "Robert@fabrikam.com"]A list of additional email addresses for the user; for example: ["bob@contoso.com", "Robert@fabrikam.com"]. $filter をサポートします。Supports $filter.
passwordPoliciespasswordPolicies StringString ユーザーのパスワード ポリシーを指定します。この値は列挙値であり、可能な 1 つの値は "DisableStrongPassword" です。この場合は、既定のポリシーより脆弱なパスワードを指定できます。"DisablePasswordExpiration" を指定することもできます。2 つを一緒に指定することもできます。例:"DisablePasswordExpiration, DisableStrongPassword"Specifies password policies for the user. This value is an enumeration with one possible value being “DisableStrongPassword”, which allows weaker passwords than the default policy to be specified. “DisablePasswordExpiration” can also be specified. The two may be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile PasswordProfilePasswordProfile ユーザーのパスワード プロファイルを指定します。プロファイルには、ユーザーのパスワードが含まれています。このプロパティは、ユーザーの作成時に必要です。プロファイルにあるパスワードは、passwordPolicies プロパティによって指定されている最小要件を満たす必要があります。既定では、強力なパスワードが必要です。Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
pastProjectspastProjects String コレクションString collection ユーザーが過去のプロジェクトを列挙する一覧。A list for the user to enumerate their past projects.
postalCodepostalCode StringString ユーザーの住所の郵便番号。郵便番号は、ユーザーの国/地域に固有です。アメリカ合衆国では、この属性には、ZIP コードが含まれます。The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.
preferredDataLocationpreferredDataLocation StringString ユーザーの希望するデータの場所です。The preferred data location for the user. 詳細については、オンラインの複数の地域 OneDriveを参照してください。For more information, see OneDrive Online Multi-Geo.
preferredLanguagepreferredLanguage StringString ユーザーが設定する言語。ISO 639-1 コードに従う必要があります。たとえば "en-US" です。The preferred language for the user. Should follow ISO 639-1 Code; for example "en-US".
preferredNamepreferredName StringString ユーザーが設定する名前。The preferred name for the user.
provisionedPlansprovisionedPlans ProvisionedPlan コレクションProvisionedPlan collection ユーザーのために用意されたプラン。読み取り専用です。null 許容ではありません。The plans that are provisioned for the user. Read-only. Not nullable.
proxyAddressesproxyAddresses String コレクションString collection 例:["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] 複数値プロパティのフィルター式には、任意の演算子が必要です。読み取り専用。null 許容ではありません。$filter をサポートします。For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] The any operator is required for filter expressions on multi-valued properties. Read-only, Not nullable. Supports $filter.
refreshTokensValidFromDateTimerefreshTokensValidFromDateTime DateTimeOffsetDateTimeOffset トークンの更新やセッション トークン (セッション cookie) は、この時間が有効でないと、アプリケーションはトークンを取得するエラー、無効な更新やセッション トークンを使用して、委任されたアクセスを取得するとき (Api にアクセスする Microsoft のグラフなど) の前に発行されます。Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications will get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph). このような場合は、アプリケーションが承認エンドポイントを要求することによって、新しい更新のトークンを取得する必要があります。If this happens, the application will need to acquire a new refresh token by making a request to the authorize endpoint. 読み取り専用です。Read-only. リセットするには、 invalidateAllRefreshTokensを使用します。Use invalidateAllRefreshTokens to reset.
responsibilitiesresponsibilities String コレクションString collection ユーザーが自分の責任の範囲を列挙する一覧。A list for the user to enumerate their responsibilities.
schoolsschools String コレクションString collection ユーザーが在籍した学校を列挙する一覧。A list for the user to enumerate the schools they have attended.
showInAddressListshowInAddressList BooleanBoolean true の場合、Outlook のグローバル アドレス一覧は、このユーザー、それ以外の場合はfalseを含める必要があります。true if the Outlook global address list should contain this user, otherwise false. かどうかが設定されていないこのとして扱われます場合は trueです。If not set, this will be treated as true. 招待マネージャーによって参加を要請するユーザー、このプロパティはfalseに設定されます。For users invited through the invitation manager, this property will be set to false.
skillsskills String コレクションString collection ユーザーが自分のスキルを列挙する一覧。A list for the user to enumerate their skills.
statestate StringString ユーザーの住所の都道府県。$filter をサポートします。The state or province in the user's address. Supports $filter.
streetAddressstreetAddress StringString ユーザーの勤務先の番地。The street address of the user's place of business.
surnamesurname StringString ユーザーの姓。$filter をサポートします。The user's surname (family name or last name). Supports $filter.
usageLocationusageLocation StringString 2 文字の国コード (ISO 規格 3166)国におけるサービスの利用可能性を確認することが法的に義務付けられているため、ライセンスを割り当てられるユーザーには必須です。例:"US"、"JP"、"GB"null 許容ではありません。$filter をサポートします。A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: "US", "JP", and "GB". Not nullable. Supports $filter.
userPrincipalNameuserPrincipalName StringString ユーザーのユーザー プリンシパル名 (UPN)。UPN は、インターネット標準 RFC 822 に基づいた、インターネット スタイルのユーザーのログイン名です。規則では、これはユーザーの電子メール名にマップされる必要があります。一般的な形式は alias@domain です。このドメインは、検証済みドメインのテナントのコレクション内に存在している必要があります。このプロパティは、ユーザーの作成時に必要です。テナントの検証済みのドメインには、organizationverifiedDomains プロパティからアクセスできます。$filter および $orderby をサポートします。The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby.
userTypeuserType StringString 「メンバー」および"Guest"など、ディレクトリ内のユーザーの種類を分類するために使用する文字列値。A string value that can be used to classify user types in your directory, such as "Member" and "Guest". $filter をサポートします。Supports $filter.

この説明では、どのように 3 つの年齢グループのプロパティ (legalAgeGroupClassificationageGroupconsentProvidedForMinor) 時代に関連する規制を満たすために、Azure AD の管理者とエンタープライズ アプリケーションの開発者によって使用されます。This section explains how the three age group properties (legalAgeGroupClassification, ageGroup and consentProvidedForMinor) are used by Azure AD administrators and enterprise application developers to meet age-related regulations.

例: ある Cameron は、英国の Holyport で、小学生用のディレクトリの管理者です。For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. 学校年度の開始時のマイナーの親が愛知県の年齢関連の規制に基づく承認を取得するのには来園者の書類を使用しました。At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. 親から取得した同意は、Holyport の学校およびマイクロソフトのアプリケーションで使用される、マイナーのアカウントを使用できます。The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. ある Cameron は、すべてのアカウントを作成し、「小さな」に ageGroup と consentProvidedForMinor を「許可」に設定します。Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". 自分の受講者が使用するアプリケーションでは、未成年者が適切ではないフィーチャーを抑制すること、です。Applications used by his students are then able to suppress features that are not suitable for minors.

エンタープライズ アプリケーションの開発者がこの読み取り専用プロパティを使用して、年齢、法律に基づいて、ユーザーの適切に処理できるように。This read-only property is used by enterprise application developers to ensure the correct handling of a user based on their legal age group. ユーザーの基に計算、ageGroupconsentProvidedForMinorのプロパティです。It is calculated based on the user's ageGroup and consentProvidedForMinor properties.

Value # 説明Description
nullnull 00 既定値は noageGroupユーザー用に設定されています。Default value, no ageGroup has been set for the user.
minorWithoutParentalConsentminorWithoutParentalConsent 11 (将来使用するために予約されています)(Reserved for future use)
minorWithParentalConsentminorWithParentalConsent 22 ユーザーが自分の国の年齢関連の規制に基づき、マイナーと見なされます。 または地域、およびアカウントの管理者から入手して適切な同意、親か保護者です。The user is considered a minor based on the age-related regulations of their country or region and the administrator of the account has obtained appropriate consent from a parent or guardian.
成人向けコンテンツadult 33 ユーザーには、自分の国または地域の年齢関連の規制に基づく成人と見なされます。The user considered an adult based on the age-related regulations of their country or region.
notAdultnotAdult 44 ユーザーから国または地域を持つその他の有効期間に関連する規制 (米国、英国、欧州連合または (韓国)) は、ユーザーの年齢を副専攻と成人向けの有効期間の間 (として規定に基づいて国や地域)。The user is from a country or region that has additional age-related regulations (such as the United States, United Kingdom, European Union or South Korea), and the user's age is between a minor and an adult age (as stipulated based on country or region). 通常、これは、10 代の若者と見なされますnotAdult規制対象国にします。Generally, this means that teenagers are considered as notAdult in regulated countries.
minorNoParentalConsentRequiredminorNoParentalConsentRequired 55 ユーザーは、マイナーでは、国または地域の時代に関連する規制がないからです。The user is a minor but is from a country or region that has no age-related regulations.

年齢グループおよびマイナーの同意のプロパティは、Azure AD の管理者アカウントの使用が正しく、年齢に関連する規制のルールに基づいてユーザーの国または地域を制御する処理を確実に使用する省略可能なプロパティです。The age group and minor consent properties are optional properties used by Azure AD administrators to help ensure the use of an account is handled correctly based on the age-related regulatory rules governing the user's country or region.

ageGroup プロパティageGroup property

Value # 説明Description
nullnull 00 既定値は noageGroupユーザー用に設定されています。Default value, no ageGroup has been set for the user.
マイナーminor 11 ユーザーが副専攻を検討してください。The user is consider a minor.
notAdultnotAdult 22 ユーザーは、米国、英国、欧州連合、または韓国の法律上の規制のある国からは)、ユーザーの年齢 (国) に子供の年齢の上限を超えると成人の年齢の下限よりも小さい (として規定に基づいて国や地域).The user is from a country that has statutory regulations United States, United Kingdom, European Union or South Korea) and user’s age is more than the upper limit of kid age (as per country) and less than lower limit of adult age (as stipulated based on country or region). として 10 代の若者が考慮されるように基本的には、notAdult規制対象国にします。So basically, teenagers are considered as notAdult in regulated countries.
成人向けコンテンツadult 33 ユーザーは、大人として扱われる必要があります。The user should be a treated as an adult.

consentProvidedForMinor プロパティconsentProvidedForMinor property

Value # 説明Description
nullnull 00 既定値は noconsentProvidedForMinorユーザー用に設定されています。Default value, no consentProvidedForMinor has been set for the user.
付与granted 11 アカウントのユーザーの同意を受けています。Consent has been obtained for the user to have an account.
denieddenied 22 アカウントのユーザーの同意が取得されていません。Consent has not been obtained for the user to have an account.
必要ありません。notRequired 33 ユーザーは、同意を必要としない場所です。The user is from a location that does not require consent.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
agreementAcceptancesagreementAcceptances agreementAcceptanceコレクションagreementAcceptance collection 使用の承認の状態のユーザーの条件です。The user's terms of use acceptance statuses. 読み取り専用です。Read-only. Null 許容型。Nullable.
予定表calendar calendarcalendar ユーザーの標準予定表。読み取り専用です。The user's primary calendar. Read-only.
calendarGroupscalendarGroups calendarGroupコレクションcalendarGroup collection ユーザーの予定表グループ。読み取り専用です。Null 許容型。The user's calendar groups. Read-only. Nullable.
calendarViewcalendarView event コレクションevent collection 予定表のカレンダー ビュー。読み取り専用です。Null 許容型。The calendar view for the calendar. Read-only. Nullable.
calendarscalendars calendar collectioncalendar collection ユーザーの予定表。読み取り専用です。Null 許容型。The user's calendars. Read-only. Nullable.
contactFolderscontactFolders contactFolderコレクションcontactFolder collection ユーザーの連絡先フォルダー。読み取り専用です。Null 許容型。The user's contacts folders. Read-only. Nullable.
contactscontacts contactコレクションcontact collection ユーザーの連絡先。読み取り専用です。Null 許容型。The user's contacts. Read-only. Nullable.
createdObjectscreatedObjects directoryObject コレクションdirectoryObject collection ユーザーによって作成されたディレクトリ オブジェクト。読み取り専用です。Null 許容型。Directory objects that were created by the user. Read-only. Nullable.
directReportsdirectReports directoryObject collectiondirectoryObject collection そのユーザーの部下であるユーザーと連絡先。(マネージャー プロパティがこのユーザーに設定されている、ユーザーと連絡先。)読み取り専用です。Null 許容型。The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable.
ドライブdrive drivedrive ユーザーの OneDrive。読み取り専用です。The user's OneDrive. Read-only.
eventsevents event コレクションevent collection ユーザーのイベント。既定は、既定の予定表でイベントを表示します。読み取り専用です。Null 許容型。The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable.
extensionsextensions extension コレクションextension collection 開いている拡張機能がユーザーの定義のコレクションです。The collection of open extensions defined for the user. Null 許容型。Nullable.
inferenceClassificationinferenceClassification inferenceClassificationinferenceClassification 明示的な指定に基づく、ユーザーのメッセージの関連性の分類。明示的な指定は、推定される関連性や重要性より優先されます。Relevance classification of the user's messages based on explicit designations which override inferred relevance or importance.
洞察insights 情報のコレクションinsights collection 読み取り専用。Null 許容型。Read-only. Nullable.
joinedGroupsjoinedGroups group コレクションgroup collection 読み取り専用。Null 許容型。Read-only. Nullable.
mailFoldersmailFolders mailFolder コレクションmailFolder collection ユーザーのメール フォルダー。読み取り専用です。Null 許容型。The user's mail folders. Read-only. Nullable.
managermanager directoryObjectdirectoryObject このユーザーの上司であるユーザーまたは連絡先。読み取り専用です。(HTTP メソッド:GET、PUT、DELETE)The user or contact that is this user’s manager. Read-only. (HTTP Methods: GET, PUT, DELETE.)
memberOfmemberOf directoryObject コレクションdirectoryObject collection ユーザーがメンバーになっているグループ、ディレクトリ ロール、および管理単位。読み取り専用。Null 許容型。The groups, directory roles and administrative units that the user is a member of. Read-only. Nullable.
joinedTeamsjoinedTeams group コレクションgroup collection ユーザーがのメンバーであるマイクロソフトのチームです。The Microsoft Teams that the user is a member of. 読み取り専用です。Read-only. Null 許容型。Nullable.
messagesmessages message コレクションmessage collection メールボックスまたはフォルダー内のメッセージ。読み取り専用です。Null 許容型。The messages in a mailbox or folder. Read-only. Nullable.
onenoteonenote OneNoteOneNote 読み取り専用です。Read-only.
outlookoutlook outlookUseroutlookUser 選択 Outlook サービス ユーザーが利用できます。Selective Outlook services available to the user. 読み取り専用です。Read-only. Null 許容型。Nullable.
ownedDevicesownedDevices directoryObject コレクションdirectoryObject collection ユーザーが所有しているデバイス。読み取り専用です。Null 許容型。Devices that are owned by the user. Read-only. Nullable.
ownedObjectsownedObjects directoryObject コレクションdirectoryObject collection ユーザーが所有しているディレクトリ オブジェクト。読み取り専用です。Null 許容型。Directory objects that are owned by the user. Read-only. Nullable.
peoplepeople コレクションperson collection 読み取り専用。ユーザーに最も関連のある人。コレクションは、ユーザーに対する関連 (ユーザーの通信、コラボレーション、およびビジネス リレーションシップによって決まる) を基準として配列されます。person は、メール、連絡先、およびソーシャル ネットワークのすべてからの情報の集約です。Read-only. The most relevant people to the user. The collection is ordered by their relevance to the user, which is determined by the user's communication, collaboration and business relationships. A person is an aggregation of information from across mail, contacts and social networks.
photophoto profilePhotoprofilePhoto ユーザーのプロフィール写真。読み取り専用です。The user's profile photo. Read-only.
Photosphotos Photo コレクションPhoto collection 読み取り専用。Null 許容型。Read-only. Nullable.
プランナーplanner plannerUserplannerUser 選択的プランナー サービス ユーザーが利用できます。Selective Planner services available to the user. 読み取り専用です。Read-only. Null 許容型。Nullable.
sharepointsharepoint sharepointsharepoint ユーザーの SharePoint サイトにアクセスします。読み取り専用。Access to the user's SharePoint site. Read-only.
scopedRoleMemberOfscopedRoleMemberOf scopedRoleMembership コレクションscopedRoleMembership collection このユーザーのスコープ役割の管理単位のメンバーシップ。The scoped-role administrative unit memberships for this user. 読み取り専用です。Read-only. Null 許容型。Nullable.
settingssettings 設定コレクションsettings collection 読み取り専用。Null 許容型。Read-only. Nullable.
registeredDevicesregisteredDevices directoryObject コレクションdirectoryObject collection ユーザーについて登録されているデバイス。読み取り専用です。Null 許容型。Devices that are registered for the user. Read-only. Nullable.

JSON 表記JSON representation

以下は、リソースの JSON 表記ですHere is a JSON representation of the resource

{
  "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",
  "deletedDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "externalUserState": "PendingAcceptance",
  "externalUserStateChangeDateTime": "2018-11-12T01:13:13Z",
  "givenName": "string",
  "hireDate": "String (timestamp)",
  "id": "string (identifier)",
  "interests": ["string"],
  "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",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "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"],
  "responsibilities": ["string"],
  "schools": ["string"],
  "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" },
  "insights": { "@odata.type": "microsoft.graph.officeGraphInsights" },
  "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" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "outlook": { "@odata.type": "microsoft.graph.outlookUser" },
  "ownedDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "registeredDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ]
}

関連項目See also