Тип ресурса user

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет учетную запись пользователя Microsoft Entra. Этот ресурс относится к открытому типу, который позволяет передавать другие свойства. Наследуется от directoryObject.

Ресурс пользователя позволяет приложениям указать пользовательские предпочтения для языков и форматов даты и времени для основных почтовых ящиков Exchange и профиля Microsoft Entra пользователя. Дополнительные сведения см. в разделе Пользовательские настройки языков и региональных форматов.

Чтобы повысить производительность, операции create, get и list возвращают только подмножество часто используемых свойств по умолчанию. Эти свойства по умолчанию указаны в разделе Свойства. Чтобы получить любое из свойств, не возвращенных по умолчанию, укажите их в параметре $select запроса OData.

Этот ресурс поддерживает:

• Добавление данных в пользовательские свойства в качестве расширений.
• подписку на уведомления об изменениях;
• отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).

Методы

Метод	Возвращаемый тип	Описание
Перечисление пользователей	Коллекция объектов user	Получение списка, включающего объекты user.
Создание пользователя	user	Создание объекта user.
Получение пользователя	user	Чтение свойств и связей объекта пользователя.
Обновление пользователя	user	Обновление объекта пользователя.
Удаление пользователя	Нет	Удаление объекта пользователя.
Получение дельты	Коллекция объектов user	Получение добавочных изменений для пользователей.
changePassword	Нет	Обновление собственного пароля.
Преобразование внешнего пользователя во внутреннего пользователя-члена	user	Преобразование пользователя, прошедшего внешнюю проверку подлинности, во внутреннего пользователя-члена.
invalidateAllRefreshTokens	user	Аннулирование всех маркеров обновления пользователя, выпущенных для приложений.
validatePassword	passwordValidationInformation	Проверка пароля пользователя на соответствие политике проверки паролей организации и определение действительности пароля.
Назначение ролей приложений
Перечисление appRoleAssignments	Коллекция appRoleAssignment	Получение приложений и ролей приложений, назначенных пользователю.
Список appRoleAssignedResources	Коллекция servicePrincipal	Получение приложений, которым пользователь имеет назначение роли приложения, напрямую или с помощью членства в группе.
Добавление объекта appRoleAssignment	appRoleAssignment	Назначение роли приложения пользователю.
Удаление объекта appRoleAssignment	Нет	Удаление назначения роли приложения от пользователя.
Календарь
Создание календаря	Calendar	Создание объекта Calendar путем добавления в коллекцию календарей.
Создание объекта calendarGroup	CalendarGroup	Создание объекта CalendarGroup путем записи в коллекцию групп календарей.
Создание события	event	Создание объекта event путем публикации в коллекции объектов event.
findMeetingTimes	meetingTimeSuggestionsResult	Получение времени и местоположения для собрания с учетом доступности участника, а также ограничений по местоположению или времени.
findRooms	Коллекция emailaddress.md	Получите все комнаты для собраний в клиенте пользователя или в определенном списке комнат.
findRoomLists	Коллекция emailaddress.md	Получение списка помещений, определенных в клиенте.
getSchedule	scheduleInformation	Получите сведения о доступности для коллекции пользователей, списков рассылки или ресурсов (помещений или оборудования) за указанный период.
Список календарей	Коллекция Calendar	Получение коллекции объектов Calendar.
Список объектов calendarGroup	Коллекция CalendarGroup	Получение коллекции объектов CalendarGroup.
Список calendarView	Коллекция event	Получение коллекции объектов event.
Получение списка событий	Коллекция event	Получение списка объектов event в почтовом ящике пользователя. В этом списке указаны единичные собрания и главные собрания в соответствующих рядах.
reminderView	Коллекция Reminder	Возвращает список напоминаний календаря за указанный период времени.
Контакты
Создание контакта	contact	Создание контакта путем добавления в коллекцию контактов.
Создание объекта contactFolder	contactFolder	Создание объекта contactFolder путем добавления в коллекцию папок контактов.
Список контактов	Коллекция contact	Получение коллекции контактов из папки контактов по умолчанию для выполнившего вход пользователя.
Список объектов contactFolder	Коллекция contactFolder	Получение коллекции папок контактов в папке контактов по умолчанию для вошедшего пользователя.
Объекты каталога
assignLicense	user	Добавление или удаление подписок пользователя. Вы также можете включать и отключать отдельные планы, связанные с подпиской.
exportPersonalData	Нет	Отправляет запрос на операцию политики данных, сделанный администратором компании для экспорта данных пользователя организации.
getByIds	Коллекция String	Возвращает объекты каталогов, указанные в списке идентификаторов.
checkMemberGroups	Коллекция строк	Проверка членства в списке групп. Это транзитивная проверка.
checkMemberObjects	Коллекция String	Проверка участия в списке группы, роли каталога или объектах административных единиц. Это транзитивная проверка.
getMemberGroups	Коллекция строк	Возвращает все группы, в которые входит пользователь. Это транзитивная проверка.
getMemberObjects	Коллекция строк	Возвращает все группы, роли каталога и административные единицы, в которые входит пользователь. Это транзитивная проверка.
Получение transitiveReports	Целое число	Получение количества транзитивных отчетов для пользователя из свойства навигации transitiveReports.
Перечисление createdObjects	Коллекция directoryObject	Получение объектов каталога, созданных пользователем, из свойства навигации createdObjects.
Перечисление licenseDetails	Коллекция объектов licenseDetails	Получение коллекции объектов licenseDetails.
Список ownedDevices	Коллекция directoryObject	Получите устройства, принадлежащие пользователю, из свойства навигации ownedDevices.
Список ownedObjects	Коллекция directoryObject	Получите объекты каталога, принадлежащие пользователю, из свойства навигации ownedObjects.
Список registeredDevices	Коллекция directoryObject	Получение устройств, зарегистрированных для пользователя, из свойства навигации registeredDevices.
Перечисление участий с ролью в заданной области	Коллекция scopedRoleMembership	Получение участий пользователя в административных единицах с ролью в заданной области.
Список usageRights	Коллекция usageRight	Получение коллекции прав использования, предоставленных пользователю.
reprocessLicense	user	Переработка назначенных подписок для пользователя.
revokeSignInSessions	Нет	Отменяет все маркеры обновления и сеанса пользователя, выданные приложениям, сбрасывая свойство пользователя signInSessionsValidFromDateTime до текущей даты и времени. Эта операция вынуждает пользователя снова войти в эти приложения. Этот метод заменяет метод invalidateAllRefreshTokens.
Перечисление удаленных пользователей	Коллекция directoryObject	Получение пользователей, удаленных в клиенте за последние 30 дней.
Получение удаленного пользователя	Коллекция directoryObject	Получение удаленного пользователя по идентификатору.
Восстановление удаленного пользователя	Коллекция directoryObject	Восстановление пользователя, удаленного в клиенте за последние 30 дней.
Удаление пользователя без возможности восстановления	Коллекция directoryObject	Окончательное удаление пользователя из клиента.
Drive
Получение объекта drive	drive	Получение свойств и связей ресурса Drive.
Список дочерних элементов	DriveItems	Возвращает коллекцию DriveItems в дочерних элементах ресурса DriveItem.
Группы
Перечисление объектов joinedTeams	Коллекция team	Получение команд Microsoft Teams, непосредственным участником которых является пользователь, из свойства навигации joinedTeams.
Список memberOf	Коллекция directoryObject	Получение групп, ролей каталога и административных единиц, непосредственным участником которых является пользователь. Эта операция не является транзитивной.
Перечисление transitiveMemberOf	Коллекция directoryObject	Получение групп, ролей каталогов и административных единиц, участником которых является пользователь, посредством прямого или транзитивного членства.
Аналитика
Список "Общие"	Коллекция объектов sharedInsight	Расчетные данные, возвращающие список файлов, которыми вы поделились с пользователем.
Список "Популярные"	Коллекция объектов trending	Расчетные данные, возвращающие список элементов, популярных в окружении пользователя.
Список "Использованные"	Коллекция объектов usedInsight	Расчетные данные, возвращающие список файлов, которые вы используете вместе с пользователем.
Почта
Создание объекта inferenceClassificationOverride	inferenceClassificationOverride	Создание переопределения сортировки почты для отправителя, определенного SMTP-адресом.
Создание объекта mailFolder	mailFolder	Создание объекта mailFolder путем добавления в коллекцию папок почты
Создание сообщения	message	Создание сообщения путем добавления в коллекцию сообщений.
Создание объекта messageRule	messageRule	Создает объект messageRule, определяя набор условий и действий.
getMailTips	Коллекия mailTips	Возвращение подсказок о доступности одного или нескольких получателей для вошедшего пользователя.
Список объектов mailFolder	Коллекция mailFolder	Получение коллекции папок почты в корневой папке вошедшего пользователя.
Список сообщений	Коллекция message	Получение всех сообщений в почтовом ящике вошедшего пользователя.
Список переопределений	Коллекция объектов inferenceClassificationOverride	Получение переопределений для папки "Входящие", которые пользователь настраивает для классификации сообщений от определенных отправителей определенными способами.
Список правил	Коллекция messageRule	Получение всех объектов messageRule, определенных для папки пользователя "Входящие".
Отправка почты	Нет	Отправка сообщения, указанного в теле запроса.
Примечания
Создание записной книжки	notebook	Создание записной книжки OneNote.
Список записных книжек	Коллекция объектов notebook	Получение списка объектов notebook.
Открытые расширения
Создание открытого расширения	openTypeExtension	Создание открытого расширения и добавление настраиваемых свойств в новый или существующий ресурс.
Получение открытого расширения	Коллекция объектов openTypeExtension	Получение открытого расширения, определяемого именем расширения.
Организационная иерархия
Назначение руководителя	Нет	Назначение руководителя пользователя.
Получение имени руководителя	directoryObject	Получение пользователя или контакта, являющегося руководителем пользователя, из свойства навигации manager.
Удаление диспетчера	Нет	Удалите руководителя пользователя.
Список directReports	Коллекция directoryObject	Получение пользователей и контактов, являющихся подчиненными данного пользователя, из свойства навигации directReports.
Параметры Outlook
Создание категории Outlook	outlookCategory	Создание объекта outlookCategory в основном списке категорий пользователя.
Получение supportedLanguages	Коллекция объектов localeInfo	Получение списка поддерживаемых языковых стандартов и языков, которые настроены на сервере почтовых ящиков пользователя.
Получение supportedTimeZones	Коллекция timeZoneInformation	Получение списка поддерживаемых часовых поясов, которые настроены на сервере почтовых ящиков пользователя.
Получение параметров почтового ящика пользователя	mailboxSettings	Получение объекта mailboxSettings пользователя.
Список категорий Outlook	Коллекция outlookCategory	Получение всех категорий, определенных для пользователя.
Преобразование идентификаторов Exchange	Коллекция convertIdResult	Перевод идентификаторов ресурсов, связанных с Outlook, между форматами.
Обновление параметров почтового ящика пользователя	mailboxSettings	Включение, настройка или отключение одного или нескольких mailboxSettings для пользователя.
Учетные данные единого входа на основе пароля
getPasswordSingleSignOnCredentials	коллекция passwordSingleSignOnCredentialSet	Получите список учетных данных единого входа на основе пароля для указанного пользователя. Пароли никогда не возвращаются, а вместо этого всегда возвращаются в виде пустой или пустой строки.
deletePasswordSingleSignOnCredentials	Нет	Удалите учетные данные единого входа на основе пароля для заданного субъекта-службы, связанного с заданным пользователем.
Люди
Получение списка людей	person	Получение списка объектов person, упорядоченных по их релевантности для пользователя, которая определяется его моделями общения и совместной работы, а также бизнес-отношениями.
Фотография
Получение фотографии	profilePhoto	Получение указанного объекта profilePhoto или его метаданных (свойств profilePhoto).
Обновление объекта profilephoto	Нет	Обновите фотографию любого пользователя в клиенте, включая пользователя, выполнившего вход, или указанную группу или контакт.
Удаление profilephoto	Нет	Удалите фотографию любого пользователя в клиенте, включая пользователя, выполнившего вход, или указанную группу.
Планировщик
Получение объекта plannerUser	plannerUser	Получение свойств и связей объекта plannerUser.
Список объектов favoritePlans	Коллекция объектов plannerPlan	Получение списка объектов plannerPlan, отмеченных пользователем как избранные.
Список объектов recentPlans	Коллекция объектов plannerPlan	Получение списка объектов plannerPlan, недавно просмотренных пользователем.
Перечисление задач	Коллекция plannerTask	Получает объекты plannerTask, назначенные пользователю.
Обновление plannerUser	Нет	Обновление свойств объекта plannerUser.
Профиль
Получение профиля	profile	Получение свойств и связей объекта profile для указанного пользователя.
Удаление профиля	Нет	Удаление объекта profile из учетной записи пользователя.
Расширения схемы
Добавление значений расширений для схемы	Нет	Создайте определение расширения схемы, а затем используйте его для добавления пользовательских данных в ресурс.
Спонсоров
Назначение спонсоров	Нет	Назначьте пользователя спонсором.
Список спонсоров	Коллекция directoryObject	Получение пользователей и групп, которые являются спонсорами этого пользователя.
Удаление спонсоров	Нет	Удаление спонсора пользователя.
Командная работа
Перечисление приложений, установленных для пользователя	Коллекция userScopeTeamsAppInstallation	Список приложений, установленных в личной области пользователя.
Получение приложения, установленного для пользователя	userScopeTeamsAppInstallation	Список указанных приложений, установленных в личной области пользователя.
Добавление приложения для пользователя	Нет	Добавление (установка) приложения в личную область пользователя.
Удаление приложения для пользователя	Нет	Удаление приложения из личной области пользователя.
Обновление приложения, установленного для пользователя	Нет	Обновление до последней версии приложения, установленного в личной области пользователя.
Общение в чате между пользователем и приложением	Чат	Список индивидуальных чатов между пользователем и приложением.
Общение в чате между пользователем и приложением	Чат	Список индивидуальных чатов между пользователем и приложением.
Перечисление предоставленных разрешений	Коллекция resourceSpecificPermissionGrant	Список всех предоставленных пользователемразрешений для конкретных ресурсов.
Задачи To-Do
Создание задачи	todoTask	Создание todoTask в указанном списке задач.
Создание списка задач	todoTaskList	Создание списка задач To Do в почтовом ящике пользователя.
Перечисление задач	Коллекция todoTask	Получение всех ресурсов todoTask в указанном списке.
Перечисление списков задач	Коллекция todoTaskList	Получение всех списков задач в почтовом ящике пользователя.
Параметры пользователя
Получение параметров	userSettings	Чтение объекта settings пользователя и организации.
Обновление параметров	userSettings	Обновление свойств объекта settings.
Задачи Outlook (не рекомендуется)
Создание объекта outlookTask (не рекомендуется)	outlookTask	Создание задачи Outlook в группе задач по умолчанию ("Мои задачи") и папке задач по умолчанию ("Задачи") в почтовом ящике пользователя.
Перечисление задач (не рекомендуется)	Коллекция объектов outlookTask	Получение всех задач Outlook в почтовом ящике пользователя.
Облачный ПК
Перечисление облачных ПК	Коллекция cloudPC	Перечислите устройства cloudPC, которые связаны с вошедшим пользователем.
Получение сведений о запуске	cloudPCLaunchInfo	Получите cloudPCLaunchInfo для вошедшего пользователя.

