reportRoot : getOneDriveActivityUserDetail
Espace de noms: microsoft.graph
Obtenir les détails sur l’activité OneDrive par utilisateur.
Note: Pour plus d’informations sur les différents noms et vues de rapport, consultez Rapports Microsoft 365 - OneDrive Entreprise activité.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | Reports.Read.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Reports.Read.All | Non disponible. |
Remarque : Pour que les autorisations déléguées permettent aux applications de lire les rapports d’utilisation du service au nom d’un utilisateur, l’administrateur client doit avoir attribué à l’utilisateur le rôle d’administrateur approprié Microsoft Entra limité. Si vous souhaitez en savoir plus, veuillez consulter la rubriqueAutorisation pour les API de lire les rapports d'utilisation de Microsoft 365.
GET /reports/getOneDriveActivityUserDetail(period='{period_value}')
GET /reports/getOneDriveActivityUserDetail(date={date_value})
Dans l’URL de la requête, indiquez une valeur valide pour l’un des paramètres suivants.
Paramètre | Type | Description |
---|---|---|
point | string | Spécifie la durée de regroupement du rapport. Les valeurs prises en charge pour {period_value} sont les suivantes : D7, D30, D90 et D180. Ces valeurs suivent le format Dn, où n représente le nombre de jours pendant lesquels le rapport est regroupé. |
date | Date | Spécifie la date à laquelle vous voulez afficher les utilisateurs ayant effectué une activité. La valeur {date_value} doit suivre le format AAAA-MM-JJ. Sachant que ce rapport est disponible uniquement pour les 30 derniers jours, la valeur {date_value} doit être comprise dans cette plage. |
Remarque : vous devez définir la période ou la date dans l’URL.
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
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. |
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
- Est supprimé
- Date de suppression
- Date de la dernière activité
- Nombre de fichiers consultés ou modifiés
- Nombre de fichiers synchronisés
- Nombre de fichiers partagés en interne
- Nombre de fichiers partagés en externe
- Produits attribués
- Période du rapport
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/reports/getOneDriveActivityUserDetail(period='D7')
L’exemple suivant illustre la 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,Is Deleted,Deleted Date,Last Activity Date,Viewed Or Edited File Count,Synced File Count,Shared Internally File Count,Shared Externally File Count,Assigned Products,Report Period