reportRoot : getOffice365ActivationsUserDetail

  • Article
  • 2 minutes de lecture

Espace de noms: microsoft.graph

Obtenez des détails sur les utilisateurs qui ont activé Microsoft 365.

Note: Pour plus d’informations sur les différents noms et vues de rapport, voir Rapports Microsoft 365 - Activations microsoft Office.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Reports.Read.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Reports.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. Si vous souhaitez en savoir plus, veuillez consulter la rubriqueAutorisation pour les API de lire les rapports d'utilisation de Microsoft 365.

Requête HTTP

GET /reports/getOffice365ActivationsUserDetail

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.
If-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é. Facultatif.

Réponse

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. Cette URL est accessible dans l’en-tête Location de la réponse.

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.

Le fichier CSV comporte les en-têtes de colonnes suivants.

  • Date d’actualisation du rapport
  • Nom d’utilisateur principal
  • Nom d’affichage
  • Type de produit
  • Date de la dernière activation
  • Windows
  • Mac
  • Windows 10 Mobile
  • iOS
  • Android
  • Activé sur un ordinateur partagé

Exemple

Demande

Voici un exemple de demande.

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

Réponse

Voici un exemple de réponse.

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.

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