Method: users.get

Recupera un usuario.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
userKey

string

Identifica al usuario en la solicitud a la API. El valor puede ser la dirección de correo electrónico principal, el alias de la dirección de correo electrónico o el ID de usuario único del usuario.

Parámetros de consulta

Parámetros
customFieldMask

string

Una lista de nombres de esquema separados por comas. Se recuperan todos los campos de estos esquemas. Solo se debe configurar cuando projection=custom.

projection

enum (Projection)

El subconjunto de campos que se debe recuperar para este usuario.

viewType

enum (ViewType)

Indica si se debe recuperar la vista pública del usuario solo de administrador o de todo el dominio. Para obtener más información, consulta Cómo recuperar un usuario como no administrador.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de User.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta la guía de autorización.

Proyección

Enumeradores
BASIC No incluyas ningún campo personalizado para el usuario.
CUSTOM Incluye campos personalizados de esquemas solicitados en customFieldMask.
FULL Incluye todos los campos asociados con este usuario.

ViewType

Enumeradores
admin_view Los resultados incluyen los campos solo para administrador y público del dominio para el usuario.
domain_public Los resultados solo incluyen campos para el usuario que son visibles públicamente para otros usuarios del dominio.