copilotReportRoot: getMicrosoft365CopilotUserCountSummary

Obtenga el número agregado de usuarios activos y habilitados de Microsoft 365 Copilot durante un período de tiempo especificado.

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.

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

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.

Solicitud HTTP

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(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.

Versiones del informe

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

• Fecha de actualización del informe
• Período del informe
• Usuarios habilitados para Microsoft Teams
• Usuarios activos de Microsoft Teams
• Usuarios habilitados para Word
• Usuarios activos de Word
• Usuarios habilitados para PowerPoint
• Usuarios activos de PowerPoint
• Usuarios habilitados para Outlook
• Usuarios activos de Outlook
• Usuarios habilitados para Excel
• Usuarios activos de Excel
• Usuarios habilitados para OneNote
• Usuarios activos de OneNote
• Usuarios habilitados para Loop
• Usuarios activos de Loop
• Cualquier aplicación habilitada Users
• Cualquier aplicación Usuarios activos
• Usuarios habilitados para Copilot Chat
• Usuarios activos de Copilot Chat

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

• Usuarios habilitados para Edge
• Usuarios activos de Microsoft Edge
• Usuarios habilitados para Microsoft 365 Copilot
• Usuarios activos de Microsoft 365 Copilot
• Usuarios habilitados de Copilot Chat (trabajo)
• Copilot Chat (trabajo) Usuarios activos
• Usuarios habilitados para Copilot Chat (web)
• Copilot Chat (web) Usuarios activos
• Total de solicitudes enviadas
• Promedio de mensajes enviados

Encabezados de solicitud

Cuerpo de la solicitud

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

Respuesta

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(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/octet-stream

Report Refresh Date,Report Period,Microsoft Teams Enabled Users,Microsoft Teams Active Users,Word Enabled Users,Word Active Users,PowerPoint Enabled Users,PowerPoint Active Users,Outlook Enabled Users,Outlook Active Users,Excel Enabled Users,Excel Active Users,OneNote Enabled Users,OneNote Active Users,Loop Enabled Users,Loop Active Users,Any App Enabled Users,Any App Active Users,Copilot Chat Enabled Users,Copilot Chat Active Users
2026-07-03,7,25,0,25,0,25,0,25,0,25,0,25,0,25,0,25,0,25,0

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

{
  "value": [
    {
      "reportRefreshDate": "2025-08-20",
      "adoptionByProduct": [
        {
          "reportPeriod": 7,
          "anyAppEnabledUsers": 359229,
          "anyAppActiveUsers": 165115,
          "microsoftTeamsEnabledUsers": 359096,
          "microsoftTeamsActiveUsers": 123341,
          "wordEnabledUsers": 359096,
          "wordActiveUsers": 21459,
          "powerPointEnabledUsers": 359096,
          "powerPointActiveUsers": 8530,
          "outlookEnabledUsers": 359096,
          "outlookActiveUsers": 37270,
          "excelEnabledUsers": 359096,
          "excelActiveUsers": 6709,
          "oneNoteEnabledUsers": 359096,
          "oneNoteActiveUsers": 1660,
          "loopEnabledUsers": 359096,
          "loopActiveUsers": 1345,
          "copilotChatEnabledUsers": 359096,
          "copilotChatActiveUsers": 65480
        }
      ]
    }
  ]
}