CsP2PSession* レポート
CsP2PSession* REST URI は、Office 365 Lync Online ピアーツーピア セッションの数に関するサマリー統計を提供します。全体的な構造が同じで、データの集計期間だけが日単位、週単位、月単位と異なる 3 つのレポートがあります。簡略化するため、これらのレポートについて 1 つのトピックで取り上げます。
最終更新日: 2015年9月17日
適用対象: Office 365
REST URI
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionMonthly[?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 |
ID |
long |
Edm.Int64 |
[入力/出力] レポート レコードのインデックス番号。 |
72 |
2013-V1 |
P2PApplicationSharingSessions |
long |
Edm.Int64 |
[入力/出力] レポート期間中における、ピアーツーピア (P2P) アプリケーション共有セッションの数。 |
182 |
2013-V1 |
P2PAudioSessions |
long |
Edm.Int64 |
[入力/出力] レポート期間中の P2P オーディオ セッションの数。 |
12 |
2013-V1 |
P2PFileTransferSessions |
long |
Edm.Int64 |
[入力/出力] レポート期間中の P2P ファイル転送セッションの数。 |
42 |
2013-V1 |
P2PIMSessions |
long |
Edm.Int64 |
[入力/出力] レポート期間中の P2P インスタント メッセージ セッションの数。 |
142 |
2013-V1 |
P2PVideoSessions |
long |
Edm.Int64 |
[入力/出力] レポート期間中の P2P ビデオ セッションの数。 |
1562 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[入力/出力] 組織の GUID。 |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
string |
Edm.String |
[入力/出力] 組織名。 |
example.onmicrosoft.com |
2013-V1 |
TotalP2PSessions |
long |
Edm.Int64 |
レポート期間中のすべての種類の P2P セッションの数。 |
12587 |
2013-V1 |
*WCF 型は、Visual Studio に Windows Communications Framework (WCF) Service Reference を作成する場合にフィールドに割り当てられる .NET Framework データ型を参照します。EDM 型は、Atom 形式のレポートで返される ADO.NET エンティティ データ モデル (EDM) 型を参照します。
**[入力/出力]: 詳しくは、「入力パラメーターとレポート出力列」のセクションを参照してください。
解説
報告されるセッションの数に含めるには、少なくとも 1 人の参加者が Office 365 組織ユーザー アカウントとしてセッションに参加していなければなりません。
レポートには、セッションの参加者のうち電話やタブレットなどのモバイル デバイスを使用した参加者は含まれません。このため、セッションのすべての参加者がモバイル デバイスを使用していた場合、そのセッションはレポートに表示されません。
レポート内の各エントリにはメタデータの複数のフィールドが含まれます。詳しくは、「Office 365 レポート Web サービスが返す一般的なメタデータ」を参照してください。
3 種類のレポートは、レポートの各エントリがカバーする時間だけが異なります。 日付フィールドに表示される時刻は、期間の最後を表します。日付と時刻は、HTTPS GET X-timezone ヘッダーに指定されているタイム ゾーンで報告されます。タイム ゾーンが指定されていない場合は、UTC 時刻が使用されます。報告される期間は、次のように計算されます。
レポート名 |
期間の計算方法 |
---|---|
毎日 (CsP2PSessionDaily) |
報告する日は正確に午前 0 時 (00:00) に始まり、その同じ日の夜 12 時直前 (23.59:59.9999...) に終了します。報告される最後の日は、データが利用可能な最後の丸 1 日で、今日を含みません。Date フィールドに返される日時は、その日のレポートの最後の時刻を表します。 |
毎週 (CsP2PSessionWeekly) |
報告する週は、正確に日曜日の午前 0 時 (00:00:00) に始まり、次の土曜日の夜 12 時前 (23:59:59.9999...) に終わります。直近に報告されるエントリは当日を含むエントリなので、通常、レポートを要求した時点より後まで続きます。Date フィールドに返される日時は、その週のレポートの最後の時刻を表します。 |
毎月 (CsP2PSessionMonthly) |
報告する月は、正確にその月の最初の日の午前 0 時 (00:00:00) に始まり、その月の最後の日の夜 12 時前 (23:59:59.9999...) に終わります。直近に報告されるエントリは当日を含むエントリなので、通常、レポートを要求した時点より後まで続きます。Date フィールドに返される日時は、その月のレポートの最後の時刻を表します。 |
例
以下の要求と応答のペアは、グループの活動に関する日単位のレポートを JSON 形式で取得する方法の例を示しています。分かりやすくするために、要求と応答に改行が追加されています。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
$select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,P2PVideoSessions,
P2PApplicationSharingSessions,P2PFileTransferSessions&
$format=Json
{
"d":
{
"results":
[
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
"type":"TenantReporting.CsP2PSessionReport"
},
"Date":"\/Date(1368144000000)\/",
"TotalP2PSessions":"23",
"P2PIMSessions":"12",
"P2PAudioSessions":"8",
"P2PVideoSessions":"1",
"P2PApplicationSharingSessions":"2",
"P2PFileTransferSessions":"1"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
"type":"TenantReporting.CsP2PSessionReport"
},
"Date":"\/Date(1368403200000)\/",
"TotalP2PSessions":"42",
"P2PIMSessions":"16",
"P2PAudioSessions":"18",
"P2PVideoSessions":"7",
"P2PApplicationSharingSessions":"3",
"P2PFileTransferSessions":"5"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
"type":"TenantReporting.CsP2PSessionReport"
},
"Date":"\/Date(1368489600000)\/",
"TotalP2PSessions":"38",
"P2PIMSessions":"18",
"P2PAudioSessions":"8",
"P2PVideoSessions":"3",
"P2PApplicationSharingSessions":"7",
"P2PFileTransferSessions":"5"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
"type":"TenantReporting.CsP2PSessionReport"
},
"Date":"\/Date(1369180800000)\/",
"TotalP2PSessions":"3",
"P2PIMSessions":"1",
"P2PAudioSessions":"0",
"P2PVideoSessions":"0",
"P2PApplicationSharingSessions":"0",
"P2PFileTransferSessions":"2"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
"type":"TenantReporting.CsP2PSessionReport"
},
"Date":"\/Date(1369353600000)\/",
"TotalP2PSessions":"2",
"P2PIMSessions":"1",
"P2PAudioSessions":"0",
"P2PVideoSessions":"0",
"P2PApplicationSharingSessions":"0",
"P2PFileTransferSessions":"1"
}
]
}
}
以下の要求と応答のペアは、5 月 20 日から 5 月 25 日までの各日に生じたセッション数を取得する方法の例を示しています。このクエリは Atom 形式で情報を要求します。分かりやすくするために、要求と応答に改行が追加されています。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
$select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,
P2PVideoSessions,P2PApplicationSharingSessions,
P2PFileTransferSessions&
$filter=Date%20ge%20datetime'2013-05-20T00:00:00'%20and%20Date%20lt%20datetime'2013-05-26T00:00:00'&
$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/CsP2PSessionDaily</id>
<title type="text">CsP2PSessionDaily</title>
<updated>2013-06-25T20:36:14Z</updated>
<link rel="self" title="CsP2PSessionDaily" href="CsP2PSessionDaily" />
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')</id>
<category term="TenantReporting.CsP2PSessionReport"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title />
<updated>2013-06-25T20:36:14Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-05-22T00:00:00</d:Date>
<d:TotalP2PSessions m:type="Edm.Int64">3</d:TotalP2PSessions>
<d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
<d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
<d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
<d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
<d:P2PFileTransferSessions m:type="Edm.Int64">2</d:P2PFileTransferSessions>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')</id>
<category term="TenantReporting.CsP2PSessionReport"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<title />
<updated>2013-06-25T20:36:14Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-05-24T00:00:00</d:Date>
<d:TotalP2PSessions m:type="Edm.Int64">2</d:TotalP2PSessions>
<d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
<d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
<d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
<d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
<d:P2PFileTransferSessions m:type="Edm.Int64">1</d:P2PFileTransferSessions>
</m:properties>
</content>
</entry>
</feed>
入力パラメーターとレポート出力例
フィールド表の [入力/出力] という表記には次の意味があります。
フィールド表で [入力] が付いているフィールドは、主に $filter=、$orderby= およびレポートが返すエントリを制限する他のクエリ オプションで使用するためのものです。フィールド表で [入力] が付いているフィールドは、$select= オプションに含めることができ、レポート エントリに表示されますが、有用なデータは入っていません。
フィールド表で [入力/出力] が付いているフィールドは、列選択 ($select=) およびエントリ制限 ($filter= と $orderby=) オプションの両方で使用できます。これらのフィールドの 1 つを $select= オプションに含めると、レポート エントリに表示され、利用可能な場合には有用なデータが入っています。
互換性
CsP2PSessionDaily、CsP2PSessionWeekly、CsP2PSessionMonthly レポートが Office 365 サービス バージョン 2013-V1 で導入されました。バージョン管理の詳細については、「Office 365 レポート Web サービスのバージョン管理」を参照してください。
対応する PowerShell コマンドレッド
CsP2PSession* レポートは、Get-CsP2PSessionReport Windows PowerShell コマンドレットと同じ情報を返します。
権限
レポートにアクセスするアカウントには、その Office 365 組織の管理権限が必要です。レポートがサービス記述文書に含まれており $metadata 文書がユーザーに返される場合、REST Web サービスからデータを取得する権限があります。このレポートでは、ユーザーを参照のみ可受信者の役割に割り当てる必要があります。既定の Office 365 権限構造では、次の管理者権限があるユーザーはこのレポートにアクセスできます: 課金管理者、全体管理者、パスワード管理者、サービス管理者、ユーザー管理の管理者。
データの粒度、永続性、可用性
これらのレポートで使用可能な情報は、HTTP X-timezone ヘッダーに呼び出し元アプリケーションによって報告されているタイムゾーンの午前 0 時から始まる 1 日ごとに分けることができます。
このレポートの情報は、1 年間またはサブスクリプションをキャンセルするまで利用可能です。
イベントがレポートに表示されるまで、最大で 24 時間遅れる場合があります。