Method: courses.courseWork.rubrics.patch

Aktualisiert ein Bewertungsschema.

Informationen zu den Feldern, die aktualisiert werden können, finden Sie unter google.classroom.v1.Rubric. Nach Beginn der Benotung sind die Möglichkeiten zum Aktualisieren des Bewertungsschemas begrenzt.

Diese Anfrage muss über die Google Cloud Console der OAuth-Client-ID erfolgen, die zum Erstellen des übergeordneten Arbeitselements des Kurses verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn das anfragende Entwicklerprojekt die entsprechende Kursarbeit nicht erstellt hat, der Nutzer nicht berechtigt ist, die angeforderte Änderung am Bewertungsschema vorzunehmen, oder wenn Zugriffsfehler aufgetreten sind. Dieser Fehlercode wird auch zurückgegeben, wenn mit der Benotung bereits begonnen wurde.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist und der folgende Anfragefehler aufgetreten ist:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursaufgabe oder das Bewertungsschema nicht vorhanden ist oder der Nutzer keinen Zugriff auf die entsprechende Kursaufgabe hat.
  • INTERNAL, wenn mit der Benotung bereits begonnen wurde.

HTTP-Anfrage

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. ID des Kurses.

courseWorkId

string

Erforderlich. ID der Kursaufgabe.

id

string

Optional. ID des Bewertungsschemas.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Optional. Maske, die angibt, welche Felder im Bewertungsschema aktualisiert werden sollen Dieses Feld ist für eine Aktualisierung erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben sind. Es gibt mehrere Möglichkeiten, die Kriterien eines Bewertungsschemas zu definieren: die sourceSpreadsheetId- und die criteria-Liste. Es kann jeweils nur eine dieser Optionen zum Definieren eines Bewertungsschemas verwendet werden.

Die Liste criteria des Bewertungsschemas wird vollständig durch die in der Aktualisierungsanfrage angegebenen Kriterien ersetzt. Wenn beispielsweise ein Kriterium oder eine Ebene in der Anfrage fehlt, wird es gelöscht. Neue Kriterien und Ebenen werden hinzugefügt und eine ID wird zugewiesen. Vorhandene Kriterien und Ebenen behalten die zuvor zugewiesene ID, wenn die ID in der Anfrage angegeben ist.

Die folgenden Felder können von Lehrkräften festgelegt werden:

  • criteria
  • sourceSpreadsheetId

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

previewVersion

enum (PreviewVersion)

Optional. Die Vorschauversion der API. Diese Einstellung muss aktiviert sein, damit Sie auf neue API-Funktionen zugreifen können, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext enthält eine Instanz von Rubric.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Rubric.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.coursework.students

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.