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 affichages et les noms des rapports, consultez Rapports Microsoft 365 – Utilisation de Microsoft 365 Copilot. Les API de rapports d’utilisation Copilot sont disponibles en tant qu’API REST standard sous l’espace de noms Microsoft Graph. Pour plus d’informations, consultez Présentation des API Microsoft 365 Copilot.

Remarque

Cette API renvoie uniquement les données d’utilisation des utilisateurs disposant d’une licence Microsoft 365 Copilot. Les données d’utilisation de 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 Centre d’administration Microsoft 365 Rapport d’utilisation du Copilot Chat
  • Accéder aux données d’audit via le journal d’audit de Microsoft Purview Audit
  • Exportez par programme à l’aide Search-UnifiedAuditLog de (PowerShell) ou de l’API d’activités de gestion d’Office 365

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

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ❌ ❌ ❌

Autorisations

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

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
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 les autorisations déléguées permettant aux applications de lire les rapports d’utilisation du service au nom d’un utilisateur, l’administrateur client doit attribuer à l’utilisateur l’un des rôles d’administrateur limité 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, voir 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 sur 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, D180ALL, , . Car v2, ils sont D7, , D90D28, D180ALL, , . 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 pour 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 du rapport demandée. La valeur prise en charge est v2 (par défaut).

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é
  • Date de la dernière activité de Copilot Chat
  • Date de la dernière activité de Microsoft Teams Copilot
  • Date de la dernière activité de Word Copilot
  • Date de la dernière activité Excel Copilot
  • Date de la dernière activité de PowerPoint Copilot
  • Date de la dernière activité Outlook Copilot
  • Date de la dernière activité de OneNote Copilot
  • Date de la dernière activité de Loop Copilot
  • 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 envoyées pour le chat Copilot Chat (travail)
  • Requêtes envoyées pour le Copilot Chat (Web)
  • Nombre de jours d’utilisation active pour toutes les applications
  • Date de la dernière activité de Copilot Chat (travail)
  • Date de la dernière activité de Copilot Chat (Web)
  • Date de la dernière activité de Microsoft 365 Copilot
  • Date de la dernière activité sur Microsoft 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 les autorisations.

Corps de la demande

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

Réponse

En cas de succès, cette fonction renvoie un code de 200 OK réponse et un flux dans le corps de la réponse. Le contenu du flux est un fichier CSV avec le rapport demandé.

En cas de réussite, cette fonction renvoie un code de réponse et une 200 OK 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
        }
      ]
    }
  ]
}
  • Dernière mise à jour :