Microsoft 365 使用情況分析資料模型

Microsoft 365 使用方式分析數據表的數據

Microsoft 365 使用方式分析會連線到公開多維度數據模型的 API。 Microsoft 365 使用方式分析用來產生其數據的 API 來自各種已正式推出的圖形 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 和 Viva Engage 的用戶數目相關數據。	包含 12 個月期間內每月彙總的資料，包括目前部分月份。
租用戶 SharePoint Online 使用量	包含 SharePoint 網站 (涵蓋小組或群組網站) 的相關資料，例如網站總數、網站上的文件數目、依活動類型計算的檔案計數，以及使用的儲存空間。	包含滾動 12 個月期間的月底狀態數據，包括目前的部分月份。
租用戶商務用 OneDrive 使用量	包含 OneDrive 帳戶的相關資料，例如帳戶數目、OneDrive 上的文件數目、使用的儲存空間、依活動類型計算的檔案計數。	包含滾動 12 個月期間的月底狀態數據，包括目前的部分月份。
租使用者 Microsoft 365 群組 用量	包含有關 Microsoft 365 群組 使用方式的數據，包括 Mailbox、SharePoint 和 Viva Engage。	包含滾動 12 個月期間的月底狀態數據，包括目前的部分月份。
租用戶 Office 啟用	包含 Office 訂閱啟用次數、每個裝置 (Android/iOS/Mac/PC) 啟用計數、服務方案啟用的相關數據，例如 Microsoft 365 Apps 企業版、Visio、Project。	包含滾動 12 個月期間的月底狀態數據，包括目前的部分月份。
使用者狀態	包含使用者的相關中繼資料，包括使用者顯示名稱、指派的產品、地點、部門、職稱、公司。 此數據是關於在過去一個完整月份中獲指派授權的使用者。 每個使用者都是以使用者識別碼唯一表示。	此資料與上一個完整月份期間指派授權的使用者有關。
使用者活動	包含授權使用者執行活動的每個使用者層級資訊。 如需產品內此資料表格中傳回活動的相關資訊，請參閱作用中使用者定義。	此資料與上一個完整月份期間在任何服務中執行活動的使用者有關。

展開下列各節，以查看每個資料表格的詳細資訊。

資料表格 - 使用者狀態

下表提供在上個月指派授權的所有用戶的用戶層級詳細數據。 它會從 Microsoft Entra ID 帶入數據。

欄名稱	欄描述
UserId	代表使用者的唯一使用者標識碼，可與數據集內的其他數據表聯結。
Timeframe	此表格內含資料的月份值。
UPN	使用者主體名稱，可唯一識別能夠使用其他外部資料來源加入的使用者。
DisplayName	使用者的顯示名稱。
IDType	如果使用者是使用其 Viva Engage 標識碼進行連線的 Viva Engage 使用者，則標識符類型會設定為 1;如果使用者使用其 Microsoft 365 標識符連線到 Viva Engage，則為 0。 值為 1，表示此使用者使用其 Viva Engage 識別碼而不是 Microsoft 365 標識符聯機到 Viva Engage
HasLicenseEXO	如果用戶獲指派授權並啟用在當月最後一天使用 Exchange，則設定為 true。
HasLicenseODB	如果用戶獲指派授權並啟用在當月最後一天使用 商務用 OneDrive，則設定為 true。
HasLicenseSPO	如果用戶獲指派授權並啟用在當月最後一天使用 SharePoint Online，則設定為 true。
HasLicenseYAM	如果用戶獲指派授權，並啟用在當月最後一天使用 Viva Engage，則設定為 true。
HasLicenseSFB	如果用戶獲指派授權並啟用在當月最後一天使用商務用Skype，則設定為 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	使用者的辦公室。
標題	此使用者在 Microsoft Entra ID 中表示的標題數據。
刪除	True 是表示 如果使用者已從 Microsoft 365 在最後一個完成月份刪除。
DeletedDate	從 Microsoft 365 刪除使用者的日期。
YAM_State	使用者在 Viva Engage 系統中的狀態，可以是作用中、刪除或暫停。
YAM_ActivationDate	用戶在 Viva Engage 中進入作用中狀態的日期。
YAM_DeletionDate	用戶在 Viva Engage 中進入刪除狀態的日期。
YAM_SuspensionDate	用戶在 Viva Engage 中進入暫停狀態的日期。

