Работа с пользователями в Microsoft GraphWorking with users in Microsoft Graph

Вы можете использовать Microsoft Graph для создания привлекательных приложений, учитывающих пользователей, их связи с другими пользователями и группами, а также почту, календарь и файлы.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.

Вы можете получить доступ к пользователям через Microsoft Graph двумя указанными ниже способами.You can access users through Microsoft Graph in two ways:

  • По идентификатору пользователя (/users/{id | userPrincipalName}).By their ID, /users/{id | userPrincipalName}
  • С помощью псевдонима /me (который совпадает с /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}

АвторизацияAuthorization

Для операций доступа к пользователям необходимо одно из указанных ниже разрешений. Первые три разрешения могут быть предоставлены приложению пользователем. Остальные разрешения могут быть предоставлены приложению администратором.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

Общие свойстваCommon properties

Ниже показан набор свойств, используемый по умолчанию и возвращаемый при получении пользователя или выводе списка пользователей.The following represent the default set of properties that are returned when getting a user or listing users. Это подмножество всех доступных свойств.These are a subset of all available properties. Чтобы получить дополнительные свойства пользователя, используйте параметр запроса $select.To get more user properties, use the $select query parameter.

СвойствоProperty ОписаниеDescription
idid Уникальный идентификатор для пользователя.The unique identifier for the user.
businessPhonesbusinessPhones Номера телефонов пользователя.The user's phone numbers.
displayNamedisplayName Имя, отображаемое в адресной книге, для пользователя.The name displayed in the address book for the user.
givenNamegivenName Имя пользователя.The first name of the user.
jobTitlejobTitle Должность пользователя.The user's job title.
mailmail Электронный адрес пользователя.The user's email address.
mobilePhonemobilePhone Номер мобильного телефона пользователя.The user's cellphone number.
officeLocationofficeLocation Физическое расположение офиса пользователя.The user's physical office location.
preferredLanguagepreferredLanguage Предпочитаемый язык пользователя.The user's language of preference.
surnamesurname Фамилия пользователя.The last name of the user.
userPrincipalNameuserPrincipalName Имя участника-пользователя для пользователя.The user's principal name.

Дополнительные сведения и список всех свойств см. в статье об объекте user.For details and a list of all the properties, see the user object.

Стандартные действияCommon operations

Примечание. Для выполнения некоторых из этих операций необходимы дополнительные разрешения.Note: Some of these operations require additional permissions.

PathPath ОписаниеDescription
/users Вывод списка пользователей в организации.Lists users in the organization.
/users/{id} Получение определенного пользователя по идентификатору.Gets a specific user by id.
/users/{id}/photo/$value Получение фотографии профиля пользователя.Gets the user's profile photo.
/users/{id}/manager Получение сведений о руководителе пользователя.Gets the user's manager.
/users/{id}/messages Вывод списка электронных писем пользователя в его основном почтовом ящике.Lists the user's email messages in their primary inbox.
/users/{id}/events Вывод списка предстоящих событий пользователя из его календаря.Lists the user's upcoming events in their calendar.
/users/{id}/drive Получение хранилища файлов OneDrive пользователя.Gets the user's OneDrive file store.
/users/{id}/memberOf Вывод списка групп, участником которых является пользователь.Lists the groups that the user is a member of.