Свойства

Важно!

Определенное использование $filter и параметра запроса $search поддерживается только при применении заголовка ConsistencyLevel с присвоенным значением eventual и $count. Дополнительные сведения см. в разделе Расширенные возможности запросов к объектам каталогов.

Свойство	Тип	Описание
aboutMe	String	Поле ввода текста в свободной форме, в котором пользователи могут описать себя. Возвращается только с помощью оператора $select.
accountEnabled	Логический	Если учетная запись обеспечена — true, в противном случае — false. Это свойство обязательно указывать при создании пользователя. Поддерживает $filter (eq, ne, not и in).
ageGroup	ageGroup	Устанавливает возрастную группу пользователя. Допустимые значения: null, Minor, NotAdultи Adult. Дополнительные сведения см. в разделе Определения свойств юридической возрастной группы. Поддерживает $filter (eq, ne, not и in).
assignedLicenses	Коллекция assignedLicense	Назначенные пользователю лицензии, в том числе наследуемые (на основе групп). Это свойство не различает назначенные напрямую и унаследованные лицензии. Используйте свойство licenseAssignmentStates для идентификации непосредственно назначенных и унаследованных лицензий. Значение null не допускается. Поддерживает $filter (eq, not, /$count eq 0, /$count ne 0).
assignedPlans	Коллекция assignedPlan	Планы, назначенные пользователю. Только для чтения. Значение null не допускается. Поддерживает $filter (eq и not).
authorizationInfo	authorizationInfo	Идентификаторы, которые можно использовать для идентификации и проверки подлинности пользователя в средах, отличных от Azure AD. Это свойство может хранить идентификаторы сертификатов на основе смарт-карт, которые пользователи используют для доступа к локальная служба Active Directory развертываниям или федеративного доступа. Его также можно использовать для хранения альтернативного имени субъекта (SAN), связанного с общей карточкой доступа (CAC). Допускается значение null. Поддерживает $filter (eq и startsWith).
birthday	DateTimeOffset	День рождения пользователя. Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Возвращается только с помощью оператора $select.
businessPhones	Коллекция строк	Номера телефонов пользователя. Для этого свойства можно указать только один номер. "Только для чтения" для пользователей, которые синхронизируются с локальным каталогом. Поддерживает $filter (eq, not, ge, le, startsWith).
city	String	Город, в котором находится пользователь. Максимальная длина: 128 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
cloudRealtimeCommunicationInfo	cloudRealtimeCommunicationInfo	Информация о коммуникации в реальном времени Майкрософт, связанная с пользователем. Поддерживает $filter (eq, ne,not).
CompanyName	String	Имя компании, с которым связан пользователь. Это свойство может быть полезно для описания компании внешнего пользователя. Максимальная длина: 64 символа. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null).
consentProvidedForMinor	consentProvidedForMinor	Устанавливает, получено ли согласие для несовершеннолетних. Допустимые значения: null, Granted, Denied и NotRequired. Дополнительные сведения см. в разделе Определения свойств юридических возрастных групп. Поддерживает $filter (eq, ne, not и in).
country	String	Страна или регион, в котором находится пользователь; например, US или UK. Максимальная длина: 128 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
createdDateTime	DateTimeOffset	Дата и время создания пользователя в формате ISO 8601 и UTC. Значение не может изменяться и заполняется автоматически при создании сущности. Допускается значение null. Для локальных пользователей значение представляет момент их создания в Microsoft Entra ID. Свойство предназначено null для некоторых пользователей, созданных до июня 2018 г. и локальных пользователей, синхронизированных с Microsoft Entra ID до июня 2018 г. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in).
creationType	Строка	Указывает, была ли учетная запись пользователя создана с помощью одного из следующих методов: В качестве обычной учебной или рабочей учетной записи (null). Как внешняя учетная запись (Invitation). В качестве локальной учетной записи для клиента Azure Active Directory B2C (LocalAccount). Через самообслуживаемую регистрацию внутренним пользователем с помощью проверки электронной почты (EmailVerified). Через самообслуживаемую регистрацию внешним пользователем, регистрирующимся по ссылке, которая является частью пользовательского потока (SelfServiceSignUp). Только для чтения. Поддерживает $filter (eq, ne, not и in).
customSecurityAttributes	customSecurityAttributeValue	Открытый сложный тип, который содержит значение настраиваемого атрибута безопасности, назначенного объекту каталога. Допускается значение null. Возвращается только с помощью оператора $select. Поддерживает $filter (eq, ne, not, startsWith). Значение фильтра учитывает регистр.
deletedDateTime	DateTimeOffset	Дата и время удаления пользователя. Поддерживает $filter (eq, ne, not, ge, le и in)
department	String	Имя отдела, в котором работает пользователь. Максимальная длина: 64 символа. Поддерживает $filter (eq, ne, not, ge, le, in, eq и по null значениям).
displayName	String	Имя пользователя, отображаемое в адресной книге. Это значение обычно является сочетанием имени, отчества и фамилии пользователя. Это свойство является обязательным при создании пользователя и не может быть очищено во время обновлений. Максимальная длина: 256 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null), $orderby и $search.
employeeHireDate	DateTimeOffset	Дата и время, когда пользователь был нанят или начнет работу, если есть будущий сотрудник. Поддерживает $filter (eq, ne, not, ge, le, in).
employeeLeaveDateTime	DateTimeOffset	Дата и время, когда пользователь покинет организацию или покинет ее. Чтобы прочитать это свойство, вызывающему приложению необходимо назначить разрешение User-LifeCycleInfo.Read.All . Чтобы записать это свойство, вызывающему приложению должны быть назначены разрешения User.Read.All и User-LifeCycleInfo.ReadWrite.All . Чтобы считывать это свойство в делегированных сценариях, администратору требуется одна из следующих Microsoft Entra ролей: администратор рабочих процессов жизненного цикла, глобальный читатель или глобальный администратор. Чтобы записать это свойство в делегированных сценариях, администратору требуется роль глобального администратора . Поддерживает $filter (eq, ne, not, ge, le, in). Дополнительные сведения см. в разделе Настройка свойства employeeLeaveDateTime для пользователя.
employeeId	String	Идентификатор сотрудника, назначенный пользователю организацией. Максимальная длина составляет 16 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWithи eq для значений null).
employeeOrgData	employeeOrgData	Представляет данные организации (например, division и costCenter), связанные с пользователем. Поддерживает $filter (eq, ne, not, ge, le, in).
employeeType	String	Фиксирует тип корпоративного работника. Например, Employee, Contractor, Consultant или Vendor. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith).
externalUserConvertedOn	DateTimeOffset	Дата и время преобразования пользователя из внешнего во внутренний.
externalUserState	String	Для внешних пользователей, приглашенных в клиент с помощью API приглашений, это свойство представляет состояние приглашения пользователя. Для приглашенных пользователей значением состояния может быть PendingAcceptance или Accepted, а для всех остальных пользователей — null. Поддерживает $filter (eq, ne, not, in).
externalUserStateChangeDateTime	String	Показывает метку времени последнего изменения в свойстве externalUserState. Поддерживает $filter (eq, ne, not, in).
faxNumber	String	Номер факса пользователя. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
givenName	String	Простое имя пользователя. Максимальная длина: 64 символа. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
hireDate	DateTimeOffset	Дата найма пользователя. Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Возвращается только с помощью оператора $select. Примечание. Это свойство относится только к SharePoint Online. Рекомендуем использовать собственное свойство employeeHireDate, чтобы устанавливать и обновлять значения даты найма с помощью API Microsoft Graph.
id	String	Уникальный идентификатор пользователя. Его следует рассматривать как непрозрачный идентификатор. Наследуется от directoryObject. Значение null не допускается. Только для чтения. Поддерживает $filter (eq, ne, not, in).
identities	Коллекция objectIdentity	Представляет удостоверения, которые можно использовать для входа в учетную запись пользователя. Удостоверение может быть предоставлено корпорацией Майкрософт (также называемой локальной учетной записью), организациями или поставщиками удостоверений социальных удостоверений, такими как Facebook, Google и Майкрософт, и привязано к учетной записи пользователя. Он может содержать несколько элементов с одинаковым значением signInType . Поддерживает $filter (eq) с ограничениями.
imAddresses	Коллекция строк	Sip-адреса для пользователя, передаваемые по IP-адресам сеанса voIP. Только для чтения. Поддерживает $filter (eq, not, ge, le, startsWith).
infoCatalogs	Коллекция строк	Определяет сегменты сведений, назначенные пользователю. Поддерживает $filter (eq, not, ge, le, startsWith).
interests;	Коллекция строк	Список пользователей, описывающий их интересы. Возвращается только с помощью оператора $select.
isLicenseReconciliationNeeded	Логический	Указывает, ожидает ли пользователь назначения лицензии почтового ящика Exchange. Только для чтения. Поддерживает $filter (eq только для where true ).
isManagementRestricted	Логический	true Значение , если пользователь является членом административной единицы управления с ограниченным доступом, для управления которой требуется роль, ограниченная административной единицей. Значение по умолчанию — false. Только для чтения. Для управления пользователем, который является членом ограниченной административной единицы, вызывающему приложению должно быть назначено разрешение Directory.Write.Restricted . Для делегированных сценариев администраторам также должны быть явно назначены поддерживаемые роли в ограниченной административной единице область.
isResourceAccount	Логическое	Не используйте — зарезервировано для использования в будущем.
jobTitle;	String	Должность пользователя. Максимальная длина: 128 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
lastPasswordChangeDateTime	DateTimeOffset	Когда пользователь Microsoft Entra в последний раз изменял свой пароль или когда был создан пароль, в зависимости от даты выполнения последнего действия. Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения. Возвращается только с помощью оператора $select.
legalAgeGroupClassification	legalAgeGroupClassification	Используется корпоративными приложениями для определения юридической возрастной группы пользователя. Это свойство предназначено только для чтения. Вычисляется на основе свойств ageGroup и consentProvidedForMinor. Допустимые значения: null, MinorWithOutParentalConsent, MinorWithParentalConsent, NotAdultMinorNoParentalConsentRequiredи Adult. Дополнительные сведения см. в разделе Определения свойств юридической возрастной группы. Возвращается только на $select.
licenseAssignmentStates	Коллекция licenseAssignmentState	Состояние назначений лицензий для пользователя. Он также указывает лицензии, которые назначаются напрямую, и лицензии, унаследованные пользователем через членство в группах. Только для чтения. Возвращается только с помощью оператора $select.
почта;	String	SMTP-адрес пользователя, например admin@contoso.com. Изменения этого свойства также обновят коллекцию proxyAddresses пользователя, чтобы включить значение в качестве SMTP-адреса. Это свойство не может содержать знаки акцента. ПРИМЕЧАНИЕ: Не рекомендуется обновлять это свойство для Azure AD профилей пользователей B2C. Вместо этого используйте свойство otherMails. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith, endsWith и eq для значений null).
mailboxSettings	mailboxSettings	Параметры основного почтового ящика вошедшего пользователя. Вы можете получить или обновить параметры языкового стандарта, часового пояса, отправки автоматических ответов на входящие сообщения. Дополнительные сведения см. в разделе Пользовательские настройки языков и региональных форматов. Возвращается только с помощью оператора $select.
mailNickname	String	Почтовый псевдоним для пользователя. Это свойство должно быть указано при создании пользователя. Максимальная длина: 64 символа. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
mobilePhone	String	Основной сотовый телефон пользователя. Доступ только для чтения для пользователей, синхронизированных из локального каталога. Поддерживает $filter (eq, , ne, genot, lein, startsWithи eq для значенийnull) и $search.
mySite	String	URL-адрес сайта пользователя. Возвращается только с помощью оператора $select.
officeLocation	String	Расположение офиса на месте работы пользователя. Максимальная длина: 128 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
onPremisesDistinguishedName	String	Содержит параметры локальной службы Active Directory distinguished name или DN. Свойство заполняется только для клиентов, синхронизирующих локальный каталог с Microsoft Entra ID через Microsoft Entra Connect. Только для чтения.
onPremisesDomainName	String	Содержит локальный параметр domainFQDN, также называемый dnsDomainName, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих локальный каталог с Microsoft Entra ID через Microsoft Entra Connect. Только для чтения.
onPremisesExtensionAttributes	onPremisesExtensionAttributes	Содержит extensionAttributes1-15 для пользователя. Эти атрибуты расширения также называются настраиваемыми атрибутами 1–15 Exchange. Для пользователей onPremisesSyncEnabled исходным центром управления для этого набора свойств является локальная среда, и он предназначен только для чтения. Для пользователя только в облаке (где параметр onPremisesSyncEnabled имеет значение false), эти свойства можно задать во время создания или обновления объекта пользователя. Для исключительно облачных пользователей, ранее синхронизированных из локальной службы Active Directory, эти свойства предназначены только для чтения в Microsoft Graph, но могут быть полностью управляемыми с помощью Центра администрирования Exchange или модуля Exchange Online версии 2 в Windows PowerShell. Поддерживает $filter (eq, ne, not, in).
onPremisesImmutableId	String	Это свойство связывает учетную запись пользователя локальная служба Active Directory с объектом пользователя Microsoft Entra. Это свойство должно быть указано при создании новой учетной записи пользователя в Graph, если вы используете федеративный домен для свойства пользователя userPrincipalName (UPN). Примечание: Символы $ и _ нельзя использовать при указании этого свойства. Поддерживает $filter (eq, ne, not, ge, le, in).
onPremisesLastSyncDateTime	DateTimeOffset	Указывает время последней синхронизации объекта с локальным каталогом, например: "2013-02-16T03:04:54Z". Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors	Коллекция onPremisesProvisioningError	Ошибки при использовании продукта синхронизации Майкрософт во время подготовки. Поддерживает $filter (eq, not, ge, le).
onPremisesSamAccountName	String	Содержит локальный параметр sAMAccountName, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих локальный каталог с Microsoft Entra ID через Microsoft Entra Connect. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith).
onPremisesSecurityIdentifier	String	Содержит локальный идентификатор безопасности (SID) для пользователя, синхронизированного из локальной среды в облако. Только для чтения. Поддерживает $filter (eq в том числе null значений).
onPremisesSipInfo	onPremisesSipInfo	Содержит все локальные сведения по протоколу SIP, связанные с пользователем. Только для чтения.
onPremisesSyncEnabled	Логический	trueЗначение , если этот объект пользователя в настоящее время синхронизируется из локальная служба Active Directory (AD); в противном случае пользователь не синхронизируется и может управляться в Microsoft Entra ID. Только для чтения. Поддерживает $filter (eq, ne, not, in и eq для значений null).
onPremisesUserPrincipalName	String	Содержит локальный параметр userPrincipalName, синхронизированный из локального каталога. Свойство заполняется только для клиентов, синхронизирующих локальный каталог с Microsoft Entra ID через Microsoft Entra Connect. Только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith).
otherMails	Коллекция строк	Список дополнительных адресов электронной почты для пользователя. Например: ["bob@contoso.com", "Robert@fabrikam.com"]. ПРИМЕЧАНИЕ. Это свойство не может содержать знаки акцента. Поддерживает $filter (eq, , not, lege, in, startsWith, endsWith, /$count eq 0, ). /$count ne 0
passwordPolicies	String	Задает политики паролей для пользователя. Это свойство представляет собой перечисление с возможным значением DisableStrongPassword. Оно позволяет использовать менее надежные пароли, чем предусмотрено политикой по умолчанию. Вы также можете указать значение DisablePasswordExpiration. Два значения можно указать одновременно. Пример: DisablePasswordExpiration, DisableStrongPassword. Дополнительные сведения о политиках паролей по умолчанию см. в разделе политики паролей Microsoft Entra. Поддерживает $filter (ne, not и eq по null значениям).
passwordProfile	passwordProfile	Задает профиль пароля для пользователя. Профиль содержит пароль пользователя. Это свойство обязательно указывать при создании пользователя. Пароль в профиле должен соответствовать минимальным требованиям, указанным в свойстве passwordPolicies. По умолчанию требуется надежный пароль. Поддерживает $filter (eq, ne, not, in и eq для значений null).
pastProjects	Коллекция строк	Список для пользователей для перечисления своих прошлых проектов. Возвращается только с помощью оператора $select.
postalCode	String	Почтовый индекс адреса пользователя. Формат почтового индекса зависит от страны или региона пользователя. В США для этого атрибута используется ZIP-код. Максимальная длина: 40 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null).
preferredDataLocation	String	Предпочитаемое расположение данных для пользователя. Дополнительные сведения см. в статье OneDrive Online с поддержкой нескольких регионов.
preferredLanguage	String	Предпочитаемый язык для пользователя. Предпочтительный формат языка основан на RFC 4646. Имя объединяет двухбуквенный код языка и региональных параметров ISO 639, связанный с языком, и двухбуквенный код субкультуры ISO 3166, связанный со страной или регионом. Пример: "en-US" или "es-ES". Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
preferredName	String	Предпочитаемое имя пользователя. Не поддерживается. Этот атрибут возвращает пустую строку. Возвращается только с помощью оператора $select.
provisionedPlans	Коллекция provisionedPlan	Планы, подготовленные для пользователя. Только для чтения. Значение null не допускается. Поддерживает $filter (eq, not, ge, le).
proxyAddresses	Коллекция String	Пример: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Изменения в свойстве mail также обновят эту коллекцию, включив значение в качестве SMTP-адреса. Дополнительные сведения см. в разделе Свойства mail и proxyAddresses. Адрес прокси-сервера с SMTP префиксом (с прописной буквой) является основным прокси-адресом, а адрес прокси-сервера с smtp префиксом — вторичными адресами прокси-сервера. Для Azure AD учетных записей B2C это свойство имеет ограничение в 10 уникальных адресов. Доступно только для чтения в Microsoft Graph. Обновить это свойство можно только с помощью Центра администрирования Microsoft 365. Значение null не допускается. Поддерживает $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).
refreshTokensValidFromDateTime	DateTimeOffset	Все маркеры обновления или маркеры сеансов (файлы cookie сеанса), выданные до этого времени, недопустимы, а приложения получают ошибку при использовании недопустимого маркера обновления или сеансов для получения маркера делегированного доступа (для доступа к API, таким как Microsoft Graph). В этом случае приложение должно получить новый маркер обновления, запросив авторизованную конечную точку. Только для чтения. Сброс можно выполнить с помощью invalidateAllRefreshTokens.
responsibilities	Коллекция строк	Список обязанностей пользователя. Возвращается только с помощью оператора $select.
schools	Коллекция строк	Список учебных заведений, которые посещал пользователь. Возвращается только с помощью оператора $select.
securityIdentifier	String	Идентификатор безопасности (SID) пользователя, используемый в сценариях Windows. Только для чтения. Возвращается по умолчанию. Поддерживает $select и $filter(eq, not, ge, le, startsWith).
serviceProvisioningErrors	serviceProvisioningError collection	Ошибки, опубликованные федеративной службой, описывающие нетрансляционную ошибку службы в отношении свойств или ссылки из пользовательского объекта.
showInAddressList	Логический	Не используйте в Microsoft Graph. Вместо этого управляйте этим свойством с помощью Центр администрирования Microsoft 365. Указывает, должен ли пользователь быть включен в общую адресную книгу Outlook. См. сведения об известной проблеме.
signInSessionsValidFromDateTime	DateTimeOffset	Все маркеры обновления или маркеры сеансов (файлы cookie сеанса), выданные до этого времени, недопустимы, а приложения получают ошибку при использовании недопустимого маркера обновления или сеансов для получения маркера делегированного доступа (для доступа к API, таким как Microsoft Graph). В этом случае приложение должно получить новый маркер обновления, запросив авторизованную конечную точку. Только для чтения. Сброс можно выполнить с помощью revokeSignInSessions.
skills	Коллекция строк	Список навыков пользователя. Возвращается только с помощью оператора $select.
signInActivity	signInActivity	Получение последней даты входа в систему и идентификатора запроса на вход для указанного пользователя. Только для чтения. Возвращается только с помощью оператора $select. Поддерживает $filter (eq, ne, not, ge, le), но не поддерживает другие фильтруемые свойства. Примечание. Для сведений об этом свойстве требуется лицензия Microsoft Entra ID P1 или P2 и разрешение AuditLog.Read.All. Это свойство не возвращается пользователю, который никогда не входил в систему или входил последний раз до апреля 2020 года.
state	String	Область, республика, край или округ в адресе пользователя. Максимальная длина: 128 символов. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
streetAddress	String	Почтовый адрес места работы пользователя. Максимальная длина: 1024 символа. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
surname	String	Фамилия пользователя. Максимальная длина: 64 символа. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq по null значениям).
usageLocation	String	Двухбуквенный код страны (по стандарту ISO 3166). Требуется для пользователей, которым назначены лицензии в соответствии с юридическими требованиями к проверка для доступности служб в странах. Примеры: US, JP и GB. Значение null не допускается. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null).
userPrincipalName	String	Имя участника-пользователя. Имя участника-пользователя — это имя для входа в интернет-стиле для пользователя, основанное на стандарте Интернета RFC 822. В соответствии с соглашением оно должно указывать на имя пользователя для электронной почты. Общий формат — alias@domain, где домен должен присутствовать в проверенной коллекции доменов клиента. Это свойство обязательно указывать при создании пользователя. Доступ к проверенным доменам клиента можно получить с помощью свойства verifiedDomains объекта organization. ПРИМЕЧАНИЕ. Это свойство не может содержать знаки акцента. Разрешены только следующие символы: A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Полный список разрешенных символов см. в политиках имен пользователей. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith, endsWith) и $orderby.
userType	String	Строковое значение, которое можно использовать для классификации типов пользователей в каталоге. Возможные значения: Member и Guest. Поддерживает $filter (eq, ne, not, in и eq для значений null). ПРИМЕЧАНИЕ: Дополнительные сведения о разрешениях для участников и гостевых пользователей см. в статье Какие разрешения пользователей по умолчанию в Microsoft Entra ID?

