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個月月度彙整數據。
租用戶產品活動 每月活動總數及產品活動的活躍用戶數。

欲了解本表中回傳的活動資訊，請參閱 Microsoft 365 使用報告中的主動使用者。		 包含當前部分月份的滾動12個月月度彙整數據。
租用戶 Office 授權 分配給使用者的 Microsoft Office 訂閱數量。 包含當前部分月份的滾動12個月期間的月底州數據。
租用戶信箱使用量 信箱資料，包括：
  • 總郵箱數量。
  • 儲存空間的使用。
 包含當前部分月份的滾動12個月期間的月底州數據。
租用戶用戶端使用量 使用特定用戶端或裝置來連接的使用者數量：
  • Exchange Online。
  • Teams。
  • Viva Engage。
 包含當前部分月份的滾動12個月月度彙整數據。
租戶 SharePoint 使用情況 SharePoint 網站資料，包括：
  • (Teams 或 Groups 網站總數) 。
  • 文件數目。
  • 依活動類型分類檔案數量。
  • 儲存空間已使用。
 包含當前部分月份的滾動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 365 使用報告中的主動使用者。		 在過去完整一個月內，於任何服務中執行活動的用戶。

欲查看每個資料表的詳細資訊，請參閱以下章節。

資料表格 - 使用者狀態

使用者狀態表提供所有在過去完整月份內被分配授權的使用者層級細節。 它會帶來來自 Microsoft Entra ID 的資料。

名稱 描述
UserId 唯一使用者 ID，代表使用者，並允許與資料集中的其他資料表連結。
Timeframe 此表中有該月值的資料。
UPN 使用者主體名稱 (UPN) ，唯一識別使用者以與其他外部資料來源連線。
DisplayName 使用者的顯示名稱。
IDType 帳號使用者曾登入。 數值可以是：
  • 1 是若使用者是使用 Viva Engage ID 連線的 Viva Engage 使用者。
  • 若使用者使用 Microsoft 365 ID 連接 Viva Engage，則為 0。
HasLicenseEXO 若使用者被指派授權並在月底啟用使用 Exchange，則設定為 true。
HasLicenseODB 如果使用者在月底被分配授權並啟用使用 OneDrive，則會設定為 true。
HasLicenseSPO 若使用者在月底被指派授權並啟用使用 SharePoint 時，則該設定為 true。
HasLicenseYAM 如果使用者被指派授權並在月底啟用使用 Viva Engage，則該設定為 true。
擁有授權SFB 若使用者被指派授權並啟用 Teams 於月底使用，則該設定為 true。
HasLicenseTeams 若使用者在月底被指派授權並啟用使用 Microsoft Teams，則該設定為 true。
Company 此使用者的公司資料以 Microsoft Entra ID 表示。
部門 部門資料以 Microsoft Entra ID 表示。
地點城市 此用戶的城市資料以 Microsoft Entra ID 表示。
地點國家 此用戶的國家/地區資料以 Microsoft Entra ID 表示。
地點州 此使用者的狀態資料以 Microsoft Entra ID 表示。
地點辦公室 使用者的辦公室。
Title 此使用者的標題資料以 Microsoft Entra ID 表示。
Deleted 如果使用者在過去一個月內被 Microsoft 365 刪除，那就沒問題。
刪除日期 使用者被從 Microsoft 365 刪除的日期。
YAM_State 使用者在 Viva Engage 系統中的狀態。 數值可以是：
  • 啟動。
  • 已刪除。
  • 被停學。
YAM_ActivationDate 使用者進入 Viva Engage 活躍狀態的日期。
YAM_DeletionDate 使用者進入 Viva Engage 刪除狀態的日期。
YAM_SuspensionDate 使用者進入 Viva Engage 被暫停狀態的日期。

資料表格 - 使用者活動

使用者活動表包含每個在上個月內在任何服務中有活動的使用者資料。

名稱 描述
UserID 唯一使用者 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 使用者參與的會議場次數量。

資料表格 - 租用戶產品使用情況

租戶產品使用表提供 Microsoft 365 中每個產品按月度採用數據，涵蓋以下使用者類型：

  • 已啟用。
  • 啟動。
  • 回歸
  • 第一次使用。

Microsoft 365 的數值代表任何產品中的活躍使用情況。

名稱 描述
產品 摘要說明其使用情況資訊的產品名稱。
  • Microsoft 365 值代表任何產品的活動。
Timeframe 月份值。
  • 每個產品每月一行。
  • 包含過去12個月，包括目前的部分月份。
啟用使用者 有多少用戶能以時間框架價值使用該產品。
  • 每月任何時段啟用的用戶都會被計算。
