Method: courses.update

Aktualisiert einen Kurs.

Hinweis: Im Gegensatz zu anderen Feldern wird levels nicht gelöscht, wenn es in der Anfrage nicht angegeben ist. Die Methode courses.update ändert levels nur, wenn es explizit angegeben ist. Andernfalls bleibt der vorhandene Wert erhalten. Verwenden Sie die Methode courses.patch, um das Feld levels zu löschen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED wenn der anfragende Nutzer nicht berechtigt ist, den angeforderten Kurs zu ändern, oder bei Zugriffsfehlern.
  • NOT_FOUND, wenn kein Kurs mit der angeforderten ID vorhanden ist.
  • FAILED_PRECONDITION für die folgenden Anfragenfehler:
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

HTTP-Anfrage

PUT https://classroom.googleapis.com/v1/courses/{id}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
id

string

ID des zu aktualisierenden Kurses. Diese ID kann entweder die von Classroom zugewiesene ID oder ein alias sein.

Suchparameter

Parameter
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese muss festgelegt werden, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext enthält eine Instanz von Course.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.