Совет

Расширения каталогов и связанные данные возвращаются по умолчанию; Расширения схемы и связанные данные возвращаются только в $select; а открытые расширения и связанные данные возвращаются только в $expand.

свойства mail и proxyAddresses

mail и proxyAddresses — это свойства, связанные с электронной почтой. proxyAddresses — это коллекция адресов, относящихся только к серверу Microsoft Exchange. Это свойство используется для хранения списка привязанных к одному почтовому ящику почтовых адресов пользователя. Свойство mail используется в качестве адреса электронной почты пользователя для различных целей, включая вход пользователя, и определяет основной прокси-адрес.

Mail и proxyAddresses можно получить с помощью API пользователя GET . Вы можете обновить почту с помощью API обновления пользователя , но не можете обновить proxyAddresses через Microsoft Graph. При обновлении почтового свойства пользователя активируется пересчет proxyAddresses, а для новой обновленной почты устанавливается основной прокси-адрес, за исключением следующих сценариев:

1. Если у пользователя есть лицензия, включающая Microsoft Exchange, все прокси-адреса пользователя должны относиться к проверенному домену клиента. Все, что не относится к проверенным доменам, удаляется без предупреждения.
2. Если пользователь является гостевым, а основной адрес прокси-сервера не будет установлен для почты пользователя, а основной адрес прокси-сервера содержит строку имени участника-пользователя гостевого пользователя с #EXT#.
3. Почта пользователя не будет удалена, даже если у него больше нет прокси-адресов, если пользователь является гостем.

