reportRoot : getM365AppPlatformUserCountsreportRoot: getM365AppPlatformUserCounts

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Obtenez un rapport qui fournit la tendance des utilisateurs actifs à travers toutes les applications pour chaque plateforme : Windows, Mac, Web et mobile dans votre organisation.Get a report that provides the trend of active users across all apps for each platform – Windows, Mac, web, and mobile - in your organization.

Remarque : Pour plus d’informations sur les différents noms et vues de rapport, voir rapports microsoft 365-utilisation 365 des applications.Note: For details about different report views and names, see Microsoft 365 reports - Microsoft 365 Apps usage.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Reports.Read.AllReports.Read.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Reports.Read.AllReports.Read.All

Remarque : Pour les autorisations déléguées permettant aux applications de lire des rapports d’utilisation de service au nom d’un utilisateur, l’administrateur client doit avoir affecté à l’utilisateur le rôle d’administrateur limité Azure AD approprié.Note: For delegated permissions to allow apps to read service usage reports on behalf of a user, the tenant administrator must have assigned the user the appropriate Azure AD limited administrator role. Pour plus d’informations, consultez la rubrique authorization for API to Read Microsoft 365 usage Reports.For details, see Authorization for APIs to read Microsoft 365 usage reports.

Requête HTTPHTTP request

GET /reports/getM365AppPlatformUserCounts(period='{period_value}')

Paramètres de fonctionFunction parameters

Dans l’URL de la requête, indiquez une valeur valide pour le paramètre suivant.In the request URL, provide the following parameter with a valid value.

ParamètreParameter TypeType DescriptionDescription
pointperiod stringstring Spécifie la durée de regroupement du rapport.Specifies the length of time over which the report is aggregated. Les valeurs prises en charge pour {period_value} sont les suivantes : D7 , D30 , D90 et D180 .The supported values for {period_value} are: D7, D30, D90, and D180. Ces valeurs suivent le format Dn, où n représente le nombre de jours pendant lesquels le rapport est regroupé.These values follow the format Dn where n represents the number of days over which the report is aggregated. Obligatoire.Required.

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge le $format paramètre de requête OData pour vous aider à personnaliser la réponse.This method supports the $format OData query parameter to customize the response. Le type de sortie par défaut est text/CSV.The default output type is text/csv. Toutefois, si vous souhaitez spécifier le type de sortie, vous pouvez utiliser le $format paramètre de requête OData pour définir la sortie par défaut sur Text/CSV ou application/JSON.However, if you want to specify the output type, you can use the OData $format query parameter to set the default output to text/csv or application/json.

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body with this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un 200 OK Code de réponse et un objet Report dans le corps de la réponse.If successful, this method returns a 200 OK response code and a report object in the response body. Les données de rapport sont contenues dans la propriété content de l’objet Report .Report data is contained in the content property of the report object.

CSVCSV

Si elle réussit, la demande de la propriété content renvoie une 302 Found réponse qui redirige vers une URL de téléchargement préalablement authentifiée pour le rapport.If successful, requesting the content property returns a 302 Found response that redirects to a preauthenticated download URL for the report. Cette URL est accessible dans l’en-tête Location de la réponse.That URL can be found in the Location header in the response.

Les URL de téléchargement préalablement authentifiées ne sont valides que pour une courte durée (quelques minutes) et ne nécessitent pas d’en-tête Authorization.Preauthenticated download URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header.

Le fichier CSV comporte les en-têtes de colonne suivants :The CSV file has the following headers for columns:

  • Date d’actualisation du rapportReport Refresh Date
  • Période du rapportReport Period
  • Date du rapportReport Date
  • OutlookOutlook
  • WordWord
  • ExcelExcel
  • PowerPointPowerPoint
  • OneNoteOneNote
  • TeamsTeams

JSONJSON

Si elle réussit, la demande de la propriété content renvoie un 200 OK Code de réponse et un objet JSON dans le corps de la réponse.If successful, requesting the content property returns a 200 OK response code and a JSON object in response body.

ExemplesExamples

Exemple 1 : sortie CSVExample 1: CSV output

Voici un exemple qui génère le format CSV.The following is an example that outputs CSV.

DemandeRequest

Voici un exemple de la demande pour obtenir la propriété content .The following is an example of the request to get the content property.

GET https://graph.microsoft.com/beta/reports/getM365AppPlatformUserCounts(period='D7')/content?$format=text/csv

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Suivez la redirection 302 et le fichier CSV téléchargé aura le schéma suivant.Follow the 302 redirection and the CSV file that downloads will have the following schema.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,Report Period,Report Date,Windows,Mac,Mobile,Web

Exemple 2 : sortie JSONExample 2: JSON output

Voici un exemple qui renvoie JSON.The following is an example that returns JSON.

DemandeRequest

Voici un exemple de la demande pour obtenir la propriété content .The following is an example of the request to get the content property.

GET https://graph.microsoft.com/beta/reports/getM365AppPlatformUserCounts(period='D7')/content?$format=application/json

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 156

{
  "value": [
    {
      "reportRefreshDate": "2020-06-30",
      "reportPeriod": 7,
      "userCounts": [
        {
          "reportDate": "2020-06-30",
          "windows": 1445,
          "mac": 146,
          "mobile": 1131,
          "web": 1080
        }
      ]
    }
  ]
}