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
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 | EduAssignments.ReadWriteBasic.All | EduAssignments.ReadWrite.All |
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 | String | 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. Utilisez l’en-tête Prefer: include - unknown -enum-members de requête pour obtenir les membres suivants dans cette énumération évolutive : studentsOnly. Facultatif. |
| allowLateSubmissions | Booléen | Indique si les étudiants peuvent envoyer une soumission après la date d’échéance. |
| allowStudentsToAddResourcesToSubmission | Booléen | 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 d’être modifié lorsque l’affectation est 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 | String | 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. |
| languageTag | String | Spécifie la langue dans laquelle les notifications d’interface utilisateur pour l’affectation sont affichées. Si languageTag n’est pas fourni, la langue par défaut est en-US. Facultatif. |
| notificationChannelUrl | String | Canal de communication des notifications relatives à l’affectation. Pour modifier l’URL, définissez la valeur sur assignToeducationAssignmentClassRecipient. 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",
"languageTag": "pt-BR",
"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
}
}
}