reportRoot: getTeamsDeviceUsageDistributionUserCounts
Espace de noms: microsoft.graph
Obtenez le nombre d’utilisateurs uniques Microsoft Teams par type d’appareil sur la période sélectionnée.
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/getTeamsDeviceUsageDistributionUserCounts(period='{period_value}')
Paramètres de fonction
Dans l’URL de la requête, indiquez une valeur valide pour le paramètre suivant.
| 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é. Obligatoire. |
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
- Web
- Windows Phone
- Téléphone Android
- iOS
- Mac
- Windows
- Système d’exploitation Chrome
- Linux
- Période du rapport
Attention
La colonne Windows Phone est déconseillée et sa valeur sera 0toujours . Il est conservé dans la réponse pour des raisons de compatibilité descendante.
Exemple
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/reports/getTeamsDeviceUsageDistributionUserCounts(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é a le schéma suivant.
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Period