Mettre à jour educationassignment
Espace de noms: microsoft.graph
Mettre à jour un objet educationAssignment .
Seuls les enseignants peuvent effectuer cette action.
Vous pouvez également demander à modifier le status d’une affectation avec une action de publication. N’utilisez pas d’opération PATCH à cet effet.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | EduAssignments.ReadWriteBasic | EduAssignments.ReadWrite |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Non prise en charge. | Non prise en charge. |
Requête HTTP
PATCH /education/classes/{class-id}/assignments/{assignment-id}
En-têtes de demande
En-tête | Valeur |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json |
Corps de la demande
Dans le corps de la demande, fournissez uniquement les valeurs des champs que vous souhaitez mettre à jour.
Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas été modifiées.
Propriété | Type | Description |
---|---|---|
addedStudentAction | Chaîne | Décrit si le devoir doit être distribué aux étudiants qui sont ajoutés après la date de publication du devoir. |
addToCalendarAction | educationAddToCalendarOptions | Champ facultatif pour contrôler le comportement des devoirs pour ajouter des devoirs aux calendriers des étudiants et des enseignants lors de la publication du devoir . Les valeurs possibles sont : none , studentsAndPublisher , studentsAndTeamOwners , unknownFutureValue , studentsOnly . Vous devez utiliser l’en-tête Prefer: include - unknown -enum-members de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : studentsOnly . Optional. |
allowLateSubmissions | Valeur booléenne | Indique si les étudiants peuvent envoyer une soumission après la date d’échéance. |
allowStudentsToAddResourcesToSubmission | Valeur booléenne | Indique si un étudiant peut ajouter des ressources à une soumission ou non. Indique également si toutes les ressources de la soumission correspondent à la liste des ressources d’affectation. |
assignDateTime | DateTimeOffset | Indique la date de publication du devoir pour les étudiants. Impossible de modifier une fois l’affectation publiée. |
assignTo | educationAssignmentRecipient | Étudiants qui obtiennent le devoir. |
closeDateTime | DateTimeOffset | Date à laquelle le devoir est fermé pour les soumissions. Il s’agit d’un champ facultatif qui peut être null si l’affectation n’autorise pasLateSubmissions ou si closeDateTime est identique à dueDateTime, mais si elle est spécifiée, elle doit être supérieure ou égale à dueDateTime. |
displayName | Chaîne | Nom de l’affectation. |
dueDateTime | DateTimeOffset | L’attribution de date est due. |
Classement | educationAssignmentGradeType | Comment l’affectation est notée. |
Instructions | itemBody | Instructions à donner aux étudiants en même temps que le devoir. |
notificationChannelUrl | Chaîne | Canal de communication des notifications relatives à l’affectation. Pour modifier l’URL, définissez la valeur sur assignTo educationAssignmentClassRecipient. L’URL du canal ne peut pas changer après la publication de l’affectation. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet educationAssignment mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/4679bc1b-90c5-45af-ae1a-d5357672ed39
Content-type: application/json
{
"displayName": "Reading and review test 09.03 #5",
"instructions": {
"contentType": "text",
"content": "Read chapter 5 and write your review"
},
"dueDateTime": "2021-09-10T00:00:00Z",
"addedStudentAction": "none"
}
Réponse
Voici un exemple de réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments/$entity",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "Reading and review test 09.03 #5",
"closeDateTime": null,
"dueDateTime": "2021-09-10T00:00:00Z",
"assignDateTime": null,
"assignedDateTime": null,
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"createdDateTime": "2021-09-03T23:57:14.6088791Z",
"lastModifiedDateTime": "2021-09-04T15:01:35.3361649Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "draft",
"notificationChannelUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2272a7baec-c3e9-4213-a850-f62de0adad5f%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%224679bc1b-90c5-45af-ae1a-d5357672ed39%5C%22%5D%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22%7D%22,%22channelId%22%3Anull%7D",
"addedStudentAction": "none",
"id": "4679bc1b-90c5-45af-ae1a-d5357672ed39",
"instructions": {
"content": "Read chapter 5 and write your review",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 50
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
"displayName": null
}
}
}
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour