Новые возможности Microsoft Graph

Microsoft Graph предоставляет унифицированную модель программирования, которую можно использовать для доступа к данным в Microsoft 365, Windows и Enterprise Mobility + Security. В этой статье содержатся сведения о новых возможностях API Microsoft Graph, документации, пакетов SDK и т. д.

Более подробные обновления на уровне API см. в журнале изменений API Microsoft Graph.

Дополнительные сведения о предыдущих обновлениях Microsoft Graph см. в статье Новый журнал Microsoft Graph.

Важно!

Функции в состоянии предварительной версии могут быть изменены без уведомления и не могут быть повышены до общедоступного (общедоступного) состояния. Не используйте предварительные версии функций в рабочих приложениях.

Июнь 2026 г.: новые возможности только в предварительной версии

Хранилище резервных копий

Используйте новые API полного резервного копирования рабочей нагрузки для защиты всех рабочих нагрузок Microsoft 365 (SharePoint Online, OneDrive для работы или учебы и Exchange Online) с минимальными административными издержками. Вместо того, чтобы вручную выбирать каждый элемент для защиты, можно создать политику защиты, которая создает резервную копию всех данных в рабочей нагрузке, а затем указывает только элементы, которые следует исключить из резервной копии. Дополнительные сведения см. в разделах exclusionUnitBase и exclusionUnitBulkAdditionJob.

Май 2026 г.: новые и общедоступные

Agents

  • Добавлены тип ресурса agentUser и связанные методы для управления жизненным циклом удостоверений пользователей агента.
  • Добавлены ресурсы verifiedIdProfile и связанная конфигурация профиля для настройки проверенного идентификатора Microsoft Entra.

Файлы

Используйте API разрешений Upsert для создания или обновления до 10 объектов разрешений в файлеStorageContainer в одном запросе .

Группы

В конечную точку версии 1.0 добавлен тип ресурса ownerlessGroupPolicy и связанные методы. Используйте эту политику для настройки уведомлений электронной почты с действиями, которые побуждают активных участников групп Microsoft 365 принять право собственности, когда единственный владелец покидает организацию или его учетная запись отключена.

Удостоверение и доступ | Управление каталогом

Используйте тип ресурса deviceRegistrationPolicy и связанные с ним методы для управления политикой, которая управляет ограничениями квот на регистрацию устройств, дополнительной проверкой подлинности и политиками авторизации для клиента Microsoft Entra.

Удостоверение и доступ | Удостоверение и вход в систему

  • Добавлены типы ресурсов onVerifiedIdClaimValidationCustomExtension и onVerifiedIdClaimValidationListener и связанные с ними методы для поддержки пользовательской логики для проверки утверждений из презентаций учетных данных проверенного идентификатора во время потоков проверки подлинности с помощью настраиваемых расширений проверки подлинности Microsoft Entra во внешнем идентификаторе.
  • Добавлены возможности проверки утверждений и проверки соответствия для профилей проверенных идентификаторов, что обеспечивает более надежную проверку утверждений и более гибкое сопоставление.
  • Улучшен тип ресурса x509CertificateAuthenticationMethodConfiguration с помощью следующих возможностей проверки подлинности на основе сертификатов (CBA):
    • Определение области CBA до определенных центров сертификации и ограничение групп пользователей, которые могут проходить проверку подлинности с помощью сертификатов из этих центров сертификации.
    • Управление отправкой клиенту указаний издателя для фильтрации сертификатов, отображаемых в элементе выбора сертификатов.
  • Обновлено свойство targetedAuthenticationMethod ресурса authenticationMethodsRegistrationCampaignIncludeTarget для поддержки Fido2microsoftAuthenticator кампаний регистрации методов проверки подлинности. Теперь организации могут использовать кампании регистрации, чтобы подталкивать пользователей к регистрации и входу с помощью ключей доступа, устойчивых к фишингу (FIDO2).

