CsConference * 報告
CsConference * REST Uri 提供摘要Office 365數目統計資料 Lync Online 會議。報告的會議數目包含只會依據租用戶的登入的成員。有三個報告,使用相同的整體結構和只能在他們掌控彙總資料的時間間隔之間的差異: 每天、 每週及每月。為了簡化,三個報告詳細說明這一個主題。
前次修改時間: 2015年9月17日
適用於: Office 365
REST Uri
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceMonthly[?ODATA options]
欄位
您可以指定下列欄位中$select、 $filter,以及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。
名稱 |
WCF 類型 * |
EDM 類型 * |
[以/照] * * 描述 |
範例值 |
新增服務版本 |
---|---|---|---|---|---|
ApplicationSharingConferences |
Long |
Edm.Int64 |
[納入/剔除]應用程式共用會議報表期間數目。 |
1042 |
2013-V1 |
AVConferences |
Long() |
Edm.Int64 |
[納入/剔除]在報表數 AV 會議。 |
Lync 2013 |
2013-V1 |
Date |
System.DateTime |
Edm.DateTime |
[納入/剔除]結束日期與時間的報表期間。請參閱下列各節的時程表期間的詳細資訊。 |
簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間 |
2013-V1 |
ID |
Long |
Edm.Int64 |
[納入/剔除]報表記錄的索引編號。 |
72 |
2013-V1 |
IMConferences |
Long |
Edm.Int64 |
立即訊息會議中的報表期間數目。 |
14 |
2013-V1 |
TelephonyConferences |
Long |
Edm.Int64 |
電話語音會議中的報表期間數目。 |
204 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[納入/剔除]組織的 GUID。 |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
string |
Edm.String |
[納入/剔除]組織的名稱。 |
example.onmicrosoft.com |
2013-V1 |
TotalConferences |
Long |
Edm.Int64 |
會議的所有類型的報表期間數目。 |
12587 |
2013-V1 |
WebConferences |
Long() |
Edm.Int64 |
Web 會議中的報表期間數目。 |
5 |
2013-V1 |
* WCF 類型參照Visual Studio中建立 Windows Communications Framework (WCF) 服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。
* * [納入/剔除]: 如需詳細資訊,請參閱在輸入參數並報告輸出欄] 區段中。
備註
要包含在會議中的報告的數字,至少一位參與者必須已加入為其 Office 365 組織使用者帳戶。
會議參與者所參加透過電話或平板電腦等行動裝置並不包含在報表中。此原因,如果所有參與者在會議中的都使用的行動裝置、 會議不會在報表中顯示。
傳回會議計數包括所組織的使用者所召集的會議。每個會議只會計算每個類別,不論使用者或來賓數目的參與之後。因為不同 Lync Online 計劃可能不包含能夠召集會議,但可能仍有能力參與它們,組織內的租用戶的會議數目可能遇到了一律會傳回零。
在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊,請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。
三個報告類型不同只能隨著每個報告項目涵蓋的時間。Date 功能變數中報告的時間代表期結束的時間。日期及時間報告中的 HTTPS 取得X-timezone標頭中指定的時區。如果未不指定任何時區,則會使用 UTC 時間。報告的持續時間的計算公式為時間列在下表中。
報表名稱 |
時間週期計算 |
---|---|
每日() CsConferenceDaily |
報告每天午夜精準地啟動 (00:00:00) 結束之前在同一天的午夜 (23.59:59.9999...)。報告的最後一天就資料有可用的最後一個完整天因此將不會包含目前的日期。日期及時間Date ] 欄位中傳回代表該報表天結束。 |
每週() CsConferenceWeekly |
報表週午夜精準地啟動 (00:00:00)、 早期在星期日結束之前在下列星期六晚上午夜 (23:59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報告的週的結尾。 |
每月() CsConferenceMonthly |
報表的月份午夜精準地啟動 (00:00:00) 上的第一天的月和結束之前在該月的最後一個行事曆天的午夜 (23.59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。 |
範例
下列的要求及回應配對示範如何 month JSON 格式來擷取會議活動的報告。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceMonthly?$format=Json
{
"d":
{
"results":
[
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsConferenceMonthly(datetime'2013-05-31T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsConferenceMonthly(datetime'2013-05-31T00%3A00%3A00')",
"type":"TenantReporting.CsConferenceReport"
},
"ID":"24984",
"Date":"\/Date(1369958400000)\/",
"TenantGuid":"b4225608-d90a-4289-a458-bc69587bc613",
"TenantName":"ExampleTenantName",
"TotalConferences":"19",
"AVConferences":"12",
"IMConferences":"13",
"ApplicationSharingConferences":"4",
"WebConferences":"15",
"TelephonyConferences":"0"
}
]
}
}
下列的要求及回應配對會示範如何擷取 (依反向先後順序) 的會議中的每日計數 Atom 格式。報表會傳回資料會議實際上發生,您要求"N"項目使用 $top 選項天內,因為報表會傳回過去 N 天鎖會議。這是不一定是取得"先前 N 行事曆 days"相同。請注意分行符號所新增的要求和回應以利檢視。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceDaily?
$select=Date,TotalConferences,AVConferences,IMConferences,ApplicationSharingConferences,WebConferences,TelephonyConferences&
$top=10&
$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/CsConferenceDaily</id>
<title type="text">CsConferenceDaily</title>
<updated>2013-07-08T20:48:10Z</updated>
<link rel="self" title="CsConferenceDaily" href="CsConferenceDaily" />
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsConferenceDaily(datetime'2013-05-14T00%3A00%3A00')</id>
<category term="TenantReporting.CsConferenceReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title />
<updated>2013-07-08T20:48:10Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
<d:TotalConferences m:type="Edm.Int64">6</d:TotalConferences>
<d:AVConferences m:type="Edm.Int64">5</d:AVConferences>
<d:IMConferences m:type="Edm.Int64">4</d:IMConferences>
<d:ApplicationSharingConferences m:type="Edm.Int64">3</d:ApplicationSharingConferences>
<d:WebConferences m:type="Edm.Int64">6</d:WebConferences>
<d:TelephonyConferences m:type="Edm.Int64">0</d:TelephonyConferences>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsConferenceDaily
(datetime'2013-05-13T00%3A00%3A00')</id>
<category term="TenantReporting.CsConferenceReport"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title />
<updated>2013-07-08T20:48:10Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
<d:TotalConferences m:type="Edm.Int64">10</d:TotalConferences>
<d:AVConferences m:type="Edm.Int64">7</d:AVConferences>
<d:IMConferences m:type="Edm.Int64">6</d:IMConferences>
<d:ApplicationSharingConferences m:type="Edm.Int64">1</d:ApplicationSharingConferences>
<d:WebConferences m:type="Edm.Int64">8</d:WebConferences>
<d:TelephonyConferences m:type="Edm.Int64">0</d:TelephonyConferences>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsConferenceDaily
(datetime'2013-05-10T00%3A00%3A00')</id>
<category term="TenantReporting.CsConferenceReport"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title />
<updated>2013-07-08T20:48:10Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
<d:TotalConferences m:type="Edm.Int64">3</d:TotalConferences>
<d:AVConferences m:type="Edm.Int64">0</d:AVConferences>
<d:IMConferences m:type="Edm.Int64">3</d:IMConferences>
<d:ApplicationSharingConferences m:type="Edm.Int64">0</d:ApplicationSharingConferences>
<d:WebConferences m:type="Edm.Int64">1</d:WebConferences>
<d:TelephonyConferences m:type="Edm.Int64">0</d:TelephonyConferences>
</m:properties>
</content>
</entry>
</feed>
輸入參數並報告輸出欄
在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義:
欄位中表格主要用於$filter=、 $orderby=及其他查詢選項限制報表會傳回的項目中的欄位中標示為 [中]。在欄位標示為 [In 包含$select= ] 選項,可以是資料表欄位和其出現在報表項目但他們會包含任何的有用資料。
欄位標記 [納入/剔除] 欄選取範圍 ($select=) 和項目限制 ($filter=和$orderby=) 選項中可用資料表的欄位中。加入時這些欄位之一$select= ] 選項,將會出現在報表項目,且可用時將會包含有用的資料。
相容性
Office 365 service version 2013-V1中所引進的 CsConferenceDaily、 CsConferenceWeekly,以及 CsConferenceMonthly 報告。如需版本設定的詳細資訊,請參閱在 「 Office 365 報告 」 web 服務的版本控制。
對應的 PowerShell cmdlet
CsConference * 報告傳回資訊與Get-csconferencereport Windows PowerShell指令程式相同。
權限
存取從報表的帳戶必須該Office 365組織中有系統管理權限。如果報表是出現在服務描述文件及 $metadata 傳回給使用者,他們會有從 REST web 服務擷取資料的權限。這份報告要求使用者指派給 「 僅檢視收件者 」 角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告: 帳務管理員、 全域管理員、 密碼管理員、 服務管理員及使用者管理管理員。
資料精確度、 保存及可用性
透過這些報告提供的資訊可分為單日期間從時區 HTTP X-timezone標頭中呼叫的應用程式所報告的午夜十二點開始。
針對此報表之資訊的一年以上,或取消訂閱直到一段。
事件可能最多它們顯示在報表中前 24 小時的延遲。