Method: users.get

Recupera un utente.

Richiesta HTTP

GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userKey

string

Identifica l'utente nella richiesta API. Il valore può essere l'indirizzo email principale, l'indirizzo email alias o l'ID utente univoco dell'utente.

Parametri di query

Parametri
customFieldMask

string

Un elenco separato da virgole di nomi di schemi. Vengono recuperati tutti i campi di questi schemi. Questo valore deve essere impostato solo quando projection=custom.
projection

enum (Projection)

Il sottoinsieme di campi da recuperare per questo utente.
viewType

enum (ViewType)

Indica se recuperare la visualizzazione pubblica solo per gli amministratori o a livello di dominio dell'utente. Per saperne di più, vedi Recuperare un utente come utente 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 un'istanza di User.

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Projection

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

ViewType

Enum
admin_view I risultati includono sia i campi riservati agli amministratori sia quelli pubblici del dominio per l'utente.
domain_public I risultati includono solo i campi per l'utente che sono visibili pubblicamente agli altri utenti del dominio.