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 使用方式	包含 SharePoint 網站 (涵蓋小組或群組網站) 的相關資料，例如網站總數、網站上的文件數目、依活動類型計算的檔案計數，以及使用的儲存空間。	包含滾動 12 個月期間的月末狀態資料，包括目前的部分月份。
租用戶 OneDrive 使用量	包含 OneDrive 帳戶的相關資料，例如帳戶數目、OneDrive 上的文件數目、使用的儲存空間、依活動類型計算的檔案計數。	包含滾動 12 個月期間的月末狀態資料，包括目前的部分月份。
租用戶 Microsoft 365 群組使用量	包含 Microsoft 365 群組使用量的相關數據，包括信箱、SharePoint 和 Viva Engage。	包含滾動 12 個月期間的月末狀態資料，包括目前的部分月份。
租用戶 Office 啟用	包含有關 Office 訂閱啟用次數、每部裝置 (Android/iOS/Mac/PC) 的啟用計數、依服務方案（例如 Microsoft 365 Apps 企業版、Visio、Project）啟用的資料。	包含滾動 12 個月期間的月末狀態資料，包括目前的部分月份。
使用者狀態	包含使用者的相關中繼資料，包括使用者顯示名稱、指派的產品、地點、部門、職稱、公司。此資料是關於在上個月內獲指派授權的使用者。每個使用者都有唯一的使用者 ID。	此資料與上一個完整月份期間指派授權的使用者有關。
使用者活動	包含授權使用者執行活動的每個使用者層級資訊。如需產品內此資料表格中傳回活動的相關資訊，請參閱作用中使用者定義。	此資料與上一個完整月份期間在任何服務中執行活動的使用者有關。

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

資料表格 - 使用者狀態

此表格提供在上一個完整月份內已指派授權的所有使用者的使用者層級詳細資料。它會從 Microsoft Entra ID 匯入資料。

欄名稱	欄描述
UserId	代表使用者的唯一使用者 ID，並允許與資料集中的其他資料表結合。
Timeframe	此表格內含資料的月份值。
UPN	使用者主體名稱 (UPN) 唯一識別使用者，以便能夠與其他外部資料來源聯結。
DisplayName	使用者的顯示名稱。
IDType	如果使用者是使用其 Viva Engage ID 連線的 Viva Engage 使用者，則標識碼類型會設定為 1，如果他們使用其 Microsoft 365 ID 連線到 Viva Engage，則會設定為 0。值為 1，表示此使用者使用其 Viva Engage ID 連線到 Viva Engage，而不是其 Microsoft 365 ID
有許可證EXO	如果使用者獲指派授權，並啟用在當月最後一天使用 Exchange，則設定為 true。
有授權ODB	如果使用者已獲指派授權，並啟用在當月最後一天使用 OneDrive，則設定為 true。
HasLicenseSPO	如果使用者獲指派授權，並啟用在當月最後一天使用 SharePoint，則設定為 true。
有許可證YAM	如果使用者已獲指派授權，並啟用在當月最後一天使用 Viva Engage，則設定為 true。
HasLicenseSFB	如果使用者獲指派授權，並啟用在當月最後一天使用商務用 Skype，則設定為 true。
HasLicense團隊	如果使用者獲指派授權，並啟用在當月最後一天使用 Microsoft Teams，則設定為 true。
Company	此使用者的 Microsoft Entra ID 中表示的公司資料。
部門	此使用者的 Microsoft Entra ID 中代表的部門資料。
地點城市	此使用者的 Microsoft Entra ID 中代表的城市資料。
地點國家	此使用者的 Microsoft Entra ID 中表示的國家/地區資料。
Location狀態	此使用者的 Microsoft Entra ID 中表示的狀態資料。
地點辦公室	使用者的辦公室。
標題	此使用者的 Microsoft Entra ID 中代表的標題資料。
刪除	如果使用者在上一個完整月份從 Microsoft 365 中刪除，則為 True。
刪除日期	從 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 使用者，則標識碼類型會設定為 1，如果他們使用其 Microsoft 365 ID 連線到 Viva Engage，則會設定為 0。值為 1，表示此使用者使用其 Viva Engage ID 連線到 Viva Engage，而不是其 Microsoft 365 ID
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 個月內，每個產品每月有一列，包括目前的部分月份。
已啟用使用者	啟用時間範圍值產品之使用者數目，如果使用者已啟用當月部分時間，則仍會計算在內。
活躍用戶	在時間範圍值內在產品中執行有意活動的使用者人數。如果使用者在產品中執行了其中一個關鍵活動，則會在特定月份計為產品的作用中。 The key activities are available in the Tenant Product Activity table.
累積作用中使用者	自從在新的使用系統中開始收集資料以來，能夠使用產品並在該時間範圍內的月份至少使用過一次產品的使用者人數。
MoMReturning用戶	在時間範圍月份內有效，且在上一個月也有效的使用者數目。
首次用戶	自新的使用情況系統開始收集資料起，在時間範圍內第一次成為作用中使用者的使用者數目。如果我們自這個新的報告系統開始收集資料起，第一次偵測到使用者的活動，則會將該使用者計入特定月份的初次使用者。一旦計為首次使用者，即使該使用者的活動差距很大，也不會再次計為首次使用者
Content Date	如果時間範圍顯示當前月份，則此值代表可用資料的當前月份的最晚日期。如果時間範圍顯示上個月，則此值代表時間範圍月份的最後日期。

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

