- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Elenca le iscrizioni a uno spazio. Per un esempio, vedi Elencare gli utenti e le app Google Chat in uno spazio. L'elenco dei membri con autenticazione app elenca i membri degli spazi a cui ha accesso l'app Chat, ma esclude i membri dell'app Chat, inclusi i suoi. La scheda delle iscrizioni con Autenticazione utente elenca le iscrizioni agli spazi a cui l'utente autenticato ha accesso.
Supporta i seguenti tipi di autenticazione:
Autenticazione utente Puoi autenticare e autorizzare questo metodo con i privilegi di amministratore impostando il campo
useAdminAccess
nella richiesta.
Richiesta HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Il nome della risorsa dello spazio per il quale recuperare un elenco di membri. Formato: space/{space} |
Parametri di query
Parametri | |
---|---|
page |
(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, questo viene modificato automaticamente in 1000. I valori negativi restituiscono un errore |
page |
(Facoltativo) Un token di pagina ricevuto da una chiamata precedente per elencare le iscrizioni. 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 può portare a risultati imprevisti. |
filter |
(Facoltativo) Un filtro di query. Puoi filtrare le iscrizioni in base al ruolo ( Per filtrare in base al ruolo, imposta Per filtrare per tipo, imposta Per filtrare sia in base al ruolo che al tipo, utilizza l'operatore
Ad esempio, le seguenti query sono valide:
Le seguenti query non sono valide:
Le query non valide vengono rifiutate dal server con un errore |
show |
(Facoltativo) Se |
show |
(Facoltativo) Quando Al momento è richiesta l'autenticazione dell'utente. |
use |
Se 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 L'elenco delle iscrizioni alle app in uno spazio non è supportato quando si utilizza l'accesso amministrativo. |
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 ( |
Campi | |
---|---|
memberships[] |
Elenco non ordinato. Elenco degli abbonamenti nella pagina richiesta (o nella prima). |
next |
Un token che puoi inviare come |
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.