copilotReportRoot: getMicrosoft365CopilotUsageUserDetailByDate

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 detalles de uso de Microsoft 365 Copilot a nivel de usuario para todos los usuarios denunciados en una sola fecha seleccionada.

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 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/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date={date})

Parámetros de función

En la dirección URL de la solicitud, proporcione los siguientes parámetros de consulta necesarios con valores.

Parámetro Tipo Descripción
date Fecha Obligatorio. Fecha para la que se devuelve la actividad de los usuarios. El valor debe usar YYYY-MM-DD formato y estar comprendido desde siete días antes de la última fecha de actualización del informe hasta la fecha de actualización, inclusive. La ventana de disponibilidad se basa en , no en reportRefreshDatela fecha del calendario actual. Por ejemplo, si la última fecha de actualización del informe es el 17 de septiembre de 2026, los valores válidos son del 10 de septiembre de 2026 al 17 de septiembre de 2026, ambos inclusive.

Parámetros de consulta opcionales

Este método no admite ningún parámetro de consulta OData para ayudar a personalizar la respuesta.

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 una representación JSON del informe solicitado en el cuerpo de la respuesta. Cada fila del informe contiene las siguientes propiedades.

Propiedad Tipo Description
allAppsCopilotActionCount Int64 Número de acciones de Copilot en todas las aplicaciones compatibles.
businessChatWebPromptsCount Int64 Número de mensajes enviados a través de Business Chat en la web.
displayName Cadena Nombre para mostrar del usuario o identificador oculto, según la configuración del informe.
isActive Booleano Si el usuario estaba activo en cualquier experiencia de Copilot notificada.
isActiveInBusinessChatWeb Booleano Actividad en Business Chat en la Web.
isActiveInEdge Booleano en Microsoft Edge.
isActiveInExcel Booleano en Microsoft Excel.
isActiveInLoop Booleano en Microsoft Loop.
isActiveInM365Chat Booleano Actividad en Microsoft 365 Chat.
isActiveInM365CopilotChatCopilotApp Booleano Actividad en Microsoft 365 Copilot Chat en la aplicación de Microsoft 365 Copilot.
isActiveInOneNote Booleano en Microsoft OneNote.
isActiveInOutlook Booleano en Microsoft Outlook.
isActiveInPowerPoint Booleano en Microsoft PowerPoint.
isActiveInTeams Booleano en Microsoft Teams.
isActiveInWord Booleano en Microsoft Word.
m365ChatQueriesSubmitted Int64 Número de consultas enviadas a través de Microsoft 365 Chat.
reportRefreshDate Fecha Fecha en que se actualizaron los datos del informe.
reportSelectedDate Fecha Fecha seleccionada por la solicitud.
userPrincipalName Cadena Nombre principal de usuario o identificador oculto, según la configuración del informe.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date=2026-09-14)

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

{
  "value": [
    {
      "reportRefreshDate": "2026-09-17",
      "reportSelectedDate": "2026-09-14",
      "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
      "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
      "allAppsCopilotActionCount": 10,
      "m365ChatQueriesSubmitted": 3,
      "businessChatWebPromptsCount": 7,
      "isActive": true,
      "isActiveInTeams": false,
      "isActiveInWord": false,
      "isActiveInPowerPoint": false,
      "isActiveInExcel": true,
      "isActiveInOutlook": false,
      "isActiveInOneNote": false,
      "isActiveInLoop": false,
      "isActiveInM365Chat": true,
      "isActiveInBusinessChatWeb": true,
      "isActiveInEdge": false,
      "isActiveInM365CopilotChatCopilotApp": false
    }
  ]
}
  • Se actualizó por última vez el