Listet Gruppenbereiche auf, in denen der Anrufer Mitglied ist. Gruppenchats und DNs werden erst angezeigt, wenn die erste Nachricht gesendet wurde. Ein Beispiel finden Sie unter Gruppenbereiche auflisten.
Erfordert eine Authentifizierung. Unterstützt die App-Authentifizierung und die Nutzerauthentifizierung.
Listet Gruppenbereiche auf, die für den Anrufer oder authentifizierten Nutzer sichtbar sind. Gruppenchats und DNs werden erst angezeigt, 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 |
Optional. Die maximale Anzahl von Leerzeichen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Vorgabe erfolgt, werden maximal 100 Leerzeichen 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 der Listenbereiche empfangen wurde. Geben Sie diesen Parameter an, um die nachfolgende Seite abzurufen. Beim Paginieren sollte der Filterwert mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Das Übergeben eines anderen Werts kann zu unerwarteten Ergebnissen führen. |
filter |
Optional. Ein Abfragefilter. Sie können Gruppenbereiche nach Art des Gruppenbereichs filtern ( Zum Filtern nach Typ von Gruppenbereichen müssen Sie einen gültigen enum-Wert angeben, z. B. Die folgenden Abfragen sind beispielsweise gültig:
Ungültige Abfragen werden vom Server mit dem Fehler |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Antwort auf eine Anfrage zum Auflisten von Gruppenbereichen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"spaces": [
{
object ( |
Felder | |
---|---|
spaces[] |
Liste der Gruppenbereiche auf der angeforderten (oder ersten) Seite. |
nextPageToken |
Sie können ein Token als |
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.