Адреса proxyAddresses уникальны для объектов каталогов (пользователей, групп и контактов организации). Если почтовое свойство пользователя конфликтует с одним из proxyAddresses другого объекта, попытка обновить почту завершается ошибкой, и свойство proxyAddresses также не будет обновлено.

Пользовательские настройки языков и региональных форматов

Ресурс пользователя содержит свойство mailboxSettings , включающее предпочитаемый язык пользователя, форматирование даты и времени, часовой пояс по умолчанию и другие параметры, специально для основного почтового ящика Exchange. Эти параметры предназначены для почтовых клиентов и доступны только в том случае, если у пользователя подготовлен почтовый ящик. MailboxSettings можно использовать, если в вашем сценарии основное внимание уделяется только почте, календарю, контактам или задачам задач Outlook.

В дополнение к mailboxSettings ресурс user включает связь посредством userSettings с regionalAndLanguageSettings — надмножеством настроек языка и регионального формата, которые могут использоваться любым приложением, чтобы предоставить пользователю оптимальный языковой и региональный интерфейс. Используйте userSettings для согласованного взаимодействия с приложениями, которые используют профиль пользователя Microsoft Entra, чтобы отразить те же предпочтения пользователей.

Определения свойств юридических возрастных групп

В этом разделе объясняется, как три свойства возрастной группы (legalAgeGroupClassification, ageGroup и consentProvidedForMinor) используются администраторами Microsoft Entra и разработчиками корпоративных приложений в соответствии с возрастными правилами:

