educationAssignment : delta
Espace de noms: microsoft.graph
Obtenez une liste des affectations nouvellement créées ou mises à jour sans avoir à effectuer une lecture complète de la collection.
Un enseignant ou une application s’exécutant avec des autorisations d’application peut voir tous les objets de devoir pour la classe. Les étudiants peuvent uniquement voir les devoirs qui leur sont attribués.
Note: Cette méthode ne retourne pas les affectations supprimées.
Autorisations
L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
---|---|
Déléguée (compte professionnel ou scolaire) | EduAssignments.ReadBasic, EduAssignments.ReadWriteBasic, EduAssignments.Read, EduAssignments.ReadWrite |
Déléguée (compte Microsoft personnel) | Non prise en charge. |
Application | EduAssignments.ReadBasic.All, EduAssignments.ReadWriteBasic.All, EduAssignments.Read.All, EduAssignments.ReadWrite.All |
Paramètres facultatifs de la requête
Cette méthode prend uniquement en charge le paramètre de $top
requête OData.
Requête HTTP
GET /education/classes/{educationClassId}/assignments/delta
GET /education/classes/{educationClassId}/members/{educationUserId}/assignments/delta
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette fonction renvoie un 200 OK
code de réponse et une collection educationAssignment dans le corps de la réponse.
Exemples
Exemple 1 : Obtenir des affectations avec la prise en charge des requêtes delta
Demande
Voici un exemple de demande.
Utilisez le $top
paramètre pour spécifier le nombre d’affectations à retourner. Le paramètre est facultatif. Utilisez-la lorsque vous avez une longue liste de devoirs ; sinon, vous obtiendrez tous les devoirs de la classe.
GET https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$top=2
Réponse
Voici un exemple de réponse.
Note: Prenez le
@odata.nextLink
à partir de la réponse pour passer un autre appel et obtenir l’ensemble d’affectations suivant.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 344
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(educationAssignment)",
"@odata.nextLink": "https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$skiptoken=U43TyYWKlRvJ6wWxZOfJvkp22nMqShRw9f-GxBtG2FDy9b1hMDaAJGdLb7n2fh1IdHoweKQs1czM4Ry1LVsNqwIFXftTcRHvgSCbcszvbJHEWDCO3QO7K7zwCM8DdXNepZOa1gqldecjIUM0NFRbGQoQ5yR6RmGnMgtko8TDMOyMH_yg1my82PTXA_t4Nj-DhMDZWvuNTd_lbLeTngc7mIJPMCR2gHN9CSKsW_kw850.UM9tUqwOu5Ln1pnxaP6KdMmfJHszGqY3EKPlQkOiyGs",
"value": [
{
"@odata.type": "#microsoft.graph.educationAssignment",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "Expand options 3.1",
"closeDateTime": "2021-11-14T07:59:00Z",
"dueDateTime": "2021-11-14T07:59:00Z",
"assignDateTime": null,
"assignedDateTime": "2021-11-10T23:57:16.1897643Z",
"allowLateSubmissions": false,
"resourcesFolderUrl": null,
"createdDateTime": "2021-11-10T23:56:03.7992389Z",
"lastModifiedDateTime": "2021-11-11T00:42:20.8999693Z",
"allowStudentsToAddResourcesToSubmission": false,
"status": "published",
"notificationChannelUrl": "https://graph.microsoft.com/v1.0/teams/72a7baec-c3e9-4213-a850-f62de0adad5f/channels/19:e375b98b9d4f4738857fb70f23d329b7@thread.skype",
"webUrl": null,
"addToCalendarAction": "none",
"addedStudentAction": "none",
"grading": null,
"id": "3b870c07-21fe-47fb-8562-cdd6f2c281d6",
"instructions": {
"content": "follow up",
"contentType": "text"
},
"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
}
}
},
{
"@odata.type": "#microsoft.graph.educationAssignment",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "Expand options 4",
"closeDateTime": null,
"dueDateTime": "2021-11-12T07:59:00Z",
"assignDateTime": null,
"assignedDateTime": null,
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"createdDateTime": "2021-11-10T23:58:29.2670914Z",
"lastModifiedDateTime": "2021-11-10T23:58:39.6191021Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "draft",
"notificationChannelUrl": null,
"webUrl": null,
"addToCalendarAction": "none",
"addedStudentAction": "none",
"grading": null,
"id": "34ab8c17-eaae-4996-9c04-53696934e6ff",
"instructions": {
"content": "",
"contentType": "text"
},
"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
}
}
}
]
}
Exemple 2 : Obtenir le jeu d’affectations suivant avec la prise en charge des requêtes delta
Demande
Voici un exemple de demande.
Utilisez la @odata.nextLink
valeur de l’appel précédent pour cette demande.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$skiptoken=U43TyYWKlRvJ6wWxZOfJvkp22nMqShRw9f-GxBtG2FDy9b1hMDaAJGdLb7n2fh1IdHoweKQs1czM4Ry1LVsNqwIFXftTcRHvgSCbcszvbJHEWDCO3QO7K7zwCM8DdXNepZOa1gqldecjIUM0NFRbGQoQ5yR6RmGnMgtko8TDMOyMH_yg1my82PTXA_t4Nj-DhMDZWvuNTd_lbLeTngc7mIJPMCR2gHN9CSKsW_kw850.UM9tUqwOu5Ln1pnxaP6KdMmfJHszGqY3EKPlQkOiyGs
Réponse
Voici un exemple de réponse.
Note: Vous devez continuer à utiliser la
@odata.nextLink
valeur pour les appels suivants jusqu’à ce que vous obteniez la@odata.deltaLink
propriété dans la réponse.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 344
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(educationAssignment)",
"@odata.deltaLink": "https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$deltatoken=7ORzTfzlUEGDy6BRE3OC-3ePBbvLHCRe4aJ_hjaBKJxUHmn_ODgoM4xreLS7YRaxROmLjac48n-iXm5j6n5aQwlsnC-2OvL3lI0Z8M4klERNmJQjnBn7MHqwXZ6L8GlI3VPnya3E-p1bisiZX97jLvQUAopseIYhvnD6v7fiYrk.fVsHempT6X2CiBh6aN9Ex5nVJ71adKdcf-mdke8OHKs",
"value": [
{
"@odata.type": "#microsoft.graph.educationAssignment",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "Expand options 2",
"closeDateTime": null,
"dueDateTime": "2021-11-12T07:59:00Z",
"assignDateTime": null,
"assignedDateTime": "2021-11-10T23:54:15.9533379Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"createdDateTime": "2021-11-10T23:51:08.8548584Z",
"lastModifiedDateTime": "2021-11-10T23:54:17.4687411Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "assigned",
"notificationChannelUrl": null,
"webUrl": null,
"addToCalendarAction": "none",
"addedStudentAction": "none",
"grading": null,
"id": "efa3b9a8-b41f-4263-adc5-738c01912153",
"instructions": {
"content": "",
"contentType": "text"
},
"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": "AAAAAAAA-0123-4567-89AB-1B4BB48C3119",
"displayName": null
}
}
},
{
"@odata.type": "#microsoft.graph.educationAssignment",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "Expand options in publish",
"closeDateTime": null,
"dueDateTime": "2021-11-12T07:59:00Z",
"assignDateTime": null,
"assignedDateTime": "2021-11-10T23:48:03.9134549Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"createdDateTime": "2021-11-10T23:42:37.2869391Z",
"lastModifiedDateTime": "2021-11-10T23:48:06.490359Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "assigned",
"notificationChannelUrl": null,
"webUrl": null,
"addToCalendarAction": "none",
"addedStudentAction": "none",
"grading": null,
"id": "5cf13354-0156-4483-8c19-3185c6252188",
"instructions": {
"content": "",
"contentType": "text"
},
"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": "AAAAAAAA-0123-4567-89AB-1B4BB48C3119",
"displayName": null
}
}
}
]
}
Exemple 3 : Obtenir les affectations créées et modifiées à l’aide du jeton delta
Demande
Voici un exemple de demande.
Utilisez la @odata.deltaLink
valeur de l’appel précédent pour cette demande.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$deltatoken=7ORzTfzlUEGDy6BRE3OC-3ePBbvLHCRe4aJ_hjaBKJxUHmn_ODgoM4xreLS7YRaxROmLjac48n-iXm5j6n5aQwlsnC-2OvL3lI0Z8M4klERNmJQjnBn7MHqwXZ6L8GlI3VPnya3E-p1bisiZX97jLvQUAopseIYhvnD6v7fiYrk.fVsHempT6X2CiBh6aN9Ex5nVJ71adKdcf-mdke8OHKs
Réponse
Voici un exemple de réponse.
Note: Vous devez continuer à utiliser pour
@odata.deltaLink
obtenir les affectations nouvellement créées ou modifiées depuis l’appel delta initial.
Note: La réponse delta peut être grande, auquel cas un
@odata.nextLink
est retourné. Continuez à extraire les modifications jusqu’à ce que vous appuyiez à nouveau sur un@odata.deltaLink
.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 344
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(educationAssignment)",
"@odata.deltaLink": "https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$deltatoken=7ORzTfzlUEGDy6BRE3OC-3ePBbvLHCRe4aJ_hjaBKJxUHmn_ODgoM4xreLS7YRaxROmLjac48n-iXm5j6n5aQwlsnC-2OvL3lI0Z8M4klER9TeVMFnEEWX3TRYFAJe1nNUp5s0cjvqM59nMNhcFoIhmt6RUUcXe6vlP9yy00ADA.gT8PrGKC3hZnt4oDxMAmjyX50EASWG4KNcc1E9yTRRo",
"value": [
{
"@odata.type": "#microsoft.graph.educationAssignment",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "expand options 2 updated for delta",
"closeDateTime": null,
"dueDateTime": "2021-11-12T07:59:00Z",
"assignDateTime": null,
"assignedDateTime": "2021-11-10T23:54:15.9533379Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"createdDateTime": "2021-11-10T23:51:08.8548584Z",
"lastModifiedDateTime": "2021-11-16T15:17:07.518655Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "assigned",
"notificationChannelUrl": null,
"webUrl": null,
"addToCalendarAction": "none",
"addedStudentAction": "none",
"grading": null,
"id": "efa3b9a8-b41f-4263-adc5-738c01912153",
"instructions": {
"content": "",
"contentType": "text"
},
"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
}
}
}
]
}