Consultez l'API Chrome Management Reports pour obtenir un aperçu des fonctionnalités de l'API.
Toutes les requêtes présentées ci-dessous utilisent les variables suivantes:
$TOKEN
: jeton OAuth 2$CUSTOMER
: ID du client ou du littéralmy_customer
$ORG_UNIT_ID
: ID de l'unité organisationnelle particulière pour laquelle vous souhaitez générer une requête.
Nombre de versions de Chrome actives dans la période
Pour afficher les versions de Chrome actives au cours d'une période donnée, utilisez la valeur last_active_date
dans le paramètre filter
. Vous pouvez contrôler la pagination des résultats à l'aide des paramètres pageSize
et pageToken
.
Requête
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countChromeVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"
Réponse
{
"browserVersions": [
{
"count": "1",
"version": "85.0.4183.83",
"system": "SYSTEM_MAC",
"channel": "STABLE"
},
{
"count": "1",
"version": "85.0.4183.102",
"system": "SYSTEM_WINDOWS",
"channel": "STABLE"
},
{
"count": "13697",
"version": "71.0.3578.96",
"system": "SYSTEM_MAC",
"channel": "STABLE"
},
{
"count": "1",
"version": "87.0.4280.40",
"system": "SYSTEM_MAC",
"channel": "BETA"
},
{
"count": "1",
"version": "88.0.4314.0",
"system": "SYSTEM_MAC",
"channel": "CANARY"
},
{
"count": "1718"
},
],
"totalSize": 5
}
Compter la répartition des installations d'applications avec un certain nombre d'autorisations
Pour afficher le nombre d'appareils sur lesquels une application particulière a été installée avec un nombre donné d'autorisations, utilisez la valeur number_of_permissions
dans le paramètre filter
. Vous pouvez contrôler la pagination des résultats à l'aide des paramètres pageSize
et pageToken
.
Pour plus de paramètres de filtre, consultez la documentation de référence.
Requête
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"
Réponse
{
"totalSize": 1,
"installedApps": [
{
"browserDeviceCount": "2",
"appSource": "CHROME_WEBSTORE",
"displayName": "Secure Shell App",
"description": "Terminal emulator and SSH and SFTP client.",
"appType": "APP",
"appInstallType": "ADMIN",
"appId": "pnhechapfaindjhompbnflcldabbghjo",
"homepageUri": "https://chrome.google.com/webstore/detail/pnhechapfaindjhompbnflcldabbghjo",
"permissions": [
"clipboardRead",
"clipboardWrite",
"crashReportPrivate",
"idle",
"metricsPrivate",
"notifications",
"storage",
"unlimitedStorage"
]
},
]
}
Compter les appareils sur lesquels une application est installée
L'exemple précédent montrait une application installée sur deux appareils.
Pour afficher les appareils sur lesquels cette application est installée, vous pouvez utiliser la méthode personnalisée findInstalledAppDevices
.
Vous pouvez contrôler la pagination des résultats à l'aide des paramètres pageSize
et pageToken
.
Requête
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"
Réponse
{
"totalSize": 2,
"devices": [
{
"machine": "MACHINEA-A",
"deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
},
{
"machine": "MACHINE-B",
"deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
}
]
}
Demande de suivi
Compte tenu de l'ID d'appareil renvoyé dans l'exemple précédent, vous pouvez obtenir plus d'informations sur l'appareil sur lequel l'application a été installée à l'aide de l'API Directory du SDK Admin pour les navigateurs Chrome.