• Свойство legalAgeGroupClassification доступно только для чтения. Разработчики корпоративных приложений используют его, чтобы обеспечить правильную обработку пользователя в зависимости от его возрастной группы. Он вычисляется на основе свойств ageGroup и consentProvidedForMinor пользователя.
• ageGroup и consentProvidedForMinor — это необязательные свойства, используемые администраторами Microsoft Entra, чтобы обеспечить правильную обработку использования учетной записи на основе возрастных нормативных правил, регулирующих страну или регион пользователя.

Например, Кэмерон является администратором каталога начальной школы в Холипорте в Соединенном Королевстве. В начале учебного года он использует документы о приеме для получения согласия от родителей несовершеннолетнего на основе возрастных правил Соединенного Королевства. Согласие, полученное от родителя, позволяет использовать учетную запись несовершеннолетнего в приложениях Holyport School и Майкрософт. После этого Кэмерон создает все учетные записи и присваивает свойству ageGroup значение minor, а свойству consentProvidedForMinor значение granted. Затем приложения, используемые его учащимися, могут подавлять функции, которые не подходят для несовершеннолетних.

значения legalAgeGroupClassification

Member	Описание
null	Значение по умолчанию. Пользователю не присвоено свойство ageGroup.
MinorWithoutParentalConsent	(Зарезервировано для последующего использования)
MinorWithParentalConsent	Пользователь считается несовершеннолетним в соответствии с возрастными правилами страны или региона, и администратор учетной записи получил соответствующее согласие от родителя или опекуна.
Adult	Пользователь считается взрослым в соответствии с возрастными правилами страны или региона.
NotAdult	Пользователь из страны или региона, в которых есть дополнительные возрастные правила (например, США, Соединенное Королевство, Европейский союз или Южная Корея), а возраст пользователя — от несовершеннолетнего до совершеннолетия (как указано в зависимости от страны или региона). Обычно это означает, что в странах с регулированием подростки относятся к категории notAdult.
MinorNoParentalConsentRequired	Пользователь является несовершеннолетним, но находится в стране без нормативных требований, связанных с возрастом.

