Informes de MailboxActivity

  • Artículo

Los URI de REST MailboxActivity * proporcionan estadísticas de resumen acerca de la creación de buzones de organización de Office 365 y la eliminación. Existen cuatro informes que use la misma estructura general y a continuación, sólo se diferencian en el intervalo de tiempo durante los cuales resumen los datos: diaria, semanal, mensual y anual. Por motivos de simplicidad, en este tema se detallan los cuatro 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/MailboxActivityDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityYearly[?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. Vea a continuación 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

AccountCreated

long

Edm.Int64

[In/Out] El número de buzones de Office 365 creados durante dicho período de tiempo.

265

2013-V1

AccountDeleted

long

Edm.Int64

[In/Out] El número de buzones de Office 365 eliminado durante dicho período de tiempo.

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

No se especifica ninguno

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

example.onmicrosoft.com

2013-V1

TotalNumberOfActiveMailboxes

long

Edm.Int64

[In/Out] El número total de buzones que estaban activos durante el período del informe.

1242

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

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 cuatro 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 (GroupActivityDaily)

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 (GroupActivityWeekly)

La semana informes comienza a medianoche con precisión (00: 00:00), los primeros el sábado y finaliza justo antes de medianoche (23:59:59.9999...) en la siguiente viernes 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 (GroupActivityMonthly)

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.

Anual (GroupActivityYearly)

El año de notificación que se inicia en la medianoche con precisión (00: 00:00) el 1 de enero de ese año natural y termina justo antes de medianoche (23:59:59.9999...) el 31 de diciembre de ese mismo año de calendario. 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 buzón de correo por mes en formato JSON.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityMonthly?$format=Json

  {
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
                    "type":"TenantReporting.MailboxActivityReport"
                  },
                "TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
                "TenantName":"example.onmicrosoft.com",
                "Date":"\/Date(1354233600000)\/",
                "TotalNumberOfActiveMailboxes":"0",
                "AccountCreated":"0",
                "AccountDeleted":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
                    "type":"TenantReporting.MailboxActivityReport"
                  },
                "TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
                "TenantName":"example.onmicrosoft.com",
                "Date":"\/Date(1356912000000)\/",
                "TotalNumberOfActiveMailboxes":"0",
                "AccountCreated":"0",
                "AccountDeleted":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
                    "type":"TenantReporting.MailboxActivityReport"
                  },
                "TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
                "TenantName":"example.onmicrosoft.com",
                "Date":"\/Date(1359590400000)\/",
                "TotalNumberOfActiveMailboxes":"1",
                "AccountCreated":"0",
                "AccountDeleted":"0"
              }
            
          ]
        
      }
    
  }

El par de solicitud y respuesta siguiente muestra cómo recuperar el número total de buzones activos cada día, para los cuatro días anteriores, en orden cronológico inverso. Esta consulta solicita el recuento de Date y TotalNumberOfActiveMailboxes y solicita la información en formato Atom. Saltos de línea se agregaron a la solicitud y respuesta para mayor claridad.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityDaily?
  $select=Date,TotalNumberOfActiveMailboxes&
  $top=4&
  $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/MailboxActivityDaily</id>
  <title type="text">MailboxActivityDaily</title>
  <updated>2013-01-31T05:23:09Z</updated>
  <link rel="self" title="MailboxActivityDaily" href="MailboxActivityDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-29T00%3A00%3A00')</id>
    <category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-29T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T05:23:09Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
        <d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-28T00%3A00%3A00')</id>
    <category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-28T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T05:23:09Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-28T00:00:00</d:Date>
        <d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-27T00%3A00%3A00')</id>
    <category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-27T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T05:23:09Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-27T00:00:00</d:Date>
        <d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-26T00%3A00%3A00')</id>
    <category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-26T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T05:23:09Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-26T00:00:00</d:Date>
        <d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
      </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 MailboxActivityDaily, MailboxActivityWeekly, MailboxActivityMonthly y MailboxActivityYearly se introdujeron en Versión 2013-V1 del servicio de Office 365. Para obtener más información sobre el control de versiones, vea Control de versiones en el servicio web de informes de Office 365.

Cmdlets de PowerShell correspondientes

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

Permisos

La cuenta de tener acceso a los informes de debe tener permisos administrativos en esa organización Office 365. Si la cuenta puede ver este informe en el panel de control de Office 365, la cuenta tiene 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.