Gibt eine Liste der Einladungen zurück, die der anfragende Nutzer ansehen darf. Sie wird auf die Einladungen beschränkt, die der Listenanfrage entsprechen.
Hinweis: Es muss in jedem Fall entweder userId
oder courseId
angegeben werden. Beide Felder können angegeben 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änkt zurückgegebene Einladungen auf die Einladungen eines bestimmten Nutzers. Die Kennung kann eine der folgenden sein:
|
courseId |
Beschränkt zurückgegebene Einladungen auf diejenigen für einen Kurs mit der angegebenen Kennung. |
pageSize |
Maximale Anzahl der Artikel, die zurückgegeben werden sollen. Wenn nicht angegeben, ist der Standardwert 500 oder Der Server gibt möglicherweise weniger als die angegebene Anzahl von Ergebnissen zurück. |
pageToken |
Die Anfrage |
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 der Listenanfrage entsprechen |
nextPageToken |
Token, das die nächste Ergebnisseite angibt, die zurückgegeben werden soll. 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 OAuth 2.0-Übersicht.