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
Obtention d’un objet educationClass 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 étudiant 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 educationAssignment 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.
Créer une éducationCategory 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 educationClass Mettez à jour l’objet educationClass.
Supprimer Aucun Supprimez l’objet educationClass.
Obtenir delta Ensemble d’objets educationClass Obtenez des modifications incrémentielles pour educationClasses.

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.
Sûr 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 ces ressources ont été générées.
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

Voici une représentation JSON de la 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" }
}