reportRoot: getEmailAppUsageUserDetailreportRoot: getEmailAppUsageUserDetail

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Obtiene información sobre las actividades que realizaron los usuarios en las diferentes aplicaciones de correo electrónico.Get details about which activities users performed on the various email apps.

Nota: Para obtener información sobre los diferentes nombres de informes y vistas de informes, vea Microsoft 365 Reports-uso de aplicaciones de correo electrónico.Note: For details about different report views and names, see Microsoft 365 reports - Email apps usage.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Reports.Read.AllReports.Read.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication Reports.Read.AllReports.Read.All

Nota: Para permisos delegados a fin de permitir que las aplicaciones lean los informes de uso del servicio en nombre de un usuario, el administrador de la cuenta empresarial debe haber asignado al usuario un rol de administrador limitado apropiado en Azure AD.Note: For delegated permissions to allow apps to read service usage reports on behalf of a user, the tenant administrator must have assigned the user the appropriate Azure AD limited administrator role. Para obtener más información, vea autorización para API para leer informes de uso de Microsoft 365.For more details, see Authorization for APIs to read Microsoft 365 usage reports.

Solicitud HTTPHTTP request

GET /reports/getEmailAppUsageUserDetail(period='{period_value}')
GET /reports/getEmailAppUsageUserDetail(date={date_value})

Parámetros de funciónFunction parameters

En la URL de la solicitud, especifique uno de los parámetros siguientes con un valor válido.In the request URL, provide one of the following parameters with a valid value.

ParámetroParameter TipoType DescripciónDescription
periodperiod cadenastring Especifica la duración de tiempo durante la que se agrega el informe.Specifies the length of time over which the report is aggregated. Los valores admitidos para {period_value} son: D7, D30, D90 y D180.The supported values for {period_value} are: D7, D30, D90, and D180. Estos valores tienen el formato Dn, donde n representa el número de días durante los que se agrega el informe.These values follow the format Dn where n represents the number of days over which the report is aggregated.
datedate FechaDate Especifica la fecha en que quiere ver los usuarios que realizaron alguna actividad.Specifies the date for which you would like to view the users who performed any activity. {date_value} necesita tener el formato de AAAA-MM-DD.{date_value} must have a format of YYYY-MM-DD. Como este informe solo está disponible para los últimos 30 días, {date_value} tiene que ser una fecha de ese intervalo.As this report is only available for the past 30 days, {date_value} should be a date from that range.

Nota: Necesita establecer un período o una fecha en la URL.Note: You need to set either period or date in the URL.

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
If-None-MatchIf-None-Match Si se incluye el encabezado de la solicitud y la eTag proporcionada coincide con la etiqueta actual del archivo, se devuelve un código de respuesta 304 Not Modified.If this request header is included and the eTag provided matches the current tag on the file, a 304 Not Modified response code is returned. Opcional.Optional.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve una respuesta 302 Found que redirige a una URL de descarga con autenticación previa para el informe.If successful, this method returns a 302 Found response that redirects to a preauthenticated download URL for the report. La URL se encuentra en el encabezado Location de la respuesta.That URL can be found in the Location header in the response.

Las URL de descarga con autenticación previa solo son válidas durante un breve período de tiempo (unos minutos) y no necesitan un encabezado Authorization para descargarlas.Preauthenticated download URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header.

El archivo CSV tiene los siguientes encabezados de columna.The CSV file has the following headers for columns.

  • Fecha de actualización del informeReport Refresh Date
  • Nombre principal de usuarioUser Principal Name
  • Nombre para mostrarDisplay Name
  • EliminadoIs Deleted
  • Fecha de eliminaciónDeleted Date
  • Fecha de la última actividadLast Activity Date
  • Mail para MacMail For Mac
  • Outlook para MacOutlook For Mac
  • Outlook para WindowsOutlook For Windows
  • Outlook para móvilesOutlook For Mobile
  • Otros para móvilesOther For Mobile
  • Outlook para webOutlook For Web
  • Aplicación POP3POP3 App
  • Aplicación IMAP4IMAP4 App
  • Aplicación SMTPSMTP App
  • Período del informeReport Period

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/reports/getEmailAppUsageUserDetail(period='D7')

RespuestaResponse

Este es un ejemplo de la respuesta.The following is an example of the response.

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Siga el redireccionamiento 302 y el archivo CSV descargado tendrá el esquema siguiente.Follow the 302 redirection and the CSV file that downloads will have the following schema.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Last Activity Date,Mail For Mac,Outlook For Mac,Outlook For Windows,Outlook For Mobile,Other For Mobile,Outlook For Web,POP3 App,IMAP4 App,SMTP App,Report Period