Method: courses.checkGradingPeriodsSetupEligibility

Gibt zurück, ob ein Nutzer „GradingPeriodSettings“ in einem bestimmten Kurs aktualisieren kann.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED für Zugriffsfehler.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs nicht vorhanden ist.

HTTP-Anfrage

GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Die Kennung des Kurses.

Abfrageparameter

Parameter
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 muss leer sein.

Antworttext

Gibt an, ob der Nutzer „GradingPeriodSettings“ in diesem Kurs aktualisieren darf.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
Felder
courseId

string

Nicht veränderbar. Die Kennung des Kurses.
isGradingPeriodsSetupEligible

boolean

Gibt an, ob der Nutzer die „GradingPeriodSettings“ in diesem Kurs aktualisieren darf.
previewVersion

enum (PreviewVersion)

Nur Ausgabe. 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.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.