ActiveUsers 在時間範圍值內，執行產品中刻意活動的使用者數目。
  • 若使用者執行了關鍵產品活動之一，則該用戶被視為活躍。
  • 主要活動列於 租戶產品活動 表中。
累積活躍用戶 啟用使用該產品的用戶數量。
  • 包含自資料收集開始以來至少使用過該產品的使用者。
  • 計算到包含時間月。
MoMReturningUsers 該時間段月份的活躍用戶數。
  • 用戶也必須在上個月內保持活躍。
首次使用者 該時間框架月份首次活躍的用戶數量。
  • 活動從新使用系統資料收集開始時就進行測量。
  • 一旦使用者被計為首次使用者，該用戶將不再被計入。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。

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

租戶產品活動表提供產品內各項活動的每月活動總數及活躍用戶數。

名稱 描述
Timeframe 月份值。
  • 每個產品每月一行。
  • 包含過去12個月，包括目前的部分月份。
產品 Microsoft 365 中可用使用資料的產品名稱。
活動 產品中用以展示該產品積極使用行為的名稱。
活動計數 所有活躍用戶中，每次活動的總行動數。
  • 對於 SharePoint 和 OneDrive 活動，這個數值代表使用者互動過的不同文件數量。
ActiveUserCount 已在產品內執行活動的使用者數目。
總時間分鐘 所有活躍用戶的總持續時間（分鐘）。
  • 適用於適用於 Microsoft Teams 活動中的音訊或視訊會話。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。

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

租戶信箱使用量表顯示所有擁有使用者信箱的授權 Exchange Online 使用者的摘要資料。 它會顯示所有使用者信箱的月底狀態。 你無法跨越多個月份加入這個表格中的資料。 本表中最新一個月的數據顯示了最近的州份。

名稱 描述
TotalMailboxes Microsoft 365 訂閱的使用者信箱數量。
IssueWarningQuota 所有用戶信箱發出警告的總配額。
ProhibitSendQuota 禁止所有使用者信箱發送動作的總配額。
ProhibitSendReceiveQuota 禁止所有用戶信箱發送與接收操作的總配額。
全項目位元組 所有使用者信箱使用的儲存空間，以位元組為單位。
信箱無警告 低於儲存警告限制的使用者信箱數量。
信箱問題警告 收到儲存配額警告的用戶信箱數量。
MailboxesExceedSendQuota 超過發送配額的使用者信箱數量。
MailboxesExceedSendReceiveQuota 超過發送與接收配額的使用者信箱數量。
刪除郵件箱 在這段時間內刪除的使用者信箱數量。
Timeframe 月份值。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。

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

租戶用戶端使用量表提供使用者用來連接的用戶端的月度摘要資料：

  • Exchange Online。
  • Microsoft Teams。
  • Viva Engage。

這個表格目前還沒有 SharePoint 和 OneDrive 的客戶使用資料。

名稱 描述
產品 Microsoft 365 中可取得用戶端使用資料的產品名稱。
客戶識別碼 每個用來連接產品的裝置名稱。
使用者計數 每個產品使用過每個客戶端的用戶數量。
Timeframe 月份值。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。

Data table - 租戶 SharePoint 使用情況

租戶 SharePoint 使用量表顯示 SharePoint 網站的使用或活動的月度摘要資料。 此表中資料僅涵蓋團隊站點與群組站點，並代表 SharePoint 站點的月末狀態：

  • 這些數值反映的是月底的最終總額，而非臨時活動。
  • 在這個月內，使用者可能會建立、刪除及新增檔案。
  • 只記錄月底的州。

以下範例顯示的結果值為七份文件與5 MB，代表月末狀態：

  • 使用者建立五份文件，每份文件使用10 MB的儲存空間。
  • 使用者接著刪除部分檔案，新增其他檔案。
  • 月底時，該網站包含七份文件，使用了 5 MB 的儲存空間。

為避免聚合重複計數，此表被隱藏。 它被用作建立兩個參考表的來源。

名稱 描述
網站類型 場地類型價值。 可能的值為：
  • 任意：代表團隊或團體場地。
  • 團隊。
  • 團體。
TotalSites 在時間範圍結束時存在的網站數目。
文件計數 在時間範圍結束時存在網站上的文件總數。
磁碟使用資料 在時間結束時，所有站點總共使用了多少儲存空間。
活動類型 記錄特定檔案活動的網站數量。 代表任何執行過的檔案活動。 例如：
  • 任何活動。
  • 活動檔案。
  • Files 外部分享。
  • Files 內部共享。
  • Files 已同步。
