Recupera tutti i gruppi di un dominio o di un utente a cui è stata assegnata una chiave utente (paginata).
Richiesta HTTP
GET https://admin.googleapis.com/admin/directory/v1/groups
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
Parametri | |
---|---|
customer |
L'ID univoco dell'account Google Workspace del cliente. In caso di un account multidominio, per recuperare tutti i gruppi di un cliente, utilizza questo campo anziché |
domain |
Il nome di dominio. Utilizza questo campo per ottenere gruppi da un solo dominio. Per restituire tutti i domini per un account cliente, utilizza il parametro di query |
maxResults |
Il numero massimo di risultati da restituire. Il valore massimo consentito è 200. |
orderBy |
Colonna da utilizzare per ordinare i risultati |
pageToken |
Token per specificare la pagina successiva nell'elenco |
query |
Ricerca stringa di query. Deve essere nel formato " |
sortOrder |
Indica se i risultati devono essere restituiti in ordine crescente o decrescente. Da usare solo quando viene usato anche orderBy |
userKey |
Indirizzo email o ID immutabile dell'utente se devono essere elencati solo questi gruppi, di cui l'utente specificato è membro. Se si tratta di un ID, deve corrispondere all'ID dell'oggetto utente. Non può essere utilizzato con il parametro |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"kind": string,
"etag": string,
"groups": [
{
object ( |
Campi | |
---|---|
kind |
Il tipo di risorsa. |
etag |
ETag della risorsa. |
groups[] |
Un elenco di oggetti gruppo. |
nextPageToken |
Token utilizzato per accedere alla pagina successiva di questo risultato. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://apps-apis.google.com/a/feeds/groups/
https://www.googleapis.com/auth/admin.directory.group
https://www.googleapis.com/auth/admin.directory.group.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
OrderBy
Enum | |
---|---|
EMAIL |
Indirizzo email del gruppo. |
SortOrder
Enum | |
---|---|
ASCENDING |
Ordine crescente. |
DESCENDING |
Ordine decrescente. |