Microsoft Graph 新增功能
Microsoft Graph 提供了一个统一的可编程性模型，可用于访问 Microsoft 365、Windows 和 企业移动性 + 安全性 中的数据。 本文提供有关 Microsoft Graph API、文档、SDK 等中的新增功能的信息。
有关 API 级别更新的更多详细信息，请参阅Microsoft图形 API更改日志。
有关 Microsoft Graph 以前更新的详细信息，请参阅 Microsoft Graph 新增历史记录。
重要
预览状态中的功能可能会更改，无需通知，并且可能不会提升为正式版 (GA) 状态。 请勿在生产应用中使用预览功能。
2025 年 2 月：新增和正式发布
设备和应用管理 |云打印
使用 printSettings 上的 printerDiscoverySettings 属性指定在使用通用打印时影响打印机发现的设置。
安全性
添加了 teamsMessageEvidence 作为支持的 警报证据。
安全性 |电子数据展示
- 已启用 contentQuery 作为 ediscoveryHoldPolicy 资源的更新作支持的参数。
- 列出并删除 userSource 或 siteSource 对象。
- 删除unifiedGroupSource。
团队合作和沟通 |通话和联机会议
- 提取 Teams 实时事件的录制。
- 在 onlineMeeting的更新作中启用 allowRecording、allowTranscription、anonymizeIdentityForRoles、broadcastSettings 和 watermarkProtection 作为支持的属性。
团队合作和沟通 |消息
2025 年 2 月：仅预览版新增功能
备份存储
- 使用 driveProtectionUnit、mailboxProtectionUnit 和 siteProtectionUnit 上的 protectionSources 属性获取保护单元当前受到保护的源。
- 更新driveProtectionRule 或 mailboxProtectionRule。
- 删除并取消保护driveProtectionRule 或 mailboxProtectionRule 中动态规则保护的所有项目。
- 使用 Create driveRestoreArtifactsBulkAdditionRequests 方法时，已启用 directoryObjectIds 和 drive 属性作为支持的属性。
- 使用 Create mailboxRestoreArtifactsBulkAdditionRequest 方法时，已启用 directoryObjectIds 和邮箱属性作为支持的属性。
- 使用 Create siteRestoreArtifactsBulkAdditionRequests 方法时，已启用 siteIds 和 siteWebUrls 属性作为支持的属性。
安全性 |电子数据展示
- 添加了 itemsToInclude、 cloudAttachmentVersion、 documentVersion、 additionalDataOptions 和 statisticsOptions 作为电子数据展示 API 的各种资源和作支持的属性和参数。
- 已启用 contentQuery 作为 ediscoveryHoldPolicy 资源的更新作支持的参数。
- 列出并删除 userSource 或 siteSource 对象。
- 删除unifiedGroupSource。
设备和应用管理|云电脑
- 获取不可访问的云电脑趋势的每周区域聚合报告。
- 获取 云电脑的故障排除报告。
身份和访问 | 身份和登录
替换了用于管理自定义身份验证扩展的以下 API作：
| 旧终结点 | 建议的终结点 |
|---|---|
GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionStartListener/handler/microsoft.graph.onAttributeCollectionStartCustomExtensionHandler/customExtension GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionSubmitListener/handler/microsoft.graph.onAttributeCollectionSubmitCustomExtensionHandler/customExtension GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.OnEmailOtpSendListener/handler/microsoft.graph.OnOtpSendCustomExtensionHandler/customExtension
|
GET /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} |
PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionStartListener/handler/microsoft.graph.onAttributeCollectionStartCustomExtensionHandler/customExtension/$ref PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionSubmitListener/handler/microsoft.graph.onAttributeCollectionSubmitCustomExtensionHandler/customExtension/$ref PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onEmailOtpSendListener/handler/microsoft.graph.onOtpSendCustomExtensionHandler/customExtension/$ref |
PATCH /identity/customAuthenticationExtensions/{customAuthenticationExtensionId} |
安全性
添加了 teamsMessageEvidence 作为支持的 警报证据。
网站和列表
为网站启用了应用程序权限Sites.Archive.All：存档和站点：unarchive 方法。
任务和计划
- 列出 Teams 中共享频道拥有Planner计划。
- 更新了 List businessScenarioTasks 方法的请求 URL，要求
$filter查询参数将请求范围限定为 externalObjectId、 externalContextId 或 groupId。
团队合作和沟通 |通话和联机会议
在 onlineMeeting的更新作中启用 allowRecording、allowTranscription、anonymizeIdentityForRoles、broadcastSettings 和 watermarkProtection 作为支持的属性。
团队合作和沟通 |消息
- 引入了以下更精细的委托和应用程序权限，用于检索通道的所有成员：
-
ChannelMember.Read.All使用委托的权限，Group.Read.All而不是委托的权限。 - 使用
ChannelMember.Read.Group和ChannelMember.ReadWrite.Group应用程序权限进行特定于资源的许可。
-
- 使用 RSC 授予的应用创建一对一聊天。
2025 年 1 月：新增和正式发布
文件
更新了 fileStorageContainer： restore 方法的终结点。
身份和访问 | 身份和登录
为 服务主体的可疑 API 流量检测添加了 riskEventType 条目。
Microsoft Graph Bicep 模板
现在可以在 Bicep 模板中为基础结构部署用户资源，即代码 (IaC) 项目。 有关详细信息，请参阅 Microsoft.Graph 用户 Bicep 参考。
团队合作和沟通 |通话和联机会议
- Microsoft Teams 自定义会议模板允许为会议组织者提供的许多会议选项指定值。 使用 onlineMeeting 上的 meetingTemplateId 属性创建具有会议模板的联机会议。
- 使用 allowBreakoutRooms、 allowLiveShare、 allowPowerPointSharing 和 allowWhiteboard 指示在 onlineMeeting 或 virtualEventSession 中是否启用了分组讨论室、实时共享、PowerPoint live 和白板功能。
- 使用 onlineMeeting 上的 allowedLobbyAdmitters 属性获取或设置可从大厅中允许的用户。
- 使用 onlineMeeting 和 virtualEventSession 上的 allowRecording 和 allowTranscription 属性来指示是否为会议或虚拟事件会话启用了录制或听录。
团队合作和沟通 |消息
2025 年 1 月：仅限预览版中的新增功能
更改通知
已启用更改通知，支持用于 列出、 获取、 创建、 更新、 删除和 重新授权aiInteraction 订阅的方法。
设备和应用管理|云电脑
- 使用 所选云电脑重试批量作。
- 使用 cloudPC 上的 productType 属性可以获取云电脑的产品类型或按产品类型筛选云电脑。
- 弃用了 cloudPcReports 资源的 getCloudPcPerformanceReport 方法，转而改用 retrieveCloudPcTenantMetricsReport 方法。
文件
更新了 fileStorageContainer： restore 方法的终结点。
身份和访问 | 目录管理
- 使用设备上的alternativeNames 属性获取或设置设备的备用名称。
- 使用 deviceTemplate 资源及其关联方法来管理 Microsoft Entra ID 中的设备的设备模板。
- 使用 mutualTlsOauthConfiguration 资源及其关联方法来管理证书颁发机构，这些证书颁发机构允许为用于 mTLS 的一组特定对象颁发证书。
身份和访问 | 身份和登录
添加了对使用以下对象在 Microsoft Entra 外部 ID 中为一次性密码 (OTP) 配置自定义电子邮件提供程序的支持：
- onOtpSendCustomExtension 资源类型，用于配置自定义身份验证扩展，其中包含可能是 Azure 函数的外部服务的配置详细信息。
- onEmailOtpSendListener 资源类型，用于配置触发的事件侦听器，以便基于 onOtpSendCustomExtension 对象中的配置详细信息向用户发送 OTP 提示。
此功能还允许在自定义身份验证扩展未成功调用时配置默认回退选项。
行业数据 ETL
使用 industryDataRun 资源上的启动作执行按需运行，限制限制为每 12 小时最多成功运行 5 次。
邮箱导入和导出
使用 Microsoft Graph 中的新邮箱导入和导出 API 生成与邮箱资源集成的解决方案，以用于数据导入和导出方案。 有关详细信息，请参阅 Microsoft Graph 中的邮箱导入和导出 API 概述。
报告 | 身份和访问报告
添加了 attributeCollectionStart、 attributeCollectionSubmit和 emailOtpSend 作为 appliedAuthenticationEventListener 资源的 eventType 属性支持的值。
网站和列表
任务和计划
使用 teamsChannel 容器类型在 Microsoft Teams 中的共享频道中创建计划。
团队合作和沟通 |通话和联机会议
获取 Microsoft Teams 紧急呼叫事件更新的更改通知。
团队合作和沟通 |消息
获取包含Microsoft Loop组件作为两个附件的聊天消息。
参与Microsoft图形
是否有希望 Microsoft Graph 支持的方案？
使用 Microsoft Graph 反馈门户为新功能提供建议和投票。 某些新功能来源于开发人员社区的热门请求。 Microsoft Graph 团队定期评估客户需求，并将新功能发布到 beta ()
https://graph.microsoft.com/beta和 v1.0 (https://graph.microsoft.com/v1.0) 终结点。加入 每周Microsoft 365 平台社区通话，成为 Microsoft Graph 社区的活跃成员。 若要了解开发人员呼叫的完整日历，请访问 Microsoft 365 和 Power Platform 社区页面。
加入我们 的研究面板，提供有关开发人员体验的意见。