Type de ressource educationAssignment

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 une tâche ou une unité de travail affectée à un étudiant ou à un membre de l’équipe d’une classe dans le cadre de son étude.

Les devoirs contiennent des documents et des tâches sur lesquelles l’enseignant souhaite que l’élève travaille. Chaque devoir d’étudiant est associé à une soumission qui contient tout travail que son enseignant a demandé à remettre. Seuls les enseignants ou les propriétaires d’équipe peuvent créer des devoirs. Un enseignant peut ajouter des scores et des commentaires à la soumission rendue par l’étudiant.

Lorsqu’un devoir est créé, il est à l’état de brouillon. Les étudiants ne peuvent pas voir le devoir et les soumissions ne sont pas créées. Vous pouvez modifier le status d’un devoir en utilisant l’action de publication. Vous ne pouvez pas utiliser une demande PATCH pour modifier le status de l’affectation.

Les API d’affectation sont exposées dans l’espace de noms de classe.

Hérite de l’entité.

Méthodes

Méthode Type renvoyé Description
Créer educationAssignment Créez un nouveau devoir.
Obtenir educationAssignment Lisez les propriétés et les relations d’un objet educationAssignment .
Mettre à jour educationAssignment Mettre à jour un objet EducationAssignment .
Supprimer Aucun Supprimez un objet educationAssignment .
Publier educationAssignment Modifier l’état d’un objet educationAssignment de brouillon à publié.
Créer une ressources de devoirs educationAssignmentResource Créez une ressource d’affectation.
Obtenir une ressource d’affectation educationAssignmentResource Obtenir les propriétés d’une ressource de devoir d’éducation associée à un devoir.
Supprimer une ressource d’affectation Aucun Supprimez une ressource de devoir d’éducation spécifique attachée à un devoir.
Configurer le dossier des ressources d’affectation string Créez un dossier SharePoint (sous un emplacement prédéfini) pour charger des fichiers en tant que ressources d’affectation.
Configurer le dossier des ressources de commentaires sur les devoirs educationAssignment Créez un dossier SharePoint pour télécharger des fichiers de commentaires pour une educationSubmission donnée.
Répertorier les ressources educationAssignmentCollection de ressources Obtenir une collection d’objets educationAssignmentResource .
Soumissions de liste educationSubmission collection Obtenir une collection d’objets educationSubmission .
List categories collection educationCategory Obtenir une collection d’objets educationCategory .
Ajouter des catégories educationCategory Attribuez à ce devoir une catégorie educationCategory appartenant à la classe.
Enlever une catégorie Aucun Supprimez une educationCategory appartenant à la classe de ce devoir.
Joindre la rubrique Aucun Joignez une educationRubric existante à ce devoir.
Supprimer la rubrique Aucun Détachez la rubrique éducation de ce devoir.
Obtenir delta collection educationAssignment Obtenez une liste des nouveaux devoirs créés ou mis à jour sans avoir à effectuer une lecture complète de la collection.
Ajouter une catégorie de notation educationGradingCategory Ajoutez GradingCategory en publiant dans la collection GradingCategory .
Supprimer la catégorie de notation Aucun Supprimez un objet educationGradingCategory .
Activer l’attribution educationAssignment Activez un educationAssignment inactif pour signaler que le devoir a d’autres éléments d’action pour les enseignants ou les étudiants.
Désactiver l’affectation educationAssignment Marquez un educationAssignment attribué comme inactif pour signaler que le devoir n’a pas d’autres éléments d’action pour les enseignants et les étudiants.
Ajouter un schéma de notation educationGradingScheme Ajoutez un educationGradingScheme existant à un educationAssignment existant.

Propriétés