網站擁有者活動 網站擁有者在自己網站上進行檔案活動的活躍網站數量。
  • 網站擁有者是對網站負責的人。
  • 網站擁有者可透過 PowerShell 指令 get-sposite來識別。
網站與非擁有者活動 本月除網站擁有者外，其他使用者執行檔案活動的活躍網站總數。
  • 網站擁有者是對網站負責的人。
  • 網站擁有者可透過 PowerShell 指令 get-sposite來識別。
活動總站 在時間範圍期間記錄任何活動的網站數目。
  • 在時間框架結束前被刪除的網站，若在該時間段較早有活動，仍會被計算。
Timeframe Date 值。
  • 作為與 Calendar 表格的多對一關係使用。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。

資料表 - 租戶 OneDrive 使用情況

租戶 OneDrive 使用量表提供有關 OneDrive 帳號的資料。 例如：

  • 帳號數量。
  • OneDrive 帳號間的文件數量。
  • 儲存空間已使用。
  • 依活動類型分類檔案數量。

表格同時顯示了 OneDrive 帳號的月底狀態：

  • 這些數值反映的是月底的最終狀態，而非當月所做的變更。
  • 使用者可以在整個月內建立、刪除及新增檔案。
  • 此表僅記錄月底總數。

以下範例中，表格記錄七個檔案與 5 MB，代表月末狀態：

  • 使用者建立五份文件，每份文件使用10 MB的儲存空間。
  • 在這個月裡，使用者會刪除一些檔案並新增其他檔案。
  • 到月底，帳號內有七個檔案，佔用了 5 MB 的儲存空間。
名稱 描述
網站類型 值為 OneDrive。
TotalSites 期限結束時，存在的 OneDrive 帳號數量。
文件計數 在期限結束時，所有 OneDrive 帳號共有的文件總數。
磁碟使用資料 這是所有 OneDrive 帳號在時間結束時總共使用的儲存空間。
活動類型 記錄特定類型檔案活動的帳號數量。 例如：
  • 任何活動。
  • 活動檔案。
  • Files 外部分享。
  • Files 內部共享。
  • Files 已同步。
網站擁有者活動 帳號擁有者在自己帳號上執行檔案活動的活躍 OneDrive 帳號數量。
網站與非擁有者活動 有 OneDrive 帳號中有非擁有者使用者檔案活動的數量。
活動總站 在這段期間內記錄任何活動的 OneDrive 帳號數量。
  • 在期限結束前刪除的帳號，如果在該期限內有活動，仍會被計算。
Timeframe Date 值。
  • 作為與 Calendar 表格的多對一關係使用。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。

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

租戶 Microsoft 365 群組使用表提供 Microsoft 365 群組在組織內的使用情況。

名稱 描述
時間框架 月份值。 過去12個月，包括目前的部分月份，每個產品每月只有一列。
GroupType 群組類型 (私人、公開或任何) 。
TotalGroups 每種群組類型的群組數量。
活躍團體 活躍團體數量。
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_PostedActivities Viva Engage 的活動數量。
YAM_ReadActivities Viva Engage 閱讀活動數量。

資料表 - 租戶辦公室執照

租戶辦公室授權表提供用戶授權分配的月度摘要資料。

名稱 描述
執照名稱 執照名稱。
AssignedCount 授權的數量。
Timeframe 月份值。

資料表格 - 租用戶 Office 啟用

租戶辦公室啟用表提供各服務方案中辦公室訂閱啟用次數的資料。 例如：

  • Microsoft 365 Apps for enterprises。
  • Visio。
  • 專案。

它也提供 Android、iOS、Mac 或 PC) (裝置啟用次數的數據。

名稱 描述
ServicePlanName 服務方案名稱。
全能啟用 在該期限結束時，服務方案啟用的用戶數。
TotalActivatedUsers 在期限結束前啟用服務方案的用戶人數。
AndroidCount 在 Android 裝置上，該服務計畫在該期限結束前的啟用次數。
iOSCount 在期限結束前，iOS 裝置上服務方案的啟用次數。
麥考特 在時間框架結束前，Mac 裝置啟用服務方案的次數。
電腦計數 在時間框架結束前，PC 裝置上服務方案的啟用次數。
WinRtCount 在 Windows Mobile 裝置上，該服務方案在該期限結束前的啟用次數。
Timeframe
  • Date 值。
  • 作為與 Calendar 表格的多對一關係使用。
Content Date 如果時間範圍是：
  • 以當月為準，最新有可用資料的日期。
  • 前一個月，也就是那個月的最後一天。
  • 上次更新時間：