Method: invitations.accept

Akzeptiert eine Einladung, entfernt sie und fügt den eingeladenen Nutzer den Lehrkräften oder Schülern/Studenten (je nach Fall) des angegebenen Kurses hinzu. Nur der eingeladene Nutzer kann eine Einladung annehmen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer die angeforderte Einladung nicht annehmen darf, oder bei Zugriffsfehlern.
  • FAILED_PRECONDITION für die folgenden Anfragefehler:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • CourseTeacherLimitReached
    • UserGroupsMembershipLimitReached
  • NOT_FOUND, wenn keine Einladung mit der angeforderten ID vorhanden ist.

HTTP-Anfrage

POST https://classroom.googleapis.com/v1/invitations/{id}:accept

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
id

string

Kennung der Einladung, die angenommen werden soll.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.