Propriété Type Description
addedStudentAction String Champ facultatif pour contrôler le comportement du devoir pour les étudiants ajoutés après la publication du devoir . Si ce paramètre n’est pas spécifié, la valeur par défaut est .none Les valeurs prises en charge sont les suivantes : none, assignIfOpen. Par exemple, un enseignant peut utiliser assignIfOpen pour indiquer qu’un devoir doit être attribué à tout nouvel étudiant qui rejoint la classe alors que le devoir est encore ouvert, et none pour indiquer qu’un devoir ne doit pas être attribué à de nouveaux étudiants.
addToCalendarAction educationAddToCalendarOptions Champ facultatif pour contrôler le comportement des devoirs pour ajouter des devoirs aux calendriers des étudiants et des enseignants lorsque le devoir est publié. Les valeurs possibles sont : none, studentsAndPublisher, studentsAndTeamOwnersunknownFutureValue, et studentsOnly. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les membres suivants dans cette énumération évolutive : studentsOnly. La valeur par défaut est none.
allowLateSubmissions Booléen Identifie si les étudiants peuvent soumettre une soumission après la date d’échéance. Si cette propriété n’est pas spécifiée lors de la création, elle est définie par défaut sur true.
allowStudentsToAddResourcesToSubmission Booléen Identifie si les étudiants peuvent ajouter leurs propres ressources à une soumission ou s’ils peuvent uniquement modifier les ressources ajoutées par l’enseignant.
assignDateTime DateTimeOffset Date à laquelle le devoir doit devenir actif. Si à l’avenir, le devoir n’est pas affiché à l’étudiant avant cette date. Le type d’horodatage représente des informations de date et d’heure au format ISO 8601 et est toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
assignTo educationAssignmentRecipient Les utilisateurs ou la classe entière qui doivent recevoir un objet de soumission une fois le devoir publié.
assignedDateTime DateTimeOffset Le moment où le devoir a été publié pour les étudiants et que le devoir apparaît sur la chronologie des étudiants. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
classId String Classe à laquelle appartient ce devoir .
closeDateTime DateTimeOffset Date à laquelle le devoir sera fermé pour les soumissions. Ce champ facultatif peut être null si le devoir n’autorise pas LateSubmissions ou lorsque closeDateTime est identique à dueDateTime. Toutefois, si elle est spécifiée, la closeDateTime doit être supérieure ou égale à dueDateTime. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
createdBy identitySet Qui a créé le devoir.
createdDateTime DateTimeOffset Moment auquel le devoir a été créé. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
displayName String Nom de l’affectation.
dueDateTime DateTimeOffset Date d’échéance du devoir des étudiants. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
feedbackResourcesFolderUrl String URL du dossier où sont stockées toutes les ressources de fichiers de commentaires pour ce devoir .
Notation educationAssignmentGradeType Comment le devoir sera-t-il noté.
id String Identificateur unique du devoir. Hérité de l’entité. En lecture seule.
de configuration itemBody Instructions pour le devoir. Cette propriété et le nom d’affichage indiquent à l’étudiant ce qu’il doit faire.
balise de langue String Spécifie la langue dans laquelle les notifications de l’interface utilisateur pour le devoir sont affichées. Si languageTag n’est pas fourni, la langue par défaut est en-US. Facultatif.
lastModifiedBy identitySet Qui a modifié le devoir en dernier.
lastModifiedDateTime DateTimeOffset Date et heure à laquelle le devoir a été modifié. Une soumission d’étudiant ne modifie pas le devoir ; Seuls les enseignants peuvent mettre à jour les devoirs. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
moduleUrl string URL du module à partir duquel accéder au devoir.
notificationChannelUrl String Champ facultatif permettant de spécifier l’URL du canal pour publier la notification de publication du devoir . S’il n’est pas spécifié ou est null, la valeur par défaut est le General canal. Ce champ s’applique uniquement aux devoirs où la valeur assignTo est educationAssignmentClassRecipient. La mise à jour de notificationChannelUrl n’est pas autorisée une fois le devoir publié.
resourcesFolderUrl string URL du dossier où sont stockées toutes les ressources de fichier pour ce devoir .
statut string État de l’affectation. Vous ne pouvez pas appliquer de correctif à cette valeur. Les valeurs possibles sont draft, scheduled, published, assigned, unknownFutureValue, inactive. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les membres suivants dans cette énumération évolutive : inactive.
webUrl string URL de lien profond pour le devoir donné.

Relations

Relation Type Description
resources educationAssignmentCollection de ressources Objets d’apprentissage associés à ce devoir. Seuls les enseignants peuvent modifier cette liste. Pouvant accepter la valeur Null.
Soumissions educationSubmission collection Une fois publié, il y a un objet de soumission pour chaque étudiant représentant son travail et sa note. En lecture seule. Pouvant accepter la valeur Null.
categories collection educationCategory Lorsqu’elle est définie, les utilisateurs peuvent facilement trouver les affectations d’un type donné. En lecture seule. Pouvant accepter la valeur Null.
rubrique educationRubric Lorsqu’elle est définie, la rubrique de notation attachée à ce devoir.
Catégorie de notation collection educationGradingCategory Lorsqu’elle est définie, les utilisateurs peuvent pondérer les devoirs différemment lors du calcul d’une note moyenne de classe.
gradingScheme educationGradingScheme Lorsqu’elle est définie, elle permet aux utilisateurs de configurer des notes de chaîne personnalisées en fonction du pourcentage du total des points gagnés sur ce devoir.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "addedStudentAction": "String",
  "addToCalendarAction": "String",
  "allowLateSubmissions": "Boolean",
  "allowStudentsToAddResourcesToSubmission": "Boolean",
  "assignDateTime": "String (timestamp)",
  "assignedDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "classId": "String",
  "closeDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "feedbackResourcesFolderUrl": "String",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "id": "String (identifier)",
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "languageTag": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",
  "webUrl": "String"
}
  • Dernière mise à jour :