copilotReportRoot : getMicrosoft365CopilotUserCountSummary

Obtenez le nombre agrégé d’utilisateurs actifs et activés de Microsoft 365 Copilot pour une période spécifiée.

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.

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

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.

Requête HTTP

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(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.

Versions de rapport

Les rapports version 1 contiennent les informations suivantes.

• Date d’actualisation du rapport
• Période du rapport
• Utilisateurs prenant en charge Microsoft Teams
• Utilisateurs actifs de Microsoft Teams
• Utilisateurs compatibles avec Word
• Utilisateurs actifs de Word
• Utilisateurs prenant en charge PowerPoint
• Utilisateurs actifs PowerPoint
• Utilisateurs ayant activé Outlook
• Utilisateurs actifs d’Outlook
• Utilisateurs compatibles Excel
• Utilisateurs actifs Excel
• Utilisateurs OneNote activés
• Utilisateurs actifs OneNote
• Utilisateurs compatibles avec Loop
• Utilisateurs actifs dans Loop
• N’importe quelle application Utilisateurs
• Toute application Utilisateurs actifs
• Utilisateurs compatibles avec Copilot Chat
• Utilisateurs actifs de Copilot Chat

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

• Utilisateurs compatibles avec Edge
• Utilisateurs actifs Edge
• Utilisateurs activés pour Microsoft 365 Copilot
• Utilisateurs actifs de Microsoft 365 Copilot
• Utilisateurs activés pour Copilot Chat (travail)
• Copilot Chat (travail) Utilisateurs actifs
• Utilisateurs activés pour Copilot Chat (Web)
• Copilot Chat (Web) Utilisateurs actifs
• Nombre total d’invites envoyées
• Moyenne des invites envoyées

En-têtes de demande

Corps de la demande

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

Réponse

Exemples

Demande

L’exemple suivant illustre une demande.

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

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,Report Period,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
2026-07-03,7,25,0,25,0,25,0,25,0,25,0,25,0,25,0,25,0,25,0

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

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