Method: courses.updateGradingPeriodSettings

Aktualisiert die Einstellungen für den Benotungszeitraum eines Kurses.

Der anfragende Nutzer und der Kursinhaber müssen berechtigt sein, die Benotungszeiträume zu ändern. Weitere Informationen finden Sie in den Lizenzanforderungen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, die Einstellungen für den Benotungszeitraum in einem Kurs zu ändern, oder für Zugriffsfehler gilt:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs nicht vorhanden ist.

HTTP-Anfrage

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Die Kennung des Kurses.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Maske, die angibt, welche Felder in „GradingPeriodSettings“ aktualisiert werden sollen.

Die Liste „GradingPeriodSettings“ (gradingPeriods) wird vollständig durch die Benotungszeiträume ersetzt, die in der Aktualisierungsanfrage angegeben sind. Beispiel:

  • Benotungszeiträume, die in der Liste ohne ID enthalten sind, gelten als Ergänzungen. Wenn die Anfrage gestellt wird, wird ihnen eine neue ID zugewiesen.
  • Benotungszeiträume, die derzeit vorhanden sind, aber in der Anfrage fehlen, werden als gelöscht betrachtet.
  • Benotungszeiträume mit einer vorhandenen ID und geänderten Daten gelten als Änderungen. Unveränderte Daten bleiben unverändert.
  • Bei Benotungszeiträumen mit einer unbekannten ID wird ein Fehler ausgegeben.

Die folgenden Felder können angegeben werden:

  • gradingPeriods
  • applyToExistingCoursework

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Optional. Die Vorschauversion der API. Dies muss festgelegt werden, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorschauprogramm zur Verfügung stehen.

Anfragetext

Der Anfragetext enthält eine Instanz von GradingPeriodSettings.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.courses

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.