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 einen Kurs nur mit sich selbst als Inhaber erstellen. Domainadministratoren können Kurse erstellen, deren Inhaber Nutzer in ihrer Domain sind.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer keine Kurse erstellen darf, 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
  • ALREADY_EXISTS, wenn in der id ein Alias angegeben wurde und dieser 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.