Office 365 Adoption 内容包数据模型

注意: 此预发布文档用于公共预览,在未来版本中可能有所更改。

Office 365 Adoption 内容包表的数据

Office 365 Adoption 内容包连接到公开多维数据模型的 API。这些 API 处于预览状态,并可在 https://reports.office.com/pbi/v1.0/<tenantid> 进行访问(将 <tenant id> 替换为租户 GUID)。

注意: 有关详细信息,请参阅在 Microsoft Graph 中使用 Office 365 使用情况报表

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

Office 365 报告 API 返回的数据表

表名

表中信息

日期范围

租户产品使用情况

包含已启用的活动用户、逐月保留的用户、首次使用的用户和累积活动用户的每月总计。

包含滚动的为期 12 个月(包含当月)的每月汇总数据。

租户产品活动

包含活动以及产品中各种活动的活动用户计数的每月总计。

有关在此数据表中返回的产品中的活动的信息,请参阅活动用户定义

包含滚动的为期 12 个月(包含当月)的每月汇总数据。

租户 Office 许可证

包含分配给用户的 Microsoft Office 订阅数的数据

包含滚动的为期 12 个月(包含当月)的月末状态数据。

租户邮箱使用情况

包含有关用户邮箱的数据,即邮箱数总计和存储使用情况。

包含滚动的为期 12 个月(包含当月)的月末状态数据。

租户客户端使用情况

包含有关频繁使用特定客户端/设备连接到 Exchange Online、Skype for Business 和 Yammer 的用户数的数据。

包含滚动的为期 12 个月(包含当月)的每月汇总数据。

租户 SharePoint Online 使用情况

包含有关 SharePoint 网站(包括团队网站或组网站)的数据,如网站总数、网站上的文档数、各活动类型的文件数和已用存储。

包含滚动的为期 12 个月(包含当月)的月末状态数据。

租户 OneDrive for Business 使用情况

包含有关 OneDrive 帐户的数据,如帐户数、跨 OneDrive 的文档数、已用存储、各活动类型的文件数。

包含滚动的为期 12 个月(包含当月)的月末状态数据。

租户 Office 激活

包含有关 Office 订阅激活数、每个设备 (Android/iOS/Mac/PC) 激活次数、各服务计划(如 Office Proplus、Visio、Project)激活次数的数据。

包含滚动的为期 12 个月(包含当月)的月末状态数据。

用户状态

包含有关用户的元数据,包括用户显示名称、分配的产品、位置、部门、职务、公司。此数据有关在刚刚结束的一个月内分配到许可证的用户。每个用户都以唯一的用户 ID 表示。

此数据有关在刚刚结束的一个月内分配到许可证的用户。

用户活动

包含有关授权用户执行的活动的每用户级别的信息。

有关在此数据表中返回的产品中的活动的信息,请参阅活动用户定义

此数据有关刚刚结束的一个月内在任何服务中执行活动的用户。

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

下表提供了在刚刚结束的一个月内分配到许可证的所有用户的用户级别详细信息。其数据来自于 Azure Active Directory。

列名称

列说明

UserId

代表某一用户的唯一用户 ID,通过它可与数据集内的其他数据表联接。

Timeframe

月份值,此表包含该月份的数据。

UPN

用户主体名称,用于唯一标识用户,使其能够与其他外部数据源联接。

DisplayName

用户的显示名称。

IDType

如果用户是使用 Yammer ID 连接的 Yammer 用户,则 ID 类型设置为 1;如果使用 Office 365 ID 连接到 Yammer,则设置为 0。

值为 1 表示用户使用其 Yammer ID 而非其 Office 365 ID 连接到 Yammer

HasLicenseEXO

如果用户分配有许可证,并且能够使用 Exchange,则设置为 true。

HasLicenseODB

如果用户分配有许可证,并且能够使用 OneDrive for Business,则设置为 true。

HasLicenseSPO

如果用户分配有许可证,并且能够使用 SharePoint Online,则设置为 true。

HasLicenseYAM

如果用户分配有许可证,并且能够使用 Yammer,则设置为 true。

HasLicenseSFB

如果用户分配有许可证,并且能够使用 Skype For Business,则设置为 true。

Company

此用户在 Azure Active Directory 中对应的公司数据。

Department

此用户在 Azure Active Directory 中对应的部门数据。

LocationCity

此用户在 Azure Active Directory 中对应的城市数据。

LocationCountry

此用户在 Azure Active Directory 中对应的国家/地区数据。

LocationState

此用户在 Azure Active Directory 中对应的省/市/自治区数据。

LocationOffice

用户的 Office。

Title

此用户在 Azure Active Directory 中对应的职务数据。

Deleted

如果在刚刚结束的一个月内从 Office 365 中删除了该用户,则为 true。

DeletedDate

从 Office 365 中删除用户的日期。

YAM_State

Yammer 系统中的用户状态,可为活动、已删除或已挂起。

YAM_ActivationDate

用户在 Yammer 中进入活动状态的日期。

YAM_DeletionDate

用户在 Yammer 中进入已删除状态的日期。

YAM_SuspensionDate

用户在 Yammer 中进入已挂起状态的日期。

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

列名称

列说明

UserID

代表某一用户的唯一用户 ID,通过它可与数据集内的其他数据表联接。

IDType

如果用户是使用 Yammer ID 连接的 Yammer 用户,则 ID 类型设置为 1;如果使用 Office 365 ID 连接到 Yammer,则设置为 0。

值为 1 表示用户使用其 Yammer ID 而非其 Office 365 ID 连接到 Yammer

Timeframe

月份值,此表代表该月份的数据。

EXO_EmailSent

发送的邮件数。

EXO_EmailReceived

接收的邮件数。

EXO_EmailRead

用户执行的电子邮件阅读活动数,阅读已读电子邮件或以前接收的电子邮件记为多次。

ODB_FileViewedModified

此用户在任何 OneDrive for Business 上与其进行了交互(如创建、更新、删除、查看或下载)的文件数。

ODB_FileSynched

此用户在任何 OneDrive for Business 上同步的文件数。

ODB_FileSharedInternally

此用户从任何 OneDrive for Business 进行内部共享的文件数。

ODB_FileSharedExternally

此用户从任何 OneDrive for Business 进行外部共享的文件数。

ODB_AccessByOwner

用户与之交互且位于其自己的 OneDrive for Business 上的文件数。

ODB_AccessOthers

用户与之交互且位于其他用户的 OneDrive for Business 上的文件数。

SPO_GroupFileViewedModified

此用户在任何组网站上进行交互的文件数。

SPO_GroupFileSynched

此用户在任何组网站上进行同步的文件数。

SPO_GroupFileSharedInternally

此用户从任何组网站进行内部共享的文件数。

SPO_GroupFileSharedExternally

此用户从任何组网站进行外部共享的文件数。

SPO_GroupAccessByOwner

用户与之交互且位于该用户所拥有的组网站上的文件数。

SPO_GroupAccessByOthers

用户与之交互且位于其他用户所拥有的组网站上的文件数。

SPO_TeamFileViewedModified

与此用户在任何团队网站上进行交互的文件数。

SPO_TeamFileSynched

此用户从任何团队网站进行同步的文件数。

SPO_TeamFileSharedInternally

此用户从任何团队网站进行内部共享的文件数。

SPO_TeamFileSharedExternally

此用户从任何团队网站进行外部共享的文件数。

SPO_TeamAccessByOwner

用户与之交互且位于该用户所拥有的团队网站上的文件数。

SPO_TeamAccessByOthers

用户与之交互且位于其他用户所拥有的团队网站上的文件数。

YAM_MessagePost

此用户发布的 Yammer 消息数。

YAM_MessageLiked

此用户点赞的 Yammer 消息数。

YAM_MessageRead

此用户阅读的 Yammer 消息数。

SFB_P2PSummary

此用户参与的对等会话数。

SFB_ConfOrgSummary

此用户组织的会议会话数。

SFB_ConfPartSummary

此用户参与的会议会话数。

下表提供逐月采用数据,该数据有关 Office 365 中每个产品的启用、激活、继续使用和首次使用的用户。Office 365 值表示任一产品中的活动使用情况。

列名称

列说明

Product

产品名称,已汇总该产品的使用情况信息。产品列中的 Office 365 值表示跨任何产品的活动

Timeframe

月份值。对于过去 12 个月(包括当月),每个产品每月对应一行。

EnabledUsers

在时间范围值内允许使用产品的用户数,在一个月的部分时间允许使用的用户也将计算在内。

ActiveUsers

在时间范围值内在产品中执行有意活动的用户数。

如果某一用户在某一特定月份内在产品中执行了某一关键活动,则将该用户计为该月该产品的活动用户。租户产品活动表中列出了各项关键活动。

CumulativeActiveUsers

允许使用产品,且自在新使用情况系统中启用数据收集起在截至时间范围月份前至少使用了一次产品的用户数。

MoMReturningUsers

在时间范围月份内处于活动状态,且在上个月中也处于活动状态的用户数。

FirstTimeUsers

自在新使用情况系统中启用数据收集起在时间范围内首次处于活动状态的用户数。

如果自在此新报告系统中启用数据收集起,首次检测到某一用户的活动,该用户将被视为某一特定月份中首次使用的用户。计为首次使用的用户后,即使此用户的活动中存在巨大的空白,也不会再次将其计为首次使用的用户

Content Date

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

此表提供活动以及产品中各种活动的活动用户计数的每月总计。

列名称

列说明

Timeframe

月份值。对于过去 12 个月(包括当月),每个产品每月对应一行。

Product

Office 365 中的产品名称,该产品的使用情况数据可用。

活动

产品中用于展示积极使用产品的活动的名称。

ActivityCount

这是所有活动用户在产品中执行的每个活动的操作总数。

