Примеры кода для API отчетов управления Chrome

Visit Chrome Management Reports API for an overview of API features.

All the requests shown below use the following variables:

• $TOKEN - OAuth 2 token
• $CUSTOMER - ID of the customer or literal my_customer
• $ORG_UNIT_ID - ID of a particluar org unit for which you want to generate a request.

Count Chrome profile versions active in date range

Чтобы просмотреть, какие версии профиля Chrome были активны в заданном диапазоне времени, используйте значение last_active_date в параметре filter . Вы можете управлять постраничной навигацией результатов с помощью параметров pageSize и pageToken .

Запрос

  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"

Ответ

{
  "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
}

Count Chrome versions active in date range

Чтобы просмотреть, какие версии Chrome были активны в заданный период времени, используйте значение last_active_date в параметре filter . Вы можете управлять постраничной навигацией результатов с помощью параметров pageSize и pageToken .

Запрос

  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"

Ответ

{
  "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
}

Count distribution of app installations with a number of permissions

Чтобы просмотреть количество устройств, на которых установлено определенное приложение с заданным количеством разрешений, используйте значение number_of_permissions в параметре filter . Вы можете управлять постраничной навигацией результатов с помощью параметров pageSize и pageToken .

For more filter parameters, visit the reference .

Запрос

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"

Ответ

{
  "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"
      ]
    },
  ]
}

Count devices that have an installed app

В предыдущем примере было показано приложение, установленное на 2 устройствах. Чтобы просмотреть устройства, на которых установлено это приложение, вы можете использовать пользовательский метод findInstalledAppDevices . Вы можете управлять пагинацией результатов с помощью параметров pageSize и pageToken .

Запрос

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Ответ

{
  "totalSize": 2,
  "devices": [
    {
      "machine": "MACHINEA-A",
      "deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
    },
    {
      "machine": "MACHINE-B",
      "deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
    }
  ]
}

Повторный запрос

Given the device ID returned in the previous example, you can get more information about the device that has installed the app by using the Admin SDK Directory API for Chrome Browsers .

Count profiles that have an installed app

Чтобы просмотреть список профилей, установивших приложение, можно использовать пользовательский метод findInstalledAppProfiles . Пагинацию результатов можно настроить с помощью параметров pageSize и pageToken .

Запрос

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Ответ

{
  "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"
    },
  ]
}

Повторный запрос

Given the Profile permanent ID returned in the previous example, you can get more information about the profile that has installed the app by using the Chrome Management Profiles API .

Find SaaS usage

Для просмотра сводных данных об использовании SaaS-приложений в масштабах всей организации используйте пользовательский метод findSaasUsage . Вы можете фильтровать результаты с помощью параметра filter и сортировать с помощью orderBy . Пагинацию результатов можно контролировать с помощью параметров pageSize и pageToken .

Запрос

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsage"

Ответ

{
  "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"
}

Find SaaS usage grouped by profiles

Для просмотра использования SaaS-приложения для конкретного приложения, сгруппированного по профилям, используйте пользовательский метод findSaasUsageProfiles . Параметр app указывает SaaS-приложение. Вы можете фильтровать результаты с помощью параметра filter и сортировать с помощью orderBy . Вы можете управлять постраничной навигацией результатов с помощью параметров pageSize и pageToken .

Запрос

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageProfiles?app=Slack"

Ответ

{
  "profileReports": [
    {
      "email": "[e-mail]",
      "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": "[e-mail]",
      "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"
}

Повторный запрос

Given the profile permanent ID returned in the previous example, you can get more information about the profile by using the Chrome Management Profiles API .

Find SaaS usage grouped by browsers

Для просмотра использования SaaS-приложения для конкретного приложения, сгруппированного по браузерам, используйте пользовательский метод findSaasUsageBrowsers . Параметр app указывает SaaS-приложение. Вы можете фильтровать результаты с помощью параметра filter и сортировать с помощью orderBy . Вы можете управлять постраничной навигацией результатов с помощью параметров pageSize и pageToken .

Запрос

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageBrowsers?app=GitHub"

Ответ

{
  "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"
}