CsP2PAVTime* レポート

  • [アーティクル]

CsP2PAVTime* REST URI は、レポート期間に Office 365 Lync Online ピアツーピア音声セッションおよびビデオ セッションで使用された時間に関する概要統計情報を提供します。全体構造が同じレポートが 3 つあります。これらは、データを集計する間隔 (日次、週次、および月次) のみが異なります。簡単にするために、この 1 つのトピックで 3 つのレポートの詳細を説明します。

最終更新日: 2015年9月17日

適用対象: Office 365

REST URI

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PAVTimeDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PAVTimeWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PAVTimeMonthly[?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

TenantGuid

System.guid

Edm.Guid

[入力/出力] 組織の GUID。

16a58f78-539f-47f7-b9bf-02a63867d73b

2013-V1

TenantName

string

Edm.String

[入力/出力] 組織の名前。

example.onmicrosoft.com

2013-V1

TotalAudioMinutes

long

Edm.Int64

レポート期間に音声会議に使用された分数。

12557

2013-V1

TotalVideoMinutes

long

Edm.Int64

レポート期間にビデオ会議に使用された分数。

3656

2013-V1

*WCF 型は、Visual Studio に Windows Communications Framework (WCF) サービス参照を作成する場合にフィールドに割り当てられる .NET Framework データ型を参照します。EDM 型は、Atom 形式のレポートで返される ADO.NET エンティティ データ モデル (EDM) 型を参照します。

**[入力/出力]: 入力パラメーターとレポート出力列のセクションを参照してください。

解説

報告されるセッションの数に含めるには、少なくとも 1 人の参加者が Office 365 組織ユーザー アカウントとしてセッションに参加していなければなりません。

レポートには、セッションの参加者のうち電話やタブレットなどのモバイル デバイスを使用した参加者は含まれません。このため、セッションのすべての参加者がモバイル デバイスを使用していた場合、そのセッションはレポートに表示されません。

レポート内の各エントリにはメタデータの複数のフィールドが含まれます。詳しくは、「Office 365 レポート Web サービスが返す一般的なメタデータ」を参照してください。

3 種類のレポートは、レポートの各エントリがカバーする時間だけが異なります。 日付フィールドに表示される時刻は、期間の最後を表します。日付と時刻は、HTTPS GET X-timezone ヘッダーに指定されているタイム ゾーンで報告されます。タイム ゾーンが指定されていない場合は、UTC 時刻が使用されます。報告される期間は、次のように計算されます。

レポート名

期間の計算方法

日次 (CsP2PAVTimeDaily)

レポート日は、正確に午前 0 時 (00:00) に始まり、その同じ日の夜 12 時直前 (23.59:59.9999...) に終了します。レポートされる最後の日は、データが利用可能な最後の丸 1 日で、当日を含みません。Date フィールドに返される日時は、そのレポート日の終わりを表します。

週次 (CsP2PAVTimeWeekly)

レポート週は、正確に日曜日の午前 0 時 (00:00:00) に始まり、次の土曜日の夜 12 時前 (23:59:59.9999...) に終わります。直近に報告されるエントリは当日を含むエントリなので、通常、レポートを要求した時点より後まで続きます。Date フィールドに返される日時は、そのレポート週の終わりを表します。

月次 (CsP2PAVTimeMonthly)

レポート月は、正確にその月の最初の日の午前 0 時 (00:00:00) に始まり、その月の最後の日の夜 12 時前 (23:59:59.9999...) に終わります。直近に報告されるエントリは当日を含むエントリなので、通常、レポートを要求した時点より後まで続きます。Date フィールドに返される日時は、そのレポート月の終わりを表します。

例

以下の要求と応答のペアは、日単位のピアツーピア音声およびビデオ活動のレポートを Atom 形式で取得する方法を示しています。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PAVTimeDaily?
    $select=Date,TotalAudioMinutes,TotalVideoMinutes&
    $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/CsP2PAVTimeDaily</id>
  <title type="text">CsP2PAVTimeDaily</title>
  <updated>2013-07-08T23:53:01Z</updated>
  <link rel="self" title="CsP2PAVTimeDaily" href="CsP2PAVTimeDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsP2PAVTimeDaily
        (datetime'2013-05-10T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PAVTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:53:01Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
        <d:TotalAudioMinutes m:type="Edm.Int64">1</d:TotalAudioMinutes>
        <d:TotalVideoMinutes m:type="Edm.Int64">0</d:TotalVideoMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsP2PAVTimeDaily
        (datetime'2013-05-13T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PAVTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:53:01Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
        <d:TotalAudioMinutes m:type="Edm.Int64">18</d:TotalAudioMinutes>
        <d:TotalVideoMinutes m:type="Edm.Int64">6</d:TotalVideoMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsP2PAVTimeDaily
        (datetime'2013-05-14T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PAVTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:53:01Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
        <d:TotalAudioMinutes m:type="Edm.Int64">6</d:TotalAudioMinutes>
        <d:TotalVideoMinutes m:type="Edm.Int64">1</d:TotalVideoMinutes>
      </m:properties>
    </content>
  </entry>
</feed>

以下の要求と応答のペアは、1 日に使用された総分数を新しい順に取得する方法を示しています。このレポートは最大 10 行を返します。各行が組織で音声またはビデオ時間を使用した日に対応します。このクエリは、Date、TotalAudioMinutes、および TotalVideoMinutes の値を要求し、情報を Atom 形式で取得します。このケースでは、音声またはビデオ会議が 3 日間しか使用されていないため、このレポートは 3 行だけを返します。見やすくするために、要求と応答に改行が追加されています。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PAVTimeDaily?
    $select=Date,TotalAudioMinutes,TotalVideoMinutes&
    $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/CsP2PAVTimeDaily</id>
  <title type="text">CsP2PAVTimeDaily</title>
  <updated>2013-06-25T18:04:48Z</updated>
  <link rel="self" title="CsP2PAVTimeDaily" href="CsP2PAVTimeDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsP2PAVTimeDaily
      (datetime'2013-05-14T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PAVTimeReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T18:04:48Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
        <d:TotalAudioMinutes m:type="Edm.Int64">6</d:TotalAudioMinutes>
        <d:TotalVideoMinutes m:type="Edm.Int64">1</d:TotalVideoMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsP2PAVTimeDaily
      (datetime'2013-05-13T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PAVTimeReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T18:04:48Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
        <d:TotalAudioMinutes m:type="Edm.Int64">18</d:TotalAudioMinutes>
        <d:TotalVideoMinutes m:type="Edm.Int64">6</d:TotalVideoMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsP2PAVTimeDaily
      (datetime'2013-05-10T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PAVTimeReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T18:04:48Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
        <d:TotalAudioMinutes m:type="Edm.Int64">1</d:TotalAudioMinutes>
        <d:TotalVideoMinutes m:type="Edm.Int64">0</d:TotalVideoMinutes>
      </m:properties>
    </content>
  </entry>
</feed>

入力パラメーターとレポート出力列

フィールド表の [入力/出力] という表記には次の意味があります。

  • フィールド表で [入力] が付いているフィールドは、主に $filter=、$orderby= およびレポートが返すエントリを制限する他のクエリ オプションで使用するためのものです。フィールド表で [入力] が付いているフィールドは、$select= オプションに含めることができ、レポート エントリに表示されますが、有用なデータは入っていません。

  • フィールド表で [入力/出力] が付いているフィールドは、列選択 ($select=) およびエントリ制限 ($filter= と $orderby=) オプションの両方で使用できます。これらのフィールドを $select= オプションに含めると、レポート エントリに表示され、利用可能な場合には有用なデータが入っています。

互換性

CsP2PAVTimeDaily、CsP2PAVTimeWeekly、および CsP2PAVTimeMontly レポートは Office 365 サービス バージョン 2013-V1 で導入されました。バージョン管理の詳細については、「Office 365 レポート Web サービスのバージョン管理」を参照してください。

対応する PowerShell コマンドレット

CsP2PAVTime* レポートは、Get-CsP2PAVTimeReport Windows PowerShell コマンドレットと同じ情報を返します。

権限

レポートにアクセスするアカウントには、その Office 365 組織の管理権限が必要です。レポートがサービス記述文書に含まれており $metadata 文書がユーザーに返される場合、REST Web サービスからデータを取得する権限があります。このレポートでは、ユーザーを参照のみ可受信者の役割に割り当てる必要があります。既定の Office 365 権限構造では、次の管理者権限があるユーザーはこのレポートにアクセスできます: 課金管理者、全体管理者、パスワード管理者、サービス管理者、ユーザー管理の管理者。

データの細分性、永続性、可用性

これらのレポートにより利用できる情報は、HTTP X-timezone ヘッダーの呼び出し元アプリケーションにより報告されているタイムゾーンにおける真夜中から始まる日単位で分けることができます。

このレポートの情報は、1 年間またはサブスクリプションをキャンセルするまで利用可能です。

イベントがレポートに表示されるまで、最大で 24 時間遅れる場合があります。