Trabajar con usuarios en Microsoft GraphWorking with users in Microsoft Graph

Puede usar Microsoft Graph para crear experiencias de aplicaciones convincentes basadas en usuarios, sus relaciones con otros usuarios y grupos y su correo, calendario y archivos.You can use Microsoft Graph to build compelling app experiences based on users, their relationships with other users and groups, and their mail, calendar, and files.

Puede acceder a los usuarios a través de Microsoft Graph de dos formas:You can access users through Microsoft Graph in two ways:

  • Mediante su identificador, /users/{id | userPrincipalName}By their ID, /users/{id | userPrincipalName}
  • Mediante el alias /me del usuario que ha iniciado sesión, que es el mismo que /users/{signed-in user's id}By using the /me alias for the signed-in user, which is the same as /users/{signed-in user's id}

AutorizaciónAuthorization

Se requiere uno de los siguientes permisos para acceder a las operaciones de usuario. Los tres primeros permisos los puede conceder un usuario a una aplicación. El resto solo los puede conceder el administrador a una aplicación.One of the following permissions is required to access user operations. The first three permissions can be granted to an app by a user. The rest can only be granted to an app by the administrator.

  • User.ReadBasic.AllUser.ReadBasic.All
  • User.ReadUser.Read
  • User.ReadWriteUser.ReadWrite
  • User.Read.AllUser.Read.All
  • User.ReadWrite.AllUser.ReadWrite.All
  • Directory.Read.AllDirectory.Read.All
  • Directory.ReadWrite.AllDirectory.ReadWrite.All
  • Directory.AccessAsUser.AllDirectory.AccessAsUser.All

Propiedades comunesCommon properties

Las siguientes propiedades representan el conjunto predeterminado de propiedades que se devuelven al obtener un usuario o enumerar usuarios.The following represent the default set of properties that are returned when getting a user or listing users. Son un subconjunto de todas las propiedades disponibles.These are a subset of all available properties. Para obtener más propiedades de usuario, use el parámetro de consulta $select.To get more user properties, use the $select query parameter.

PropiedadProperty DescripciónDescription
idid El identificador único del usuario.The unique identifier for the user.
businessPhonesbusinessPhones Los números de teléfono del usuario.The user's phone numbers.
displayNamedisplayName El nombre del usuario que aparece en la libreta de direcciones.The name displayed in the address book for the user.
givenNamegivenName El nombre de pila del usuario.The first name of the user.
jobTitlejobTitle El puesto del usuario.The user's job title.
mailmail La dirección de correo del usuario.The user's email address.
mobilePhonemobilePhone El número de teléfono móvil del usuario.The user's cellphone number.
officeLocationofficeLocation La ubicación de la oficina física del usuario.The user's physical office location.
preferredLanguagepreferredLanguage El idioma de preferencia del usuario.The user's language of preference.
surnamesurname El apellido del usuario.The last name of the user.
userPrincipalNameuserPrincipalName El nombre principal del usuario.The user's principal name.

Para obtener información detallada y una lista de todas las propiedades, consulte el objeto user.For details and a list of all the properties, see the user object.

Operaciones comunesCommon operations

Nota: Algunas de estas operaciones requieren permisos adicionales.Note: Some of these operations require additional permissions.

PathPath DescripciónDescription
/users Enumera los usuarios de la organización.Lists users in the organization.
/users/{id} Obtiene un usuario específico por su identificador.Gets a specific user by id.
/users/{id}/photo/$value Obtiene la foto de perfil del usuario.Gets the user's profile photo.
/users/{id}/manager Obtiene el administrador del usuario.Gets the user's manager.
/users/{id}/messages Enumera los mensajes de correo electrónico del usuario en su bandeja de entrada principal.Lists the user's email messages in their primary inbox.
/users/{id}/events Enumera los eventos próximos del usuario en su calendario.Lists the user's upcoming events in their calendar.
/users/{id}/drive Obtiene el almacén de archivos del OneDrive del usuario.Gets the user's OneDrive file store.
/users/{id}/memberOf Enumera los grupos de los que el usuario es miembro.Lists the groups that the user is a member of.