значения ageGroup

Member	Описание
null	Значение по умолчанию. Пользователю не присвоено свойство ageGroup.
Незначительное	Пользователь считается несовершеннолетним.
NotAdult	Пользователь из страны, в которую действуют нормативные акты США, Соединенном Королевстве, Европейском союзе или Южной Корее), а возраст пользователя превышает верхнюю границу возраста ребенка (в соответствии с страной) и ниже нижнего предела возраста взрослого (как указано в зависимости от страны или региона). По существу, в странах с регулированием подростки относятся к категории notAdult.
Adult	Пользователь должен считаться взрослым.

значения consentProvidedForMinor

Member	Описание
null	Значение по умолчанию. Пользователю не присвоено свойство consentProvidedForMinor.
Granted	Для пользователя получено согласие на наличие учетной записи.
Denied	Согласие на наличие учетной записи у пользователя не получено.
NotRequired	Пользователь находится в расположении, которое не требует согласия.

Связи

Связь	Тип	Описание
activities	Коллекция userActivity	Действия пользователя на разных устройствах. Только для чтения. Допускается значение null.
agreementAcceptances	Коллекция agreementAcceptance	Состояния принятия пользователем условий использования. Только для чтения. Допускается значение null.
appRoleAssignments	Коллекция appRoleAssignment	Представляет роли приложения, предоставленные пользователю для приложения. Поддерживает $expand.
authentication	authentication	Методы проверки подлинности, которые поддерживаются для пользователя.
calendar	calendar	Основной календарь пользователя. Только для чтения.
calendarGroups	Коллекция calendarGroup	Группы календарей пользователя. Только для чтения. Допускается значение null.
calendarView	Коллекция event	Представление календаря. Только для чтения. Допускается значение null.
calendars	Коллекция calendar	Календари пользователя. Только для чтения. Допускается значение null.
contactFolders	Коллекция contactFolder	Папки контактов пользователя. Только для чтения. Допускается значение null.
contacts	Коллекция contact	Контакты пользователя. Только для чтения. Допускается значение null.
createdObjects	Коллекция directoryObject	Объекты каталога, созданные пользователем. Только для чтения. Допускается значение null.
directReports	Коллекция directoryObject	Пользователи и контакты, являющиеся подчиненными пользователя (пользователи и контакты, у которых в свойстве manager указан этот пользователь). (Пользователи и контакты со свойством руководителя, которым присвоено значение этого пользователя.) Только для чтения. Допускается значение null. Поддерживает $expand.
drive	drive	Хранилище OneDrive пользователя. Только для чтения.
drives	Коллекция drive	Коллекция дисков, доступных для этого пользователя. Только для чтения.
events	Коллекция event	События пользователя. По умолчанию события отображаются в календаре по умолчанию. Только для чтения. Допускается значение null.
extensions	Коллекция extension	Коллекция открытых расширений, определенных для пользователя. Поддерживает $expand. Допускается значение null.
inferenceClassification	inferenceClassification	Классификация релевантности сообщений пользователя на основе явных обозначений, которые переопределяют выводимые релевантность или важность.
insights	itemInsights	Только для чтения. Допускается значение null.
joinedGroups	Коллекция group	Только для чтения. Допускается значение null.
mailFolders	Коллекция mailFolder	Почтовые папки пользователя. Только для чтения. Допускается значение null.
manager	directoryObject	Пользователь или контакт, являющийся руководителем пользователя. Только для чтения. Поддерживает $expand.
memberOf	Коллекция directoryObject	Группы, роли каталога и административные единицы, членом которыми является пользователь. Только для чтения. Допускается значение null. Поддерживает $expand.
joinedTeams	Коллекция team	Команды Microsoft Teams, в которые входит пользователь. Только для чтения. Допускается значение null.
messages	Коллекция message	Сообщения в почтовом ящике или папке. Только для чтения. Допускается значение null.
onenote	onenote	Только для чтения.
onlineMeetings	Коллекция onlineMeeting	Сведения о собрании, включая URL-адрес, используемый для присоединения к собранию, список участников и описание.
outlook	outlookUser	Выборочные службы Outlook, доступные пользователю. Только для чтения. Допускается значение null.
ownedDevices	Коллекция directoryObject	Устройства, принадлежащие пользователю. Только для чтения. Допускается значение null. Поддерживает $expand.
ownedObjects	Коллекция directoryObject	Объекты каталога, принадлежащие пользователю. Только для чтения. Допускается значение null. Поддерживает $expand, $select вложенные в $expand, и $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
pendingAccessReviewInstances	коллекция accessReviewInstance	Свойство навигации для получения списка проверок доступа, ожидающих утверждения рецензентом.
people	Коллекция person	Только для чтения. Наиболее релевантные люди для пользователя. Коллекция упорядочена по их релевантности для пользователя, что определяется взаимодействием, совместной работой и деловыми отношениями пользователя. Пользователь объединяет информацию из почты, контактов и социальных сетей.
permissionGrants	Коллекция resourceSpecificPermissionGrant	Список всех предоставленных пользователем разрешений для конкретных ресурсов.
photo;	profilePhoto	Фотография профиля пользователя. Только для чтения.
photos	Коллекция объектов profilePhoto	Коллекция фотографий профиля пользователя разных размеров. Только для чтения.
planner	plannerUser	Выборочные службы Планировщика, доступные пользователю. Только для чтения. Допускается значение null.
profile	profile	Представляет свойства, описывающие пользователей в клиенте.
registeredDevices	Коллекция directoryObject	Устройства, зарегистрированные для пользователя. Только для чтения. Допускается значение null. Поддерживает $expand и возвращает до 100 объектов.
scopedRoleMemberOf	Коллекция scopedRoleMembership	Участие пользователя в административных единицах с ролью в заданной области. Только для чтения. Допускается значение null.
Безопасности	Безопасности	Допускается значение null.
settings	userSettings	Только для чтения. Допускается значение null.
Спонсоров	Коллекция directoryObject	Пользователи и группы, отвечающие за привилегии этого гостевого пользователя в клиенте, сохраняют информацию и доступ гостевого пользователя в актуальном состоянии. (Методы HTTP: GET, POST, DELETE.). Поддерживает $expand.
teamwork	userTeamwork	Контейнер для функций Microsoft Teams, доступных пользователю. Только для чтения. Допускается значение null.
todo	todo	Представляет службы To Do, доступные пользователю.
transitiveMemberOf	Коллекция directoryObject	Группы, включая вложенные группы и роли каталога, членом которых является пользователь. Допускается значение null.
transitiveReports	Коллекция directoryObject	Транзитивные отчеты для пользователя. Только для чтения.
usageRights	Коллекция usageRight	Представляет права использования, предоставленные пользователю.

