copilotReportRoot: getMicrosoft365CopilotUserCountSummary

Wichtig

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

Abrufen der aggregierten Anzahl aktiver und aktivierter Benutzer von Microsoft 365 Copilot für einen angegebenen Zeitraum.

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 zugewiesen haben:

  • Unternehmensadministrator
  • KI-Administrator
  • Exchange-Administrator
  • SharePoint-Administrator
  • Lync-Administrator
  • Teams-Dienstadministrator
  • Teams-Kommunikationsadministrator
  • Globaler Leser
  • Leseberechtigter für Verwendungszusammenfassungsberichte
  • Berichteleser

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

HTTP-Anforderung

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})

Funktionsparameter

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

Parameter Typ Beschreibung
period Zeichenfolge Erforderlich. Die Anzahl der vorherigen Tage, über die die aggregierte Nutzung gemeldet werden soll. Die unterstützten Werte hängen vom Wert von versionab. Denn v1sie sind: D7, D30, D90, , D180. ALL Denn v2sie sind D7, D28, , D90, D180, ALL. Die ersten vier Werte folgen dem Format Dn , wobei die n Anzahl der vorherigen Tage dargestellt wird, über die Daten aggregiert werden sollen. ALL Gibt an, dass die Verwendung für alle unterstützten Zeiträume gemeldet werden soll (7, 30, 90 und 180 Tage für v1, 7, 28, 90 und 180 Tage für v2).
version Zeichenfolge Optional. Die Version des angeforderten Berichts. Der unterstützte Wert ist v2 (Standard).

Berichtsversionen

Berichte der Version 1 enthalten die folgenden Informationen.

  • Berichtsaktualisierungsdatum
  • Berichtszeitraum
  • Für Microsoft Teams aktivierte Benutzer
  • Aktive Benutzer von Microsoft Teams
  • Für Word aktivierte Benutzer
  • Aktive Word-Benutzer
  • PowerPoint-fähige Benutzer
  • Aktive PowerPoint-Benutzer
  • Outlook-aktivierte Benutzer
  • Aktive Outlook-Benutzer
  • Excel-fähige Benutzer
  • Aktive Excel-Benutzer
  • Für OneNote aktivierte Benutzer
  • Aktive OneNote-Benutzer
  • Für Loop aktivierte Benutzer
  • Aktive Loop-Benutzer
  • Alle Benutzer mit App-Aktivierung
  • Alle aktiven Benutzer der App
  • Für Copilot Chat aktivierte Benutzer
  • Aktive Benutzer von Copilot Chat

Berichte der Version 2 enthalten alle Informationen aus Version 1 mit den folgenden zusätzlichen Informationen.

  • Edge-aktivierte Benutzer
  • Aktive Edge-Benutzer
  • Benutzer mit aktiviertem Microsoft 365 Copilot
  • Aktive Benutzer von Microsoft 365 Copilot
  • Für Copilot Chat (Arbeit) aktivierte Benutzer
  • Copilot Chat (Arbeit) Aktive Benutzer
  • Für Copilot Chat (Web) aktivierte Benutzer
  • Copilot Chat (Web) Aktive Benutzer
  • Insgesamt gesendete Prompts
  • Durchschnittlich gesendete Prompts

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 einen Stream im Antworttext zurück. Der Inhalt des Streams ist eine CSV-Datei mit dem angeforderten Bericht.

Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK Antwortcode und eine JSON-Darstellung des angeforderten Berichts im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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