Gibt eine Liste mit Einladungen zurück, die der anfragende Nutzer aufrufen darf, beschränkt auf Einladungen, die mit der Listenanfrage übereinstimmen.
Hinweis: Es muss in jedem Fall entweder userId
oder courseId
angegeben werden. Beide Felder können ausgefüllt werden.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
für Zugriffsfehler
HTTP-Anfrage
GET https://classroom.googleapis.com/v1/invitations
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
userId |
Beschränkte Rückgaben auf Einladungen für einen bestimmten Nutzer. Die Kennung kann eine der folgenden sein:
|
courseId |
Beschränkt die zurückgegebenen Einladungen auf einen Kurs mit der angegebenen ID. |
pageSize |
Maximale Anzahl der zurückzugebenden Elemente. Der Standardwert ist 500, wenn nicht angegeben, oder Der Server gibt möglicherweise weniger als die angegebene Anzahl von Ergebnissen zurück. |
pageToken |
Die |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Antwort beim Auflisten von Einladungen.
JSON-Darstellung |
---|
{
"invitations": [
{
object ( |
Felder | |
---|---|
invitations[] |
Einladungen, die mit der Listenanfrage übereinstimmen. |
nextPageToken |
Token, das die nächste Ergebnisseite angibt. Wenn das Feld leer ist, sind keine weiteren Ergebnisse verfügbar. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.rosters
https://www.googleapis.com/auth/classroom.rosters.readonly
Weitere Informationen finden Sie in der Übersicht zu OAuth 2.0.