Compartir a través de

Informes de CsP2PAVTime

  • Artículo

Los URI de REST CsP2PAVTime * proporcionan estadísticas de resumen acerca de la cantidad de tiempo que se usa en sesiones de audio Office 365 Peer-to-Peer Lync Online y sesiones de vídeo durante el período del informe. Hay tres informes que usan la misma estructura general. Sólo se diferencian en el intervalo de tiempo durante los cuales resumen los datos: diaria, semanal y mensual. Por motivos de simplicidad, en este uno tema se detallan los tres informes.

Última modificación: jueves, 17 de septiembre de 2015

Hace referencia a: Office 365

URI de REST

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]

Campos

Los siguientes campos pueden especificarse en las opciones de consulta de ODATA2 $select, $filter y $orderby . Si no hay ninguna opción de $select se proporciona, se devuelven todos los campos.

Nombre

Tipo WCF *

Tipo EDM *

[In/Out] ** descripción

Valores de ejemplo

Agregado en la versión de servicio

Date

System.DateTime

Edm.DateTime

[In/Out] La fecha de finalización y la hora del período de notificación. Consulte las siguientes secciones para obtener más información acerca de los períodos de informes.

Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] El número de índice del registro del informe.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] El GUID de la organización.

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

2013-V1

TenantName

string

Edm.String

[In/Out] El nombre de la organización.

example.onmicrosoft.com

2013-V1

TotalAudioMinutes

long

Edm.Int64

El número de minutos transcurrido en conferencias de Audio en el período del informe.

12557

2013-V1

TotalVideoMinutes

long

Edm.Int64

El número de minutos empleado en una conferencia de vídeo en el período del informe.

3656

2013-V1

* Tipo WCF hace referencia al tipo de datos .NET Framework asignado al campo cuando se crea una referencia de servicio de Windows Communications Framework (WCF) en Visual Studio. El tipo de EDM hace referencia a los tipos de ADO.NET Entity Data Model (EDM) devueltos en los informes con formato Atom.

** [In/Out]: ver los parámetros de entrada y notificar la sección de columnas de salida.

Comentarios

Para ser incluido en los números de informes de sesiones, como mínimo un participante debe han participado en la sesión como su cuenta de usuario de la organización de Office 365.

Los participantes de la sesión que se han asistir a través de dispositivos móviles como teléfonos o tabletas no se incluyen en el informe. Por este motivo, si todos los participantes en una sesión se encuentran en dispositivos móviles, esa sesión no se mostrará en el informe.

Cada entrada en el informe incluye varios campos de metadatos. Para obtener más información, vea Metadatos comunes devueltos por el servicio web de informes de Office 365.

Los tres tipos de informe difieren sólo en la cantidad de tiempo que cubre de cada entrada del informe. El tiempo que se indica en el campo fecha representa el final del período de tiempo. Las fechas y horas se muestran en la zona horaria especificada en el encabezado de X-timezone HTTPS GET. Si no se especifica ninguna zona horaria, se usa la hora UTC. Informa de las duraciones de tiempo se calcula de la manera siguiente.

Nombre del informe

Cálculo de período de tiempo

Diaria (CsP2PAVTimeDaily)

El día de presentación de informes se inicia en la medianoche con precisión (00: 00:00) y finaliza justo antes de medianoche (23.59:59.9999...) en ese mismo día. El último día que se notifiquen será el último día completo para la que los datos están disponibles y no incluirá el día actual. La fecha y hora devuelto en el campo Date representa el final de ese día informes.

Semanal (CsP2PAVTimeWeekly)

La semana informes comienza a medianoche con precisión (00: 00:00), los primeros domingo y finaliza justo antes de medianoche (23:59:59.9999...) en la siguiente sábado por la noche. La entrada recientemente reportada es uno que incluya el día actual y, por lo tanto, normalmente se extienden más allá de cuando se solicita el informe. La fecha y hora devuelto en el campo Date representa el final de esa semana informes.

Mensual (CsP2PAVTimeMonthly)

El mes informes se inicia en la medianoche con precisión (00: 00:00) en el primer día del mes y los extremos justo antes de medianoche (23.59:59.9999...) en el último día de calendario de ese mes. La entrada recientemente reportada es uno que incluya el día actual y, por lo tanto, normalmente se extienden más allá de cuando se solicita el informe. La fecha y hora devuelto en el campo Date representa el final de ese mes del informe.

Ejemplos

El par de solicitud y respuesta siguiente muestra cómo recuperar un informe de actividad de vídeo y audio de punto a punto por día en formato 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>

El siguiente par de solicitud y respuesta muestra cómo recuperar los totales diarios de minutos utilizados en orden cronológico inverso. El informe devolverá hasta diez filas, una fila por cada día cuando la organización usa hora de audio o vídeo. Esta consulta solicita los valores de TotalAudioMinutes y TotalVideoMinutes , Datey solicita la información en formato Atom. En este caso, conferencias de audio o vídeo se usan para sólo tres días, por lo que el informe devuelve sólo tres filas. Saltos de línea se agregaron a la solicitud y respuesta para mayor claridad.

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>

Parámetros de entrada y salida columnas de informe

Los indicadores de [In/Out] en la tabla campos tienen los significados siguientes:

  • Campos marcados [In] en los campos de tabla principalmente están diseñados para su uso en $filter=, $orderby= y otras opciones de consulta que restringen las entradas que se devuelve el informe. Campos marcados [In] en los campos de tabla puede ser incluyen la opción $select= y aparecen en las entradas de informe, pero no va a contener ningún dato útil.

  • Campos marcados [In/Out] en los campos de tabla puede utilizarse en Opciones de ($filter= y $orderby=) de la restricción de entrada y de selección de columna ($select=). Cuando uno de estos campos se incluye en la opción $select= , aparecerán en las entradas de informe y va a contener datos útiles cuando esté disponible.

Compatibilidad

Los informes de CsP2PAVTimeDaily, CsP2PAVTimeWeekly y CsP2PAVTimeMontly se introdujeron en Versión 2013-V1 del servicio de Office 365. Para obtener más información acerca de las versiones, vea Control de versiones en el servicio web de informes de Office 365.

Cmdlets de PowerShell correspondientes

Los informes de CsP2PAVTime * devuelven la misma información que el cmdlet de Get-CsP2PAVTimeReportWindows PowerShell. 

Permisos

La cuenta de tener acceso a los informes de debe tener permisos administrativos en esa organización Office 365. Si el informe está presente en el documento de descripción de servicio y el documento $metadata devuelve al usuario, a continuación, disponen de permisos para recuperar los datos desde el servicio web REST. Este informe requiere que el usuario que se asignará a la función de los destinatarios con permiso de vista. En la estructura de permisos Office 365 de forma predeterminada, los usuarios con los siguientes permisos de administrador pueden tener acceso a este informe: administrador del usuario, administrador global, Administrador de contraseñas, Administrador de servicio y Administrador de facturación.

Disponibilidad, la persistencia y la granularidad de datos

Información disponible a través de estos informes puede dividirse en períodos de un día, comienza a medianoche de la zona horaria que notifica la aplicación de llamada en el encabezado de X-timezone HTTP.

La información de este informe está disponible durante un período de un año, o hasta que se cancele la suscripción.

Los eventos se pueden retrasar por 24 horas antes de que aparezcan en un informe.