Rufen Sie einen Bericht ab, der den Trend der aktiven Benutzer für alle Apps für jede Plattform (Windows, Mac, Web und Mobilgeräte) in Ihrem organization.
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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.
Hinweis: Für delegierte Berechtigungen, mit denen Apps Dienstnutzungsberichte im Namen eines Benutzers lesen können, muss der Mandantenadministrator dem Benutzer die entsprechende Microsoft Entra eingeschränkte Administratorrolle zugewiesen haben. Weitere Details finden Sie unter Autorisierung für APIs zum Lesen von Microsoft 365-Nutzungsberichten.
HTTP-Anforderung
GET /reports/getM365AppPlatformUserCounts(period='{period_value}')
Funktionsparameter
Geben Sie in der Anforderungs-URL den folgenden Parameter mit einem gültigen Wert an.
Parameter
Typ
Beschreibung
Zeitraum
Zeichenfolge
Gibt die Zeitspanne an, für die der Bericht aggregiert wird. Die unterstützten Werte für {period_value} sind: D7, D30, D90und D180. Diese Werte folgen dem Format Dn, wobei n die Anzahl der Tage angibt, für die der Bericht aggregiert wird. Erforderlich.
Optionale Abfrageparameter
Diese Methode unterstützt den $formatOData-Abfrageparameter , um die Antwort anzupassen. Der Standardausgabetyp ist text/csv. Wenn Sie jedoch den Ausgabetyp angeben möchten, können Sie den OData-Abfrageparameter $format verwenden, um die Standardausgabe auf text/csv oder application/jsonfestzulegen.
Bei dieser Methode wird kein Anforderungstext angegeben.
Antwort
CSV
Wenn diese Methode erfolgreich ist, wird eine 302 Found-Antwort zurückgegeben, die zu einer vorauthentifizierten Download-URL für den Bericht umleitet. Die URL finden Sie in der Location-Kopfzeile der Antwort.
Zuvor authentifizierte Download-URLs sind nur für einen kurzen Zeitraum (einige Minuten) gültig und erfordern keinen Authorization-Header.
Die CSV-Datei verfügt über die folgenden Spaltenheader:
Berichtsaktualisierungsdatum
Berichtszeitraum
Berichtsdatum
Windows
Mac
Mobil
Web
JSON
Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein JSON-Objekt im Antworttext zurückgegeben.
GET https://graph.microsoft.com/v1.0/reports/getM365AppPlatformUserCounts(period='D7')?$format=text/csv
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Reports.GetM365AppPlatformUserCountsWithPeriod("{period}").GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Format = "text/csv";
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.reports().getM365AppPlatformUserCountsWithPeriod("{period}").get(requestConfiguration -> {
requestConfiguration.queryParameters.format = "text/csv";
});
GET https://graph.microsoft.com/v1.0/reports/getM365AppPlatformUserCounts(period='D7')?$format=application/json
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Reports.GetM365AppPlatformUserCountsWithPeriod("{period}").GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Format = "application/json";
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.reports().getM365AppPlatformUserCountsWithPeriod("{period}").get(requestConfiguration -> {
requestConfiguration.queryParameters.format = "application/json";
});
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.