Импорт и экспорт почтового ящика

Используйте API импорта и экспорта почтовых ящиков в Microsoft Graph для создания решений, которые интегрируются с ресурсами почтовых ящиков для сценариев импорта и экспорта данных. Дополнительные сведения см. в статье Обзор API импорта и экспорта почтовых ящиков в Microsoft Graph.

Безопасность | Оповещения и инциденты

Командная работа и коммуникации | Обмена сообщениями

Командная работа и коммуникации | Смены

Поддерживает дополнительные цвета темы в перечислении scheduleEntityTheme для свойства темыв openShiftItem, shiftItem, shiftActivity и timeOffItem.

Май 2026 г.: новые возможности только в предварительной версии

Управление устройствами и приложениями | Облачный компьютер

Файлы

Используйте API разрешений Upsert для создания или обновления до 10 объектов разрешений в файлеStorageContainer в одном запросе .

Удостоверение и доступ | Управление

Добавлены ресурсы approverDelegate и identityGovernanceUserSettings , позволяющие пользователям делегировать свои обязанности по утверждению пакетов доступа и проверкам доступа.

Удостоверение и доступ | Удостоверение и вход в систему

  • Добавлены описательные свойства blueprintId и source agent-descriptive для ресурсов agentRiskDetection и riskyAgent .
  • Добавлены типы ресурсов onVerifiedIdClaimValidationCustomExtension и onVerifiedIdClaimValidationListener и связанные с ними методы для поддержки пользовательской логики для проверки утверждений из презентаций учетных данных проверенного идентификатора во время потоков проверки подлинности с помощью настраиваемых расширений проверки подлинности Microsoft Entra во внешнем идентификаторе.
  • Добавлена поддержка политик доступа между клиентами Microsoft 365, которые позволяют администраторам управлять доступом к ресурсам и данным Microsoft 365 при совместной работе с внешними организациями. Используйте ресурсы crossTenantAccessPolicyConfigurationDefault и crossTenantAccessPolicyConfigurationPartner с новым отношением m365Capabilities для управления возможностями, включая общий доступ к профилям, общий доступ к календарю, миграцию, подсказки по почте и резервирование мест через границы организации.
  • Обновлено свойство targetedAuthenticationMethod ресурса authenticationMethodsRegistrationCampaignIncludeTarget для поддержки Fido2microsoftAuthenticator кампаний регистрации методов проверки подлинности. Теперь организации могут использовать кампании регистрации, чтобы подталкивать пользователей к регистрации и входу с помощью ключей доступа, устойчивых к фишингу (FIDO2).

Аналитика людей и рабочих мест | Параметры администратора пользователей

Используйте свойство isVisible в profileCardProperty , чтобы указать, должно ли указанное свойство каталога отображаться на карточке профиля пользователя.

Аналитика людей и рабочих мест | Параметры обновления фотографий

Используйте методы List и Update в качестве единственных операций для photoUpdateSettings для получения и обновления свойств photoUpdateSettings .

Отчеты | Отчеты об удостоверениях и доступе

Добавлен тип ресурса identityCorrelation и связанные методы для просмотра отчетов о корреляции удостоверений между локальными каталогами и идентификатором Microsoft Entra.

Безопасность | Оповещения и инциденты

Используйте следующие новые ресурсы, расширяющие базовый тип alertEvidence , чтобы предоставить подробный контекст о различных артефактах, участвующих в оповещениях системы безопасности:

Безопасность | Безопасность данных и соответствие требованиям

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

Командная работа и коммуникации | Приложения

Используйте свойство scopeInfo в teamsAppInstallation , чтобы получить сведения о области, в которой установлено приложение.

Командная работа и коммуникации | Обмена сообщениями

Добавлена поддержка связи элементов ресурса teamworkSection для $expand получения раздела вместе с его элементами в одном запросе.

