Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
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:
gradingPeriodsapplyToExistingCoursework 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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-02-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-02-27 (UTC)."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]
