Microsoft 365 Copilot使用报告API正式发布

本文详细介绍了Microsoft 365 Copilot使用报告API的正式发布情况,包括API功能、使用方法和实际应用场景。文章还探讨了如何通过PowerShell脚本结合Entra ID数据增强Copilot使用数据分析,以及当前API存在的一些技术限制和解决方案。

Microsoft 365 Copilot使用报告API正式发布

正式发布很好,但Copilot使用报告API能做什么?

MC877369首次出现在2024年8月,宣布通过Graph使用报告API提供Microsoft 365 Copilot使用数据(Microsoft 365路线图项目396562)。最新更新(2025年10月6日)为API的正式可用性设定了新的时间表,预计将于2025年10月下旬开始推出,并在2025年11月下旬在全球完成。微软没有说明最近延迟发生的原因,也没有解释为什么将API从预览版转移到正式版需要这么长时间。

仍在测试端点

尽管Copilot使用报告API即将正式发布,但它仍然只能通过测试端点访问。只要API正常工作,这并没有什么问题。通常,通过测试端点访问的Microsoft Graph API正在积极开发中,以解决性能或可靠性问题,或完成转移到生产(V1.0)状态所需的功能。

使用Copilot使用报告API

我于2024年9月首次查看了该API,并得出结论:Copilot用户活动详情API可以带来最大的价值。如果您想执行以下操作,了解人们在哪些应用中使用Copilot是很有价值的信息:

  • 了解Copilot在哪些部门使用,以及哪些部门需要一些帮助才能开始使用。通过将Entra ID中的用户数据与Copilot使用数据结合,我们可以对使用数据进行切片和切块以生成更多见解(图1)。

  • 查找拥有昂贵(360美元/年)Microsoft 365 Copilot许可证的用户帐户,并自动删除未充分利用的许可证,以便将这些许可证重新分配给可能更常使用它们的人。失去Microsoft 365 Copilot许可证的人可能会对免费的Microsoft Copilot聊天功能感到满意。或者他们可能是公司中使用ChatGPT和其他AI工具而不是Copilot的人。

  • 这个主题的一个变体是将Microsoft 365审核数据与Copilot使用报告数据集成,以深入了解人们使用Copilot在做什么。目的再次是清除未充分利用的Microsoft 365 Copilot许可证,以便可以将这些许可证分配给其他人。

  • 我有一个脚本来创建跨多个工作负载的用户活动的复合图片。将Copilot使用数据添加到组合中很容易。

提供了示例PowerShell脚本来演示每个场景中探讨的原则。关键是使用数据本身很有趣,但当与其他易于访问的关于用户活动的Microsoft 365数据源结合时,它变得更强大。

广告:请记住允许完全显示报告数据的用户名和其他信息。如果不这样做,使用数据将被混淆(隐藏),并且无法与其他Microsoft 365源的数据匹配。

其他使用报告API

Microsoft 365支持一堆其他工作负载的使用报告API。并非Microsoft 365管理中心中特色的所有工作负载都可通过Graph API使用(如Forms、Project、Visio和Viva Learning)。一些子报告(如Copilot代理)也是如此。然而,有足够的数据可用,能够全面了解人们如何使用Microsoft 365。

报告SharePoint URL的问题(首次于2023年9月报告)仍然存在。一些安全问题显然限制了Microsoft在网站活动报告(由getSharePointSiteUsageDetail API提供支持)中包含网站URL的能力,这意味着为网站返回的使用数据看起来像这样:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
Report Refresh Date      : 2025-10-07
Site Id                  : 66bbf297-2f09-43ec-ab94-9333deacf769
Site URL                 :
Owner Display Name       : Project Haycock Owners
Is Deleted               : False
Last Activity Date       : 2025-05-23
File Count               : 375
Active File Count        : 131
Page View Count          : 0
Visited Page Count       : 0
Storage Used (Byte)      : 110786012
Storage Allocated (Byte) : 27487790694400
Root Web Template        : Group
Owner Principal Name     : projecthaycock@office365itpros.com
Report Period            : 180

站点ID可用于查找网站URL:

1
2
(Get-MgSite -SiteId '66bbf297-2f09-43ec-ab94-9333deacf769').WebUrl
https://office365itpros.sharepoint.com/sites/projecthaycock

为什么微软不会或不能解决这个恼人的问题是个谜。只是那些云谜团之一…

comments powered by Disqus
使用 Hugo 构建
主题 StackJimmy 设计