Method: spaces.list

Listet Gruppenbereiche auf, in denen der Anrufer Mitglied ist. Gruppenchats und DNs werden erst aufgeführt, wenn die erste Nachricht gesendet wurde. Ein Beispiel finden Sie unter Gruppenbereiche auflisten.

Erfordert Authentifizierung. Unterstützt vollständig die Dienstkontoauthentifizierung und die Nutzerauthentifizierung erfordert den Autorisierungsbereich chat.spaces oder chat.spaces.readonly.

Listet Gruppenbereiche auf, die für den Anrufer oder den authentifizierten Nutzer sichtbar sind. Gruppenchats und DNs werden erst aufgeführt, wenn die erste Nachricht gesendet wurde.

HTTP-Anfrage

GET https://chat.googleapis.com/v1/spaces

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl von Gruppenbereichen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Wenn nichts angegeben ist, werden maximal 100 Leerzeichen zurückgegeben.

Der Höchstwert ist 1.000. Wenn Sie einen Wert über 1.000 verwenden, wird er automatisch in 1.000 geändert.

Negative Werte geben den Fehler INVALID_ARGUMENT zurück.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen Listenplatzaufruf empfangen wurde. Geben Sie diesen Parameter an, um die nachfolgende Seite abzurufen.

Bei der Paginierung sollte der Filterwert mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Die Übergabe eines anderen Werts kann zu unerwarteten Ergebnissen führen.
filter

string

Optional. Ein Abfragefilter.

Erfordert Nutzerauthentifizierung.

Sie können Gruppenbereiche nach Gruppenbereichstyp (spaceType) filtern.

Wenn Sie nach Gruppenbereichstyp filtern möchten, müssen Sie einen gültigen Aufzählungswert angeben, z. B. SPACE oder GROUP_CHAT. spaceType darf nicht SPACE_TYPE_UNSPECIFIED sein. Verwenden Sie den Operator OR, um mehrere Gruppenbereichstypen abzufragen.

Die folgenden Abfragen sind beispielsweise gültig:

spaceType = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

Ungültige Abfragen werden vom Server mit dem Fehler INVALID_ARGUMENT abgelehnt.

Bei der Dienstkontoauthentifizierung wird dieses Feld ignoriert und die Abfrage gibt immer alle Leerzeichen zurück. Die Chat API validiert die Abfragesyntax jedoch weiterhin mit Dienstkonten, sodass ungültige Abfragen weiterhin abgelehnt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
Felder
spaces[]

object (Space)

Liste der Gruppenbereiche auf der angeforderten (oder ersten) Seite.
nextPageToken

string

Sie können ein Token als pageToken senden, um die nächste Ergebnisseite abzurufen. Wenn das Feld leer ist, gibt es keine weiteren Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.