MailboxActivity * 報告
MailboxActivity * REST Uri 提供摘要Office 365組織信箱建立及刪除相關的統計資料。有四個報表,使用相同的整體結構和只能在他們掌控彙總資料的時間間隔之間的差異: 每天、 每週、 每月及每年。為了簡化,四個報表詳細說明這一個主題。
前次修改時間: 2015年9月17日
適用於: Office 365
REST Uri
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityYearly[?ODATA options]
欄位
您可以指定下列欄位中$select、 $filter及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。
名稱 |
WCF 類型 * |
EDM 類型 * |
[以/照] * * 描述 |
範例值 |
新增服務版本 |
---|---|---|---|---|---|
Date |
System.DateTime |
Edm.DateTime |
[納入/剔除]結束日期與時間的報表期間。請參閱下方時程表期間的詳細資訊。 |
簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間 |
2013-V1 |
AccountCreated |
Long() |
Edm.Int64 |
[納入/剔除]Office 365該期間建立的信箱數目。 |
265 |
2013-V1 |
AccountDeleted |
Long |
Edm.Int64 |
[納入/剔除]刪除該期間Office 365信箱數目。 |
72 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[納入/剔除]組織的 GUID。 |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
string |
None 指定 |
[納入/剔除]組織的網域名稱。 |
example.onmicrosoft.com |
2013-V1 |
TotalNumberOfActiveMailboxes |
Long |
Edm.Int64 |
[納入/剔除]報告期間所使用中的信箱總數。 |
1242 |
2013-V1 |
* WCF 類型參照Visual Studio中建立 Windows Communications Framework (WCF) 服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。
* * [納入/剔除]: 請參閱在輸入參數並報告輸出欄] 區段中。
註解
在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊,請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。
四個報表類型不同只能隨著每個報告項目涵蓋的時間。Date 功能變數中報告的時間代表期結束的時間。日期及時間報告中的 HTTPS 取得X-timezone標頭中指定的時區。如果未不指定任何時區,則會使用 UTC 時間。時間持續報告以下列方式計算:
報表名稱 |
時間週期計算 |
---|---|
每日() GroupActivityDaily |
報告每天午夜精準地啟動 (00:00:00) 結束之前在同一天的午夜 (23.59:59.9999...)。報告的最後一天就資料有可用的最後一個完整天因此將不會包含目前的日期。日期及時間Date ] 欄位中傳回代表該報表天結束。 |
每週() GroupActivityWeekly |
報表週午夜精準地啟動 (00:00:00)、 早期在星期六、 結束之前在下列星期五晚上午夜 (23:59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報告的週的結尾。 |
每月() GroupActivityMonthly |
報表的月份午夜精準地啟動 (00:00:00) 上的第一天的月和結束之前在該月的最後一個行事曆天的午夜 (23:59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。 |
每年() GroupActivityYearly |
報表年份午夜精準地啟動 (00:00:00) 年 1 月 1 日該行事曆年度和結束的之前在該相同的月曆年 12 月 31 午夜 (23:59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。 |
範例
下列的要求及回應配對示範如何將月 JSON 格式來擷取信箱活動的報告。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityMonthly?$format=Json
{
"d":
{
"results":
[
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
"type":"TenantReporting.MailboxActivityReport"
},
"TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
"TenantName":"example.onmicrosoft.com",
"Date":"\/Date(1354233600000)\/",
"TotalNumberOfActiveMailboxes":"0",
"AccountCreated":"0",
"AccountDeleted":"0"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
"type":"TenantReporting.MailboxActivityReport"
},
"TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
"TenantName":"example.onmicrosoft.com",
"Date":"\/Date(1356912000000)\/",
"TotalNumberOfActiveMailboxes":"0",
"AccountCreated":"0",
"AccountDeleted":"0"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
"type":"TenantReporting.MailboxActivityReport"
},
"TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
"TenantName":"example.onmicrosoft.com",
"Date":"\/Date(1359590400000)\/",
"TotalNumberOfActiveMailboxes":"1",
"AccountCreated":"0",
"AccountDeleted":"0"
}
]
}
}
下列的要求及回應配對示範如何擷取使用中的信箱總數每日、 舊的四天內,反向先後順序。此查詢要求Date和TotalNumberOfActiveMailboxes計數及要求 Atom 格式中的資訊。分行符號已新增至要求及回應以利檢視。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityDaily?
$select=Date,TotalNumberOfActiveMailboxes&
$top=4&
$orderby=Date%20desc&
$format=Atom
<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/"
xmlns="http://www.w3.org/2005/Atom"
xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices"
xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
<id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityDaily</id>
<title type="text">MailboxActivityDaily</title>
<updated>2013-01-31T05:23:09Z</updated>
<link rel="self" title="MailboxActivityDaily" href="MailboxActivityDaily" />
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-29T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-29T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-28T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-28T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-28T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-27T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-27T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-27T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-26T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-26T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-26T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
</feed>
輸入參數並報告輸出欄
在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義:
欄位中表格主要用於$filter=、 $orderby=及其他查詢選項限制報表會傳回的項目中的欄位中標示為 [中]。在欄位標示為 [In 包含$select= ] 選項,可以是資料表欄位和其出現在報表項目但他們會包含任何的有用資料。
欄位標記 [納入/剔除] 欄選取範圍 ($select=) 和項目限制 ($filter=和$orderby=) 選項中可用資料表的欄位中。加入時這些欄位之一$select= ] 選項,將會出現在報表項目,且可用時將會包含有用的資料。
相容性
Office 365 service version 2013-V1中所引進的 MailboxActivityDaily、 MailboxActivityWeekly、 MailboxActivityMonthly 及 MailboxActivityYearly 報告。如需有關版本設定的詳細資訊,請參閱在 「 Office 365 報告 」 web 服務的版本控制。
對應的 PowerShell cmdlet
MailboxActivity * 報告傳回資訊與Get MailboxActivityReport Windows PowerShell指令程式相同。
權限
存取從報表的帳戶必須該Office 365組織中有系統管理權限。如果帳戶可以檢視這份報告Office 365控制台中的帳戶已從 REST web 服務擷取資料的權限。這份報告要求使用者指派給 「 僅檢視收件者 」 角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告: 帳務管理員、 全域管理員、 密碼管理員、 服務管理員及使用者管理管理員。
資料精確度、 保存性及可用性
透過這些報告提供的資訊可分為單日期間從時區 HTTP X-timezone標頭中呼叫的應用程式所報告的午夜十二點開始。
針對此報表之資訊的一年以上,或取消訂閱直到一段。
事件可能最多它們顯示在報表中前 24 小時的延遲。