Method: invitations.create

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.