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 コレクション リソース コレクションに対する増分変更を取得します。
taughtClasses を一覧表示する educationClass コレクション taughtClasses ナビゲーション プロパティから educationClass リソースを取得します。

プロパティ

プロパティ 型 説明
accountEnabled Boolean アカウントが有効な場合は True であり、それ以外の場合は false です。 このプロパティは、ユーザーの作成時に必要です。 $filter をサポートしています。
assignedLicenses assignedLicense コレクション ユーザーに割り当てられているライセンス。 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.com)。 読み取り専用です。 $filter をサポートします。
mailingAddress physicalAddress ユーザーのメール アドレス。
mailNickname String ユーザーの電子メール エイリアス。 ユーザーの作成時に、このプロパティを指定する必要があります。 $filter をサポートしています。
middleName String ユーザーのミドル ネーム。
mobilePhone String ユーザーの主な携帯電話の番号。
onPremisesInfo educationOnPremisesInfo Microsoft Entra ユーザーを対応する 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 TrueOutlook グローバル アドレス一覧にこのユーザーが含まれている必要がある場合。それ以外の場合は 。 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。ドメインは、検証済みドメインのテナントのコレクションに存在する必要があります。 このプロパティは、ユーザーの作成時に必要です。 テナントの検証済みドメインには、organizationの verifiedDomains プロパティからアクセスできます。 $filter と $orderby をサポートします。
userType String ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (Member、Guest など)。 $filter をサポートします。

重要

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

リレーションシップ

リレーションシップ 型 説明
assignments educationAssignment コレクション ユーザーに属する割り当て。
classes educationClass コレクション ユーザーが属しているクラス。 Null 許容型。
schools educationSchool コレクション ユーザーが属している学校。 Null 許容型。
taughtClasses educationClass コレクション ユーザーが教師であるクラス。
ユーザー user このユーザーに対応するディレクトリ ユーザー。
ルーブリック educationRubric コレクション 設定すると、課題にアタッチされたグレーディング ルーブリックが設定されます。

JSON 表記

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

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