Partager via

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’activité les plus récentes pour les utilisateurs qui sont activés pour les applications 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

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/getMicrosoft365CopilotUsageUserDetail

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

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 précédents pendant lesquels agréger des 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 retourne un 200 OK code de réponse et un flux 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')?$format=application/json

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