Diese Methode unterstützt derzeit nur den Administratorzugriff. Daher ist für dieses Feld nur true zulässig.
pageSize
integer
Die maximale Anzahl von Leerzeichen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.
Wenn keine Angabe gemacht wird, werden maximal 100 Leerzeichen zurückgegeben.
Der Höchstwert beträgt 1.000. Wenn Sie einen höheren Wert als 1.000 verwenden, wird er automatisch in 1.000 geändert.
pageToken
string
Ein Token, das vom vorherigen Suchbereichsaufruf empfangen wurde. Geben Sie diesen Parameter an, um die nachfolgende Seite abzurufen.
Beim Paginieren müssen alle anderen angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Wenn Sie für die anderen Parameter unterschiedliche Werte übergeben, kann das zu unerwarteten Ergebnissen führen.
query
string
Erforderlich. Eine Suchanfrage.
Sie können mit den folgenden Parametern suchen:
createTime
customer
displayName
externalUserAllowed
lastActiveTime
spaceHistoryState
spaceType
createTime und lastActiveTime akzeptieren einen Zeitstempel im RFC-3339-Format und die unterstützten Vergleichsoperatoren sind: =, <, >, <= und >=.
customer ist erforderlich und gibt an, von welchem Kunden Gruppenbereiche abgerufen werden sollen. customers/my_customer ist der einzige unterstützte Wert.
Für displayName ist nur der Operator HAS (:) zulässig. Der übereinstimmende Text wird zuerst in Tokens tokenisiert und bei jedem Token wird die Groß-/Kleinschreibung nicht berücksichtigt und unabhängig als Teilstring an beliebiger Stelle im displayName des Bereichs abgeglichen. Beispielsweise stimmt Fun Eve mit Fun event oder The
evening was fun überein, aber nicht mit notFun event oder even.
Für externalUserAllowed sind entweder true oder false zulässig.
Für spaceHistoryState sind nur Werte aus dem Feld historyState einer space-Ressource zulässig.
spaceType ist erforderlich und der einzige gültige Wert ist SPACE.
In verschiedenen Feldern werden nur AND-Operatoren unterstützt. Ein gültiges Beispiel ist spaceType = "SPACE" AND displayName:"Hello" und spaceType = "SPACE" OR displayName:"Hello" ist ungültig.
Innerhalb desselben Felds werden für spaceType keine AND- oder OR-Operatoren unterstützt. displayName, „spacehistoryState“ und „externalUserAllowed“ unterstützen nur OR-Operatoren. lastActiveTime und createTime unterstützen die Operatoren AND und OR. AND kann nur verwendet werden, um ein Intervall darzustellen, z. B. lastActiveTime
< "2022-01-01T00:00:00+00:00" AND lastActiveTime >
"2023-01-01T00:00:00+00:00".
Die folgenden Beispielabfragen sind gültig:
customer = "customers/my_customer" AND spaceType = "SPACE"
customer = "customers/my_customer" AND spaceType = "SPACE" AND
displayName:"Hello World"
customer = "customers/my_customer" AND spaceType = "SPACE" AND
(lastActiveTime < "2020-01-01T00:00:00+00:00" OR lastActiveTime >
"2022-01-01T00:00:00+00:00")
customer = "customers/my_customer" AND spaceType = "SPACE" AND
(displayName:"Hello World" OR displayName:"Fun event") AND
(lastActiveTime > "2020-01-01T00:00:00+00:00" AND lastActiveTime <
"2022-01-01T00:00:00+00:00")
customer = "customers/my_customer" AND spaceType = "SPACE" AND
(createTime > "2019-01-01T00:00:00+00:00" AND createTime <
"2020-01-01T00:00:00+00:00") AND (externalUserAllowed = "true") AND
(spaceHistoryState = "HISTORY_ON" OR spaceHistoryState = "HISTORY_OFF")
orderBy
string
Optional. Die Reihenfolge der Gruppenbereiche.
Folgende Attribute werden unterstützt:
membershipCount.joined_direct_human_user_count: Die Anzahl der menschlichen Nutzer, die einem Gruppenbereich direkt beigetreten sind.
lastActiveTime: Gibt an, wann dem letzten Thema in diesem Gruppenbereich ein berechtigtes Element hinzugefügt wurde.
createTime: Gibt den Zeitpunkt der Erstellung des Gruppenbereichs an.
Ein Token, mit dem die nächste Seite abgerufen werden kann. Wenn dieses Feld leer ist, gibt es keine nachfolgenden Seiten.
totalSize
integer
Die Gesamtzahl der Gruppenbereiche, die der Suchanfrage entsprechen, auf allen Seiten. Wenn das Ergebnis mehr als 10.000 Leerzeichen beträgt, ist dieser Wert eine Schätzung.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-02-27 (UTC)."],[[["Returns a paginated list of Google Workspace spaces based on an administrator's search criteria, including parameters like displayName, createTime, and spaceType."],["Requires administrator privileges and the `useAdminAccess` parameter set to `true` in the request."],["Utilizes the `GET https://chat.googleapis.com/v1/spaces:search` HTTP request with query parameters for customization."],["Needs authorization with either the `chat.admin.spaces` or `chat.admin.spaces.readonly` OAuth scope."],["Response body includes an array of spaces, a token for pagination, and an estimate of the total number of matching spaces."]]],["To search for Google Workspace spaces, send a `GET` request to `https://chat.googleapis.com/v1/spaces:search`, ensuring admin privileges and setting `useAdminAccess` to `true`. Define the search using query parameters, including a required `query` to filter spaces (by `customer`, `displayName`, etc.), optional `pageSize` and `pageToken` for pagination, and optional `orderBy` for sorting. You must have one of the authorization scopes: `chat.admin.spaces` or `chat.admin.spaces.readonly`. The response will list spaces matching the query.\n"]]
