Microsoft 365 使用情况分析数据模型

Microsoft 365 使用情况分析表的数据

Microsoft 365 使用情况分析连接到公开多维数据模型的 API。 Microsoft 365 使用情况分析用于生成其数据的 API 来自各种正式版 Graph API。 Microsoft 365 使用情况分析 API 的功能本身并不正式发布。

注意

有关详细信息，请参阅 在 Microsoft Graph 中使用 Microsoft 365 使用情况报告。

此 API 提供有关各种 Microsoft 365 服务的每月使用趋势的信息。 有关 API 返回的确切数据，请参考以下部分中的表。

Microsoft 365 报告 API 返回的数据表

表名	表中信息	日期范围
租户产品使用情况	包含已启用用户、活动用户、每月保留用户、首次使用用户和累积活动用户的每月总计。	包含滚动的为期 12 个月（包含当月）的每月汇总数据。
租户产品活动	包含产品中各种活动的每月活动总数和活跃用户计数。 有关在此数据表中返回的产品中的活动的信息，请参阅活动用户定义。	包含滚动的为期 12 个月（包含当月）的每月汇总数据。
租户 Office 许可证	包含分配给用户的 Microsoft Office 订阅数的数据	包含滚动 12 个月期间（包括当前部分月份）的月末状态数据。
租户邮箱使用情况	包含有关用户邮箱的总邮箱计数和存储使用方式的数据。	包含滚动 12 个月期间（包括当前部分月份）的月末状态数据。
租户客户端使用情况	包含有关主动使用特定客户端/设备连接到Exchange Online、Skype for Business和Viva Engage的用户数的数据。	包含滚动的为期 12 个月（包含当月）的每月汇总数据。
租户 SharePoint Online 使用情况	包含有关 SharePoint 网站（包括团队网站或组网站）的数据，如网站总数、网站上的文档数、各活动类型的文件数和已用存储。	包含滚动 12 个月期间（包括当前部分月份）的月末状态数据。
租户 OneDrive for Business 使用情况	包含有关 OneDrive 帐户的数据，如帐户数、跨 OneDrive 的文档数、已用存储、各活动类型的文件数。	包含滚动 12 个月期间（包括当前部分月份）的月末状态数据。
租户Microsoft 365 组使用情况	包含有关Microsoft 365 组使用情况的数据，包括 Mailbox、SharePoint 和 Viva Engage。	包含滚动 12 个月期间（包括当前部分月份）的月末状态数据。
租户 Office 激活	包含有关 Office 订阅激活数、每个设备的激活计数 (Android/iOS/Mac/PC) 、按服务计划（例如，Microsoft 365 企业应用版、Visio、Project）激活的数据。	包含滚动 12 个月期间（包括当前部分月份）的月末状态数据。
用户状态	包含有关用户的元数据，包括用户显示名称、分配的产品、位置、部门、职务、公司。 此数据与在上个月分配了许可证的用户有关。 每个用户都由用户 ID 唯一表示。	此数据有关在刚刚结束的一个月内分配到许可证的用户。
用户活动	包含有关授权用户执行的活动的每用户级别的信息。 有关在此数据表中返回的产品中的活动的信息，请参阅活动用户定义。	此数据有关刚刚结束的一个月内在任何服务中执行活动的用户。

展开以下各部分，查看每个数据表的详细信息。

数据表 - 用户状态

此表提供了在上个月分配了许可证的所有用户的用户级别详细信息。 它从Microsoft Entra ID引入数据。

列名称	列说明
UserID	表示用户的唯一用户 ID，并启用与数据集内其他数据表的联接。
Timeframe	月份值，此表包含该月份的数据。
UPN	用户主体名称，用于唯一标识用户，使其能够与其他外部数据源联接。
DisplayName	用户的显示名称。
IDType	如果用户是使用其Viva Engage ID 进行连接的Viva Engage用户，则 ID 类型设置为 1;如果用户使用 Microsoft 365 ID 连接到Viva Engage，则 ID 类型设置为 0。 值为 1 表示此用户使用其Viva Engage ID 而不是 Microsoft 365 ID 连接到Viva Engage
HasLicenseEXO	如果用户在每月的最后一天分配了许可证并启用 Exchange，则设置为 true。
HasLicenseODB	如果为用户分配了许可证并启用在当月的最后一天使用OneDrive for Business，则设置为 true。
HasLicenseSPO	如果为用户分配了许可证并启用了在当月的最后一天使用 SharePoint Online，则设置为 true。
HasLicenseYAM	如果为用户分配了许可证并启用在当月最后一天使用Viva Engage，则设置为 true。
HasLicenseSFB	如果用户在每月的最后一天分配了许可证并启用使用 Skype For Business，则设置为 true。
HasLicenseTeams	如果用户分配了许可证并启用在当月的最后一天使用 Microsoft Teams，则设置为 true。
Company	此用户的 Microsoft Entra ID 中表示的公司数据。
部门	此用户的 Microsoft Entra ID 中表示的部门数据。
LocationCity	此用户的 Microsoft Entra ID 中表示的城市数据。
LocationCountry	此用户的 Microsoft Entra ID 中表示的国家/地区数据。
LocationState	此用户以 Microsoft Entra ID 表示的状态数据。
LocationOffice	用户的 Office。
标题	此用户的 Microsoft Entra ID 中表示的游戏数据。
Deleted	如果在上个月从 Microsoft 365 中删除了用户，则为 True。
DeletedDate	从 Microsoft 365 中删除用户的日期。
YAM_State	Viva Engage系统中用户的状态可以是活动、删除或挂起。
YAM_ActivationDate	用户在Viva Engage中输入活动状态的日期。
YAM_DeletionDate	用户在 Viva Engage 中输入删除状态的日期。
YAM_SuspensionDate	用户在Viva Engage中进入暂停状态的日期。

数据表 - 用户活动

此表包含有关上个月在任何服务中有活动的每个用户的数据。

列名称	列说明
UserID	表示用户的唯一用户 ID，并启用与数据集内其他数据表的联接。
IDType	如果用户是使用其Viva Engage ID 进行连接的Viva Engage用户，则 ID 类型设置为 1;如果用户使用 Microsoft 365 ID 连接到Viva Engage，则 ID 类型设置为 0。 值为 1 表示此用户使用其Viva Engage ID 而不是 Microsoft 365 ID 连接到Viva Engage
Timeframe	月份值，此表代表该月份的数据。
EXO_EmailSent	发送的邮件数。
EXO_EmailReceived	接收的邮件数。
EXO_EmailRead	用户执行的电子邮件读取活动数，可能是多次阅读已阅读的电子邮件或以前收到的电子邮件。
EXO_AppointmentCreated	创建的约会数。
EXO_MeetingAccepted	接受的会议数。
EXO_MeetingCancelled	已取消的会议数。
EXO_MeetingDeclined	会议数已减少。
EXO_MeetingSent	已发送的会议数。
ODB_FileViewedModified	此用户在任何 OneDrive for Business 上与其进行了交互（如创建、更新、删除、查看或下载）的文件数。
ODB_FileSynched	此用户在任何 OneDrive for Business 上同步的文件数。
ODB_FileSharedInternally	此用户从任何OneDrive for Business内部共享的文件数，或者与组 (（可能包括外部用户) ）中的用户共享的文件数。
ODB_FileSharedExternally	此用户从任何 OneDrive for Business 进行外部共享的文件数。
ODB_AccessedByOwner	用户与其交互的驻留在其自己的OneDrive for Business上的站点数。
ODB_AccessedByOthers	此用户与之交互的、驻留在另一个用户的OneDrive for Business上的站点数。
SPO_GroupFileViewedModified	此用户在任何组网站上与之交互的文件数。
SPO_GroupFileSynched	此用户在任何组网站上进行同步的文件数。
SPO_GroupFileSharedInternally	已与组织内的用户或组内用户共享的文件计数， (可能包括外部用户) 。
SPO_GroupFileSharedExternally	此用户从任何组网站进行外部共享的文件数。
SPO_GroupAccessedByOwner	用户与其交互的、位于其拥有的组网站上的站点数。
SPO_GroupAccessedByOthers	用户与另一个用户拥有的组站点上交互的网站数。
SPO_OtherFileViewedModified	此用户在任何其他网站上与之交互的文件数。
SPO_OtherFileSynched	此用户从任何其他站点同步的文件数。
SPO_OtherFileSharedInternally	此用户从任何其他网站内部共享的文件数，或者与组内的用户共享的文件数， (可能包括外部用户) 。
SPO_OtherFileSharedExternally	此用户从任何其他网站外部共享的文件数。
SPO_OtherAccessedByOwner	用户与其交互的驻留在其拥有的其他网站上的网站数。
SPO_OtherAccessedByOthers	用户与之交互的网站数，这些站点位于其他用户拥有的其他网站上。
SPO_TeamFileViewedModified	与此用户在任何团队网站上进行交互的文件数。
SPO_TeamFileSynched	此用户从任何团队网站进行同步的文件数。
SPO_TeamFileSharedInternally	此用户从任何团队网站内部共享的文件数，或者与组内的用户共享的文件数， (可能包括外部用户) 。
SPO_TeamFileSharedExternally	此用户从任何团队网站进行外部共享的文件数。
SPO_TeamAccessedByOwner	用户与其交互的驻留在其拥有的团队网站上的网站数。
SPO_TeamAccessedByOthers	用户与另一个用户拥有的团队网站上交互的网站数。
Teams_ChatMessages	发送的聊天消息数。
Teams_ChannelMessage	发布到通道的消息数。
Teams_CallParticipate	用户参与的呼叫数。
Teams_MeetingParticipate	用户加入的会议数。
Teams_HasOtherAction	如果用户在 Microsoft Teams 中执行其他操作，则为布尔值。
YAM_MessagePost	此用户发布的Viva Engage消息数。
YAM_MessageLiked	此用户喜欢的Viva Engage消息数。
YAM_MessageRead	此用户读取的Viva Engage消息数。
SFB_P2PSummary	此用户参与的对等会话数。
SFB_ConfOrgSummary	此用户组织的会议会话数。
SFB_ConfPartSummary	此用户参与的会议会话数。

注意

Teams_HasOtherAction意味着用户被视为活动用户，但聊天消息、1：1 通话、频道消息、会议总数和会议组织为零。

数据表 - 租户产品使用情况

此表提供了 Microsoft 365 中每个产品的启用、活跃、返回和首次用户方面的月度采用数据。 Microsoft 365 值表示任一产品中的活跃使用情况。

列名称	列说明
Product	产品名称，已汇总该产品的使用情况信息。 产品列中的 Microsoft 365 值表示任何产品的活动
Timeframe	月份值。 对于过去 12 个月（包括当月），每个产品每月对应一行。
EnabledUsers	启用将产品用于时间范围值的用户数，如果为用户启用了当月的一部分时间，则仍会将其计算在内。
ActiveUsers	在产品中针对时间范围值执行有意活动的用户数。 如果某一用户在某一特定月份内在产品中执行了某一关键活动，则将该用户计为该月该产品的活动用户。 租户产品活动 表中列出了各项关键活动。
CumulativeActiveUsers	允许使用产品，且自在新使用情况系统中启用数据收集起在截至时间范围月份前至少使用了一次产品的用户数。
MoMReturningUsers	在时间范围月份内处于活动状态，且在上个月中也处于活动状态的用户数。
FirstTimeUsers	自在新使用情况系统中启用数据收集起在时间范围内首次处于活动状态的用户数。 如果自在此新报告系统中启用数据收集起，首次检测到某一用户的活动，该用户将被视为某一特定月份中首次使用的用户。 一旦被计为首次用户，即使此用户的活动存在较大差距，他们也不会再次被计为第一次用户
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。

数据表 - 租户产品活动

此表提供产品内各种活动的每月活动总数和活动用户计数。

列名称	列说明
Timeframe	月份值。 对于过去 12 个月（包括当月），每个产品每月对应一行。
产品	Microsoft 365 中提供使用情况数据的产品的名称。
活动	产品中用于展示积极使用产品的活动的名称。
ActivityCount	这是所有活动用户在产品中执行的每个活动的操作总数。 注意： 对于 SharePoint Online 和 OneDrive for Business 活动，此值表示用户与之交互的不同文档数。
ActiveUserCount	在产品中执行活动的用户数。
TotalDurationInMinute	所有活动用户在适当 Skype for Business 活动中使用音频或视频会话的持续分钟数。
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。

数据表 - 租户邮箱使用情况

此表包含具有用户邮箱的所有许可Exchange Online用户的摘要数据。 它包含跨所有用户邮箱的月末状态。 此表中的数据不会跨多个月累加。 此表中的最新月份的数据表示最新状态。

列名称	列说明
TotalMailboxes	Microsoft 365 订阅的用户邮箱数。
IssueWarningQuota	针对所有用户邮箱发出警告的总配额。
ProhibitSendQuota	跨所有用户邮箱禁止发送的总配额。
ProhibitSendReceiveQuota	跨所有用户邮箱禁止发送接收配额的总配额。
TotalItemBytes	跨所有用户邮箱使用的、以字节为单位的存储量。
MailboxesNoWarning	低于存储警告限制的用户邮箱数。
MailboxesIssueWarning	针对存储配额发出警告的用户邮箱数。
MailboxesExceedSendQuota	已超出发送配额的用户邮箱数。
MailboxesExceedSendReceiveQuota	超过发送/接收配额的用户邮箱数。
DeletedMailboxes	在时间范围内删除的用户邮箱数。
Timeframe	月份值。
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。

数据表 - 租户客户端使用情况

此表提供了有关用户用于连接到Exchange Online、Skype for Business和Viva Engage的客户端的月度汇总数据。 此表尚没有 SharePoint Online 和 OneDrive for Business 的客户端使用数据。

列名称	列说明
产品	Microsoft 365 中提供客户端使用情况数据的产品的名称。
ClientId	用于连接到产品的每个设备的名称。
UserCount	针对每个产品使用每个客户端的用户数。
Timeframe	月份值
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。

数据表 - 租户 SharePoint Online 使用情况

此表包含有关 SharePoint Online 网站的使用情况或活动的逐月汇总数据。 这仅包含团队网站和组网站。 SharePoint Online 网站的月末状态在此列中表示，例如，如果用户创建了 5 个文档，使用 10 MB 的总存储空间，然后删除了一些文件，并添加了更多文件，以便文件的月末状态为 7 个，总共使用 5 MB 的存储空间， 此表中表示的值是月末状态。 此表处于隐藏状态，以避免汇总时重复计数，并用作创建两个引用表的源。

列名称	列说明
SiteType	网站类型值（任意/团队/组）（任意表示这两种网站类型均可）。
TotalSites	在时间范围结束时存在的网站数。
DocumentCount	在时间范围结束时存在于网站上的文档总数。
Diplansed	在时间范围结束时，所有网站的已用存储总计。
ActivityType	记录文件活动的各种类型（任何/活动文件/共享 EXT/INT 的文件/同步的文件）的网站数。 表示执行的任何文件活动。
SitesWithOwnerActivities	活动网站数，其中网站所有者在其自己的网站上执行特定文件活动。 可以从 PowerShell 命令 get-sposite 获取网站所有者。 这是对网站负责的人员。
SitesWithNonOwnerActivities	该月汇总的活动网站数，其中除网站所有者之外的用户在网站上执行特定文件活动。 可以从 PowerShell 命令 get-sposite 获取网站所有者。 这是对网站负责的人员。
ActivityTotalSites	记录时间范围内的任何活动的网站数。 如果某一网站在时间范围早期具有活动，但在时间范围结束时被删除，仍会将其计入该时间范围内活动网站。
Timeframe	此列包含日期值。 用作日历表的多对一关系。
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。

数据表 - 租户 OneDrive 使用情况

此表提供有关 OneDrive 帐户的数据，如帐户数、跨 OneDrive 帐户的文档数、使用的存储、各活动类型的文件数。 此外，此表中还展示了 OneDrive for Business 帐户的月末状态。 例如，如果用户创建了一个使用 10 MB 存储空间的五个文档，然后删除了一些文档并添加了更多文件，以便在月末他们拥有使用 5 MB 存储空间的 7 个文件，则月底的此表中显示月末值。

列名称	列说明
SiteType	值为"OneDrive"。
TotalSites	在时间范围结束时存在的 OneDrive for Business 帐户数。
DocumentCount	在时间范围结束时，所有 OneDrive for Business 帐户中存在的文档总数
Diplansed	时间范围结束时，所有 OneDrive 帐户的已用总存储。
ActivityType	记录文件活动的各种类型（任何/活动文件/共享 EXT/INT 的文件/同步的文件）的帐户数。 任何表示执行任何文件活动
SitesWithOwnerActivities	活动 OneDrive for Business 帐户数，其中帐户所有者在其自己的帐户上执行特定文件活动。
SitesWithNonOwnerActivities	OneDrive for Business 帐户计数，其中文件活动由除帐户所有者之外的用户执行。
ActivityTotalSites	在时间范围内记录任何活动的 OneDrive for Business 帐户数。 如果某一 OneDrive for Business 帐户在时间范围早期具有活动，但在时间范围结束时被删除，仍会将其计入该时间范围的活动 OneDrive for Business 帐户。
Timeframe	此列包含日期值。 用作日历表的多对一关系。
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。

