Method: spaces.search

boolean

Wenn true, wird die Methode mit den Google Workspace-Administratorberechtigungen des Nutzers ausgeführt.

Der anrufende Nutzer muss ein Google Workspace-Administrator mit der Berechtigung „Unterhaltungen in Chats und Gruppenbereichen verwalten“ sein.

Erfordert den OAuth 2.0-Bereich chat.admin.spaces.readonly oder chat.admin.spaces.

Diese Methode unterstützt derzeit nur Administratorzugriff. Daher wird für dieses Feld nur true akzeptiert.

integer

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

Wenn nicht angegeben, 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.

string

Ein Token, das vom vorherigen Aufruf von Gruppenbereichen für die Suche 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. Die Übergabe unterschiedlicher Werte an die anderen Parameter kann zu unerwarteten Ergebnissen führen.

string

Erforderlich. Eine Suchanfrage.

Sie können mithilfe der folgenden Parameter 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 wird verwendet, um anzugeben, von welchem Kunden Gruppenbereiche abgerufen werden sollen. customers/my_customer ist der einzige unterstützte Wert.

Für displayName kann nur der Operator HAS (:) verwendet werden. 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.

externalUserAllowed akzeptiert true oder false.

spaceHistoryState akzeptiert nur Werte aus dem Feld historyState einer space-Ressource.

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.

Bei demselben Feld unterstützt spaceType die Operatoren AND und OR nicht. displayName, „spacehistoryState“ und „externalUserAllowed“ unterstützen nur OR-Operatoren. lastActiveTime und createTime unterstützen die Operatoren AND und OR. AND kann nur für ein Intervall wie lastActiveTime < "2022-01-01T00:00:00+00:00" AND lastActiveTime > "2023-01-01T00:00:00+00:00" verwendet werden.

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")

string

Optional. Die Reihenfolge der Liste der Gruppenbereiche.

Folgende Attribute werden für die Sortierung unterstützt:

• membershipCount.joined_direct_human_user_count: Die Anzahl der menschlichen Nutzer, die einem Gruppenbereich direkt beigetreten sind.
• lastActiveTime: Gibt an, wann das letzte zulässige Element zu einem Thema dieses Gruppenbereichs hinzugefügt wurde.
• createTime: Gibt den Zeitpunkt der Erstellung des Gruppenbereichs an.

Gültige Werte für Sortiervorgänge sind:

• ASC für aufsteigend. Standardwert.

• DESC für absteigend.

Folgende Syntax wird unterstützt:

• membershipCount.joined_direct_human_user_count DESC
• membershipCount.joined_direct_human_user_count ASC
• lastActiveTime DESC
• lastActiveTime ASC
• createTime DESC
• createTime ASC