reportRoot : getOffice365ActivationsUserDetailreportRoot: getOffice365ActivationsUserDetail

Espace de noms : microsoft.graphNamespace: microsoft.graph

Obtenir des informations sur les utilisateurs qui ont activé Microsoft 365.Get details about users who have activated Microsoft 365.

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

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 que les autorisations déléguées permettent aux applications de lire les rapports d’utilisation des services pour le compte d’un utilisateur, l’administrateur du locataire doit avoir attribué le rôle d’administrateur limité Azure AD approprié à l’utilisateur.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. Si vous souhaitez en savoir plus, veuillez consulter la rubriqueAutorisation pour les API de lire les rapports d'utilisation de Microsoft 365.For more details, see Authorization for APIs to read Microsoft 365 usage reports.

Requête HTTPHTTP request

GET /reports/getOffice365ActivationsUserDetail

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
If-None-MatchIf-None-Match Si cet en-tête de demande est inclus et que l’eTag fourni correspond à la balise actuelle sur le fichier, un code de réponse 304 Not Modified est renvoyé.If this request header is included and the eTag provided matches the current tag on the file, a 304 Not Modified response code is returned. Facultatif.Optional.

RéponseResponse

Si elle réussit, cette méthode renvoie une réponse 302 Found qui redirige vers une URL de téléchargement préalablement authentifiée pour le rapport.If successful, this method 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 colonnes suivants.The CSV file has the following headers for columns.

  • Date d’actualisation du rapportReport Refresh Date
  • Nom d’utilisateur principalUser Principal Name
  • Nom d’affichageDisplay Name
  • Type de produitProduct Type
  • Date de la dernière activationLast Activated Date
  • WindowsWindows
  • MacMac
  • Windows 10 MobileWindows 10 Mobile
  • iOSiOS
  • AndroidAndroid
  • Activé sur un ordinateur partagéActivated On Shared Computer

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/reports/getOffice365ActivationsUserDetail

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,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer