copilotReportRoot : getMicrosoft365CopilotUsageUserDetailByDate

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 détails d’utilisation de Microsoft 365 Copilot au niveau de l’utilisateur pour tous les utilisateurs signalés à une seule date sélectionné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.

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/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date={date})

Paramètres de fonction

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

Paramètre Type Description
date Date Obligatoire. Date pour laquelle l’activité des utilisateurs doit être retournée. La valeur doit utiliser YYYY-MM-DD le format et dater de sept jours avant la date d’actualisation du dernier rapport jusqu’à la date d’actualisation, incluse. La fenêtre de disponibilité est basée sur la date du calendrier et non sur reportRefreshDatela date du calendrier actuel. Par exemple, si la dernière date d’actualisation du rapport est le 17 septembre 2026, les valeurs valides sont du 10 septembre 2026 au 17 septembre 2026 inclus.

Paramètres facultatifs de la requête

Cette méthode ne prend pas en charge les paramètres de requête OData pour personnaliser la réponse.

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 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. Chaque ligne du rapport contient les propriétés suivantes.

Propriété Type Description
allAppsCopilotActionCount Int64 Nombre d’actions Copilot dans toutes les applications prises en charge.
businessChatWebPromptsCount Int64 Nombre d’invites envoyées via Business Chat sur le web.
displayName String Nom d’affichage de l’utilisateur ou identificateur masqué, selon les paramètres du rapport.
isActive Booléen Indique si l’utilisateur a été actif dans une expérience Copilot signalée.
isActiveInBusinessChatWeb Booléen Activité dans Business Chat sur le web.
isActiveInEdge Booléen Activité dans Microsoft Edge.
isActiveInExcel Booléen Activité dans Microsoft Excel.
isActiveInLoop Booléen Activité dans Microsoft Loop.
isActiveInM365Chat Booléen Activité dans Microsoft 365 Chat.
isActiveInM365CopilotChatCopilotApp Booléen Activité dans Microsoft 365 Copilot Chat dans l’application Microsoft 365 Copilot.
isActiveInOneNote Booléen Activité dans Microsoft OneNote.
isActiveInOutlook Booléen Activité dans Microsoft Outlook.
isActiveInPowerPoint Booléen Activité dans Microsoft PowerPoint.
isActiveInTeams Booléen Activité dans Microsoft Teams.
isActiveInWord Booléen Activité dans Microsoft Word.
m365ChatQueriesSubmitted Int64 Nombre de requêtes envoyées via Microsoft 365 Chat.
reportRefreshDate Date Date à laquelle les données du rapport ont été actualisées.
reportSelectedDate Date Date sélectionnée par la demande.
userPrincipalName String Nom d’utilisateur principal ou identificateur masqué, selon les paramètres du rapport.

Exemple

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date=2026-09-14)

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

{
  "value": [
    {
      "reportRefreshDate": "2026-09-17",
      "reportSelectedDate": "2026-09-14",
      "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
      "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
      "allAppsCopilotActionCount": 10,
      "m365ChatQueriesSubmitted": 3,
      "businessChatWebPromptsCount": 7,
      "isActive": true,
      "isActiveInTeams": false,
      "isActiveInWord": false,
      "isActiveInPowerPoint": false,
      "isActiveInExcel": true,
      "isActiveInOutlook": false,
      "isActiveInOneNote": false,
      "isActiveInLoop": false,
      "isActiveInM365Chat": true,
      "isActiveInBusinessChatWeb": true,
      "isActiveInEdge": false,
      "isActiveInM365CopilotChatCopilotApp": false
    }
  ]
}
  • Dernière mise à jour :