Method: spaces.findGroupChats

Restituisce tutti gli spazi con spaceType == GROUP_CHAT, le cui iscrizioni umane contengono esattamente l'utente chiamante e gli utenti specificati in FindGroupChatsRequest.memberships.

Se l'utente chiamante blocca alcuni utenti o è bloccato da alcuni utenti e non vengono trovati spazi con l'intero insieme di utenti specificato, questo metodo restituisce spazi che non includono gli utenti bloccati o bloccanti.

Il set di utenti specificato deve contenere solo iscrizioni di persone (non di app). Una richiesta che contiene utenti non umani non restituisce spazi.

Richiede l'autenticazione utente con uno dei seguenti ambiti di autorizzazione:

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
user[]

string

Nomi delle risorse di tutti gli utenti umani nella chat di gruppo con l'utente che chiama. Le app di chat non possono essere incluse nella richiesta.

Formato: users/{user}, dove {user} è il id della persona dell'API People o il id dell'utente nell'API Directory. Ad esempio, per trovare tutte le chat di gruppo con l'utente chiamante e altri due utenti, con gli ID profilo dell'API People 123456789 e 987654321, puoi utilizzare users/123456789 e users/987654321. Puoi anche utilizzare l'email come alias per {user}. Ad esempio, users/example@gmail.com, dove example@gmail.com è l'email dell'utente di Google Chat.

Quando l'utente chiamante è un utente Google Workspace, tutti gli utenti richiesti devono essere membri della stessa organizzazione Google Workspace dell'utente chiamante.
pageSize

integer

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

Se non specificato, vengono restituiti al massimo 100 spazi.

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

I valori negativi restituiscono un errore INVALID_ARGUMENT.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata per trovare le chat di gruppo. Fornisci questo parametro per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token. Il passaggio di valori diversi può portare a risultati imprevisti.
spaceView

enum (SpaceView)

Tipo di visualizzazione dello spazio richiesto. Se non viene impostato, il valore predefinito è SPACE_VIEW_RESOURCE_NAME_ONLY. Le richieste che specificano SPACE_VIEW_EXPANDED devono includere ambiti che consentano la lettura dei dati dello spazio, ad esempio https://www.googleapis.com/auth/chat.spaces o https://www.googleapis.com/auth/chat.spaces.readonly.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta contenente spazi di chat di gruppo con esattamente l'utente chiamante e gli utenti richiesti.

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 degli spazi nella pagina richiesta (o nella prima pagina).
nextPageToken

string

Un token che puoi inviare come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

SpaceView

Una visualizzazione che specifica quali campi devono essere compilati nella risorsa Spazio. Per garantire la compatibilità con le versioni future, ti consigliamo di fare in modo che il codice tenga conto di valori aggiuntivi.

Enum
SPACE_VIEW_UNSPECIFIED Il valore predefinito / non impostato.
SPACE_VIEW_RESOURCE_NAME_ONLY Compila solo il nome della risorsa Spazio.
SPACE_VIEW_EXPANDED Compila i campi delle risorse Spazio. Nota: il campo permissionSettings non verrà compilato. Le richieste che specificano SPACE_VIEW_EXPANDED devono includere ambiti che consentono la lettura dei dati dello spazio, ad esempio https://www.googleapis.com/auth/chat.spaces o https://www.googleapis.com/auth/chat.spaces.readonly.