Method: courses.teachers.create

Erstellt eine Lehrkraft für einen Kurs.

Domainadministratoren können Nutzer in ihrer Domain direkt als Lehrkräfte zu Kursen in ihrer Domain hinzufügen. Nutzer ohne Administratorberechtigungen sollten stattdessen eine Invitation senden.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer keine Lehrkräfte in diesem Kurs erstellen darf, oder aufgrund von Zugriffsfehlern.
  • NOT_FOUND, wenn die angeforderte Kurs-ID nicht vorhanden ist.
  • FAILED_PRECONDITION Wenn das Konto des angeforderten Nutzers deaktiviert ist, bei den folgenden Anfragefehlern:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • CourseTeacherLimitReached
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS, wenn der Nutzer bereits eine Lehrkraft oder ein Schüler/Student im Kurs ist.

HTTP-Anfrage

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

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 Teacher.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.