注意:对于 SharePoint Online 和 OneDrive for Business 活动,此值表示用户与之交互的不同文档数。

ActiveUserCount

在产品中执行活动的用户数。

TotalDurationInMinute

所有活动用户在适当 Skype for Business 活动中使用音频或视频会话的持续分钟数。

Content Date

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

此表包含跨所有具有用户邮箱的已授权 Exchange Online 用户的汇总数据。它包含跨所有用户邮箱的月末状态。此表中的数据不能跨多个月份进行累加。此表中的最新月份的数据表示最新状态。

列名称

列说明

TotalMailboxes

Office 365 订阅的用户邮箱数。

IssueWarningQuota

跨所有用户邮箱发出警告的总配额。

ProhibitSendQuota

跨所有用户邮箱禁止发送的总配额。

ProhibitSendReceiveQuota

跨所有用户邮箱禁止发送接收配额的总配额。

TotalItemBytes

跨所有用户邮箱使用的、以字节为单位的存储量。

MailboxesNoWarning

低于存储警告限制的用户邮箱数。

MailboxesIssueWarning

针对存储配额发出警告的用户邮箱数。

MailboxesExceedSendQuota

已超出发送配额的用户邮箱数。

MailboxesExceedSendReceiveQuota

已超出发送/接收配额的用户邮箱数。

DeletedMailboxes

在时间范围内删除的用户邮箱数。

Timeframe

月份值。

Content Date

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

下表提供了有关用户用于连接到 Exchange Online、Skype for Business 和 Yammer 的客户端的逐月汇总数据。此表中的客户端尚未使用 SharePoint Online 和 OneDrive for Business 数据。

列名称

列说明

Product

Office 365 中的产品名称,该产品的客户端使用情况数据可用。

ClientId

用于连接到产品的每个设备的名称。

UserCount

针对每个产品使用每个客户端的用户数。

Timeframe

月份值

Content Date

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

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

列名称

列说明

SiteType

网站类型值(任意/团队/组)(任意表示这两种网站类型均可)。

TotalSites

在时间范围结束时存在的网站数。

DocumentCount

在时间范围结束时存在于网站上的文档总数。

DiskQuota

在时间范围结束时,所有网站的已分配存储配额总计。

DiskUsed

在时间范围结束时,所有网站的已用存储总计。

ActivityType

记录文件活动的各种类型(任何/活动文件/共享 EXT/INT 的文件/同步的文件)的网站数。

任何表示执行任何文件活动。

SitesWithOwnerActivities

活动网站数,其中网站所有者在其自己的网站上执行特定文件活动。

SitesWithNonOwnerActivities

该月汇总的活动网站数,其中除网站所有者之外的用户在网站上执行特定文件活动。

ActivityTotalSites

记录时间范围内的任何活动的网站数。如果某一网站在时间范围早期具有活动,但在时间范围结束时被删除,仍会将其计入该时间范围内活动网站。

Timeframe

此列包含日期值。用作日历表的多对一关系。

Content Date

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

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

列名称

列说明

SiteType

值为“OneDrive”。

TotalSites

在时间范围结束时存在的 OneDrive for Business 帐户数。

DocumentCount

在时间范围结束时,所有 OneDrive for Business 帐户中存在的文档总数

DiskQuota

在时间范围结束时,所有 OneDrive for Business 帐户中已分配的存储配额总计。

DiskUsed

在时间范围结束时,所有 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

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

此表提供了有关跨服务计划(如 Office Proplus、Visio、Project)激活 Office 订阅的次数的数据。此外,它还提供了有关每个设备 (Android/iOS/Mac/PC) 的激活次数的数据。

列名称

列说明

ServicePlanName

服务计划名称值列表和通过设备进行的激活次数,如以下列所示。

TotalEnabled

在时间范围结束时,允许使用每个服务计划的用户数(按服务计划名称排列)。

TotalActivatedUsers

在时间范围结束时,激活每个服务计划的用户数。

AndroidCount

在时间范围结束时,Android 设备上每个服务计划的激活次数。

iOSCount

在时间范围结束时,iOS 设备上每个服务计划的激活次数。

MacCount

在时间范围结束时,MAC 设备上每个服务计划的激活次数。

PcCount

在时间范围结束时,PC 设备上每个服务计划的激活次数。

WinRtCount

在时间范围结束时,Windows Mobile 设备上每个服务计划的激活次数。

Timeframe

此列包含日期值。用作日历表的多对一关系。

Content Date

如果时间范围显示当前月,则此值表示数据可供使用的当前月的最后一天。

如果时间范围显示上个月,则此值表示上个月的最后一天。

另请参阅

Office 365 Adoption 内容包

启用 Office 365 的 Power BI Adoption 内容包

处理 Office 365 Adoption 内容包中的报表

自定义 Office 365 Adoption 内容包

扩展你的技能
了解培训
抢先获得新功能
加入 Office 预览体验计划

此信息是否有帮助?

谢谢您的反馈!

谢谢你的反馈! 可能需要转接到 Office 支持专员。

×