Method: courses.create

Erstellt einen Kurs.

Der in ownerId angegebene Nutzer ist der Inhaber des erstellten Kurses und wurde als Lehrkraft hinzugefügt. Nutzer ohne Administratorberechtigungen können einen Kurs nur erstellen, wenn sie der Eigentümer sind. Domainadministratoren können Kurse erstellen, die jedem Nutzer in ihrer Domain gehören.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer keine Kurse erstellen darf oder Zugriffsfehler besteht.
  • NOT_FOUND, wenn die primäre Lehrkraft kein gültiger Nutzer ist.
  • FAILED_PRECONDITION, wenn das Konto des Kursinhabers deaktiviert ist oder die folgenden Anfragefehler aufgetreten sind:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • ALREADY_EXISTS, wenn in id ein Alias angegeben wurde und bereits vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält eine Instanz von Course.

Antworttext

Bei Erfolg 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 Leitfaden zur Autorisierung.