Method: spaces.members.list

Elenca le iscrizioni in uno spazio. Per un esempio, vedi Elencare gli utenti e le app Google Chat in uno spazio. La scheda degli abbonamenti con autenticazione app elenca le iscrizioni agli spazi a cui l'app Chat ha accesso, ma esclude le iscrizioni all'app Chat, incluse le sue. La scheda delle iscrizioni con Autenticazione utente elenca le iscrizioni agli spazi a cui l'utente autenticato ha accesso.

Richiede l'autenticazione. Supporta l'autenticazione delle app e l'autenticazione degli utenti.

Richiesta HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/members

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa dello spazio per il quale recuperare un elenco di membri.

Formato: workspace/{space}

Parametri di query

Parametri
pageSize

integer

(Facoltativo) Il numero massimo di abbonamenti da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore.

Se non specificato, vengono restituite al massimo 100 abbonamenti.

Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, il valore 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 per elencare le iscrizioni. Fornisci 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 può portare a risultati imprevisti.
filter

string

(Facoltativo) Un filtro di query.

Puoi filtrare le iscrizioni in base al ruolo (role) e al tipo (member.type) di un membro.

Per filtrare in base al ruolo, imposta role su ROLE_MEMBER o ROLE_MANAGER.

Per filtrare per tipo, imposta member.type su HUMAN o BOT. Anteprima per gli sviluppatori: puoi anche filtrare in base a member.type utilizzando l'operatore !=.

Per filtrare sia in base al ruolo che al tipo, utilizza l'operatore AND. Per filtrare in base a ruolo o tipo, utilizza l'operatore OR.

Se useAdminAccess è impostato su true, è obbligatorio member.type = "HUMAN" o member.type != "BOT". Gli altri filtri dei tipi di membri verranno rifiutati.

Ad esempio, le seguenti query sono valide:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

Le seguenti query non sono valide:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

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

boolean

(Facoltativo) Quando true, oltre ad altri tipi di abbonamenti, restituisce anche gli abbonamenti associati a un Google Group. Se viene impostato un filter, le appartenenze a Google Group che non corrispondono ai criteri del filtro non vengono restituite.
showInvited

boolean

(Facoltativo) Quando true, restituisce anche gli abbonamenti associati ai membri invited, oltre ad altri tipi di abbonamenti. Se viene impostato un filtro, le appartenenze a invited che non corrispondono ai criteri del filtro non vengono restituite.

Attualmente richiede l'autenticazione dell'utente.
useAdminAccess

boolean

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

L'utente che chiama deve essere un amministratore di Google Workspace con il privilegio di gestione delle conversazioni di Chat e spazi.

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

Se si utilizza l'accesso amministrativo, non è possibile elencare gli abbonamenti all'app in uno spazio.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta all'elenco dei membri dello spazio.

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

Rappresentazione JSON 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Campi
memberships[]

object (Membership)

Elenco non ordinato. Elenco degli abbonamenti nella pagina richiesta (o nella prima).
nextPageToken

string

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.