Erstellt eine Einladung. Es kann jeweils nur eine Einladung für einen Nutzer und einen Kurs geben. Löschen Sie die Einladung und erstellen Sie sie neu, um Änderungen vorzunehmen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED, wenn der anfragende Nutzer keine Einladungen für diesen Kurs erstellen darf, oder aufgrund von Zugriffsfehlern.NOT_FOUND, wenn der Kurs oder der Nutzer nicht existiert.FAILED_PRECONDITION:- wenn das Konto des angeforderten Nutzers deaktiviert ist.
- wenn der Nutzer bereits diese Rolle oder eine Rolle mit mehr Berechtigungen hat.
- für die folgenden Anfragefehler:
- IneligibleOwner
ALREADY_EXISTS, wenn bereits eine Einladung für den angegebenen Nutzer und Kurs vorhanden ist.
HTTP-Anfrage
POST https://classroom.googleapis.com/v1/invitations
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält eine Instanz von Invitation.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Invitation.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/classroom.rosters
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.