reportRoot: getTeamsDeviceUsageUserDetail
Espace de noms: microsoft.graph
Obtenez des détails sur l’utilisation de l’appareil Microsoft Teams par utilisateur.
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 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Autorisations
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 ID limité. Pour plus d’informations, consultez Autorisation pour les API de lire les rapports d’utilisation de Microsoft 365.
Requête HTTP
GET /reports/getTeamsDeviceUsageUserDetail(period='{period_value}')
GET /reports/getTeamsDeviceUsageUserDetail(date='{date_value}')
Paramètres de fonction
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 : D7, D30, D90et 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. Étant donné que ce rapport n’est disponible que pour les 28 derniers jours, {date_value} doit être une date de cette plage. |
Note: Vous devez définir une période ou une date dans l’URL.
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
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é-authentifiées ne sont valides que pendant une courte période (quelques minutes) et ne nécessitent pas d’en-tête Authorization .
Le fichier CSV comporte les en-têtes de colonne suivants :
- Date d’actualisation du rapport
- User Id
- Nom d’utilisateur principal
- Date de la dernière activité
- Est supprimé
- Date de suppression
- Web utilisé
- Windows Phone utilisé
- iOS utilisé
- Mac utilisé
- Téléphone Android utilisé
- Windows utilisé
- Chrome OS utilisé
- Linux utilisé
- Est licencié
- Période du rapport
Exemple
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/reports/getTeamsDeviceUsageUserDetail(period='D7')
Réponse
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 Id,User Principal Name,Last Activity Date,Is Deleted,Deleted Date,Used Web,Used Windows Phone,Used iOS,Used Mac,Used Android Phone,Used Windows,Used Chrome OS,Used Linux,Is Licensed,Report Period