Method: spaces.search

boolean

Quando true, il metodo viene eseguito utilizzando i privilegi amministrativi di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'ambito OAuth 2.0 chat.admin.spaces.readonly o chat.admin.spaces.

Al momento, questo metodo supporta solo l'accesso amministrativo, pertanto per questo campo è accettato solo true.

integer

Il numero massimo di spazi da restituire. Il servizio potrebbe restituire meno di questo valore.

Se non specificato, vengono restituiti al massimo 100 spazi.

Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, il valore viene modificato automaticamente in 1000.

string

Un token ricevuto dalla chiamata dello spazio di ricerca precedente. Specifica questo parametro per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token pagina. Se passi valori diversi agli altri parametri, potresti ottenere risultati imprevisti.

string

Obbligatorio. Una query di ricerca.

Puoi eseguire ricerche utilizzando i seguenti parametri:

• createTime
• customer
• displayName
• externalUserAllowed
• lastActiveTime
• spaceHistoryState
• spaceType

createTime e lastActiveTime accettano un timestamp in formato RFC-3339 e gli operatori di confronto supportati sono: =, <, >, <=, >=.

customer è obbligatorio e viene utilizzato per indicare da quale cliente recuperare gli spazi. customers/my_customer è l'unico valore supportato.

displayName accetta solo l'operatore HAS (:). Il testo da abbinare viene prima tokenizzato in token e ogni token viene associato, senza distinzione tra maiuscole e minuscole e indipendentemente dal prefisso, come sottostringa in qualsiasi punto dello spazio displayName. Ad esempio, Fun Eve corrisponde a Fun event o The evening was fun, ma non a notFun event o even.

externalUserAllowed accetta true o false.

spaceHistoryState accetta solo valori dal campo historyState di una risorsa space.

spaceType è obbligatorio e l'unico valore valido è SPACE.

In diversi campi, sono supportati solo gli operatori AND. Un esempio valido è spaceType = "SPACE" AND displayName:"Hello", mentre un esempio non valido è spaceType = "SPACE" OR displayName:"Hello".

Nello stesso campo, spaceType non supporta gli operatori AND o OR. displayName, "spaceHistoryState" ed "externalUserAllowed" supportano solo gli operatori OR. lastActiveTime e createTime supportano entrambi gli operatori AND e OR. AND può essere utilizzato solo per rappresentare un intervallo, ad esempio lastActiveTime < "2022-01-01T00:00:00+00:00" AND lastActiveTime > "2023-01-01T00:00:00+00:00".

Le seguenti query di esempio sono valide:

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

(Facoltativo) L'ordinamento dell'elenco di spazi.

Gli attributi supportati per l'ordinamento sono:

• membershipCount.joined_direct_human_user_count: indica il numero di utenti che si sono uniti direttamente a uno spazio.
• lastActiveTime: indica l'ora in cui è stato aggiunto l'ultimo elemento idoneo a qualsiasi argomento di questo spazio.
• createTime: indica l'ora in cui è stato creato lo spazio.

I valori validi per l'operazione di ordinamento sono:

• ASC per l'ordine crescente. Valore predefinito.

• DESC per la modalità discendente.

Le sintassi supportate sono:

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