Freigeben über

Aktualisieren der EducationAssignment-Zuweisung

  • Artikel

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 eine PATCH-Anforderung nicht verwenden, um die status einer Zuweisung zu ändern. Verwenden Sie die Veröffentlichungsaktion, um die Zuweisung status zu ändern.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

PATCH /education/classes/{class-id}/assignments/{assignment-id}

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die 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 von Kursteilnehmern, die nach der Veröffentlichung der Aufgabe hinzugefügt werden.
addToCalendarAction educationAddToCalendarOptions Optionales Feld zum Steuern des Zuordnungsverhaltens zum Hinzufügen von Aufgaben zu den Kalendern von Kursteilnehmern und Lehrkräften, wenn die Aufgabe veröffentlicht wird. Mögliche Werte: none, studentsAndPublisher, studentsAndTeamOwners, studentsOnly, unknownFutureValue. Der Standardwert ist none. Kann nicht geändert werden, wenn sich die Zuweisung in published status befindet.
allowLateSubmissions Boolesch Gibt an, ob Übermittlungen nach dem Fälligkeitsdatum eingereicht werden können.
allowStudentsToAddResourcesToSubmission Boolesch Gibt an, ob ein Kursteilnehmer einer Übermittlung Ressourcen hinzufügen kann. Gibt an, ob die einzigen Elemente in der Übermittlung aus der Zuordnungsressourcenliste stammen.
assignDateTime DateTimeOffset Datum, an dem die Aufgabe für Kursteilnehmer veröffentlicht werden soll. Kann nicht bearbeitet werden, wenn die Zuweisung veröffentlicht wird.
assignTo educationAssignmentRecipient Kursteilnehmer, die die Aufgabe erhalten.
closeDateTime DateTimeOffset Datum, an dem die Zuweisung für Übermittlungen geschlossen wird. Dies ist ein optionales Feld, das NULL sein kann, wenn die Zuweisung nicht allowLateSubmissions enthält oder closeDateTime mit dueDateTime identisch ist, aber wenn angegeben, muss es größer oder gleich dueDateTime sein.
displayName Zeichenfolge Name der Zuweisung.
dueDateTime DateTimeOffset Die Datumszuweisung ist fällig.
Verschneidungen educationAssignmentGradeType Wie die Aufgabe bewertet wird.
Anweisungen itemBody Anweisungen, die den Kursteilnehmern zusammen mit der Aufgabe gegeben werden sollen.
notificationChannelUrl Zeichenfolge Kanal zur Veröffentlichungsbenachrichtigung nach der Zuweisung. Das Aktualisieren der Kanal-URL ist nach der Veröffentlichung der Zuweisung nicht zulässig und nur zulässig, wenn der assignTo-WerteducationAssignmentClassRecipient ist.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 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",
    "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",
    "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
        }
    }
}

Verwandte Inhalte