Erstellt eine Einladung. Für einen Nutzer und einen Kurs kann jeweils nur eine Einladung vorhanden sein. Löschen Sie eine Einladung und erstellen Sie sie neu, um Änderungen vorzunehmen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, Einladungen für diesen Kurs oder Zugriffsfehler zu erstellen.NOT_FOUND, wenn der Kurs oder der Nutzer nicht vorhanden ist.FAILED_PRECONDITION:- Das Konto des angeforderten Nutzers ist deaktiviert.
- Der Nutzer hat diese Rolle oder eine Rolle mit umfassenderen Berechtigungen.
- für die folgenden Fehler bei Anfragen:
- 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.