Method: spaces.search

Restituisce un elenco di spazi in base alla ricerca di un utente. Richiede l'autenticazione degli utenti. L'utente deve essere un amministratore dell'organizzazione Google Workspace. Nella richiesta, imposta useAdminAccess su true.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
useAdminAccess

boolean

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

L'utente chiamante 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.
pageSize

integer

Il numero massimo di spazi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore.

Se non specificati, vengono restituiti al massimo 100 spazi.

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

string

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

Durante l'impaginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token della pagina. Il trasferimento di valori diversi agli altri parametri potrebbe portare a risultati imprevisti.
query

string

Obbligatoria. Una query di ricerca.

Puoi eseguire la ricerca 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 associare viene prima tokenizzato in token e ogni token è abbinato al prefisso, senza distinzione tra maiuscole e minuscole e in modo indipendente come sottostringa in qualsiasi punto della proprietà displayName dello spazio. 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 campi diversi sono supportati solo gli operatori AND. Un esempio valido è spaceType = "SPACE" AND displayName:"Hello", mentre un esempio non valido è spaceType = "SPACE" OR displayName:"Hello".

All'interno dello stesso campo, spaceType non supporta gli operatori AND o OR. displayName, "spaceCronologiaState" 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")
orderBy

string

Campo facoltativo. Come viene ordinato l'elenco degli spazi.

Gli attributi supportati per ordinare sono:

  • membershipCount.joined_direct_human_user_count: indica il numero di utenti umani che si sono uniti direttamente a uno spazio.
  • lastActiveTime: indica la data e l'ora in cui l'ultimo elemento idoneo viene aggiunto a un argomento di questo spazio.
  • createTime: indica l'ora in cui è stata creata lo spazio.

I valori validi per le operazioni di ordinamento sono:

  • ASC per l'ordine crescente. Valore predefinito.

  • DESC per ordine decrescente.

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

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta con un elenco di spazi corrispondenti alla richiesta degli spazi di ricerca.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campi
spaces[]

object (Space)

Una pagina degli spazi richiesti.
nextPageToken

string

Un token che può essere utilizzato per recuperare la pagina successiva. Se questo campo è vuoto, non ci saranno pagine successive.
totalSize

integer

Il numero totale di spazi che corrispondono alla query in tutte le pagine. Se il risultato supera i 10.000 spazi, questo valore è una stima.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la guida all'autorizzazione.