Bildungszuweisung aktualisieren

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
        }
    }
}