Exemples de code pour l'API Chrome Management Reports

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éral my_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.