Partager via

copilotReportRoot : getMicrosoft365CopilotUserCountTrend

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 la tendance du nombre quotidien d’utilisateurs actifs et activés de Microsoft 365 Copilot pour une période spécifiée.

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 général
  • Lecteur Rapports de synthèse de l’utilisation
  • 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/getMicrosoft365CopilotUserCountTrend

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountTrend

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 Nombre de jours précédents pendant lesquels signaler l’utilisation agrégée. Les valeurs prises en charge sont : D7, D30, ALLD90D180. Les quatre premières valeurs suivent le format Dn où n représente le nombre de jours pendant lesquels agréger les données. ALL indique de signaler l’utilisation pendant 7, 30, 90 et 180 jours.

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 renvoie un 200 OK code de réponse et un Stream dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUserCountTrend(period='D7')?$format=application/json

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountTrend(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/json
Content-Length: 10747

{
  "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
        }
      ]
    }
  ]
}
  • Last updated on