Type de ressource educationUser
Espace de noms: microsoft.graph
Un utilisateur dans le système. Il s’agit d’une variante spécifique à l’éducation de l’utilisateur avec le même ID que celui retourné par Microsoft Graph à partir du point de terminaison non spécifique à /users l’éducation. Cet objet fournit un sous-ensemble ciblé de propriétés de l’objet utilisateur principal et ajoute un ensemble de propriétés spécifiques à l’éducation, telles que les données primaryRole, student et teacher .
Hérite de l’entité.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | Collection d’objets educationUser | Obtenez la liste des objets educationUser et de leurs propriétés. |
| Create | educationUser | Créez un objet educationUser . |
| Obtenir | educationUser | Lisez les propriétés et les relations d’un objet educationUser . |
| Mettre à jour | educationUser | Mettez à jour les propriétés d’un objet educationUser . |
| Supprimer | Aucun | Supprimez un objet educationUser. |
| Obtenir les modifications apportées aux utilisateurs | Collection d’objets educationUser | Obtenez les modifications incrémentielles apportées à la collection de ressources. |
| Lister les classes enseignées | Ensemble d’objets educationClass | Obtenez les ressources educationClass à partir de la propriété de navigation taughtClasses . |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| accountEnabled | Boolean |
True si le compte est activé ; sinon, false. Cette propriété est requise lorsqu’un utilisateur est créé. Prend en charge $filter. |
| assignedLicenses | collection assignedLicense | Licences attribuées à l’utilisateur. Ne pouvant accepter la valeur null. |
| assignedPlans | collection assignedPlan | Plans de charge affectés à l’utilisateur. En lecture seule. Ne pouvant accepter la valeur null. |
| businessPhones | String collection | Numéros de téléphone de l’utilisateur. Remarque : bien qu’il s’agisse d’une collection de chaînes, seul un numéro peut être défini pour cette propriété. |
| createdBy | identitySet | Entité qui a créé l’utilisateur. |
| Service | String | Nom du service où travaille l’utilisateur. Prend en charge $filter. |
| displayName | String | Nom affiché dans le carnet d’adresses de l’utilisateur. Il s’agit généralement de la combinaison du prénom de l’utilisateur, de l’initiale de son deuxième prénom et de son nom. Cette propriété est requise lors de la création d’un utilisateur et ne peut pas être désactivée lors des mises à jour. Prend en charge $filter et $orderby. |
| externalSource | educationExternalSource | Endroit à partir duquel cet utilisateur a été créé. Les valeurs possibles sont les suivantes : sis, manual. |
| externalSourceDetail | Chaîne | Nom de la source externe à partir de laquelle cette ressource a été générée. |
| givenName | String | Prénom de l’utilisateur. Prend en charge $filter. |
| id | Chaîne | Identificateur d’objet. Hérité de l’entité. |
| messagerie | String | L’adresse SMTP de l’utilisateur, par exemple, jeff@contoso.com. En lecture seule. Prend en charge $filter. |
| mailingAddress | physicalAddress | Adresse de messagerie de l’utilisateur. |
| mailNickname | String | Alias de messagerie de l’utilisateur. Cette propriété doit être spécifiée lors de la création d’un utilisateur. Prend en charge $filter. |
| middleName | Chaîne | Deuxième prénom de l’utilisateur. |
| mobilePhone | String | Numéro de téléphone portable principal de l’utilisateur. |
| officeLocation | Chaîne | Emplacement du bureau de l’utilisateur. |
| onPremisesInfo | educationOnPremisesInfo | Informations supplémentaires utilisées pour associer l’utilisateur Microsoft Entra à son équivalent Active Directory. |
| passwordPolicies | String | Spécifie les stratégies de mot de passe de l’utilisateur. Cette valeur est une énumération avec une seule valeur possible, DisableStrongPassword, qui permet de spécifier des mots de passe plus faibles que la stratégie par défaut.
DisablePasswordExpiration peut également être spécifié. Les deux peuvent être spécifiés ensemble ; par exemple : DisablePasswordExpiration, DisableStrongPassword. |
| passwordProfile | passwordProfile | Spécifie le profil du mot de passe de l’utilisateur. Le profil contient le mot de passe de l’utilisateur. Cette propriété est requise lorsqu’un utilisateur est créé. Le mot de passe du profil doit respecter les exigences minimales spécifiées par la propriété passwordPolicies. Par défaut, un mot de passe fort est requis. |
| preferredLanguage | Chaîne | Langue préférée pour l’utilisateur qui doit suivre le code ISO 639-1, par exemple. en-US |
| primaryRole | educationUserRole | Rôle par défaut pour un utilisateur. Le rôle de l’utilisateur peut être différent dans une classe individuelle. Les valeurs possibles sont les suivantes : student, teacher, none, unknownFutureValue. |
| provisionedPlans | collection provisionedPlan | Plans de charge configurés pour l’utilisateur. En lecture seule. Ne pouvant accepter la valeur null. |
| refreshTokensValidFromDateTime | DateTimeOffset | Tous les jetons d’actualisation ou de session (cookies de session) émis avant cette heure ne sont pas valides, et les applications reçoivent une erreur lors de l’utilisation d’un jeton d’actualisation ou de session non valide pour acquérir un jeton d’accès délégué (pour accéder aux API telles que Microsoft Graph). Si cela se produit, l’application doit acquérir un nouveau jeton d’actualisation en demandant le point de terminaison autorisé. Renvoyé uniquement sur $select. En lecture seule. |
| relatedContacts | collection relatedContact | Enregistrements associés à l’utilisateur. En lecture seule. |
| residenceAddress | physicalAddress | Adresse où réside l’utilisateur. |
| showInAddressList | Valeur booléenne |
True si la liste d’adresses globale Outlook doit contenir cet utilisateur ; sinon, false. Si aucune valeur n’est définie, la propriété est traitée comme true. Pour les utilisateurs invités via le gestionnaire d’invitation, cette propriété est définie sur false. |
| student | educationStudent | Si le rôle principal est celui d’étudiant, ce bloc contient des données spécifiques de l’étudiant. |
| surname | String | Nom de l’utilisateur (nom de famille). Prend en charge $filter. |
| teacher | educationTeacher | Si le rôle principal est enseignant, ce bloc contient des données spécifiques à l’enseignant. |
| usageLocation | String | Code pays à deux lettres (norme ISO 3166). Obligatoire pour les utilisateurs qui recevront des licences en raison d’une obligation légale qui exige la vérification de la disponibilité des services dans les pays ou régions. Les exemples incluent US, JP, et GB. Ne pouvant accepter la valeur null. Prend en charge $filter. |
| userPrincipalName | String | Nom d’utilisateur principal (UPN) de l’utilisateur. L’UPN est un nom de connexion de style Internet pour l’utilisateur basé sur la norme Internet RFC 822. Par convention, il doit être mappé sur le nom de messagerie de l’utilisateur. Le format général est alias@domain, où le domaine doit être présent dans la collection de domaines vérifiés du locataire. Cette propriété est requise lorsqu’un utilisateur est créé. Les domaines vérifiés du locataire sont accessibles à partir de la propriété verifiedDomains de l’organisation. Prend en charge $filter et $orderby. |
| userType | String | Valeur de chaîne qui peut être utilisée pour classer les types d’utilisateur dans votre répertoire, tels que Member et Guest. Prend en charge $filter. |
Importante
Lorsque vous utilisez des étendues d’autorisation déléguées, Microsoft Graph renvoie uniquement un ensemble limité de propriétés : id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Si votre application nécessite des propriétés supplémentaires, vous devez utiliser des étendues d’autorisation d’application.
Relations
| Relation | Type | Description |
|---|---|---|
| affectations | collection educationAssignment | Affectations appartenant à l’utilisateur. |
| classes | Ensemble d’objets educationClass | Cours auxquels appartient l’utilisateur. Peut avoir la valeur Null. |
| schools | Ensemble d’objets educationSchool | Établissements scolaires auxquels appartient l’utilisateur. Pouvant accepter la valeur Null. |
| taughtClasses | Ensemble d’objets educationClass | Classes pour lesquelles l’utilisateur est enseignant. |
| utilisateur | utilisateur | Utilisateur d’annuaire qui correspond à cet utilisateur. |
| Rubriques | educationRubric collection | Lorsqu’elle est définie, la rubrique de notation attachée à l’affectation. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@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"
}