Freigeben über


Aktualisieren von educationAssignmentSettings

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines educationAssignmentSettings-Objekts . Nur Lehrkräfte können diese Einstellungen aktualisieren.

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des educationAssignmentSettings-Objekts an.

Die folgende Tabelle zeigt die Eigenschaften, die erforderlich sind, wenn Sie educationAssignmentSettings aktualisieren.

Eigenschaft Typ Beschreibung
submissionAnimationDisabled Boolesch Gibt an, ob die Animation zur Feier zum Einwechseln angezeigt werden soll. Der Wert gibt true an, dass die Animation übersprungen wird. Der Standardwert ist false.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes educationAssignmentSettings-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren von submissionAnimationDisabled

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentSettings
Content-Type: application/json

{
  "submissionAnimationDisabled": true
}

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

{
  "submissionAnimationDisabled": true
}

Beispiel 2: Erstellen von Bewertungskategorien

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentSettings
Content-type: application/json

{
  "gradingCategories": [
        {           
            "displayName": "Lab",
            "percentageWeight": 10
        },
        {
            "displayName": "Homework",
            "percentageWeight": 80
        },
        {
            "displayName": "Test",
            "percentageWeight": 10
        }
    ]
}

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/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignmentSettings/$entity",
    "submissionAnimationDisabled": true,
    "gradingCategories@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignmentSettings/gradingCategories",
    "gradingCategories": [
        {
            "id": "36bf5273-d3e3-4f83-a534-8c816c33cc3e",
            "displayName": "Lab",
            "percentageWeight": 10
        },
        {
            "id": "5ffdba4e-2d79-4fe5-87d0-9a2b4552d3c0",
            "displayName": "Homework",
            "percentageWeight": 80
        },
        {
            "id": "691579b1-cf38-40ba-8758-c6a27529a8b7",
            "displayName": "Test",
            "percentageWeight": 10
        }
    ]
}

Beispiel 3: Delta-Nutzlast zum Löschen, Ändern und Hinzufügen von Bewertungskategorien.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentSettings
Content-type: application/json

{
    "gradingCategories@delta": [
        {
            // Change this grading category's name
            "id": "03bd9196-ce2e-41bd-902f-df9ae02de4db",
            "displayName": "Lab Updated"
        },
        {
            // Delete this grading category 
            "@odata.context": "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity",
            "id": "109e5d73-3ef7-42a5-88d8-7e30cdb85f06",
            "reason": "deleted"
        },
        {
            // Add a new grading category 
            "displayName": "New Homework",
            "percentageWeight": 50
        }
    ]
}

Hinweis: Sie müssen die Kommentare, die in den Beispielen für den Anforderungstext angezeigt werden, nicht in Ihre Anforderungen einschließen. Sie dienen dazu, jeden Vorgang für Sie zu klären.

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/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignmentSettings/$entity",
    "submissionAnimationDisabled": true,
    "gradingCategories@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignmentSettings/gradingCategories",
    "gradingCategories": [
        {
            "id": "a5ca6dda-f220-43ca-81e4-02396b99f398",
            "displayName": "Test",
            "percentageWeight": 30
        },
        {
            "id": "03bd9196-ce2e-41bd-902f-df9ae02de4db",
            "displayName": "Lab Updated",
            "percentageWeight": 20
        },
        {
            "id": "905b49a5-1639-49ab-9fbe-6a035def5ba3",
            "displayName": "New Homework",
            "percentageWeight": 50
        }
    ]
}