資料表格 - 使用者活動

此表格包含上個月在任何服務中有活動之每個使用者的相關資料。

欄名稱	欄描述
UserID	代表使用者的唯一使用者標識碼，可與數據集內的其他數據表聯結。
IDType	如果使用者是使用其 Viva Engage 標識符連線的 Viva Engage 使用者，則標識符類型會設定為 1;如果使用者使用其 Microsoft 365 標識符聯機到 Viva Engage，則為 0。 值為 1，表示此使用者使用其 Viva Engage 識別碼而不是 Microsoft 365 標識符聯機到 Viva Engage
Timeframe	此表格表示有資料的月份值。
EXO_EmailSent	已傳送的電子郵件數目。
EXO_EmailReceived	已接收的電子郵件數目。
EXO_EmailRead	使用者執行的電子郵件讀取活動數目、可能是讀取已讀取的電子郵件或先前收到的電子郵件數倍。
EXO_AppointmentCreated	建立的約會數目。
EXO_MeetingAccepted	接受的會議數目。
EXO_MeetingCancelled	已取消的會議數目。
EXO_MeetingDeclined	會議數目已拒絕。
EXO_MeetingSent	已傳送的會議數目。
ODB_FileViewedModified	此使用者在任何商務用 OneDrive 上互動的檔案數目 (例如建立、更新、刪除、檢視或下載)。
ODB_FileSynched	此使用者在任何商務用 OneDrive 上同步處理的檔案數目。
ODB_FileSharedInternally	此使用者從任何 商務用 OneDrive 或群組內的用戶共用的檔案數目， (可能包含外部使用者) 。
ODB_FileSharedExternally	此使用者從任何商務用 OneDrive 外部共用的檔案數目。
ODB_AccessedByOwner	用戶與其互動的網站數目，位於自己的 商務用 OneDrive。
ODB_AccessedByOthers	此使用者與其互動的網站數目，位於另一個使用者的 商務用 OneDrive。
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	在產品中針對時間範圍值執行刻意活動的用戶數目。 A user is counted as active for a product in a particular month, if they have performed one of the key activities in the product. The key activities are available in the Tenant Product Activity table.
CumulativeActiveUsers	可使用產品，而且自新的使用情況系統開始收集資料起，已在時間範圍月份內至少使用一次產品的使用者數目。
MoMReturningUsers	在時間範圍月份內有效，且在上一個月也有效的使用者數目。
FirstTimeUsers	自新的使用情況系統開始收集資料起，在時間範圍內第一次成為作用中使用者的使用者數目。 如果我們自這個新的報告系統開始收集資料起，第一次偵測到使用者的活動，則會將該使用者計入特定月份的初次使用者。 一旦算作第一次使用者，即使此用戶的活動有很大的差距，他們也永遠不會再次被計算為第一次使用者
Content Date	如果時間範圍顯示目前月份，此值將代表資料在目前月份可供使用的最晚日期。 如果時間範圍顯示上個月，此值將代表時間範圍月份的最後一個日期。

資料表格 - 租用戶產品活動

下表提供產品內各種活動的每月活動總數和作用中用戶計數。

欄名稱	欄描述
Timeframe	月份值。 每個產品在過去 12 個月內，每個月都會有一列，包括目前部分月份。
產品	Microsoft 365 中可用使用量數據的產品名稱。
活動	產品中用來展現產品使用中的活動名稱。
ActivityCount	這是針對產品內所有作用中使用者執行的每個活動計算的動作總數。 注意： 若是 SharePoint Online 和商務用 OneDrive 活動，此值代表與使用者互動的不同文件數目。
ActiveUserCount	已在產品內執行活動的使用者數目。
TotalDurationInMinute	在適用的商務用 Skype 活動中，使用音訊或視訊工作階段之所有作用中使用者持續使用的分鐘數。
Content Date	如果時間範圍顯示目前月份，此值將代表資料在目前月份可供使用的最晚日期。 如果時間範圍顯示上個月，此值將代表時間範圍月份的最後一個日期。

資料表格 - 租用戶信箱使用量

此數據表包含所有具有使用者信箱之授權 Exchange Online 使用者的摘要數據。 其中包含所有使用者信箱的月底狀態。 此數據表中的數據不會跨月加總。 此表格中最新月份的資料代表最新的狀態。

欄名稱	欄描述
TotalMailboxes	Microsoft 365 訂閱的使用者信箱數目。
IssueWarningQuota	在所有使用者的信箱中發出警告的總配額。
ProhibitSendQuota	在所有使用者信箱中禁止傳送的配額總計。
ProhibitSendReceiveQuota	在所有使用者信箱中禁止傳送接收配額的配額總計。
TotalItemBytes	所有使用者信箱所使用的儲存空間量 (以位元組為單位)。
MailboxesNoWarning	在儲存空間警告限制之下的使用者信箱數目。
MailboxesIssueWarning	針對儲存空間配額發出警告的使用者信箱數目。
MailboxesExceedSendQuota	已超過傳送配額的使用者信箱數目。
MailboxesExceedSendReceiveQuota	超過傳送/接收配額的使用者信箱數目。
DeletedMailboxes	在時間範圍內刪除的使用者信箱數目。
Timeframe	月份值。
Content Date	如果時間範圍顯示目前月份，此值將代表資料在目前月份可供使用的最晚日期。 如果時間範圍顯示上個月，此值將代表時間範圍月份的最後一個日期。

資料表格 - 租用戶用戶端使用量

下表提供使用者用來連線至 Exchange Online、商務用 Skype 和 Viva Engage 之用戶端的每月摘要數據。 此數據表尚無 SharePoint Online 和 商務用 OneDrive 的用戶端使用數據。

欄名稱	欄描述
產品	Microsoft 365 中用戶端使用量數據可用的產品名稱。
ClientId	用來連線至產品之每個裝置的名稱。
UserCount	使用每個產品適用之每個用戶端的使用者數目。
Timeframe	月份值
Content Date	如果時間範圍顯示目前月份，此值將代表資料在目前月份可供使用的最晚日期。 如果時間範圍顯示上個月，此值將代表時間範圍月份的最後一個日期。

資料表格 - 租用戶 SharePoint Online 使用量

此表格包含 SharePoint Online 網站使用量或活動的每月相關摘要資料。 這只涵蓋小組網站與群組網站。 SharePoint Online 網站的月底狀態會在此欄中表示，例如，如果使用者建立五份檔，並使用 10 MB 的總記憶體，然後刪除一些檔案，並新增更多檔案，讓檔案在月底的狀態是使用五 MB 記憶體的七個總計， 此數據表中所表示的 值為月底狀態。 系統會隱藏此表格以避免重複計算彙總，並當做建立兩個參照表格的來源使用。

