Compartir a través de

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

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 global
  • Resumen de uso de Lector de informes
  • 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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail

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 Número de días anteriores en los que se va a notificar el uso agregado. Los valores admitidos son: , , , , ALLD180. D90D30D7 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 que se notifica el uso durante 7, 30, 90 y 180 días.

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.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json

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/json
Content-Length: 10747

{
  "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