Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 la tendencia del número diario 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.
| 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 haber asignado 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 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 informes de uso de Microsoft 365.
Solicitud HTTP
GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUserCountTrend(period={period}, version={version})
GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountTrend(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
- Fecha 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
- 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.
- 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
- Consultas enviadas
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 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/getMicrosoft365CopilotUserCountTrend(period='D7')
GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountTrend(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,Report Date,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,Report Period
2026-07-03,2026-07-03,25,0,25,0,25,0,25,0,25,0,25,0,25,0,25,0,25,0,7
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"reportRefreshDate": "2025-08-20",
"reportPeriod": 7,
"adoptionByDate": [
{
"reportDate": "2025-08-20",
"anyAppEnabledUsers": 357584,
"anyAppActiveUsers": 94745,
"microsoftTeamsEnabledUsers": 357451,
"microsoftTeamsActiveUsers": 72272,
"wordEnabledUsers": 357451,
"wordActiveUsers": 6602,
"powerPointEnabledUsers": 357451,
"powerPointActiveUsers": 2231,
"outlookEnabledUsers": 357451,
"outlookActiveUsers": 11786,
"excelEnabledUsers": 357451,
"excelActiveUsers": 1712,
"oneNoteEnabledUsers": 357451,
"oneNoteActiveUsers": 492,
"loopEnabledUsers": 357451,
"loopActiveUsers": 340,
"copilotChatEnabledUsers": 357451,
"copilotChatActiveUsers": 26609
}
]
}
]
}