Exemples de code pour l'API Chrome Management Reports

Accédez à l'API Chrome Management Reports pour obtenir les 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 littéral my_customer
• $ORG_UNIT_ID : ID d'une unité organisationnelle particulière pour laquelle vous souhaitez générer une requête.

Nombre de versions Chrome actives au cours de la période

Pour connaître les versions de Chrome actives sur une période donnée, procédez comme suit : 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 distribution des installations d'applications avec un certain nombre d'autorisations

Pour afficher le nombre d'appareils sur lesquels une application donnée a été installée, le nombre d'autorisations, utilisez la valeur number_of_permissions dans Paramètre filter. Vous pouvez contrôler la pagination des résultats à l'aide du Paramètres pageSize et pageToken.

Pour plus de paramètres de filtrage, consultez le 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 montre une application qui a été installée sur deux appareils. Pour afficher les appareils sur lesquels cette application est installée, vous pouvez utiliser les Méthode personnalisée findInstalledAppDevices. Vous pouvez contrôler la pagination des résultats à l'aide des outils pageSize et pageToken. paramètres.

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 des informations sur l'appareil qui a installé l'application à l'aide des API Directory du SDK Admin pour les navigateurs Chrome