通过

CsP2PSession* 报告

  • 项目

CsP2PSession* REST URI 提供了有关 Office 365 Lync Online 对等会话数量的概要统计。共有三个报告使用同一个整体结构，它们仅在汇总数据使用的时间间隔（每日、每周和每月）上有区别。为简单起见，本主题中详细说明了三个报告。

上次修改时间： 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 类型*

[In/Out]** 说明

示例值

在其中添加的服务版本

Date

System.DateTime

Edm.DateTime

[In/Out] 报告期间的结束日期和时间。请参阅以下部分，获取有关报告期间的详细信息。

简写日期（例如，03/10/2013）或带引号的日期时间（例如，"03/10/2013 4:55 PM"）

2013-V1

ID

long

Edm.Int64

[In/Out] 报告记录的索引号。

72

2013-V1

P2PApplicationSharingSessions

long

Edm.Int64

[In/Out] 报告期间共享会话的对等 (P2P) 应用程序的数量。

182

2013-V1

P2PAudioSessions

long

Edm.Int64

[In/Out] 报告期间 P2P 音频会话的数量。

12

2013-V1

P2PFileTransferSessions

long

Edm.Int64

[In/Out] 报告期间 P2P 文件传输会话的数量。

42

2013-V1

P2PIMSessions

long

Edm.Int64

[In/Out] 报告期间 P2P 即时消息会话的数量。

142

2013-V1

P2PVideoSessions

long

Edm.Int64

[In/Out] 报告期间 P2P 视频会话的数量。

1562

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] 组织的 GUID。

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

2013-V1

TenantName

字符串

Edm.String

[In/Out] 组织名称。

example.onmicrosoft.com

2013-V1

TotalP2PSessions

long

Edm.Int64

报告期间所有类型的 P2P 会话的数量。

12587

2013-V1

*WCF 类型指在 Visual Studio 中创建 Windows Communications Framework (WCF) 服务参考时分配给字段的 .NET Framework 数据类型。EDM 类型指 ATOM 格式化报告中返回的 ADO.NET 实体数据模型 (EDM) 类型。

**[In/Out]：有关详细信息，请参阅"输入参数和报告输出列"部分。

备注

若要包含在报告的对话数中，必须至少已有一位参与者以其 Office 365 组织用户帐户参与了会话。

报告中不包含通过手机或平板电脑等移动设备参与的会话参与者。为此，如果某会话的所有参与者均在移动设备上进行，则报告中不会显示该会话。

报告中的每个条目都包含元数据的多个字段。有关详细信息，请参阅 Office 365 报告 Web 服务返回的常见元数据。

三个报告类型仅是每个报告条目涵盖的时间量不同。"日期"字段中报告的时间表示时间段的结束。日期和时间按 HTTPS GET X-timezone 标头指定的时区报告。如果没有指定时区，则使用 UTC 时间。报告的持续时间以下列方式计算。

报告名称

时间段计算

每日 (CsP2PSessionDaily)

报告日精确始于午夜 (00:00:00) 并在当天即将午夜前 (23.59:59.9999...) 结束。报告的最后一天是所提供数据的最后一整天，将不包含当日。Date 字段中返回的日期和时间表示该报告日的结束。

每周 (CsP2PSessionWeekly)

报告周精确始于星期日凌晨午夜 (00:00:00)，并在下一周星期六晚上即将午夜前 (23:59:59.9999...) 结束。最近报告的条目包含当日的条目，因此通常延长到请求报告的时间之外。Date 字段中返回的日期和时间表示该报告周的结束。

每月 (CsP2PSessionMonthly)

报告月精确始于每月第一天午夜 (00:00:00)，并在当月最后一个日历日即将午夜前 (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>

输入参数和报告输出列

字段表格中的 [In/Out] 指示符具有以下含义：

  • 字段表中标记为 [In] 的字段主要在 $filter=、$orderby= 和其他限制报告应返回哪些条目的查询选项中使用。字段表中标记为 [In] 的字段可包含在 $select= 选项中，他们将在报告条目中出现，但不包含有用数据。

  • 字段表中标记为 [In/Out] 的字段可在列选择 ($select=) 和条目限制（$filter= 和 $orderby=）选项中使用。当您在 $select= 选项中包含这些字段之一时，它们将在报告条目中出现，且将在提供时包含有用数据。

兼容性

CsP2PSessionDaily、CsP2PSessionWeekly 和 CsP2PSessionMonthly 报告在 Office 365 服务版本 2013-V1 中引入。有关版本控制的详细信息，请参阅 Office 365 报告 Web 服务中的版本控制。

相应的 PowerShell cmdlet

CsP2PSession* 报告返回与 Get-CsP2PSessionReport Windows PowerShell cmdlet 相同的信息。

权限

您用于访问报告的帐户必须拥有该 Office 365 组织的管理权限。如果服务说明文档及返回给用户的 $metadata 文档中包含报告，则它们具有从 REST Web 服务检索数据的权限。此报告要求为用户分配收件人（仅查看）角色。在默认的 Office 365 权限结构中，具有下列管理员权限的用户可以访问此报告：帐务管理员 、全局管理员、密码管理员、服务管理员和用户管理管理员。

数据粒度、 持久性和可用性

通过这些报告提供的信息可分隔为多个一天的时间段，从调用应用程序在 HTTP X-timezone 标头中报告的时区的午夜开始。

此报告的信息适用于一年的时间，或者直到取消订阅为止。

事件可能被推迟达 24 小时，才能显示在报告中。