copilotReportRoot : getMicrosoft365CopilotUsageUserDetail

Importante

Les API sous la /beta version sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge.

Obtenez les données d’utilisation les plus récentes pour les utilisateurs qui sont activés pour les applications Microsoft 365 Copilot.

Pour plus d’informations sur les vues et les noms des rapports, consultez Rapports Microsoft 365 - Microsoft 365 Copilot utilisation. Les API des rapports d’utilisation Copilot sont disponibles en tant qu’API REST standard sous l’espace de noms Microsoft Graph. Pour plus d’informations, consultez vue d’ensemble des API Microsoft 365 Copilot.

Remarque

Cette API retourne uniquement les données d’utilisation pour les utilisateurs disposant d’une licence Microsoft 365 Copilot. Les données d’utilisation Copilot Chat sans licence ne sont pas disponibles via les API de rapports Microsoft Graph. Au lieu de cela, vous pouvez :

  • Afficher l’utilisation sans licence dans le rapport d’utilisation Copilot Chat Center Administration Microsoft 365
  • Accéder aux données d’audit via Microsoft Purview Audit Journal
  • Exporter par programmation à l’aide de Search-UnifiedAuditLog (PowerShell) ou de l’API d’activité de gestion Office 365

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ❌ ❌ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Reports.Read.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Reports.Read.All Non disponible.

Importante

Pour que les autorisations déléguées permettent aux applications de lire les rapports d’utilisation du service au nom d’un utilisateur, l’administrateur client doit avoir attribué à l’utilisateur l’un des rôles d’administrateur limités Microsoft Entra ID suivants :

  • Administrateur de la société
  • Administrateur IA
  • Administrateur Exchange
  • Administrateur SharePoint
  • Administrateur Lync
  • Administrateur du service Teams
  • Administrateur des communications Teams
  • Lecteur de rapports

Pour plus d’informations, consultez Autorisation pour les API de lire les rapports d’utilisation de Microsoft 365.

Requête HTTP

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period={period}, version={version})

Paramètres de fonction

Dans l’URL de la demande, indiquez les paramètres de requête suivants avec leurs valeurs.

Paramètre Type Description
period String Obligatoire. Nombre de jours précédents pendant lesquels signaler l’utilisation agrégée. Les valeurs prises en charge dépendent de la valeur de version. Pour v1, ils sont : D7, D30, D90, D180, ALL. Pour v2, ils sont D7, D28, D90, D180, , ALL. Les quatre premières valeurs suivent le format Dn où n représente le nombre de jours précédents sur lesquels agréger les données. ALL indique de signaler l’utilisation pour toutes les périodes prises en charge (7, 30, 90 et 180 jours pour v1, 7, 28, 90 et 180 jours pour v2).
version String Facultatif. Version de rapport demandée. Les valeurs prises en charge sont v1 (par défaut) et v2.

Versions de rapport

Les rapports version 1 contiennent les informations suivantes.

  • Date d’actualisation du rapport
  • Nom d’utilisateur principal
  • Nom d’affichage
  • Date de la dernière activité
  • Copilot Chat date de la dernière activité
  • Date de la dernière activité de Microsoft Teams Copilot
  • Word Copilot Date de la dernière activité
  • Date de la dernière activité d’Excel Copilot
  • Date de la dernière activité de PowerPoint Copilot
  • Date de la dernière activité d’Outlook Copilot
  • Date de la dernière activité de OneNote Copilot
  • Loop Copilot Date de la dernière activité
  • Période du rapport

Les rapports version 2 contiennent toutes les informations de la version 1, avec les informations supplémentaires suivantes.

  • Requêtes envoyées pour toutes les applications
  • Requêtes soumis pour Copilot Chat (travail)
  • Requêtes envoyées pour Copilot Chat (Web)
  • Jours d’utilisation actifs pour toutes les applications
  • Copilot Chat (travail) Date de la dernière activité
  • Copilot Chat (Web) Date de la dernière activité
  • Microsoft 365 Copilot date de la dernière activité
  • Date de la dernière activité edge
  • Date de la dernière activité de l’agent Copilot

En-têtes de demande

Nom Description
Authorization Bearer {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette fonction retourne un 200 OK code de réponse et un flux dans le corps de la réponse. Le contenu du flux est un fichier CSV avec le rapport demandé.

Si elle réussit, cette fonction renvoie un 200 OK code de réponse et une représentation JSON du rapport demandé dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')

Réponse

L’exemple suivant illustre la réponse. L’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,User Principal Name,Display Name,Last Activity Date,Copilot Chat Last Activity Date,Microsoft Teams Copilot Last Activity Date,Word Copilot Last Activity Date,Excel Copilot Last Activity Date,PowerPoint Copilot Last Activity Date,Outlook Copilot Last Activity Date,OneNote Copilot Last Activity Date,Loop Copilot Last Activity Date,Report Period
2026-07-03,E58EEF6A6BBD3D0293CB306D24A42057,6A4630397AAA1A9C8EED362168DC88A0,,,,,,,,,,7

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

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