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 profil Chrome actives dans une plage de dates

Pour afficher les versions de profil 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

Réponse

{
  "profileBrowserVersions": [
    {
      "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": 6
}

Compter les versions de Chrome actives dans une plage de dates

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 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.

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 de 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.

Rechercher l'utilisation de SaaS

Pour afficher l'utilisation agrégée des applications SaaS dans votre organisation, utilisez la méthode personnalisée findSaasUsage. Vous pouvez filtrer les résultats à l'aide du paramètre filter et les trier à l'aide de orderBy. 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:findSaasUsage"

Réponse

{
  "saasReports": [
    {
      "app": "GitHub",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "visitsCount": "100",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "0",
      "encryptionProtocols": [
        "TLS_1_3"
      ]
    },
    {
      "app": "Slack",
      "firstNavigationTime": "2026-01-02T00:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "visitsCount": "25",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "2",
      "encryptionProtocols": [
        "QUIC",
        "TLS_1_2"
      ]
    }
  ],
  "totalSize": "2"
}

Rechercher l'utilisation de SaaS regroupée par profils

Pour afficher l'utilisation d'une application SaaS spécifique regroupée par profils, utilisez la méthode personnalisée findSaasUsageProfiles. Le paramètre app spécifie l'application SaaS. Vous pouvez filtrer les résultats à l'aide du paramètre filter et les trier à l'aide de orderBy. 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:findSaasUsageProfiles?app=Slack"

Réponse

{
  "profileReports": [
    {
      "email": "user1@example.com",
      "profilePermanentId": "profile-permanent-id-1",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19044"
    },
    {
      "email": "user2@example.com",
      "profilePermanentId": "profile-permanent-id-2",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_MAC",
      "osVersion": "12.3.1"
    }
  ],
  "totalSize": "2"
}

Requête de suivi

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

Rechercher l'utilisation de SaaS regroupée par navigateurs

Pour afficher l'utilisation d'une application SaaS spécifique regroupée par navigateurs, utilisez la méthode personnalisée findSaasUsageBrowsers. Le paramètre app spécifie l'application SaaS. Vous pouvez filtrer les résultats à l'aide du paramètre filter et les trier à l'aide de orderBy. 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:findSaasUsageBrowsers?app=GitHub"

Réponse

{
  "saasUsageBrowsers": [
    {
      "machine": "machine1",
      "devicePermanentId": "device1",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205b",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19042"
    }
  ],
  "totalSize": "1"
}