Командная работа и коммуникации | Звонки и собрания по сети

  • Используйте ресурс virtualEventTownhallRegistrationConfigurationConfiguration для управления доступом участников для ратуш и обеспечения более контролируемого масштабируемого управления аудиторией.
  • Добавлено свойство для ратуши capacityвиртуальных событий. Это свойство позволяет клиентам указать ожидаемый размер участника при создании или обновлении ратуши или сеанса и получить его позже. Проверка гарантирует соответствие SKU и ограничениям лицензирования, возвращая практические ошибки при превышении емкости.

Апрель 2026 г.: новые и общедоступные

Приложения

Хранилище резервных копий

  • При отключении политики защиты действие резервного копирования немедленно прекращается, новые резервные копии не создаются, а защищенные ресурсы больше не покрываются политикой. Все резервные копии, сделанные до деактивации, сохраняются в соответствии с политикой хранения, после чего они отключаются. Вы можете восстановить данные с помощью предыдущих точек восстановления даже после деактивации.
  • Политику защиты можно удалить только после ее деактивации. При удалении политики удаляются все связанные блоки защиты, а защита резервных копий останавливается для ресурсов, ранее охваченных политикой. Существующие данные резервной копии сохраняются в соответствии с политикой хранения, прежде чем они будут отключены. Вы можете восстановить данные с помощью предыдущих точек восстановления даже после удаления.
  • Используйте сеансы обзора для просмотра резервных копии данных OneDriveForBusiness и SharePoint в определенный момент времени. Создайте oneDriveForBusinessBrowseSession или sharePointBrowseSession, а затем вызовите метод browse для изучения резервного копирования содержимого.
  • Используйте детализированные артефакты восстановления для точного восстановления отдельных элементов. Вывод списка объектов granularDriveRestoreArtifact из oneDriveForBusinessRestoreSession или список объектов granularSiteRestoreArtifact из sharePointRestoreSession.

Файлы

Удостоверение и доступ | Управление

Используйте approverRemove в качестве нового поддерживаемого значения для свойства requestType ресурса accessPackageAssignmentRequest . Дополнительные сведения см. в разделе accessPackageAssignmentRequest.

Удостоверение и доступ | Удостоверение и вход в систему

  • Добавлен тип ресурса verifiableCredentialsAuthenticationMethodConfiguration и связанные методы к конечной точке версии 1.0. Используйте его для настройки проверяемых учетных данных в качестве метода проверки подлинности для входа пользователя.
  • Добавлен тип ресурса verifiableCredentialAuthenticationMethodTarget для конечной точки версии 1.0. Используйте его, чтобы указать группы и пользователей, которые могут использовать проверяемые учетные данные для проверки подлинности.
  • Используйте riskRemediation как часть элементов управления предоставлением условного доступа для применения политики условного доступа риска пользователя. При выборе параметра "Требовать исправление рисков" в элементах управления предоставлением политики Защита Microsoft Entra ID управляет соответствующим потоком исправления на основе наблюдаемой угрозы и метода проверки подлинности пользователя. В сеансах рискованных пользователей без пароля он обновляет сведения о рисках с помощью microsoftRevokedSessions.

Безопасность | Оповещения и инциденты

  • Добавлено свойство categories в ресурс alert .
  • Не рекомендуется использовать свойство category в ресурсе alert . Вместо этого используйте свойство категорий .

Командная работа и коммуникации | Приложения

Управление приложениями Teams на уровне канала в команде с помощью следующих API:

Командная работа и коммуникации | Обмена сообщениями

  • Удалены model параметры и руководство по модели оплаты из API-интерфейсов экспорта Microsoft Teams и соответствующей документации по уведомлениям об изменениях. Параметр model запроса больше не является обязательным и игнорируется при его указании. Дополнительные сведения см. в разделе Модели оплаты и требования к лицензированию для API Microsoft Teams.
  • Следующие API Microsoft Teams поддерживают @odata.nextLink на страницы для обработки увеличенных ограничений каналов. Когда результирующий набор охватывает несколько страниц, ответ включает свойство @odata.nextLink с URL-адресом для получения следующей страницы результатов:

