copilotReportRoot: getMicrosoft365CopilotUsageUserDetailByDate

Wichtig

APIs unter der /beta Version können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.

Abrufen von Details zur Nutzung von Microsoft 365 Copilot auf Benutzerebene für alle gemeldeten Benutzer an einem einzelnen ausgewählten Datum.

Weitere Informationen zu Berichtsansichten und -namen finden Sie unter Microsoft 365-Berichte – Verwendung von Microsoft 365 Copilot. Copilot-Nutzungsberichte-APIs sind als Standard-REST-APIs unter dem Microsoft Graph-Namespace verfügbar. Weitere Informationen finden Sie unter Übersicht über Microsoft 365 Copilot-APIs.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Reports.Read.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Reports.Read.All Nicht verfügbar.

Wichtig

Für delegierte Berechtigungen, die es Apps ermöglichen, Dienstnutzungsberichte im Namen eines Benutzers zu lesen, muss der Mandantenadministrator dem Benutzer eine der folgenden Microsoft Entra ID eingeschränkten Administratorrollen zuweisen:

  • Unternehmensadministrator
  • KI-Administrator
  • Exchange-Administrator
  • SharePoint-Administrator
  • Lync-Administrator
  • Teams-Dienstadministrator
  • Teams-Kommunikationsadministrator
  • Berichteleser

Weitere Informationen finden Sie unter Autorisierung für APIs zum Lesen von Microsoft 365-Nutzungsberichten.

HTTP-Anforderung

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date={date})

Funktionsparameter

Stellen Sie in der URL der Anforderung die folgenden Funktionsparameter mit Werten bereit.

Parameter Typ Beschreibung
date Datum Erforderlich. Das Datum, für das die Benutzeraktivität zurückgegeben werden soll. Der Wert muss formatiert sein YYYY-MM-DD und zwischen sieben Tagen vor dem letzten Aktualisierungsdatum des Berichts bis einschließlich dem Aktualisierungsdatum liegen. Das Verfügbarkeitsfenster basiert auf reportRefreshDate, nicht auf dem aktuellen Kalenderdatum. Wenn das letzte Aktualisierungsdatum des Berichts beispielsweise der 17. September 2026 ist, sind Werte vom 10. September 2026 bis einschließlich 17. September 2026 gültig.

Optionale Abfrageparameter

Diese Methode unterstützt keine OData-Abfrageparameter , um die Antwort anzupassen.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK Antwortcode und eine JSON-Darstellung des angeforderten Berichts im Antworttext zurück. Jede Zeile im Bericht enthält die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
allAppsCopilotActionCount Int64 Anzahl der Copilot-Aktionen für alle unterstützten Anwendungen.
businessChatWebPromptsCount Int64 Anzahl der über Business Chat im Web übermittelten Prompts.
displayName Zeichenfolge Anzeigename des Benutzers oder verdeckter Bezeichner, je nach Berichtseinstellungen.
isActive Boolean Ob der Benutzer in einer gemeldeten Copilot-Erfahrung aktiv war.
isActiveInBusinessChatWeb Boolean Aktivität in Business Chat im Web.
isActiveInEdge Boolean Aktivität in Microsoft Edge.
isActiveInExcel Boolean Aktivität in Microsoft Excel anzuzeigen.
isActiveInLoop Boolean Aktivität in Microsoft Loop.
isActiveInM365Chat Boolean Aktivität in Microsoft 365 Chat.
isActiveInM365CopilotChatCopilotApp Boolean Aktivität in Microsoft 365 Copilot Chat in der Microsoft 365 Copilot-App.
isActiveInOneNote Boolean Aktivität in Microsoft OneNote.
isActiveInOutlook Boolean Aktivität in Microsoft Outlook.
isActiveInPowerPoint Boolean Aktivität in Microsoft PowerPoint.
isActiveInTeams Boolean Aktivitäten in Microsoft Teams ausführen.
isActiveInWord Boolean Aktivität in Microsoft Word.
m365ChatQueriesSubmitted Int64 Anzahl der über Microsoft 365 Chat übermittelten Abfragen.
reportRefreshDate Datum Datum, an dem die Berichtsdaten aktualisiert wurden.
reportSelectedDate Datum Von der Anforderung ausgewähltes Datum.
userPrincipalName Zeichenfolge Benutzerprinzipalname oder verborgener Bezeichner, je nach Berichtseinstellungen.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

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
    }
  ]
}
  • Zuletzt aktualisiert um