Exemples de code pour l'API Chrome Management Reports

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

Compter les versions de Chrome actives sur une période donnée

Pour afficher les versions de Chrome qui étaient actives sur 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 distribution 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 certain nombre 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 en savoir plus sur les 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 montre une application qui a été installée sur deux appareils. Pour afficher les appareils sur lesquels cette application a été 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"
    }
  ]
}

Requête de suivi

Étant donné l'ID de l'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 Admin SDK Directory pour les navigateurs Chrome.

Compter les profils sur lesquels une application est installée

Pour afficher la liste des profils sur lesquels une application a été installée, vous pouvez utiliser la méthode personnalisée findInstalledAppProfiles. 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:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Réponse

{
  "totalSize": 2,
  "profiles": [
    {
      "email": "<email1>",
      "profileId": "ca847f92-7988-4ac8-a5a3-d0b8473c8bce",
      "profilePermanentId": "agio5SHt1rlQz3WlnKV41z5Fzxw",
      "profileOrgUnitId": "org_unit_id_1"
    },
    {
      "email": "<email2>",
      "profileId": "g472473e-fe50-4c6e-2ac3-53fe0d0753ce",
      "profilePermanentId": "pgeo2SHt1rlQz1WlnKV41z3Fzxw",
      "profileOrgUnitId": "org_unit_id_2"
    },
  ]
}

Requête de suivi

Étant donné l'ID permanent du profil renvoyé dans l'exemple précédent, vous pouvez obtenir plus d'informations sur le profil sur lequel l'application a été installée à l'aide de l' API Chrome Management Profiles.