Апрель 2026 г.: новые возможности только в предварительной версии

Agents

Добавлены уведомления об устаревании для ресурсов agentRegistry, agentCardManifest, agentCollection и agentInstance и связанных с ними операций. Эти API реестра агентов будут заменены API на основе агента 365 с 1 мая 2026 г.

Приложения

Добавлено свойство deprecationDate в ресурс applicationTemplate , указывающее, когда приложение будет удалено из коллекции приложений Microsoft Entra.

Резервное копирование и восстановление

  • При отключении политики защиты действие резервного копирования немедленно прекращается, новые резервные копии не создаются, а защищенные ресурсы больше не покрываются политикой. Все резервные копии, сделанные до деактивации, сохраняются в соответствии с политикой хранения, после чего они отключаются. Вы можете восстановить данные с помощью предыдущих точек восстановления даже после деактивации.
  • Политику защиты можно удалить только после ее деактивации. При удалении политики удаляются все связанные блоки защиты, а защита резервных копий останавливается для ресурсов, ранее охваченных политикой. Существующие данные резервной копии сохраняются в соответствии с политикой хранения, прежде чем они будут отключены. Вы можете восстановить данные с помощью предыдущих точек восстановления даже после удаления.
  • Используйте свойство billingPolicyId в protectionUnitBase, driveProtectionUnit, mailboxProtectionUnit и siteProtectionUnit , чтобы получить или задать уникальный идентификатор политики выставления счетов, назначенной единице защиты для распределения затрат.
  • Обновите свойство billingPolicyId объекта driveProtectionUnit .
  • Обновите свойство billingPolicyId объекта mailboxProtectionUnit .
  • Обновите свойство billingPolicyId объекта siteProtectionUnit .
  • Используйте свойство destinationType в granularRestoreArtifactBase, granularDriveRestoreArtifact и granularSiteRestoreArtifact , чтобы указать назначение восстановления, например восстановление на месте.
  • Используйте заметку @microsoft.graph.conflictBehavior при создании сеанса восстановления OneDrive или сеанса восстановления SharePoint для управления разрешением конфликтов во время детализированных операций восстановления.

Управление устройствами и приложениями | Облачный компьютер

  • Конечные /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo точки и /users/{userId}/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo являются устаревшими и перестанут возвращать данные 30 октября 2026 г. В дальнейшем используйте API retrieveCloudPcLaunchDetail .
  • Добавлен тип ресурса cloudPcOnPremisesConnectionSubnetIpDetail для представления IP-адресов подсети локального подключения к облачному компьютеру.
  • Используйте свойство subnetPrivateIpDetail в cloudPcOnPremisesConnection , чтобы получить подробные сведения о частных IP-адресах подсети, связанных с подсетью.

Файлы

  • Используйте параметры запроса высоты и ширины в API преобразования содержимого driveItem , чтобы скачать файл в другом формате при format=jpg.
  • Используйте свойство itemCount в ресурсе списка , чтобы быстро получить доступ к общему количеству элементов в списке SharePoint без получения всех элементов или выполнения дополнительных запросов.

Удостоверение и доступ | Управление каталогом

Добавлены связи inheritedAppRoleAssignments и inheritedOauth2PermissionGrants к ресурсу agentIdentity для получения унаследованных разрешений от родительского субъекта-службы Схемы удостоверений агента.

