Type de ressource educationClass
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente un cours dans un établissement scolaire. La ressource educationClass correspond actuellement à un groupe Microsoft 365 et partage le même ID. Les étudiants sont des membres réguliers de la classe, et les enseignants sont propriétaires et disposent des droits appropriés.
Importante
Pour que les expériences Microsoft 365 fonctionnent correctement, les enseignants doivent être membres des collections d’enseignants et de membres.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Obtenir une classe | educationClass | Lisez les propriétés et les relations d’un objet educationClass. |
| Ajouter un membre | educationUser | Ajoutez un nouvel objet educationUser pour le cours en le publiant dans la propriété de navigation members. |
| Répertorier les membres | Collection d’objets educationUser | Obtenez une collection d’objets educationUser. |
| Supprimer un membre | educationUser | Supprimez un objet educationUser du cours via la propriété de navigation members. |
| Répertorier les établissements scolaires | Ensemble d’objets educationSchool | Obtenez une collection d’objets educationSchool. |
| Ajouter un enseignant | educationUser | Ajoutez un nouvel objet educationUser pour le cours en le publiant dans la propriété de navigation teachers. |
| Répertorier les enseignants | Collection d’objets educationUser | Obtenez la liste des enseignants pour le cours. |
| Supprimer un enseignant | educationUser | Supprimez un objet educationUser du cours via la propriété de navigation teachers. |
| Create | educationAssignment | Créez un educationAssignment en publiant dans la collection devoirs. |
| Répertorier les affectations | collection educationAssignment | Obtenez une collection d’objets educationAssignment . |
| Lister les modules | collection educationModule | Obtenez une collection d’objets educationModule . |
| Obtenir un groupe | group | Obtenez le groupe Microsoft 365 qui correspond à cette educationClass. |
| Create category | educationCategory | Créez une classe educationCategory pour cette classe. |
| List categories | collection educationCategory | Obtenez la liste des objets educationCategory qui appartiennent à cette classe. |
| Mettre à jour une classe | educationClass | Mettez à jour l’objet educationClass. |
| Supprimer une classe | Aucune | Supprimez l’objet educationClass. |
| Obtenir delta | Ensemble d’objets educationClass | Obtenez des modifications incrémentielles pour educationClasses. |
| Obtenir des soumissions récemment modifiées | collection educationSubmission | Récupérer les soumissions modifiées au cours des sept jours précédents. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| id | String | Identificateur unique du cours. |
| classCode | String | Code du cours utilisé par l’établissement scolaire pour identifier le cours. |
| cours | educationCourse | Informations sur le cours pour la classe. |
| createdBy | identitySet | Entité qui a créé la classe . |
| description | String | Description du cours. |
| displayName | String | Nom du cours. |
| externalId | String | ID du cours depuis le système de synchronisation. |
| externalName | String | Nom du cours dans le système de synchronisation. |
| externalSource | Chaîne | Type de source externe à partir de laquelle cette ressource a été générée (déterminé automatiquement à partir de externalSourceDetail). Les valeurs possibles sont les suivantes : sis, lms ou manual. |
| externalSourceDetail | Chaîne | Nom de la source externe à partir de laquelle cette ressource a été générée. |
| grade | Chaîne | Niveau de note de la classe. |
| mailNickname | String | Nom du courrier pour l’envoi d’e-mails à tous les membres, si cette option est activée. |
| term | educationTerm | Terme de la classe . |
Relations
| Relation | Type | Description |
|---|---|---|
| affectations | collection educationAssignment | Toutes les affectations associées à cette classe. Peut avoir la valeur Null. |
| membres | Collection d’objets educationUser | Tous les utilisateurs du cours. Pouvant accepter la valeur Null. |
| Modules | collection educationModule | Tous les modules de la classe . Pouvant accepter la valeur Null. |
| schools | Ensemble d’objets educationSchool | Tous les établissements scolaires auxquels ce cours est associé. Peut avoir la valeur Null. |
| teachers | Collection d’objets educationUser | Tous les enseignants du cours. Pouvant accepter la valeur Null. |
| assignmentCategories | collection educationCategory | Toutes les catégories associées à cette classe. Pouvant accepter la valeur Null. |
| assignmentDefaults | collection educationAssignmentDefaults | Spécifie les valeurs par défaut au niveau de la classe respectées par les nouvelles affectations créées dans la classe. |
| assignmentSettings | collection educationAssignmentSettings | Spécifie les paramètres des affectations au niveau de la classe. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"classCode": "String",
"course": { "@odata.type": "microsoft.graph.educationCourse" },
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"description": "String",
"displayName": "String",
"externalId": "String",
"externalName": "String",
"externalSource": "string",
"grade": "string",
"id": "String (identifier)",
"mailNickname": "String",
"term": { "@odata.type": "microsoft.graph.educationTerm" }
}