Compartir a través de

copilotReportRoot: getMicrosoft365CopilotUserCountSummary

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 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 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.

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/getMicrosoft365CopilotUserCountSummary

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

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 durante 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 un Stream 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/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/json
Content-Length: 537

{
  "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
        }
      ]
    }
  ]
}
  • Last updated on