Удостоверение и доступ | Управление

  • Используйте default, notVisibleи visible в качестве поддерживаемых значений для свойства approverInformationVisibility ресурсов accessPackageApprovalStage и approvalStage , чтобы указать, видны ли сведения утверждающего для запрашивающего лица.
  • Добавлен метод cancelProcessing в ресурс рабочего процесса для отмены выполняемых в данный момент или помещенных в очередь запусков рабочих процессов.
  • Добавлены свойство referenceId и отношение файлов к ресурсу customDataProvidedResourceUploadSession для определения контекста, для которого передаются данные, например идентификатор экземпляра проверки доступа, и идентификации файлов, отправленных во время сеанса отправки, соответственно. Кроме того, добавлена расширенная поддержка возможностей запросов для операции API объектов List customDataProvidedResourceUploadSession .

Удостоверение и доступ | Удостоверение и вход в систему

Добавлены описательные свойства blueprintId и source agent-descriptive для ресурсов agentRiskDetection и riskyAgent .

Почта

Представлен новый API заметок, который позволяет пользователям создавать простые заметки и управлять ими в папке Notes . Заметки поддерживают текстовое содержимое с необязательными встроенными вложениями изображений и подходят для сценариев быстрого захвата. Используйте ресурс заметки и следующие API:

Импорт и экспорт почтового ящика

Узнайте, как обрабатывать перенаправления HTTP при доступе к папкам и элементам в архивных почтовых ящиках с автоматически развернутыми папками с помощью API импорта и экспорта почтовых ящиков. Дополнительные сведения см. в разделе Обработка перенаправлений архивных почтовых ящиков.

Люди и рабочая аналитика | Профиль

Используйте свойства действий, наград и полейOfStudy в educationalActivityDetail для получения или задания коллекций действий, наград или областей обучения.

Отчеты | Отчеты об удостоверениях и доступе

Добавлен ресурс azureADPremiumLicenseInsight и связанные с ним API-интерфейсы для получения аналитических сведений об использовании лицензий Microsoft Entra ID P1 и P2 premium для клиента, включая разбивку использования функций для функций P1, P2, доступа к Интернету и частного доступа.

Безопасность | Оповещения и инциденты

  • Добавлено свойство categories в ресурс alert .
  • Не рекомендуется использовать свойство category в ресурсе alert . Вместо этого используйте свойство категорий .

Безопасность | Соответствия

Обновлены возможности типа ресурса auditLogQuery и связанных с ним методов следующим образом:

  • Обновлено перечисление auditLogRecordType , которое представляет более 400 типов операций журнала аудита в облачных службах Майкрософт.
  • Добавлены 135 новых производных типов ресурса auditData для представления данных журнала аудита для определенных служб и функций, включая взаимодействие СИ ИИ и Copilot, управление агентами, соответствие требованиям и управление жизненным циклом данных (Microsoft Purview, обнаружение электронных данных, DLP), облачные службы (Брандмауэр Azure, Microsoft Defender, Sentinel) и службы совместной работы (Teams, Планировщик, SharePoint, Viva). Полный список типов данных аудита см. в разделе типы, производные от auditData.

Безопасность | Microsoft Defender для удостоверений

Используйте свойство sensorTypes в sensorCandidate , чтобы получить список типов устройств для датчика.

Командная работа и коммуникации | Обмена сообщениями

Участие в Microsoft Graph

Имеются ли сценарии, поддержку которых вы хотели бы видеть в Microsoft Graph?

  • Предложите новые функции и проголосуйте за нее с помощью портала отзывов Microsoft Graph. Некоторые новые функции реализуются на основе распространенных запросов сообщества разработчиков. Команда Microsoft Graph регулярно оценивает потребности клиентов и выпускает новые функции для конечных точек бета-версии (https://graph.microsoft.com/beta) и версии 1.0 (https://graph.microsoft.com/v1.0).

  • Присоединитесь к еженедельной версии сообщества Microsoft 365 и станьте активным участником сообщества Microsoft Graph. Полный календарь звонков разработчиков см. на странице сообщества Microsoft 365 и Power Platform.

  • Присоединяйтесь к нашей исследовательской группе, чтобы предоставить свои сведения о наших впечатлениях от разработчиков.

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

  • Last updated on