Method: courses.checkGradingPeriodsSetupEligibility

Gibt zurück, ob ein Nutzer die Benotungszeitraumeinstellungen in einem bestimmten Kurs aktualisieren kann.

Diese Methode ist veraltet. Verwenden Sie stattdessen UserProfiles.checkUserCapability.

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 existiert.

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 Vorabversion der API. Diese Einstellung muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Gibt an, ob der Nutzer die Einstellungen für Benotungszeiträume 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 Einstellungen für die Benotungszeiträume in diesem Kurs aktualisieren darf.
previewVersion

enum (PreviewVersion)

Nur Ausgabe. Die Vorabversion der API. Diese Einstellung muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden.

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.