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.
Aktualisieren eines educationAssignment-Objekts .
Nur Lehrer in der Klasse können dies tun. Sie können keine PATCH-Anforderung verwenden, um den Status einer Aufgabe zu ändern. Verwenden Sie die Aktion "Veröffentlichen", um den Status der Aufgabe zu ändern.
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.ReadWriteBasic | EduAssignments.ReadWrite |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | EduAssignments.ReadWriteBasic.All | EduAssignments.ReadWrite.All |
HTTP-Anforderung
PATCH /education/classes/{class-id}/assignments/{assignment-id}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json |
Anforderungstext
Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| addedStudentAction | Zeichenfolge | Steuert das Verhalten für Kursteilnehmer, die nach der Veröffentlichung der Aufgabe hinzugefügt werden. |
| addToCalendarAction | educationAddToCalendarOptions | Optionales Feld zum Steuern des Aufgabenverhaltens beim Hinzufügen von Aufgaben zu den Kalendern von Kursteilnehmern und Lehrern, wenn die Aufgabe veröffentlicht wird. Mögliche Werte sind: none, studentsAndPublisher, studentsAndTeamOwners, studentsOnly, unknownFutureValue. Der Standardwert ist none. Kann nicht geändert werden, wenn die Zuweisung im published Status ist. |
| allowLateSubmissions | Boolean | Ob Einreichungen nach dem Fälligkeitsdatum eingereicht werden können. |
| allowStudentsToAddResourcesToSubmission | Boolean | Gibt an, ob ein Schüler/Student einer Einreichung Ressourcen hinzufügen kann. Gibt an, ob die einzigen Elemente in der Einreichung aus der Ressourcenliste der Zuordnungen stammen. |
| assignDateTime | DateTimeOffset | Datum, an dem die Aufgabe für die Kursteilnehmer veröffentlicht werden soll. Kann nicht bearbeitet werden, wenn die Aufgabe veröffentlicht wird. |
| assignTo | educationAssignmentRecipient | Kursteilnehmer, die die Aufgabe erhalten. |
| closeDateTime | DateTimeOffset | Datum, an dem die Abgabefrist für die Aufgabe geschlossen wird. Dies ist ein optionales Feld, das Null sein kann, wenn die Zuweisung keine LateSubmissions zulässt oder closeDateTime mit dueDateTime identisch ist, aber wenn angegeben, muss es größer oder gleich der dueDateTime sein. |
| displayName | Zeichenfolge | Name der Zuweisung. |
| dueDateTime | DateTimeOffset | Die Datumszuweisung ist fällig. |
| Benotung | educationAssignmentGradeType | Wie die Aufgabe benotet wird. |
| Anweisungen | itemBody | Anweisungen, die den Schülern/Studenten zusammen mit der Aufgabe zu geben sind. |
| languageTag | Zeichenfolge | Gibt die Sprache an, in der UI-Benachrichtigungen für die Zuweisung angezeigt werden. Wenn languageTag nicht angegeben wird, ist en-USdie Standardsprache . Optional. |
| notificationChannelUrl | Zeichenfolge | Veröffentlichungsbenachrichtigung über den Kanal zum Posten von Aufgaben. Das Aktualisieren der Kanal-URL ist nicht zulässig, nachdem die Aufgabe veröffentlicht wurde, und es ist nur zulässig, wenn der assignTo-Wert"educationAssignmentClassRecipient" lautet. |
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und ein aktualisiertes educationAssignment-Objekt im Antworttext zurück.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
PATCH https://graph.microsoft.com/beta/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",
"languageTag": "pt-BR",
"addToCalendarAction": "studentsAndPublisher"
}
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#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",
"addToCalendarAction": "studentsAndPublisher",
"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
}
}
}