Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Microsoft Graph предоставляет унифицированную модель программирования, которую можно использовать для доступа к данным в Microsoft 365, Windows и Enterprise Mobility + Security. В этой статье содержатся сведения о новых возможностях API Microsoft Graph, документации, пакетов SDK и т. д.
Более подробные обновления на уровне API см. в журнале изменений Microsoft API Graph.
Дополнительные сведения о предыдущих обновлениях Microsoft Graph см. в статье Новый журнал Microsoft Graph.
Важно!
Функции в состоянии предварительной версии могут быть изменены без уведомления и не могут быть повышены до общедоступного (общедоступного) состояния. Не используйте предварительные версии функций в рабочих приложениях.
Март 2026 г.: новые и общедоступные
Приложения
Использование свойства signInAudience для ограничения возможностей использования приложенияне заменяет правильную проверку клиента и принудительное применение авторизации в коде приложения. Если приложение ожидает доступа только в определенных клиентах, необходимо применить эту проверку в коде приложения. Дополнительные сведения см. в статье Защита приложений и API с помощью проверки утверждений.
Управление устройствами и приложениями | Облачный компьютер
- Используйте свойство osVersionNumber в ресурсах cloudPcDeviceImage и cloudPcGalleryImage , чтобы получить версию образа операционной системы.
- Используйте свойство sizeInGB в cloudPcDeviceImage , чтобы получить размер образа в ГБ.
Файлы
- Используйте следующие новые API-интерфейсы столбцов контейнеров, добавленные для дополнительной поддержки структурированного хранилища файлов в приложениях SharePoint Embedded:
- Скачайте частичный диапазон байтов из предыдущей версии файла.
- Запросы, выполненные с помощью API контейнеров списка без контекста пользователя (проверка подлинности только для приложений), в настоящее время не поддерживаются для клиентов с несколькими регионами.
Удостоверение и доступ | Управление каталогом
Представлен API удостоверений агента для поддержки регистрации агентов ИИ и управления ими в Microsoft Entra ID. Этот API позволяет разработчикам агентов и администраторам клиентов выполнять следующие действия:
- Создание схем удостоверений агента в качестве базовых определений для агентов
- Настройка наследуемых разрешений, определяющих , какие области могут наследоваться экземплярами агента
- Создание субъектов схемы удостоверений агента в качестве представлений, зависящих от клиента
- Создание нескольких экземпляров удостоверений агента из одной схемы для сценариев с несколькими инстансами
- Управление спонсорами, которые могут авторизовать жизненный цикл агента и управлять ими
API также вводит вспомогательные типы, включая inheritableScopes, allAllowedScopes, enumeratedScopes, noScopes и перечисление scopeCollectionKind .
Удостоверение и доступ | Удостоверение и вход в систему
- Добавлены новые ресурсы событий проверки подлинности для поддержки JIT-сценариев миграции пользователей из устаревших систем проверки подлинности:
- Используйте ресурс onPasswordSubmitListener для настройки прослушивателей событий проверки подлинности, которые активируются во время отправки пароля.
- Используйте ресурс onPasswordSubmitCustomExtension для настройки пользовательских расширений, которые проверяют пароли для внешних устаревших систем проверки подлинности.
аналитика People и на рабочем месте | параметры администратора People
Используйте новые API profileSource , чтобы позволить администраторам настраивать отображение сведений об источнике профиля, которые видят пользователи в организации в интерфейсах Microsoft 365.
Личные контакты
Используйте свойства primaryEmailAddress, secondaryEmailAddress и tertiaryEmailAddress для контакта , чтобы получить или задать основной, вторичный или третичный адрес электронной почты контакта.
Командная работа и коммуникации | Звонки и собрания по сети
Добавлена поддержка нерегламентированных звонков для уведомлений об изменении расшифровок и записей в Microsoft Teams. Теперь вы можете подписаться на следующие ресурсы, чтобы получать уведомления о доступности расшифровки или записи для нерегламентированного вызова:
communications/adhocCalls/{adhocCallId}/transcriptsusers/{userId}/adhocCalls/getAllTranscriptscommunications/adhocCalls/{adhocCallId}/recordingsusers/{userId}/adhocCalls/getAllRecordings
Дополнительные сведения см. в статье Получение уведомлений об изменениях для расшифровок и записей с помощью Microsoft Graph.
Управление клиентом | Управление конфигурацией
Новые API-интерфейсы управления конфигурацией клиента в Microsoft Graph позволяют администраторам управлять параметрами конфигурации для одной или нескольких рабочих нагрузок в организации. Дополнительные сведения о поддерживаемых вариантах использования см. в статье Использование API управления конфигурацией клиента в Microsoft Graph.
Календари | Places
Добавлена известная проблема RBAC в API обновления Places: запросы на обновление могут по-прежнему выполняться без роли администратора Exchange, но приводят к непредвиденному поведению.
Март 2026 г.: новые возможности только в предварительной версии
Приложения
- Использование свойств signInAudience и signInAudienceRestrictions для ограничения возможностей использования приложенияне заменяет правильную проверку клиента и принудительное применение авторизации в коде приложения. Если приложение ожидает доступа только в определенных клиентах, необходимо применить эту проверку в коде приложения. Дополнительные сведения см. в статье Защита приложений и API с помощью проверки утверждений.
- Добавлено свойство trafficRoutingMethod в ресурс onPremisesPublishing для управления распределением трафика между несколькими соединителями в группе соединителей в Microsoft Entra прокси приложения.
Хранилище резервных копий
- Используйте свойство backupRetentionPeriodInDays в driveProtectionUnit, mailboxProtectionUnit и siteProtectionUnit , чтобы получить период хранения резервной копии в днях.
- Добавлен элемент в качестве поддерживаемого
includeNewerItemsзначения для свойства tags в restorePoint , чтобы получить точку восстановления в течение указанного периода времени, включающую все новые элементы, созданные в течение этого периода.
Управление устройствами и приложениями | Облачный компьютер
- Добавлены
underServiceMaintenanceиinUseв качестве новых поддерживаемых значений для перечисления cloudPcConnectivityStatus . Используйте эти значения со свойством statusв cloudPcConnectivityResult , чтобы указать, что облачный компьютер временно недоступен для обслуживания, инициированного службой, или в настоящее время используется пользователем. - Добавлен параметр configureAgent в качестве нового действия для cloudpcexternalpartner.
- Добавлено deployAgent в качестве нового действия для cloudpcexternalpartner.
- Добавлено значение retrieveDeployAgentActionResults в качестве нового действия для cloudpcexternalpartner.
- Добавлено действие retrieveActionReports в качестве нового действия для cloudpcexternalpartner.
- Добавлен cloudPcExternalPartnerAgentSetting в качестве нового сложного типа для cloudpcexternalpartner.
- Добавлен cloudPcExternalPartnerActionResult в качестве нового сложного типа для cloudpcexternalpartner.
- Добавлен cloudPcExternalPartnerActionReport в качестве нового сложного типа для cloudpcexternalpartner.
- Повторите отправку объекта cloudPcDeviceImage , который ранее завершился ошибкой.
- Не рекомендуется использовать метод reupload в пользу retryUpload.
Опыт сотрудников | Вовлеченность сотрудников
Используйте следующий пользователь, пользователь unfollow, список подписчиков и список следующих API для Viva Engage для управления сюжетными связями.
Файлы
- Добавлена поддержка
DELETE /groups/{group-id}/drive/items/{item-id}/retentionLabelконечных точек ,DELETE /me/drive/items/{item-id}/retentionLabelиDELETE /users/{user-id}/drive/items/{item-id}/retentionLabelв API driveItem: removeRetentionLabel . - Скачайте частичный диапазон байтов из предыдущей версии файла.
- Используйте СПИСОК, создание, получение и удаление API для управления разрешениями пользователей для типов контейнеров хранилища файлов SharePoint Embedded.
- Архив или разархив контейнер хранилища SharePoint Embedded.
- Запросы, выполненные с помощью API контейнеров списка без контекста пользователя (проверка подлинности только для приложений), в настоящее время не поддерживаются для клиентов с несколькими регионами.
Группы
Добавлен ресурс ownerlessGroupPolicy и связанные операции API, позволяющие ИТ-администраторам настраивать политики для управления группами, которые потеряли своего единственного владельца. Используйте этот API для отправки электронных уведомлений с действиями активным членам групп без владельцев, чтобы принять право собственности.
Удостоверение и доступ | Управление каталогом
Представлены API Entra резервного копирования и восстановления, позволяющие ИТ-администраторам выполнять резервное копирование и восстановление данных Microsoft Entra ID клиента. Перед выполнением заданий восстановления можно просмотреть моментальные снимки и запустить предварительный просмотр заданий для анализа. Вы также можете отслеживать состояние процессов восстановления, включая успехи и сбои. Дополнительные сведения см. в статье Обзор API резервного копирования и восстановления Microsoft Entra.
Удостоверение и доступ | Управление
Используйте связь administrationScopeTargets в ресурсахworkflowBase, workflow и workflowVersion, чтобы указать административные единицы в область рабочего процесса жизненного цикла.
- Добавлен privilegeLevel в качестве свойства в accessPackageCatalog. Это значение представляет уровень привилегий для каталогов пакетов для доступа.
- Добавлен тип ресурса targetAgentIdentitySponsorsOrOwners , который определяет спонсоров или владельцев определенного удостоверения агента.
Удостоверение и доступ | Сетевой доступ
- Добавлены свойства homeTenantId, crossTenantAccessType и deviceJoinType в ресурс подключения для поддержки сценариев совместной работы "Перенос собственного устройства" (BYOD) и "бизнес-бизнес" (B2B) в журналы подключений глобального безопасного доступа к трафику.
- Добавлен тип перечисления crossTenantAccessType .
- Добавлен тип перечисления deviceJoinType .
- Добавлены API-интерфейсы облачного брандмауэра для управления политиками брандмауэра, правилами и ссылками на политики для Microsoft Entra глобального безопасного доступа. Используйте следующие новые ресурсы и связанные с ними API:
- Используйте ресурс cloudFirewallPolicy и связанные с ним методы для создания политик брандмауэра облака и управления ими.
- Используйте ресурс cloudFirewallRule и связанные с ним методы, чтобы определить правила брандмауэра с условиями соответствия источника и назначения.
- Используйте ресурс cloudFirewallPolicyLink и связанные с ним методы для связывания политик брандмауэра облака с профилями фильтрации.
Управление клиентом | Управления
Представлен набор API управления клиентами, позволяющий организациям управлять отношениями с другими клиентами и управлять ими. Основные возможности:
- Активация приема приглашений и обнаружение связанного клиента
- Установление отношений управления между управляющим клиентом и управляемым клиентом
- Отслеживание установленных связей
- Настройка политик отношений
Дополнительные сведения см. в статье Общие сведения об API управления клиентами.
Календари | Places
Добавлена известная проблема RBAC в API обновления Places: запросы на обновление могут по-прежнему выполняться без роли администратора Exchange, но приводят к непредвиденному поведению.
Февраль 2026 г.: новые и общедоступные
Внешние подключения к данным
Добавлены семантические метки домена 19 пользователей в перечисление меток для соединителей Microsoft 365 Copilot. Эти метки позволяют разработчикам сопоставлять данные профилей пользователей из внешних систем со стандартизированными свойствами Microsoft Graph. Используйте эти метки в определениях схем для повышения возможности обнаружения и интеграции данных людей в Microsoft 365 Copilot интерфейсах. Новые метки: personEmails, , personAddresses, personAnniversaries, personName, personNote, personPhones, personCurrentPosition, personWebAccounts, personWebSite, personSkills, personProjects, , personAccount, personAwards, personCertifications, personAssistants, , personColleagues, personManager, personAlternateContactsи personEmergencyContacts.
Файлы
Обновлено требование согласия администратора для следующих делегированных разрешений, связанных с управлением контейнером хранилища файлов SharePoint Embedded:
- Делегированное
FileStorageContainerType.Manage.Allразрешение больше не требует согласия администратора. - Делегированное
FileStorageContainerTypeReg.Manage.Allразрешение больше не требует согласия администратора.
Группы
- Добавлены свойства resourceBehaviorOptions и resourceProvisioningOptions в ресурс группы . Эти свойства позволяют указать поведение группы и связанные ресурсы для группы Microsoft 365.
- Добавлена известная проблема: для обратимо удаленных групп безопасности свойство securityEnabled возвращает
falseвместоtrue. Чтобы определить тип группы, используйте свойство groupTypes , где["Unified"]указывает группу Microsoft 365, а пустой массив ([]) — группу безопасности. Дополнительные сведения см. в разделах Получение удаленного элемента и Вывод списка удаленных элементов.
Удостоверение и доступ | Управление
- Добавлен
allDirectoryAgentIdentitiesэлемент в перечисление allowedTargetScope , чтобы разрешить пакеты доступа для всех удостоверений агента каталогов. - Добавлен тип ресурса targetAgentIdentitySponsorsOrOwners , который определяет спонсоров или владельцев определенного удостоверения агента.
Удостоверение и доступ | Удостоверение и вход в систему
- Метод проверки подлинности по QR-коду в Microsoft Entra ID позволяет управлять методом проверки подлинности QR-кода для пользователей и способами входа с помощью QR-кода и ПИН-кода. Следующие ключевые ресурсы поддерживают эту возможность:
- Ресурс qrCodePinAuthenticationMethod и связанные API для управления методами проверки подлинности ПИН-кода QR-кода для пользователей. Этот метод однофакторной проверки подлинности предназначен для сотрудников первой линии и объединяет QR-код с ПИН-кодом. Также были добавлены следующие связанные ресурсы: qrCode, qrPin и qrCodeImageDetails.
- Ресурс qrCodePinAuthenticationMethodConfiguration для управления политикой метода проверки подлинности QR-кода для клиента.
- Обновлены перечисления authenticationMethodModes и baseAuthenticationMethod , чтобы добавить
qrCodePinэлемент для поддержки этого нового метода проверки подлинности.
Почта | Трассировка сообщений
Используйте API трассировки сообщений для отслеживания потока сообщений электронной почты через Exchange Online организацию. Дополнительные сведения см. в разделе exchangeMessageTrace.
Поиск
- Добавлены типы данных principal и principalCollection в externalConnection , чтобы указать тип данных для элементов свойств, связанных с людьми, во внешнем подключении.
- Добавлено свойство description к свойствам externalConnection , чтобы можно было добавлять описание к свойствам схемы во внешнем соединении.
- Добавлены дополнительные теги или семантические метки, которые можно добавить в метки в свойстве externalConnection в схеме внешнего подключения. Метки помогают Microsoft 365 Copilot понимать семантику данных в соединении и предоставлять более релевантные результаты.
- Добавлено свойство contentCategory для externalConnection , чтобы указать категорию домена содержимого, связанного с внешним подключением, для повышения релевантности и ранжирования.
Безопасность | Безопасность данных и соответствие требованиям
- Добавлен
labelNotFoundExceptionэлемент в тип перечисления usageRights . Этот элемент представляет метку без параметров защиты, поэтому в Microsoft Purview отсутствуют права на использование. - Добавлен
restrictWebGroundingэлемент в перечисление dlpAction для поддержки ограничения действий веб-заземления в политиках защиты от потери данных в Microsoft Purview.
Безопасность | Защита от угроз
Обновлено требование согласия администратора для следующих делегированных разрешений, связанных с отправкой угроз:
- Делегированное
ThreatSubmission.Readразрешение теперь требует согласия администратора. - Делегированное
ThreatSubmission.ReadWriteразрешение теперь требует согласия администратора.
Задачи и планы
Добавлена поддержка обмена сообщениями в чате в задачах Планировщика, что позволяет пользователям создавать, обновлять, удалять сообщения и реагировать на них непосредственно в задачах. Используйте следующие новые ресурсы и API:
- plannerTaskChatMessage
- plannerTaskChatMention
- plannerTaskChatReaction
- plannerTaskChatReactionEvent
- Список сообщений
- Создание сообщения
- Обновление сообщения
- Удалить сообщение
- setReaction
- unsetReaction
Командная работа и коммуникации | Администрирования
- Получите идентификатор политики для заданного имени и типа политики в администрирование Teams.
- Назначьте политику Teams пользователю с помощью идентификатора пользователя, типа политики и идентификатора политики.
- Отмена назначения политики Teams пользователем с помощью идентификатора пользователя и типа политики.
- Назначьте номер телефона Teams учетной записи пользователя.
- Отменяет назначение номера телефона Teams из учетной записи пользователя.
- Получение сведений о назначении для одного номера телетоны.
- Обновите существующий телефонный номер Teams с помощью необязательных атрибутов.
- Проверьте состояние операции назначения или отмены назначения номера телефона для учетной записи пользователя.
- Получите список телефонных номеров Teams, назначенных учетной записи пользователя.
Февраль 2026 г.: новые возможности только в предварительной версии
Приложения
Используйте свойство requiredResourceAccess в agentIdentityBlueprint , чтобы указать разрешения Microsoft Graph (делегированные области и роли приложения), необходимые агенту.
Приложения | Шаблон приложения
Используйте свойство isEntraIntegrated в applicationTemplate, чтобы указать, интегрировано ли приложение с Идентификатором Entra Microsfot (например, с помощью единого входа или подготовки пользователей).
Хранилище резервных копий
Теперь пользователи могут просматривать конечную точку fastRestore и выборочно восстанавливать файлы и папки, создавая сеанс обзора.
Процесс детализированного восстановления разработан так, чтобы быть простым и эффективным и состоит из трех основных этапов:
Создание сеанса обзора
Запуск сеанса обзора для определенной точки восстановления (snapshot резервного копирования).- Вы можете создать сеанс обзора SharePoint или сеанс просмотра OneDrive для бизнеса.
Просмотр элементов
После создания сеанса пользователь может запросить его, чтобы получить список всех элементов с резервными копиями, доступных в сеансе обзора.- Результаты возвращаются в виде коллекции объектов browseQueryResponseItem , каждый из которых представляет файл, папку или другой ресурс.
- Вы можете просматривать элементы в сеансе просмотра SharePoint или сеансе просмотра OneDrive для бизнеса.
Создание сеанса восстановления
Выберите один или несколько элементов из сеанса обзора и инициирует сеанс восстановления.- Только выбранные элементы восстанавливаются в прежнее состояние, в результате чего остальная часть сайта или диска остается без изменений.
- Вы можете создать сеанс детализированного восстановления SharePoint или сеанс OneDrive для бизнеса детализированного восстановления.
Управление устройствами и приложениями | Лицензирование облака
Используйте новые API лицензирования облака для управления данными о лицензировании клиентов, пользователей и групп для служб Microsoft 365. Эти API обеспечивают программный доступ к наемным ресурсам, назначениям, ошибкам назначения, жизненным циклам подписки и ожидающих членов. Дополнительные сведения см. в статье Использование API лицензирования облака в Microsoft Graph (предварительная версия).
Файлы
Добавлены driveItem: archive и driveItem: unarchive , чтобы разрешить организациям архивировать или неархивировать driveItems. Добавлена поддержка отключения политики защиты и отслеживания меток времени в хранилище резервных копий:
Добавлено свойство offboardRequestedDateTime для ресурса protectionPolicyBase .
Добавлены
offboardRequestedзначения иoffboardedв перечисление protectionPolicyStatus .
Удостоверение и доступ | Управление каталогом
Добавлено свойство managerApplications к ресурсам приложения и agentIdentityBlueprint для указания приложений, назначенных в качестве диспетчеров приложения. В базовом ресурсе приложения это свойство доступно только для чтения для сторонних вызовов (3P). В ресурсе agentIdentityBlueprint приложения диспетчера могут создавать субъекты схемы агента, удостоверения агентов и пользователей агента для схемы управляемого агента, не требуя разрешений с высоким уровнем привилегий, таких как AgentIdentityBlueprintPrincipal.ReadWrite.All.
Удостоверение и доступ | Управление
Добавлены отношение previewScope , метод previewTaskFailures и previewWorkflow в ресурс рабочего процесса для поддержки предварительного просмотра рабочих процессов жизненного цикла перед их запуском в рабочей среде.
Удостоверение и доступ | Удостоверение и вход в систему
- Добавлено перечисление agentIdentityType, представляющее тип удостоверения агента Microsoft Entra для обнаружения рисков и управления ими. Используйте свойство identityType в ресурсах riskyAgent и agentRiskDetection для классификации различных типов удостоверений агента.
- Добавлены новые ресурсы событий проверки подлинности для поддержки JIT-сценариев миграции пользователей из устаревших систем проверки подлинности:
- Используйте ресурс onPasswordSubmitListener для настройки прослушивателей событий проверки подлинности, которые активируются во время отправки пароля.
- Используйте ресурс onPasswordSubmitCustomExtension для настройки пользовательских расширений, которые проверяют пароли для внешних устаревших систем проверки подлинности.
- Используйте ресурс onPasswordSubmitHandler в качестве базового типа для обработчиков, вызываемых во время событий отправки пароля.
- Используйте ресурс onPasswordMigrationCustomExtensionHandler для настройки обработчиков, которые вызывают пользовательские расширения во время JIT-миграции.
Поиск
Добавлены типы данных principal и principalCollection в ресурс externalConnection , чтобы указать тип данных для элементов свойств, связанных с людьми, во внешнем подключении.
Безопасность | Безопасность данных и соответствие требованиям
- Добавлен
labelNotFoundExceptionэлемент в тип перечисления usageRights . Этот элемент представляет метку без параметров защиты, поэтому в Microsoft Purview отсутствуют права на использование. - Не рекомендуется использовать свойство accessedResources в processConversationMetadata в пользу свойства accessedResources_v2 .
- Используйте свойство accessedResources_v2в processConversationMetadata , чтобы получить подробные сведения о ресурсах, к ним обращается беседа, включая идентификаторы, тип доступа и состояние.
- Используйте свойство agents в processConversationMetadata , чтобы получить сведения об агентах ИИ, которые участвовали в подготовке сообщения.
Безопасность | защита Email и совместной работы
Усовершенствования ресурса detonationDetails, представляющего сведения из анализа подозрительных файлов и URL-адресов в сообщениях электронной почты в Microsoft Defender для Office 365:
- Добавлены следующие свойства для более подробного анализа угроз:
- detonationBehaviourDetailsV2 — показывает события, произошедшие во время детонации, в формате JSON.
- entityMetadata — дополнительные метаданные о сущности в формате JSON
- mitreTechniques — методы атак, согласованные с платформой MITRE ATT&CK
- staticAnalysis — результаты статического анализа, выполненного в файле или URL-адресе.
- submissionSource — источник отправки.
- Свойство detonationBehaviourDetails устарело и перестанет возвращать данные в марте 2026 г. Вместо этого используйте свойство detonationBehaviourDetailsV2 .
- Добавлен
moveToQuarantineэлемент в перечисление remediationAction .Prefer: include-unknown-enum-membersИспользуйте заголовок запроса для доступа к этому изменяемому члену перечисления.
Задачи и планы
Используйте API расширенных свойств для хранения или получения пользовательских данных в ресурсе todoTaskList .
Январь 2026 г.: новые и общедоступные
Удостоверение и доступ | Удостоверение и вход в систему
- Начиная с 26 января 2026 г. пользователи, которые управляют собственными методами проверки подлинности с помощью операций самообслуживания, таких как добавление, обновление или удаление номеров телефонов и адресов электронной почты, должны пройти многофакторную проверку подлинности (MFA), если в последний раз прошли проверку подлинности более 10 минут назад в текущем сеансе. Дополнительные рекомендации по обработке этого изменения в приложении см. в статье Общие сведения об API методов проверки подлинности Microsoft Entra.
- Добавлено
qrCodeв качестве нового поддерживаемого значения для перечисления usageAuthMethod , которое является типом свойства authMethod для ресурсов credentialUsageSummary, userCredentialUsageDetails, userEventsSummary и userRegistrationActivitySummary . Это значение представляет использование QR-кода в качестве метода проверки подлинности. - Теперь вы можете управлять внешними методами проверки подлинности (EAM) в Microsoft Entra ID, чтобы позволить пользователям выбирать внешнего поставщика для удовлетворения требований многофакторной проверки подлинности (MFA) при входе в Microsoft Entra ID. Дополнительные сведения см. в разделе:
- Тип ресурса externalAuthenticationMethod для управления внешними методами проверки подлинности, зарегистрированными для пользователя для проверки подлинности с помощью внешнего поставщика удостоверений.
- Тип ресурса externalAuthenticationMethodConfiguration для управления политикой на уровне клиента.
- Добавлено свойство createdDateTime к ресурсу authenticationMethod , который является базовым типом для следующих ресурсов производных методов проверки подлинности: fido2AuthenticationMethod, microsoftAuthenticatorAuthenticationMethod, passwordAuthenticationMethod, platformCredentialAuthenticationMethod, temporaryAccessPassAuthenticationMethod и windowsHelloForBusinessAuthenticationMethod.
Отчеты | Отчеты об использовании Microsoft 365
В дальнейшем используйте API-интерфейсы использования Microsoft 365 Copilot в сегменте /copilot URL-пути. Дополнительные сведения см. в разделе:
- Корень отчета Copilot
- Получение сводки по количеству пользователей Copilot
- Получить тенденцию подсчета пользователей Copilot
- Получение сведений об использовании copilot
Безопасность | Расширенная охота
Добавлены рекомендации по миграции для api Microsoft Defender для конечной точки (MDE), которые помогут организациям перейти с устаревших API, которые были доступны через https://api.securitycenter.microsoft.com конечную точку, на расширенные API охоты, доступные в Microsoft Graph. Дополнительные сведения см. в разделе Миграция с более старых API.
Безопасность | Оповещения и инциденты
- Добавлено свойство priorityScore к ресурсу инцидента , чтобы обеспечить оценку приоритета для инцидента от 0 до 100, при > этом 85 — это главный приоритет, 15–85 — средний приоритет и < 15 — низкий приоритет. Эта оценка создается с помощью машинного обучения и основана на нескольких факторах, включая серьезность, влияние на нарушение работы, аналитику угроз, типы оповещений, критичность активов, аналитику угроз, редкость инцидентов и дополнительные сигналы о приоритете.
- Внесены следующие обновления в API-интерфейсы для управления датчиками Microsoft Defender для удостоверений (MDI):
- Добавлено свойство domainName в ресурс sensorCandidate , чтобы указать доменное имя датчика.
- Добавлено свойство serviceStatus к ресурсу датчика для указания состояния службы. Возможные значения:
stopped,starting,running,disabled,onboarding,unknown,unknownFutureValue.
Безопасность | Обнаружения электронных данных
Используйте свойство reportFileMetadata в ediscoveryPurgeDataOperation , чтобы получить метаданные файла отчета о задании очистки.
Командная работа и коммуникации | Приложения
— TeamsAppInstallation.ManageSelectedForTeam.All это наименее привилегированное разрешение приложения, необходимое для установки или обновления приложения Teams, которому требуется согласие на разрешения на согласие для конкретных ресурсов (RSC) при использовании teamsAppInstallation в API обновления команды .
Январь 2026 г.: новые возможности только в предварительной версии
Приложения
Свойство allowedTenantIds в allowedTenantsAudience должно содержать по крайней мере одно значение и не может содержать более 20 значений.
Управление устройствами и приложениями | Облачный компьютер
- Используйте следующие ресурсы, чтобы представить данные, отправляемые Azure Logic Apps в рамках запроса на выноску настраиваемого расширения при использовании пользовательского расширения в каталоге:
- accessPackageAssignmentCalloutData — для назначений пакетов доступа
- accessPackageAssignmentRequestCalloutData — для запросов на назначение пакета доступа
- Добавлены ресурс controlConfiguration и отношение controlConfigurations к ресурсу entitlementManagement для представления политик, управляющих жизненным циклом и доступом к пакетам в организации.
- Добавлен ресурс entraIdProtectionRiskyUserApproval, который представляет конфигурацию утверждения для рискованных пользователей, обнаруженных Microsoft Entra ID Protection.
- Добавлен ресурс insiderRiskyUserApproval, который представляет конфигурацию утверждения для рискованных пользователей, обнаруженных Управление внутренними рисками Microsoft Purview.
Управление устройствами и приложениями | Обновления устройств
Добавлена новая модель управления утверждением и развертыванием для обновлений качества Windows в средах, управляемых автоматическим исправлением. Теперь вы можете определять политики обновления качества с настраиваемыми правилами утверждения, назначать круги развертывания группам устройств для поэтапного развертывания и управлять состоянием утверждения содержимого обновления перед развертыванием на устройствах. Дополнительные сведения содержатся в следующих ресурсах:
Группы
Используйте свойство welcomeMessageEnabled в ресурсе группы , чтобы контролировать, отправляется ли приветственное сообщение новым участникам при их добавлении в группу Microsoft 365. Значение по умолчанию — true.
Удостоверение и доступ | Удостоверение и вход в систему
Добавлено microsoftRevokedSessions значение в перечисление riskDetail , чтобы указать, что корпорация Майкрософт отозвала сеансы. Этот член перечисления применяется к следующим Microsoft Entra ресурсам защиты идентификации: riskDetection, riskUserActivity, riskyUser и signIn.
- Добавлено
mexicoв качестве нового поддерживаемого значения для типа перечисления cloudPcGeographicLocationType . Это перечисление является типом возвращаемого значения для свойства geographicLocationType в cloudPcDomainJoinConfiguration и cloudPcSupportedRegion. - Добавлен
cloudPCInventoryReportэлемент в тип перечисления cloudPcReportName . Это перечисление является типом возвращаемого значения для свойства reportName в cloudPcExportJob, действии getFrontlineReport и getCloudPcRecommendationReports. - Используйте свойство category в cloudPcSourceDeviceImage , чтобы получить категорию запрошенного исходного образа. Дополнительные сведения см. в разделе Получение объектов cloudPcSourceDeviceImage с определенной категорией.
- Добавлено
refreshPolicyConfigurationв качестве поддерживаемого значения для свойства status в cloudPC и cloudPcStatusSummary , чтобы указать, что облачный компьютер находится в процессе обновления новых конфигураций политики. - Добавлен в
riskRemediationкачестве нового члена в перечисление conditionalAccessGrantControl . Это значение позволяет пользователям самостоятельно устранять риски пользователей с помощью политик условного доступа. - Используйте свойство groupSyncInbound в crossTenantIdentitySyncPolicyPartner , чтобы определить, можно ли синхронизировать группы из клиента партнера в параметрах политики доступа между арендаторами.
Трассировка сообщений
Используйте ресурс userConfiguration и связанные с ним методы для управления пользовательскими параметрами, метаданными или данными приложения, связанными с папками почтовых ящиков, с помощью форматов XML, двоичных файлов или словарей.
Отчеты | Отчеты об удостоверениях и доступе
Удален тип ресурса conditionalAccessAudience . Тип возвращаемого значения свойства conditionalAccessAudiencesтипа ресурса signIn представляет собой коллекцию объектов String, а не сложный тип conditionalAccessAudience .
Используйте API трассировки сообщений для отслеживания потока сообщений электронной почты через Exchange Online организацию. Дополнительные сведения см. в разделе exchangeMessageTrace.
Добавлено qrCode в качестве нового поддерживаемого значения для перечисления usageAuthMethod , которое является типом свойства authMethod для ресурсов credentialUsageSummary, userCredentialUsageDetails, userEventsSummary и userRegistrationActivitySummary . Это значение представляет использование QR-кода в качестве метода проверки подлинности.
Безопасность | Оповещения и инциденты
Добавлено свойство priorityScore к ресурсу инцидента , чтобы обеспечить оценку приоритета для инцидента от 0 до 100, при > этом 85 — это главный приоритет, 15–85 — средний приоритет и < 15 — низкий приоритет. Эта оценка создается с помощью машинного обучения и основана на нескольких факторах, включая серьезность, влияние на нарушение работы, аналитику угроз, типы оповещений, критичность активов, аналитику угроз, редкость инцидентов и дополнительные сигналы о приоритете.
Безопасность | Облачные зоны
Добавлена поддержка управления зонами в Microsoft Defender для облака, что позволяет организациям сегментировать многооблачные среды (Azure, AWS, GCP и DevOps или источники реестра) в логические группировки для управления доступом и безопасностью в большом масштабе. Тип ресурса зоны и связанный с ним ресурс среды позволяют последовательно применять элементы управления доступом с минимальными привилегиями и управлять коллекциями подключенных сред в Microsoft Graph.
Безопасность | Безопасность данных и соответствие требованиям
- Не рекомендуется использовать свойство accessedResources в processConversationMetadata в пользу свойства accessedResources_v2 .
- Используйте свойство accessedResources_v2в processConversationMetadata , чтобы получить подробные сведения о ресурсах, к ним обращается беседа, включая идентификаторы, тип доступа и состояние.
- Используйте свойство agents в processConversationMetadata , чтобы получить сведения об агентах ИИ, которые участвовали в подготовке сообщения.
- Добавлено свойство contentCategory для processConversationMetadata и processFileMetadata , чтобы указать, создано ли содержимое ИИ.
Командная работа и коммуникации | Приложения
Используйте свойство layoutType в ресурсе канала , чтобы создавать каналы с различным взаимодействием с беседами и переключаться между ними в любое время. Свойство поддерживает два значения: post для традиционного формата после ответа и chat для взаимодействия с потоками в чате. Вы можете задать тип макета при создании канала и обновить его позже, чтобы переключаться между макетами.
— TeamsAppInstallation.ManageSelectedForTeam.All это наименее привилегированное разрешение приложения, необходимое для установки или обновления приложения Teams, которому требуется согласие на разрешения на согласие для конкретных ресурсов (RSC) при использовании teamsAppInstallation в API обновления команды .
Администрирование клиента | Управление конфигурацией
Новые API-интерфейсы управления конфигурацией клиента в Microsoft Graph позволяют администраторам управлять параметрами конфигурации для одной или нескольких рабочих нагрузок в организации. Дополнительные сведения о поддерживаемых вариантах использования см. в статье Использование API управления конфигурацией клиента в Microsoft Graph (предварительная версия).
Декабрь 2025 г.: новые и общедоступные
Календари | Places
- Создание, получение потомков и удалениеместа и его производных объектов (например, здание, стол, этаж или раздел). Эти API обеспечивают масштабируемое подключение и управление каталогом Places.
- Новые API-интерфейсы сопоставления в Places позволяют приложениям с соответствующими разрешениями на чтение или запись взаимодействовать с объектами признаков карты. Дополнительные сведения см. в статье Работа с API Places в Microsoft Graph.
- Используйте ресурс checkInClaim, чтобы представить состояние проверка в календаре Outlook, забронированного в месте. Дополнительные сведения см. в разделах Создание checkInClaim и Получение checkInClaim.
- Используйте свойство wifiState в здании , чтобы указать, есть ли в здании Wi-Fi.
- Используйте свойство heightAdjustableState на столе , чтобы указать, регулируется ли высота стола.
- Используйте свойство teamsEnabledState в комнате , чтобы указать, включена ли комната для Microsoft Teams.
- Используйте свойство placeId в помещении и рабочей области в качестве альтернативного неизменяемого уникального идентификатора.
- Используйте ресурс unavailablePlaceMode , чтобы указать, почему рабочий стол или рабочая область помечены как недоступные для бронирования.
Командная работа и коммуникации | Администрирования
Получение или перечисление пользовательских конфигураций для пользователей с учетными записями в контексте Teams.
Командная работа и коммуникации | Звонки и собрания по сети
- Используйте свойство sensitivityLabelAssignment в onlineMeeting и virtualEventSession , чтобы указать метку конфиденциальности, применяемую к собранию Teams.
- Используйте свойство expiryDateTime в onlineMeeting и virtualEventSession , чтобы указать дату и время истечения срока действия ресурса собрания.
- Используйте свойство meetingSpokenLanguageTag в onlineMeeting и virtualEventSession , чтобы указать разговорный язык, используемый во время собрания для записи и транскрибирования.
- Используйте свойство meetingOptionsWebUrl в onlineMeeting и virtualEventSession , чтобы получить URL-адрес страницы параметров собрания Teams для указанного собрания.
Командная работа и коммуникации | Обмена сообщениями
При $expand=members включении API списков чатов возвращает не более 25 элементов, даже если указано большее $top значение.
Декабрь 2025 г.: новые только в предварительной версии
Календари | Places
Upsert один или несколько объектов помещает в асинхронном режиме.
Безопасность
Добавлена поддержка типов доказательств mailboxConfigurationEvidence и activeDirectoryDomainEvidence в оповещениях системы безопасности.
Ноябрь 2025 г.: новые возможности только в предварительной версии
Управление гибкими рабочими часами и расположениями с помощью следующих ресурсов: workHoursAndLocationsSetting, workPlanOccurrence и workPlanRecurrence. Эти ресурсы позволяют определить повторяющиеся и конкретные шаблоны работы, расположения и время отгула для современных гибридных сценариев.
Командная работа и коммуникации | Приложения
Управление приложениями Teams на уровне канала в команде с помощью следующих API:
- Вывод списка приложений в канале.
- Получение приложения в канале.
- Включение нового приложения Teams в канале.
- Отключение приложения в канале.
Сентябрь 2025 г.: новые и общедоступные
Приложения
Используйте свойство signInAudienceRestrictions в ресурсе приложения, чтобы ограничить мультитенантные приложения определенными клиентами Microsoft Entra. Эта функция позволяет организациям ограничить использование приложений определенным списком разрешенных идентификаторов клиентов, обеспечивая расширенные средства управления безопасностью и соответствием для мультитенантных сценариев.
Управление устройствами и приложениями | Облачная печать
Используйте новые поддерживаемые размеры мультимедиа в свойстве mediaSizes ресурса printerCapabilities .
Файлы
- Используйте API задач миграции между клиентами SharePoint в Microsoft Graph, чтобы позволить организациям управлять задачами во время миграции клиента в клиент. Дополнительные сведения см. в статье sharePointMigrationTask.
- Используйте удаленное свойство sharePointGroupIdentityMapping и sharePointUserIdentityMapping , чтобы указать, что сопоставление удостоверений было успешно удалено.
Удостоверение и доступ | Управление
- Используйте следующие ресурсы, чтобы представить данные, отправляемые Azure Logic Apps в рамках запроса на выноску настраиваемого расширения при использовании пользовательского расширения в каталоге:
- accessPackageAssignmentCalloutData — для назначений пакетов доступа
- accessPackageAssignmentRequestCalloutData — для запросов на назначение пакета доступа
- Добавлены ресурс controlConfiguration и отношение controlConfigurations к ресурсу entitlementManagement для представления политик, управляющих жизненным циклом и доступом к пакетам в организации.
- Добавлен ресурс entraIdProtectionRiskyUserApproval, который представляет конфигурацию утверждения для рискованных пользователей, обнаруженных Microsoft Entra ID Protection.
- Добавлен ресурс insiderRiskyUserApproval, который представляет конфигурацию утверждения для рискованных пользователей, обнаруженных Управление внутренними рисками Microsoft Purview.
Удостоверение и доступ | Удостоверение и вход в систему
Добавлено microsoftRevokedSessions значение в перечисление riskDetail , чтобы указать, что корпорация Майкрософт отозвала сеансы. Этот член перечисления применяется к следующим Microsoft Entra ресурсам защиты идентификации: riskDetection, riskUserActivity, riskyUser и signIn.
Удостоверение и доступ | Сетевой доступ
Настройте сообщение страницы блокировки, отображаемое для пользователей, когда глобальный безопасный доступ блокирует их доступ к веб-ресурсам. Используйте ресурс customBlockPage для настройки пользовательских сообщений с ограниченной поддержкой Markdown.
Почта
- Используйте ресурс userConfiguration и связанные с ним методы для управления пользовательскими параметрами, метаданными или данными приложения, связанными с папками почтовых ящиков, с помощью форматов XML, двоичных файлов или словарей.
- API callRecord: getPstnCalls теперь поясняет, что он не возвращает сведения только для планов звонков Telstra .
- Следующие конечные точки больше не поддерживаются для управления рабочим расположением пользователей:
POST /users/{usersId}/presence/clearAutomaticLocationPOST /communications/presences/{presenceId}/clearAutomaticLocationPOST /users/{usersId}/presence/clearLocationPOST /communications/presences/{presenceId}/clearLocationPOST /users/{usersId}/presence/setAutomaticLocationPOST /communications/presences/{presenceId}/setAutomaticLocationPOST /users/{usersId}/presence/setManualLocationPOST /communications/presences/{presenceId}/setManualLocation
Отчеты | Отчеты об удостоверениях и доступе
- Удален тип ресурса conditionalAccessAudience . Тип возвращаемого значения свойства conditionalAccessAudiencesтипа ресурса signIn представляет собой коллекцию объектов String, а не сложный тип conditionalAccessAudience .
Командная работа и коммуникации | Звонки и собрания по сети
- При
$expand=membersвключении API списков чатов возвращает не более 25 элементов, даже если указано большее$topзначение. - Следующие конечные точки больше не поддерживаются для управления рабочим расположением для пользователя:
POST /users/{usersId}/presence/clearAutomaticLocationPOST /communications/presences/{presenceId}/clearAutomaticLocationPOST /users/{usersId}/presence/clearLocationPOST /communications/presences/{presenceId}/clearLocationPOST /users/{usersId}/presence/setAutomaticLocationPOST /communications/presences/{presenceId}/setAutomaticLocationPOST /users/{usersId}/presence/setManualLocationPOST /communications/presences/{presenceId}/setManualLocation
Командная работа и коммуникации | Обмена сообщениями
- Добавлена поддержка подписок членства в каналах для получения оповещений об изменениях непрямого членства для общих каналов.
- Добавлено новое уведомление об изменениях для членства в общем канале, когда канал предоставляется команде или не предоставляет общий доступ.
- Получение определенного члена из коллекции allMembers канала. Этот API обеспечивает единый доступ как к прямым, так и к косвенным членам во всех типах каналов, включая общие каналы.
- Начните миграцию внешних сообщений, включив режим миграции в существующем канале.
- Начните миграцию внешних сообщений, включив режим миграции в существующем чате.
- Завершите миграцию внешних сообщений, удалив режим миграции из чата.
- Используйте свойство layoutType в ресурсе канала , чтобы создавать каналы с различным взаимодействием с беседами и переключаться между ними в любое время. Свойство поддерживает два значения:
postдля традиционного формата после ответа иchatдля взаимодействия с потоками в чате. Вы можете задать тип макета при создании канала и обновить его позже, чтобы переключаться между макетами.
Участие в 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.
Присоединяйтесь к нашей исследовательской группе, чтобы предоставить свои сведения о наших впечатлениях от разработчиков.