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 de los usuarios habilitados para aplicaciones de Microsoft 365 Copilot.

Para obtener más información sobre las vistas y nombres de informes, 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 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 de 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 Centro de Administración de Microsoft 365 de Microsoft 365 Informe de uso de Copilot Chat
  • Acceder a los datos de auditoría a través del registro de auditoría de Auditoría de Microsoft Purview
  • Exportar mediante programación con Search-UnifiedAuditLog (PowerShell) o la API de Actividad de administración de Office 365

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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 asignar al usuario uno de los siguientes roles de administrador limitado de Microsoft Entra ID:

  • 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 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. El número de días anteriores durante los cuales se ha notificado el uso agregado. Los valores admitidos dependen del valor de version. Para v1, son: D7, D30, D90, D180, ALL. Porque v2, son D7, D28, , D90, D180, ALL. Los primeros cuatro valores siguen el formato Dn en n el que representan el número de días anteriores en los que se van a agregar datos. ALL Indica si se debe notificar el uso de todos los períodos admitidos (7, 30, 90 y 180 días para v17, 28, 90 y 180 días para v2).
version Cadena Opcional. La versión del informe solicitada. El valor admitido es v2 (predeterminado).

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
  • Fecha de la última actividad de Copilot Chat
  • Microsoft Teams Copilot Fecha de la última actividad
  • Fecha de última actividad de Word Copilot
  • Fecha de la última actividad de Excel Copilot
  • PowerPoint Copilot Fecha de la última actividad
  • Fecha de la última actividad de Outlook Copilot
  • Fecha de la última actividad de OneNote Copilot
  • Fecha de la última actividad de Loop 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 enviadas para todas las aplicaciones
  • Consultas enviadas para Copilot Chat (trabajo)
  • Consultas enviadas para Copilot Chat (web)
  • Días de uso activo para todas las aplicaciones
  • Fecha de la última actividad de Copilot Chat (trabajo)
  • Copilot Chat (web) Fecha de la última actividad
  • Fecha de última actividad de Microsoft 365 Copilot
  • Fecha de la última actividad de Edge
  • Fecha de la última actividad del agente de Copilot

Encabezados de solicitud

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

Cuerpo de la solicitud

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

Respuesta

Si se realiza correctamente, esta función devuelve un código de 200 OK 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 realiza 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
        }
      ]
    }
  ]
}
  • Se actualizó por última vez el