Method: courses.topics.create

Erstellt ein Thema.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs zuzugreifen, ein Thema im angeforderten Kurs zu erstellen oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • ALREADY_EXISTS, wenn im Kurs bereits ein Thema mit demselben Namen vorhanden ist.
  • FAILED_PRECONDITION für den folgenden Anfragefehler:
    • CourseTopicLimitReached
  • NOT_FOUND, wenn der angeforderte Kurs nicht existiert.

HTTP-Anfrage

POST https://classroom.googleapis.com/v1/courses/{courseId}/topics

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.

Anfragetext

Der Anfragetext enthält eine Instanz von Topic.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Topic.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.