此表格提供產品內各種活動的每月活動總計和作用中使用者計數。

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

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

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

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

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

此數據表提供使用者用來連線到 Exchange Online、商務用商務用 Skype 和 Viva Engage 之用戶端的月度摘要數據。此數據表還沒有 SharePoint 和 OneDrive 的用戶端使用數據。

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

資料表 - 租用戶 SharePoint 使用量

此表格包含有關 SharePoint 網站使用情況或活動的逐月摘要數據。這只涵蓋小組網站與群組網站。 SharePoint 網站的月底狀態會在此資料行中表示，例如，如果使用者建立五個文件，並使用 10 MB 的總儲存空間，然後刪除一些檔案，並新增更多檔案，以便在月底檔案狀態為七個，總共使用 5 MB 的儲存空間，此表格中表示的值是月底狀態。系統會隱藏此表格以避免重複計算彙總，並當做建立兩個參照表格的來源使用。

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

資料表 - 租用戶 OneDrive 使用量

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

欄名稱	欄描述
網站類型	值為 "OneDrive"。
總網站	時間範圍結束時存在的 OneDrive 帳戶數目。
文件計數	時間範圍結束時所有 OneDrive 帳戶中存在的文件總數
被剝奪	時間範圍結束時所有 OneDrive 帳戶使用的總儲存空間總和。
活動類型	記錄各種類型檔案活動 (任何/作用中的檔案/共用 EXT 的檔案/INT/同步處理的檔案) 的帳戶數目。任何都可以代表所執行的任何檔案活動
SitesWithOwner活動	作用中 OneDrive 帳戶數目，帳戶擁有者在其中執行特定檔案活動在自己的帳戶上。
SitesWithNonOwnerActivities	帳戶擁有者以外的使用者執行檔案活動的 OneDrive 帳戶計數。
活動總站點	在時間範圍內記錄任何活動的 OneDrive 帳戶數目。如果 OneDrive 帳戶在時間範圍較早有活動，並在時間範圍結束時刪除，則該帳戶仍會計入該時間範圍的作用中 OneDrive 帳戶中。
Timeframe	此欄有日期值。當做行事曆表格的多對一關係使用。
Content Date	如果時間範圍顯示當前月份，則此值代表可用資料的當前月份的最晚日期。如果時間範圍顯示上個月，則此值代表時間範圍月份的最後日期。

資料表 - 租用戶 Microsoft 365 群組使用量

下表提供如何在整個組織中使用 Microsoft 365 群組的相關數據。

資料行名稱	欄描述
時間範圍	月份值。在過去 12 個月內，每個產品每月有一列，包括目前的部分月份。
GroupType	群組類型 (私人/公共/任何) 。
群組總計	每個群組類型中的群組數目。
活動組	作用中群組數目。
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 讀取活動數目。

資料表 - 租戶辦公室授權

此表格提供使用者授權指派的月度摘要資料。

欄名稱	欄描述
授權名稱	授權名稱。
指派計數	指派的授權數目。
Timeframe	月份值。

資料表格 - 租用戶 Office 啟用

此數據表提供跨服務方案的 Office 訂用帳戶啟用數目的相關數據，例如 Microsoft 365 Apps 企業版、Visio、Project。它也會提供每個裝置 (Android/iOS/Mac/PC) 啟用次數的相關資料。

欄名稱	欄描述
ServicePlanName	服務方案名稱值和裝置啟用計數的清單，如下欄所述。
已啟用總計	每個服務方案名稱在時間範圍結束前啟用的使用者數目。
啟動使用者總數	在時間範圍結束時已啟動每個服務計劃的使用者人數。
安卓計數	Android 裝置的每個服務方案在時間範圍結束前的啟用次數。
iOS帳戶	iOS 裝置的每個服務方案在時間範圍結束前的啟用次數。
麥伯爵	MAC 裝置的每個服務方案在時間範圍結束前的啟用次數。
電腦計數	PC 裝置的每個服務方案在時間範圍結束前的啟用次數。
WinRt計數	Windows Mobile 裝置的每個服務方案在時間範圍結束前的啟用次數。
Timeframe	此欄有日期值。當做行事曆表格的多對一關係使用。
Content Date	如果時間範圍顯示當前月份，則此值代表可用資料的當前月份的最晚日期。如果時間範圍顯示上個月，則此值代表時間範圍月份的最後日期。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-10-11