Method: spaces.list

Elenca gli spazi di cui l'utente che chiama è membro. Le chat di gruppo e i messaggi diretti non vengono elencati finché non viene inviato il primo messaggio. Per un esempio, consulta Elenca gli spazi.

Supporta i seguenti tipi di autenticazione:

Per elencare tutti gli spazi denominati per organizzazione Google Workspace, utilizza il metodo spaces.search() utilizzando i privilegi di amministratore di Workspace.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
pageSize

integer

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

Se non specificati, vengono restituiti al massimo 100 spazi.

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

I valori negativi restituiscono un errore INVALID_ARGUMENT.
pageToken

string

(Facoltativo) Un token di pagina ricevuto da una precedente chiamata di elenco di spazi. Specifica questo parametro per recuperare la pagina successiva.

Quando viene visualizzata la paginazione, il valore del filtro deve corrispondere alla chiamata che ha fornito il token pagina. Il passaggio di un valore diverso può portare a risultati imprevisti.
filter

string

(Facoltativo) Un filtro di query.

Puoi filtrare gli spazi in base al tipo di spazio (spaceType).

Per filtrare in base al tipo di spazio, devi specificare un valore enumerato valido, ad esempio SPACE o GROUP_CHAT (spaceType non può essere SPACE_TYPE_UNSPECIFIED). Per eseguire query su più tipi di spazi, utilizza l'operatore OR.

Ad esempio, le seguenti query sono valide:

spaceType = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta a una richiesta di elenco di spazi.

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

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

object (Space)

Elenco di spazi nella pagina richiesta (o prima). Nota: il campo permissionSettings non viene restituito nell'oggetto Space per le richieste di elenco.
nextPageToken

string

Puoi inviare un token come pageToken per recuperare la pagina di risultati successiva. Se è vuoto, non ci sono pagine successive.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.