数据表 - 租户Microsoft 365 组使用情况

此表提供有关如何在组织中使用Microsoft 365 组的数据。

---

列名称	列说明
时间	月份值。 对于过去 12 个月（包括当月），每个产品每月对应一行。
GroupType	(专用/公共/任何) 的组类型。
TotalGroups	每个组类型中的组数。
ActiveGroups	活动组数。
MBX_TotalGroups	邮箱组数。
MBX_ActiveGroups	活动邮箱组数。
MBX_TotalActivities	邮箱活动数。
MBX_TotalItems	邮箱项目数。
MBX_StorageUsed	使用的邮箱存储数量。
SPO_TotalGroups	SharePoint 组数。
SPO_ActiveGroups	活动 SharePoint 组的数目。
SPO_FileAccessedActiveGroups	具有文件访问活动的 SharePoint 组数。
SPO_FileSyncedActiveGroups	具有文件同步活动的 SharePoint 组数。
SPO_FileSharedInternallyActiveGroups	具有内部共享活动的 SharePoint 组数，或具有组 (的 SharePoint 组数，这些组可能包含) 的外部用户。
SPO_FileSharedExternallyActiveGroups	已共享外部活动的 SharePoint 组数。
SPO_TotalActivities	SharePoint 活动数。
SPO_FileAccessedActivities	访问的 SharePoint 文件活动数。
SPO_FileSyncedActivities	SharePoint 文件同步活动的数目。
SPO_FileSharedInternallyActivities	SharePoint 文件内部共享活动的数量，或者包含组 (，其中可能包含外部成员) 。
SPO_FileSharedExternallyActivities	外部共享活动的 SharePoint 文件数。
SPO_TotalFiles	SharePoint 文件数。
SPO_ActiveFiles	活动 SharePoint 文件的数目。
SPO_StorageUsed	使用的 SharePoint 存储数量。
YAM_TotalGroups	Viva Engage组数。
YAM_ActiveGroups	活动Viva Engage组的数目。
YAM_LikedActiveGroups	具有类似活动的Viva Engage组数。
YAM_PostedActiveGroups	具有发布活动的Viva Engage组数。
YAM_ReadActiveGroups	具有读取活动的Viva Engage组数。
YAM_TotalActivities	Viva Engage活动数。
YAM_LikedActivities	类似活动的Viva Engage数。
YAM_PostedActivties	Viva Engage发布活动的数目。
YAM_ReadActivites	读取活动Viva Engage数。

数据表 - 租户 Office 许可证

此表提供了有关用户许可证分配的月度摘要数据。

列名称	列说明
LicenseName	许可证的名称。
AssignedCount	分配的许可证数。
Timeframe	月份值。

数据表 - 租户 Office 激活

该表提供了有关跨服务计划的 Office 订阅激活数的数据，例如，企业Microsoft 365 应用版、Visio、Project。 此外，它还提供了有关每个设备 (Android/iOS/Mac/PC) 的激活次数的数据。

列名称	列说明
ServicePlanName	服务计划名称值列表和通过设备进行的激活次数，如以下列所示。
TotalEnabled	在时间范围结束时，允许使用每个服务计划的用户数（按服务计划名称排列）。
TotalActivatedUsers	在时间范围结束时，激活每个服务计划的用户数。
AndroidCount	在时间范围结束时，Android 设备上每个服务计划的激活次数。
iOSCount	在时间范围结束时，iOS 设备上每个服务计划的激活次数。
MacCount	在时间范围结束时，MAC 设备上每个服务计划的激活次数。
PcCount	在时间范围结束时，PC 设备上每个服务计划的激活次数。
WinRtCount	在时间范围结束时，Windows Mobile 设备上每个服务计划的激活次数。
Timeframe	此列包含日期值。 用作日历表的多对一关系。
Content Date	如果时间范围显示当前月，则此值表示数据可供使用的当前月的最后一天。 如果时间范围显示上个月，则此值表示上个月的最后一天。