Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 élèves sont des membres réguliers de la classe et les enseignants sont propriétaires et ont les droits appropriés.
Importante
Pour que les expériences Microsoft 365 fonctionnent correctement, les enseignants doivent être membres des collections enseignants et 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. |
| Créer un devoir | educationAssignment | Créez un educationAssignment en le publiant dans la collection Devoirs. |
| Répertorier les affectations | collection educationAssignment | Obtenir une collection d’objets educationAssignment . |
| Lister les modules | educationModule collection | Obtenir une collection d’objets educationModule . |
| Obtenir un groupe | group | Obtenez le groupe Microsoft 365 qui correspond à cette educationClass. |
| Create category | educationCategory | Créez une nouvelle catégorie d’éducation pour cette classe. |
| List categories | collection educationCategory | Obtenez la liste des objets educationCategory appartenant à cette classe. |
| Mettre à jour une classe | educationClass | Mettez à jour l’objet educationClass. |
| Supprimer une classe | Aucun | Supprimez l’objet educationClass. |
| Obtenir delta | Ensemble d’objets educationClass | Obtenez des modifications incrémentielles pour educationClasses. |
| Obtenir les soumissions récemment modifiées | educationSubmission collection | 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 | String | 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 : sis, lms, ou manual. |
| externalSourceDetail | String | Nom de la source externe à partir de laquelle cette ressource a été générée. |
| grade | String | Niveau scolaire 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 pour la classe. |
Relations
| Relation | Type | Description |
|---|---|---|
| affectations | collection educationAssignment | Tous les devoirs associés à cette classe. Peut avoir la valeur Null. |
| membres | Collection d’objets educationUser | Tous les utilisateurs du cours. Pouvant accepter la valeur Null. |
| les modules | educationModule collection | 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 devoirs 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" }
}