educationUser リソースの種類

名前空間: microsoft.graph

システム内のユーザーです。 これは、教育固有のエンドポイントから Microsoft Graphが返すのと同じ ID を持つユーザーの教育固有のバリアント/usersです。 このオブジェクトは、コア ユーザー オブジェクトのプロパティの対象 となるサブセットを提供し、primaryRole、student、Teacher データなどの教育固有のプロパティのセットを 追加 します。

エンティティ から継承します。

メソッド

メソッド	戻り値の種類	説明
educationUsers をリストする	educationUser コレクション	educationUser オブジェクトとそのプロパティの一覧を取得します。
Create educationUser	educationUser	新しい educationUser オブジェクトを作成 します。
Get educationUser	educationUser	educationUser オブジェクトのプロパティとリレーションシップ を読み取 る。
EducationUser の更新	educationUser	educationUser オブジェクトのプロパティを更新します。
educationUser を削除する	なし	educationUser オブジェクトを削除します。
差分	educationUser コレクション	リソース コレクションへの増分変更を取得します。
List taughtClasses	educationClass コレクション	taughtClasses ナビゲーション プロパティから educationClass リソースを 取得します。

プロパティ

プロパティ	型	説明
accountEnabled	Boolean	アカウントが有効な場合は True であり、それ以外の場合は false です。 このプロパティは、ユーザーの作成時に必要です。 $filter をサポートしています。
assignedLicenses	assignedLicense collection	ユーザーに割り当てられているライセンス。null 許容ではありません。
assignedPlans	assignedPlan collection	ユーザーに割り当てられているプラン。読み取り専用です。null 許容ではありません。
businessPhones	String collection	ユーザーの電話番号。 メモ: 文字列コレクションですが、このプロパティに設定できるのは 1 つの数字のみです。
createdBy	identitySet	ユーザーを作成したエンティティ。
department	String	ユーザーが働いている部門の名前。 $filter をサポートしています。
displayName	String	アドレス帳に表示されるユーザーの名前。 これは通常、ユーザーの名前、ミドルネームのイニシャル、姓の組み合わせになります。 このプロパティはユーザーの作成時に必須です。更新時にクリアすることはできません。 $filter と $orderby をサポートします。
externalSource	educationExternalSource	このユーザーが作成された場所。 可能な値は、sis、manual です。
externalSourceDetail	String	このリソースが生成された外部ソースの名前。
givenName	String	ユーザーの名。 $filter をサポートしています。
id	String	オブジェクト識別子。 エンティティから継承 されます。
mail	String	ユーザーの SMTP アドレス (たとえば、jeff@contoso.onmicrosoft.com)。 読み取り専用です。 $filter をサポートします。
mailingAddress	physicalAddress	ユーザーのメール アドレス。
mailNickname	String	ユーザーの電子メール エイリアス。 ユーザーの作成時に、このプロパティを指定する必要があります。 $filter をサポートしています。
middleName	String	ユーザーのミドルネーム。
mobilePhone	String	ユーザーの主な携帯電話の番号。
onPremisesInfo	educationOnPremisesInfo	ユーザーを Active Directory 対応Azure Active Directory関連付ける場合に使用される追加情報。
passwordPolicies	String	ユーザーのパスワード ポリシーを指定します。 この値は列挙値であり、可能な 1 つの値は DisableStrongPassword です。この場合は、既定のポリシーより弱いパスワードを指定できます。 DisablePasswordExpiration を指定することもできます。 2 つを一緒に指定できます。例: DisablePasswordExpiration, DisableStrongPassword.
passwordProfile	passwordProfile	ユーザーのパスワード プロファイルを指定します。プロファイルには、ユーザーのパスワードが含まれています。このプロパティは、ユーザーの作成時に必要です。プロファイルにあるパスワードは、passwordPolicies プロパティによって指定されている最小要件を満たす必要があります。既定では、強力なパスワードが必要です。
preferredLanguage	String	ISO 639-1 en-USコードに従う必要があるユーザーの優先言語 (例: .
primaryRole	educationUserRole	ユーザーの既定のロール。 ユーザーのロールは、個々のクラスで異なる場合があります。 使用可能な値: student、teacher、none、unknownFutureValue。
provisionedPlans	ProvisionedPlan コレクション	ユーザーのために用意されたプラン。読み取り専用です。null 許容ではありません。
relatedContacts	relatedContact コレクション	ユーザーに関連付けられた関連レコード。 読み取り専用です。
residenceAddress	physicalAddress	ユーザーが住んでいるアドレス。
showInAddressList	Boolean	Trueグローバル アドレス一覧Outlookこのユーザーを含む必要がある場合、それ以外の場合はfalse. 設定されていない場合は、true として扱われます。 招待マネージャーから招待されたユーザーの場合、このプロパティは false に設定されます。
student	educationStudent	プライマリ ロールが学生の場合、このブロックには学生固有のデータが含まれます。
surname	String	ユーザーの姓。 $filter をサポートしています。
teacher	educationTeacher	主な役割が教師の場合、このブロックには教師固有のデータが含まれる。
usageLocation	String	2 文字の国コード (ISO 規格 3166) 国や地域におけるサービスの利用可能性を確認することが法的に義務付けられているため、ライセンスを割り当てられるユーザーには必須です。 たとえば、US、JP、GB などがあります。 null 許容ではありません。 $filter をサポートしています。
userPrincipalName	String	ユーザーのユーザー プリンシパル名 (UPN)。 UPN は、インターネット標準 RFC 822 に基づくユーザーのインターネット スタイルのログイン名です。 規則では、これはユーザーの電子メール名にマップされる必要があります。 一般的な形式は alias@domain、テナントの検証済みドメインのコレクションにドメインが存在する必要があります。 このプロパティは、ユーザーの作成時に必要です。 テナントの検証済みドメインには、組織の verifiedDomains プロパティからアクセス できます。 $filter と $orderby をサポートします。
userType	String	ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (Member、Guest など)。 $filter をサポートします。

重要

委任されたアクセス許可スコープを使用する場合、Microsoft Graph は、id、primaryRole、accountEnabled、displayName、givenName、姓、userPrincipalName、userType、onPremisesInfo、student/externalId、teacher /externalId の制限されたプロパティのセットのみを返します。 アプリケーションで追加のプロパティが必要な場合は、Application アクセス許可スコープを使用する必要があります。

リレーションシップ

リレーションシップ	型	説明
assignments	educationAssignment コレクション	ユーザーに属する割り当て。
classes	educationClass コレクション	ユーザーが属しているクラス。 Null 許容型。
schools	educationSchool コレクション	ユーザーが属している学校。 Null 許容型。
taughtClasses	educationClass コレクション	ユーザーが教師であるクラス。
ユーザー	user	このユーザーに対応するディレクトリ ユーザー。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.educationUser",
  "id": "String (identifier)",
  "primaryRole": "String",
  "middleName": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "residenceAddress": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "mailingAddress": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "student": {
    "@odata.type": "microsoft.graph.educationStudent"
  },
  "teacher": {
    "@odata.type": "microsoft.graph.educationTeacher"
  },
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "accountEnabled": "Boolean",
  "assignedLicenses": [
    {
      "@odata.type": "microsoft.graph.assignedLicense"
    }
  ],
  "assignedPlans": [
    {
      "@odata.type": "microsoft.graph.assignedPlan"
    }
  ],
  "businessPhones": ["String"],
  "department": "String",
  "displayName": "String",
  "givenName": "String",
  "mail": "String",
  "mailNickname": "String",
  "mobilePhone": "String",
  "passwordPolicies": "String",
  "passwordProfile": {
    "@odata.type": "microsoft.graph.passwordProfile"
  },
  "officeLocation": "String",
  "preferredLanguage": "String",
  "provisionedPlans": [
    {
      "@odata.type": "microsoft.graph.provisionedPlan"
    }
  ],
  "refreshTokensValidFromDateTime": "String (timestamp)",
  "showInAddressList": "Boolean",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",
  "onPremisesInfo": {
    "@odata.type": "microsoft.graph.educationOnPremisesInfo"
  }
}