Listet Mitgliedschaften in einem Gruppenbereich auf. Ein Beispiel finden Sie unter Mitgliedschaften auflisten. Wenn Sie Mitgliedschaften mit App-Authentifizierung auflisten, werden Mitgliedschaften in Gruppenbereichen aufgeführt, auf die die Chat-App Zugriff hat. Chat-App-Mitgliedschaften, einschließlich ihrer eigenen, werden jedoch ausgenommen. Wenn Sie Mitgliedschaften mit Nutzerauthentifizierung auflisten, werden Mitgliedschaften in Gruppenbereichen aufgelistet, auf die der authentifizierte Nutzer Zugriff hat.
Erfordert eine Authentifizierung. Unterstützt die App-Authentifizierung und die Nutzerauthentifizierung.
HTTP-Anfrage
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Der Ressourcenname des Gruppenbereichs, für den eine Mitgliederliste abgerufen werden soll. Format: Leerzeichen/{Leerzeichen} |
Abfrageparameter
Parameter | |
---|---|
pageSize |
Optional. Die maximale Anzahl der zurückzugebenden Mitgliedschaften. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Mitgliedschaften zurückgegeben. Der Maximalwert beträgt 1.000. Wenn Sie einen Wert über 1.000 verwenden, wird er automatisch in „1.000“ geändert. Negative Werte geben den Fehler |
pageToken |
Optional. Ein Seitentoken, das von einem vorherigen Aufruf zum Auflisten von Mitgliedschaften empfangen wurde. Geben Sie diesen Parameter an, um die nachfolgende Seite abzurufen. Beim Paginieren sollten alle anderen angegebenen Parameter dem Aufruf entsprechen, der das Seitentoken bereitgestellt hat. Die Übergabe unterschiedlicher Werte an die anderen Parameter kann zu unerwarteten Ergebnissen führen. |
filter |
Optional. Ein Abfragefilter. Sie können Mitgliedschaften nach der Rolle ( Wenn Sie nach Rolle filtern möchten, legen Sie Setzen Sie Verwenden Sie den Operator Die folgenden Abfragen sind beispielsweise gültig:
Die folgenden Abfragen sind ungültig:
Ungültige Abfragen werden vom Server mit dem Fehler |
showGroups |
Optional. Wenn |
showInvited |
Optional. Wenn Derzeit ist eine Nutzerauthentifizierung erforderlich. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"memberships": [
{
object ( |
Felder | |
---|---|
memberships[] |
Unsortierte Liste. Liste der Mitgliedschaften auf der angeforderten (oder ersten) Seite. |
nextPageToken |
Ein Token, das Sie als |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.