Method: users.list

Recupera un elenco impaginato degli utenti eliminati o di tutti gli utenti di un dominio.

Richiesta HTTP

GET https://admin.googleapis.com/admin/directory/v1/users

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
customFieldMask

string

Un elenco di nomi di schemi separati da virgole. Vengono recuperati tutti i campi di questi schemi. Deve essere impostato solo quando projection=custom.

customer

string

L'ID univoco dell'account Google Workspace del cliente. In caso di account multidominio, per recuperare tutti gli utenti di un cliente, utilizza questo campo anziché domain. Puoi anche utilizzare l'alias my_customer per rappresentare i customerId del tuo account. customerId viene restituito anche nell'ambito della risorsa Utenti. Devi fornire il parametro customer o domain.

domain

string

Il nome di dominio. Utilizza questo campo per recuperare gli utenti di un solo dominio. Per restituire tutti i domini per un account cliente, utilizza invece il parametro di query customer. È necessario specificare il parametro customer o domain.

event

enum (Event)

Evento a cui è destinata l'iscrizione (se l'abbonamento)

maxResults

integer

Numero massimo di risultati da restituire.

orderBy

enum (OrderBy)

Proprietà da utilizzare per ordinare i risultati.

pageToken

string

Token per specificare la pagina successiva nell'elenco

projection

enum (Projection)

Il sottoinsieme di campi da recuperare per questo utente.

query

string

Stringa di query per la ricerca nei campi utente. Per ulteriori informazioni sulla creazione delle query degli utenti, consulta Ricerca di utenti.

showDeleted

string

Se impostato su true, consente di recuperare l'elenco degli utenti eliminati. (Valore predefinito: false)

sortOrder

enum (SortOrder)

Indica se restituire i risultati in ordine crescente o decrescente, ignorando maiuscole e minuscole.

viewType

enum (ViewType)

Indica se recuperare la visualizzazione pubblica dell'utente solo per l'amministratore o a livello di dominio. Per ulteriori informazioni, vedi Recuperare un utente come non amministratore.

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,
  "trigger_event": string,
  "etag": string,
  "users": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Il tipo di risorsa.

trigger_event

string

Evento che ha attivato questa risposta (utilizzato solo in caso di risposta push)

etag

string

ETag della risorsa.

users[]

object (User)

Un elenco di oggetti utente.

nextPageToken

string

Token utilizzato per accedere alla pagina successiva di questo risultato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly
  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Evento

Tipo di evento Iscrizione

Enum
ADD Evento creato dall'utente
DELETE Evento eliminato dall'utente
MAKE_ADMIN Evento di modifica dello stato dell'amministratore utenti
UNDELETE Evento annullamento eliminazione utente
UPDATE Evento aggiornato dall'utente

OrderBy

Enum
EMAIL Indirizzo email principale dell'utente.
FAMILY_NAME Cognome dell'utente.
GIVEN_NAME Nome dell'utente.

Projection

Enum
BASIC Non includere campi personalizzati per l'utente.
CUSTOM Includi campi personalizzati dagli schemi richiesti in customFieldMask.
FULL Includi tutti i campi associati a questo utente.

SortOrder

Enum
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.

ViewType

Enum
admin_view I risultati includono i campi solo per l'amministratore e pubblico del dominio per l'utente.
domain_public I risultati includono solo i campi relativi all'utente che sono pubblicamente visibili ad altri utenti del dominio.