Тип ресурса 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 | Строка | Указывает, была ли учетная запись пользователя создана с помощью одного из следующих методов:
Только для чтения. Поддерживает $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 , NotAdult MinorNoParentalConsentRequired и 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 , ge not , le in , 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. false ), эти свойства можно задать во время создания или обновления объекта пользователя. Поддерживает $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 , le ge , 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 ), но не поддерживает другие фильтруемые свойства. Примечание. |
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, а для новой обновленной почты устанавливается основной прокси-адрес, за исключением следующих сценариев:
- Если у пользователя есть лицензия, включающая Microsoft Exchange, все прокси-адреса пользователя должны относиться к проверенному домену клиента. Все, что не относится к проверенным доменам, удаляется без предупреждения.
- Если пользователь является гостевым, а основной адрес прокси-сервера не будет установлен для почты пользователя, а основной адрес прокси-сервера содержит строку имени участника-пользователя гостевого пользователя с
#EXT#
. - Почта пользователя не будет удалена, даже если у него больше нет прокси-адресов, если пользователь является гостем.
Адреса 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"}
}
Связанные материалы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по