Method: courses.update

Aktualisiert einen Kurs.

Hinweis: Im Gegensatz zu anderen Feldern wird levels nicht gelöscht, wenn es in der Anfrage ausgelassen wird. Mit der Methode courses.update wird levels nur geändert, wenn es explizit angegeben wird. Andernfalls wird der vorhandene Wert beibehalten. Verwenden Sie die Methode courses.patch, um das Feld levels zu leeren.

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 Anfragefehler:
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
id

string

Kennung des Kurses, der aktualisiert werden soll. Diese Kennung kann entweder die von Classroom zugewiesene Kennung oder eine alias sein.

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.