reportRoot: getEmailAppUsageUserDetail

Espacio de nombres: microsoft.graph

Obtiene información sobre las actividades que realizaron los usuarios en las diferentes aplicaciones de correo electrónico.

Nota: Para obtener más información sobre los diferentes nombres y vistas de informe, consulte Informes de Microsoft 365: uso de aplicaciones Email.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Nota: Para que los permisos delegados permitan a las aplicaciones leer informes de uso del servicio en nombre de un usuario, el administrador de inquilinos debe haber asignado al usuario el rol de administrador Microsoft Entra limitado adecuado. Para obtener más información, vea Autorización para que las API lean informes de uso de Microsoft 365.

Solicitud HTTP

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

Parámetros de función

En la URL de la solicitud, especifique uno de los parámetros siguientes con un valor válido.

Nota: Necesita establecer un período o una fecha en la URL.

Encabezados de solicitud

Respuesta

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. La URL se encuentra en el encabezado Location de la respuesta.

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.

El archivo CSV tiene los siguientes encabezados de columna.

• Fecha de actualización del informe
• Nombre principal de usuario
• Nombre para mostrar
• Eliminado
• Fecha de eliminación
• Fecha de la última actividad
• Mail para Mac
• Outlook para Mac
• Outlook para Windows
• Outlook para móviles
• Otros para móviles
• Outlook para web
• Aplicación POP3
• Aplicación IMAP4
• Aplicación SMTP
• Período del informe

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Reports.GetEmailAppUsageUserDetailWithPeriod("{period}").GetAsync();

mgc reports get-email-app-usage-user-detail-with-period get --period {period-id}

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
period := "{period}"
graphClient.Reports().GetEmailAppUsageUserDetailWithPeriod(&period).Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.reports().getEmailAppUsageUserDetailWithPeriod("{period}").get();

const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/reports/getEmailAppUsageUserDetail(period='D7')')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->reports()->getEmailAppUsageUserDetailWithPeriod('{period}', )->get()->wait();

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.reports.get_email_app_usage_user_detail_with_period("{period}").get()

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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.

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