copilotReportRoot: getMicrosoft365CopilotUsageUserDetail

Importante

Las API de la /beta versión están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.

Obtenga los datos de uso más recientes para los usuarios que están habilitados para Microsoft 365 Copilot aplicaciones.

Para obtener más información sobre los nombres y vistas de informe, consulte Informes de Microsoft 365: uso de Microsoft 365 Copilot. Las API de informes de uso de Copilot están disponibles como API REST estándar en el espacio de nombres de Microsoft Graph. Para obtener más información, consulte introducción a las API de Microsoft 365 Copilot.

Nota:

Esta API solo devuelve datos de uso para los usuarios que tienen una licencia de Microsoft 365 Copilot. Los datos de uso de Copilot Chat sin licencia no están disponibles a través de las API de informes de Microsoft Graph. En su lugar, puede:

  • Ver el uso sin licencia en el informe de uso del Centro de Administración de Microsoft 365 Copilot Chat
  • Acceso a los datos de auditoría a través del registro de Auditoría de Microsoft Purview
  • Exportación mediante programación mediante Search-UnifiedAuditLog (PowerShell) o la API de actividad de administración de Office 365

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

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

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.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Reports.Read.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Reports.Read.All No disponible.

Importante

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 uno de los siguientes Microsoft Entra ID roles de administrador limitados:

  • Administrador de la empresa
  • Administrador de IA
  • Administrador de Exchange
  • Administrador de SharePoint
  • Administrador de Lync
  • Administrador de servicios de Teams
  • Administrador de comunicaciones de Teams
  • Lector de informes

Para obtener más información, consulte Autorización para que las API lean los informes de uso de Microsoft 365.

Solicitud HTTP

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period={period}, version={version})

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period={period}, version={version})

Parámetros de función

En la dirección URL de la solicitud, proporcione los siguientes parámetros de consulta con valores.

Parámetro Tipo Descripción
period Cadena Obligatorio. Número de días anteriores en los que se va a notificar el uso agregado. Los valores admitidos dependen del valor de version. Para v1, son: D7, D30, D90, , D180, ALL. Para v2, son D7, D28, D90, , D180, ALL. Los cuatro primeros valores siguen el formato Dn donde n representa el número de días anteriores sobre los que se van a agregar datos. ALL indica el uso de informes para todos los períodos admitidos (7, 30, 90 y 180 días para v1, 7, 28, 90 y 180 días para v2).
version Cadena Opcional. Versión del informe solicitada. Los valores admitidos son v1 (valor predeterminado) y v2.

Versiones del informe

Los informes de la versión 1 contienen la siguiente información.

  • Fecha de actualización del informe
  • Nombre principal de usuario
  • Nombre para mostrar
  • Fecha de la última actividad
  • Copilot Chat fecha de la última actividad
  • Fecha de última actividad de Copilot de Microsoft Teams
  • Word fecha de la última actividad de Copilot
  • Fecha de la última actividad de Copilot de Excel
  • Fecha de última actividad de PowerPoint Copilot
  • Fecha de la última actividad de Copilot de Outlook
  • Fecha de la última actividad de OneNote Copilot
  • Loop fecha de la última actividad de Copilot
  • Período del informe

Los informes de la versión 2 contienen toda la información de la versión 1, con la siguiente información adicional.

  • Consultas enviar para todas las aplicaciones
  • Consultas enviado para Copilot Chat (trabajo)
  • Consultas enviado para Copilot Chat (web)
  • Días de uso activos para todas las aplicaciones
  • Copilot Chat (trabajo) Fecha de la última actividad
  • Copilot Chat (web) Fecha de la última actividad
  • Microsoft 365 Copilot fecha de la última actividad
  • Fecha de la última actividad perimetral
  • Fecha de última actividad del agente de Copilot

Encabezados de solicitud

Nombre Descripción
Authorization Bearer {token}. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, esta función devuelve un 200 OK código de respuesta y una secuencia en el cuerpo de la respuesta. El contenido de la secuencia es un archivo CSV con el informe solicitado.

Si se ejecuta correctamente, esta función devuelve un 200 OK código de respuesta y una representación JSON del informe solicitado en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')

Respuesta

En el ejemplo siguiente se muestra la respuesta. El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.

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

Report Refresh Date,User Principal Name,Display Name,Last Activity Date,Copilot Chat Last Activity Date,Microsoft Teams Copilot Last Activity Date,Word Copilot Last Activity Date,Excel Copilot Last Activity Date,PowerPoint Copilot Last Activity Date,Outlook Copilot Last Activity Date,OneNote Copilot Last Activity Date,Loop Copilot Last Activity Date,Report Period
2026-07-03,E58EEF6A6BBD3D0293CB306D24A42057,6A4630397AAA1A9C8EED362168DC88A0,,,,,,,,,,7

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "reportRefreshDate": "2025-08-20",
      "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
      "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
      "lastActivityDate": "2025-08-20",
      "copilotChatLastActivityDate": "2025-08-16",
      "microsoftTeamsCopilotLastActivityDate": "2025-08-20",
      "wordCopilotLastActivityDate": "2025-08-06",
      "excelCopilotLastActivityDate": "",
      "powerPointCopilotLastActivityDate": "2025-03-26",
      "outlookCopilotLastActivityDate": "",
      "oneNoteCopilotLastActivityDate": "",
      "loopCopilotLastActivityDate": "",
      "copilotActivityUserDetailsByPeriod": [
        {
          "reportPeriod": 7
        }
      ]
    }
  ]
}
  • Last updated on