Aktualisiert die Einstellungen für den Benotungszeitraum eines Kurses.
Der anfragende Nutzer und der Kursinhaber müssen berechtigt sein, Benotungszeiträume zu ändern. Weitere Informationen finden Sie unter Anforderungen an die Lizenzierung.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED Wenn der anfragende Nutzer nicht berechtigt ist, die Einstellungen für die Benotungszeiträume in einem Kurs zu ändern, oder bei Zugriffsfehlern:
UserIneligibleToUpdateGradingPeriodSettings
INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
NOT_FOUND, wenn der angeforderte Kurs nicht existiert.
Maske, mit der angegeben wird, welche Felder in den Benotungszeiträumen aktualisiert werden sollen.
Die Liste „GradingPeriodSettings“ gradingPeriods wird vollständig durch die in der Aktualisierungsanfrage angegebenen Benotungszeiträume ersetzt. Beispiel:
Benotungszeiträume, die in der Liste ohne ID enthalten sind, gelten als Ergänzungen und erhalten bei der Anfrage eine neue ID.
Benotungszeitraume, 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.
Benachteiligte Benotungszeiträume mit einer unbekannten ID führen zu einem Fehler.
Die folgenden Felder können angegeben werden:
gradingPeriods
applyToExistingCoursework
Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
Optional. Die Vorabversion der API. Diese Einstellung muss festgelegt sein, um auf neue API-Funktionen zugreifen zu können, die Entwicklern im Vorabprogramm zur Verfügung gestellt werden.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-12-05 (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."]]],[]]