欄名稱	欄描述
SiteType	網站類型值 (任何/小組/群組) (任何都可以代表這 2 個網站類型之一)。
TotalSites	在時間範圍結束時存在的網站數目。
DocumentCount	在時間範圍結束時存在網站上的文件總數。
Diplansed	在時間範圍結束時，所有網站上加總的已使用儲存空間總計。
ActivityType	記錄各種類型檔案活動 (任何/作用中的檔案/共用 EXT 的檔案/INT/同步處理的檔案) 的網站數目。 表示已執行的任何檔案活動。
SitesWithOwnerActivities	作用中網站的數目，其中網站擁有者會在自己的網站上執行特定的檔案活動。 您可以從 PowerShell 命令 get-sposite 取得網站擁有者。 這是負責網站的人員。
SitesWithNonOwnerActivities	整個月加總的作用中網站數目，其中網站擁有者以外的使用者會在網站上執行特定的檔案活動。 您可以從 PowerShell 命令 get-sposite 取得網站擁有者。 這是負責網站的人員。
ActivityTotalSites	在時間範圍期間記錄任何活動的網站數目。 如果網站的活動在時間範圍內稍早的時候，而且在時間範圍結束時遭到刪除，則仍然會將該網站計入該時間範圍內的作用中網站總數。
Timeframe	此欄有日期值。 當做行事曆表格的多對一關係使用。
Content Date	如果時間範圍顯示目前月份，此值將代表資料在目前月份可供使用的最晚日期。 如果時間範圍顯示上個月，此值將代表時間範圍月份的最後一個日期。

數據表 - 租使用者 OneDrive 使用量

此表格提供 OneDrive 帳戶的相關資料，例如，帳戶數目、OneDrive 帳戶上的文件數目、所使用的儲存空間、依活動類型計算的檔案計數。 商務用 OneDrive 帳戶的月底狀態會在此表格中表示。 例如，如果使用者建立了使用 10 MB 儲存空間的 Five 檔，然後刪除一些檔案並新增更多檔案，以便在月底有七個使用五 MB 記憶體的檔案，則當月結尾值會在此數據表中表示於月底。

欄名稱	欄描述
SiteType	值為 "OneDrive"。
TotalSites	在時間範圍結束時存在的商務用 OneDrive 帳戶數目。
DocumentCount	在時間範圍結束時，所有商務用 OneDrive 帳戶上存在的文件總數。
Diplansed	在時間範圍結束時，所有 OneDrive 帳戶所使用的記憶體總計加總。
ActivityType	記錄各種類型檔案活動 (任何/作用中的檔案/共用 EXT 的檔案/INT/同步處理的檔案) 的帳戶數目。 任何都可以代表所執行的任何檔案活動
SitesWithOwnerActivities	作用中商務用 OneDrive 帳戶的數目，其中帳戶擁有者會在自己的帳戶上執行特定的檔案活動。
SitesWithNonOwnerActivities	商務用 OneDrive 帳戶的計數，其中帳戶擁有者以外的使用者會在其上執行檔案活動。
ActivityTotalSites	在時間範圍期間記錄任何活動的商務用 OneDrive 帳戶數目。 如果商務用 OneDrive 帳戶的活動在時間範圍內稍早的時候，而且在時間範圍結束時遭到刪除，則仍然會將該帳戶計入該時間範圍內的作用中商務用 OneDrive 帳戶。
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 群組數目，或可能包含外部使用者) 的群組 (數目。
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 Apps、Visio、Project。 它也會提供每個裝置 (Android/iOS/Mac/PC) 啟用次數的相關資料。

欄名稱	欄描述
ServicePlanName	服務方案名稱值和裝置啟用計數的清單，如下欄所述。
TotalEnabled	每個服務方案名稱在時間範圍結束前啟用的使用者數目。
TotalActivatedUsers	已在時間範圍結束前啟用每個服務方案的使用者數目。
AndroidCount	Android 裝置的每個服務方案在時間範圍結束前的啟用次數。
iOSCount	iOS 裝置的每個服務方案在時間範圍結束前的啟用次數。
MacCount	MAC 裝置的每個服務方案在時間範圍結束前的啟用次數。
PcCount	PC 裝置的每個服務方案在時間範圍結束前的啟用次數。
WinRtCount	Windows Mobile 裝置的每個服務方案在時間範圍結束前的啟用次數。
Timeframe	此欄有日期值。 當做行事曆表格的多對一關係使用。
Content Date	如果時間範圍顯示目前月份，此值將代表資料在目前月份可供使用的最晚日期。 如果時間範圍顯示上個月，此值將代表時間範圍月份的最後一個日期。