Method: courses.create

Erstellt einen Kurs.

Der in ownerId angegebene Nutzer ist der Inhaber des erstellten Kurses und wird als Lehrkraft hinzugefügt. Ein Nutzer, der kein Administrator ist, kann nur einen Kurs erstellen, bei dem er selbst der Inhaber ist. Domainadministratoren können Kurse erstellen, die einem beliebigen Nutzer in ihrer Domain gehören.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, Kurse zu erstellen, oder bei Zugriffsfehlern.
  • NOT_FOUND, wenn die primäre Lehrkraft kein gültiger Nutzer ist.
  • FAILED_PRECONDITION, wenn das Konto des Kursinhabers deaktiviert ist, oder bei den folgenden Anfragefehlern:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS, wenn in der id ein Alias angegeben wurde, der bereits vorhanden ist.

HTTP-Anfrage

POST https://classroom.googleapis.com/v1/courses

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese Einstellung ist erforderlich, 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 neu erstellte Instanz von Course.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.