Obtener un usuarioGet a user

Recupere las propiedades y las relaciones del objeto de usuario.Retrieve the properties and relationships of user object.

Nota: La obtención de un usuario solo devuelve un conjunto predeterminado de propiedades (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName). Use $select para obtener otras propiedades y relaciones del objeto user.Note: Getting a user returns a default set of properties only (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName). Use $select to get the other properties and relationships for the user object.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllUser.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) User.Read, User.ReadWriteUser.Read, User.ReadWrite
AplicaciónApplication User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Solicitud HTTPHTTP request

Para un usuario específico:For a specific user:

GET /users/{id | userPrincipalName}

Para un usuario con sesión iniciada:For the signed-in user:

GET /me

Parámetros de consulta opcionalesOptional query parameters

Este método admite los parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.This method supports the OData Query Parameters to help customize the response.

De forma predeterminada, solo se devuelve un conjunto limitado de propiedades. (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName).By default, only a limited set of properties are returned ( businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName ).

Para devolver un conjunto de propiedades alternativo, tiene que especificar el conjunto de propiedades de usuario que prefiera con el parámetro de consulta $select de OData.To return an alternative property set, you must specify the desired set of user properties using the OData $select query parameter. Por ejemplo, para devolver displayName, givenName y postalCode, tendría que agregar lo siguiente a la consulta: $select=displayName,givenName,postalCodeFor example, to return displayName, givenName, and postalCode, you would use the add the following to your query $select=displayName,givenName,postalCode

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Cuerpo de la solicitudRequest body

No proporcione un cuerpo de solicitud para este método.Do not supply a request body for this method.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el objeto user en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and user object in the response body.

Este método devuelve 202 Accepted cuando la solicitud se ha procesado correctamente pero el servidor necesita más tiempo para completar las operaciones en segundo plano relacionadas.This method returns 202 Accepted when the request has been processed successfully but the server requires more time to complete related background operations.

EjemplosExamples

Ejemplo 1: Solicitud de usuarios estándarExample 1: Standard users request

De forma predeterminada, solo se devuelve un conjunto limitado de propiedades. (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName).By default, only a limited set of properties are returned ( businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName ). Este ejemplo ilustra las solicitudes y respuestas predeterminadas.This example illustrates the default request and response.

GET https://graph.microsoft.com/v1.0/users/{id | userPrincipalName}
RespuestaResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
  "businessPhones": [
       "businessPhones-value"
   ],
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "jobTitle": "jobTitle-value",
   "mail": "mail-value",
   "mobilePhone": "mobilePhone-value",
   "officeLocation": "officeLocation-value",
   "preferredLanguage": "preferredLanguage-value",
   "surname": "surname-value",
   "userPrincipalName": "userPrincipalName-value",
   "id": "id-value"
}

Ejemplo 2: Solicitud de usuario de inicio de sesiónExample 2: Signed-in user request

Puede obtener la información de usuario para el usuario que hayan iniciado sesión reemplazando /users/{id | userPrincipalName} con /me.You can get the user information for the signed-in user by replacing /users/{id | userPrincipalName} with /me.

SolicitudRequest
GET https://graph.microsoft.com/v1.0/me
RespuestaResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
  "businessPhones": [
       "businessPhones-value"
   ],
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "jobTitle": "jobTitle-value",
   "mail": "mail-value",
   "mobilePhone": "mobilePhone-value",
   "officeLocation": "officeLocation-value",
   "preferredLanguage": "preferredLanguage-value",
   "surname": "surname-value",
   "userPrincipalName": "userPrincipalName-value",
   "id": "id-value"
}

Ejemplo 3: Solicitud de los usuarios mediante $selectExample 3: Users request using $select

Si necesita otro conjunto de propiedades, puede usar el parámetro de consulta $select de OData.If you need a different property set, you can use the OData $select query parameter. Por ejemplo, para devolver displayName, givenName y postalCode, tendría que agregar lo siguiente a la consulta: $select=displayName,givenName,postalCodeFor example, to return displayName, givenName, and postalCode, you would use the add the following to your query $select=displayName,givenName,postalCode

SolicitudRequest
GET https://graph.microsoft.com/v1.0/users/{id | userPrincipalName}?$select=displayName,givenName,postalCode
RespuestaResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "postalCode": "postalCode-value"
}