Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Rufen Sie eine Liste der neu erstellten oder aktualisierten Zuweisungen ab, ohne die gesamte Sammlung zu lesen.
Ein Lehrer oder eine Anwendung, die mit Anwendungsberechtigungen ausgeführt wird, kann alle Zuweisungsobjekte für den Kurs sehen. Kursteilnehmer können nur Aufgaben sehen, die ihnen zugewiesen sind.
Anmerkung: Diese Methode gibt keine gelöschten Zuweisungen zurück.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | EduAssignments.ReadBasic | EduAssignments.Read, EduAssignments.ReadWrite, EduAssignments.ReadWriteBasic |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | EduAssignments.ReadBasic.All | EduAssignments.Read.All, EduAssignments.ReadWrite.All, EduAssignments.ReadWriteBasic.All |
Optionale Abfrageparameter
Diese Methode unterstützt $expanddie OData-Abfrageparameter , $orderby, $searchund $filter nicht.
Diese Methode unterstützt nur den $top OData-Abfrageparameter.
HTTP-Anforderung
GET /education/classes/{educationClassId}/assignments/delta
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Funktion erfolgreich verläuft, werden der 200 OK Antwortcode und eine educationAssignment-Auflistung im Antworttext zurückgegeben.
Beispiele
Beispiel 1: Abrufen von Zuweisungen mit Deltaabfrageunterstützung
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
Verwenden Sie den $top -Parameter, um die Anzahl der zurückzugebenden Zuweisungen anzugeben. Der Parameter ist optional, aber verwenden Sie ihn vorzugsweise, wenn Sie über eine lange Liste von Zuweisungen verfügen. Andernfalls erhalten Sie alle Zuweisungen in der Klasse.
GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$top=2
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
Anmerkung: Nehmen Sie den
@odata.nextLinkaus der Antwort, um einen weiteren Aufruf zu tätigen, und rufen Sie die nächsten Zuweisungen ab.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 344
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments",
"@odata.nextLink": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/delta?$skiptoken=HDIHJlrsxOh2yxHa79l9z_WDNaTi8Rr88OsgpWAOWe76OgL-8eiUedDTjr0ELgWND5Dq2vqAD_dx6DFdJVNfldHxacVogZhBUSt3-2-oOxnYNIwi8cIqPDPPwEifGyl0z1ib8amdL9sy6YHDZSC8lioiL3l8HUtH7-XcKEMpm-5r2NFBDV5jckzIa3h7cvE3.P2GZ6gBhsoq9mHSKFt98t9oCOaydK4TZyYSBdRjJP9o",
"value": [
{
"classId": "37d99af7-cfc5-4e3b-8566-f7d40e4a2070",
"displayName": "Grade assignment 15 May 01",
"closeDateTime": null,
"dueDateTime": "2025-05-16T18:29:00Z",
"assignDateTime": null,
"assignedDateTime": "2025-05-15T16:37:18.746146Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"feedbackResourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ7ONF5UOYTXZVEKCZE43FTQRH2S",
"createdDateTime": "2025-05-15T16:36:18.6392125Z",
"lastModifiedDateTime": "2025-05-15T16:37:18.8188179Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "assigned",
"notificationChannelUrl": "https://graph.microsoft.com/beta/teams/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/channels/37d99af7-cfc5-4e3b-8566-f7d40e4a2070",
"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%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%220965958c-84f2-4ca4-b854-05cce3440aa4%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,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"addToCalendarAction": "studentsAndTeamOwners",
"addedStudentAction": "assignIfOpen",
"languageTag": "en-US",
"moduleUrl": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/dcc2ba3e-1bf2-43fc-9f12-e9acd916b372/",
"id": "0965958c-84f2-4ca4-b854-05cce3440aa4",
"instructions": {
"content": "Grade assignment 15 May 01",
"contentType": "html"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346",
"displayName": null
}
}
}
]
}
Beispiel 2: Abrufen des nächsten Satzes von Zuweisungen mit Deltaabfrageunterstützung
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
Verwenden Sie den @odata.nextLink Wert aus dem vorherigen Aufruf für diese Anforderung.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$skiptoken=U43TyYWKlRvJ6wWxZOfJvkp22nMqShRw9f-GxBtG2FDy9b1hMDaAJGdLb7n2fh1IdHoweKQs1czM4Ry1LVsNqwIFXftTcRHvgSCbcszvbJHEWDCO3QO7K7zwCM8DdXNepZOa1gqldecjIUM0NFRbGQoQ5yR6RmGnMgtko8TDMOyMH_yg1my82PTXA_t4Nj-DhMDZWvuNTd_lbLeTngc7mIJPMCR2gHN9CSKsW_kw850.UM9tUqwOu5Ln1pnxaP6KdMmfJHszGqY3EKPlQkOiyGs
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
Anmerkung: Sie müssen den
@odata.nextLinkWert für die folgenden Aufrufe weiter verwenden, bis Sie die@odata.deltaLink-Eigenschaft in der Antwort erhalten.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 344
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(educationAssignment)",
"@odata.deltaLink": "https://graph.microsoft.com/beta/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
}
}
}
]
}
Beispiel 3: Abrufen der erstellten und geänderten Zuweisungen mithilfe des Deltatokens
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
Verwenden Sie den @odata.deltaLink Wert aus dem vorherigen Aufruf für diese Anforderung.
GET /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/delta?$deltatoken=7ORzTfzlUEGDy6BRE3OC-3ePBbvLHCRe4aJ_hjaBKJxUHmn_ODgoM4xreLS7YRaxROmLjac48n-iXm5j6n5aQwlsnC-2OvL3lI0Z8M4klERNmJQjnBn7MHqwXZ6L8GlI3VPnya3E-p1bisiZX97jLvQUAopseIYhvnD6v7fiYrk.fVsHempT6X2CiBh6aN9Ex5nVJ71adKdcf-mdke8OHKs
Antwort
Das folgende Beispiel zeigt die Antwort.
Anmerkung: Sie müssen weiterhin verwenden,
@odata.deltaLinkum die neu erstellten oder geänderten Zuweisungen seit dem ersten Delta-Aufruf abzurufen.
Manchmal ist die Deltaantwort sehr groß. In diesem Fall wird eine
@odata.nextLinkzurückgegeben, um mit dem Abrufen von Änderungen fortzufahren, bis Sie erneut auf eine@odata.deltaLinkklicken.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 344
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(educationAssignment)",
"@odata.deltaLink": "https://graph.microsoft.com/beta/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
}
}
}
]
}
Beispiel 4: Verwenden von $select zum Abrufen ausgewählter Daten
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/delta?$select=displayName,id
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(educationAssignment)",
"@odata.nextLink": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/delta?$skiptoken=U43TyYWKlRvJ6wWxZOfJvkp22nMqShRw9f-GxBtG2FBcWCIKOSenQFv_rF12_tcPmr6GwzMmFb15rLKFgPCB9AMyomQQBsp8rpPB7REHVRY72dH9ygXt_v5J1THi6kEL_8e3gkl9GNBOgD75V4zUe2HWxrbhLZJFQSSRKQZ0t17wpjUSGULoPPeRrR5w4jWj3547BmlwhJydTPtrNqhNhgpWiDkoyMdfMlb4-T0uqrk.kp0pIEG4F09nMMbrh4ww0iChxBI7LqWNS6y2zQK3w7E",
"value": [
{
"@odata.type": "#microsoft.graph.educationAssignment",
"displayName": "09/28/2023 15:16:00",
"id": "e78063b9-73fc-4fbf-a33f-d0d800b53919"
},
{
"@odata.type": "#microsoft.graph.educationAssignment",
"displayName": "Reading test 09.14 Beta",
"id": "c2eeaaf2-766c-4b90-9a17-61625bc5a47d"
},
{
"@odata.type": "#microsoft.graph.educationAssignment",
"displayName": "Monica Demo page",
"id": "933b7a41-8993-4ee3-ab48-9fe5398d4ec7"
},
{
"@odata.type": "#microsoft.graph.educationAssignment",
"displayName": "Geography Handout",
"id": "41448a5b-4fc6-4623-b676-1a244ed21f76"
},
{
"@odata.type": "#microsoft.graph.educationAssignment",
"displayName": "2023-07-26T19:04:55.525Z6684",
"id": "2cb9ce0c-a4a1-40b8-b386-b43e0f05e7ed"
}
]
}