Представление JSON

Ниже указано представление ресурса в формате JSON.

{
  "aboutMe": "String",
  "accountEnabled": true,
  "ageGroup": "String",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "authorizationInfo": {
    "@odata.type": "microsoft.graph.authorizationInfo"
  },
  "birthday": "String (timestamp)",
  "businessPhones": ["String"],
  "city": "String",
  "cloudRealtimeCommunicationInfo": {
    "@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo"
  },
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "2019-02-07T21:53:13.067Z",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "deletedDateTime": "String (timestamp)",
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "employeeLeaveDateTime": "String (timestamp)",
  "employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
  "employeeType": "String",
  "externalUserConvertedOn": "String (timestamp)",
  "externalUserState": "PendingAcceptance",
  "externalUserStateChangeDateTime": "2018-11-12T01:13:13Z",
  "faxNumber": "String",
  "givenName": "String",
  "hireDate": "String (timestamp)",
  "id": "String (identifier)",
  "identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
  "interests": ["String"],
  "isLicenseReconciliationNeeded": false,
  "isResourceAccount": false,
  "jobTitle": "String",
  "legalAgeGroupClassification": "String",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "mail": "String",
  "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
  "mailNickname": "String",
  "mobilePhone": "String",
  "mySite": "String",
  "officeLocation": "String",
  "onPremisesDistinguishedName": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSipInfo": {
    "@odata.type": "microsoft.graph.onPremisesSipInfo"
  },
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "String",
  "otherMails": ["String"],
  "passwordPolicies": "String",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "pastProjects": ["String"],
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "preferredName": "String",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["String"],
  "refreshTokensValidFromDateTime": "2019-02-07T21:53:13.084Z",
  "responsibilities": ["String"],
  "schools": ["String"],
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
  "showInAddressList": true,
  "signInSessionsValidFromDateTime": "2019-02-07T21:53:13.084Z",
  "skills": ["String"],
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",
  "calendar": {"@odata.type": "microsoft.graph.calendar"},
  "calendarGroups": [{"@odata.type": "microsoft.graph.calendarGroup"}],
  "calendarView": [{"@odata.type": "microsoft.graph.event"}],
  "calendars": [{"@odata.type": "microsoft.graph.calendar"}],
  "contacts": [{"@odata.type": "microsoft.graph.contact"}],
  "contactFolders": [{"@odata.type": "microsoft.graph.contactFolder"}],
  "createdObjects": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "directReports": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "drive": {"@odata.type": "microsoft.graph.drive"},
  "drives": [{"@odata.type": "microsoft.graph.drive"}],
  "insights": {"@odata.type": "microsoft.graph.itemInsights"},
  "settings": {"@odata.type": "microsoft.graph.userSettings"},
  "events": [{"@odata.type": "microsoft.graph.event"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "inferenceClassification": {"@odata.type": "microsoft.graph.inferenceClassification"},
  "mailFolders": [{"@odata.type": "microsoft.graph.mailFolder"}],
  "manager": {"@odata.type": "microsoft.graph.directoryObject"},
  "memberOf": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "joinedTeams": [{"@odata.type": "microsoft.graph.group"}],
  "teamwork": {"@odata.type": "microsoft.graph.teamwork"},
  "messages": [{ "@odata.type": "microsoft.graph.message"}],
  "outlook": {"@odata.type": "microsoft.graph.outlookUser"},
  "ownedDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "photo": {"@odata.type": "microsoft.graph.profilePhoto"},
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "profile": {"@odata.type": "microsoft.graph.profile"},
  "registeredDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"}
}

Связанные материалы

• Добавление пользовательских данных в ресурсы с помощью расширений
• Добавление пользовательских данных в ресурсы user с помощью открытых расширений
• Добавление пользовательских данных в группы с помощью расширений схемы