Method: courses.courseWork.rubrics.patch

• HTTP-Anfrage
• Pfadparameter
• Anfrageparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche

Entwicklervorschau:Verfügbar im Rahmen des Google Workspace-Vorschauprogramms für Entwickler, das Vorabzugriff auf bestimmte Funktionen gewährt. Diese Funktion ist ab V1_20231110_PREVIEW verfügbar. Weitere Informationen finden Sie unter Auf Preview-APIs zugreifen.

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
Wichtig:Wenn Sie ein Bewertungsschema aus einer Google-Tabelle erstellen und dabei sourceSpreadsheetId angeben, sind zusätzliche Bereiche erforderlich: entweder https://www.googleapis.com/auth/spreadsheets.readonly oder https://www.googleapis.com/auth/spreadsheets. Beachten Sie, dass die spreadsheets-Bereiche als vertraulich gelten und möglicherweise eine Verifizierung Ihrer Anwendung erfordern.

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.