Przykładowy kod interfejsu Chrome Management Reports API

Aby zapoznać się z omówieniem funkcji interfejsu API, otwórz stronę Chrome Management Reports API for.

Wszystkie żądania pokazane poniżej używają tych zmiennych:

  • $TOKEN – token OAuth 2
  • $CUSTOMER – identyfikator klienta lub literał my_customer
  • $ORG_UNIT_ID – identyfikator konkretnej jednostki organizacyjnej, dla której chcesz wygenerować żądanie.

Zliczanie wersji profili Chrome aktywnych w danym przedziale czasu

Aby sprawdzić, które wersje profili Chrome były aktywne w danym przedziale czasu, użyj wartości last_active_date w parametrze filter. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

  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"

Odpowiedź

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

Zliczanie wersji Chrome aktywnych w danym przedziale czasu

Aby sprawdzić, które wersje Chrome były aktywne w danym przedziale czasu, użyj wartości last_active_date w parametrze filter. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

  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"

Odpowiedź

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

Zliczanie rozkładu instalacji aplikacji z określoną liczbą uprawnień

Aby wyświetlić liczbę urządzeń, na których zainstalowano konkretną aplikację z określoną liczbą uprawnień, użyj wartości number_of_permissions w parametrze filter. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Więcej parametrów filtra znajdziesz w dokumentacji.

Żądanie

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

Odpowiedź

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

Zliczanie urządzeń, na których zainstalowano aplikację instalowaną

W poprzednim przykładzie pokazano aplikację, która została zainstalowana na 2 urządzeniach. Aby wyświetlić urządzenia, na których zainstalowano tę aplikację, możesz użyć metody niestandardowej findInstalledAppDevices. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

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

Odpowiedź

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

Żądanie uzupełniające

Na podstawie identyfikatora urządzenia zwróconego w poprzednim przykładzie możesz uzyskać więcej informacji o urządzeniu, na którym zainstalowano aplikację, za pomocą interfejsu pakietu Admin SDK Directory API dla przeglądarek Chrome.

Zliczanie profili, na których zainstalowano aplikację

Aby wyświetlić listę profili, na których zainstalowano aplikację, możesz użyć metody niestandardowej findInstalledAppProfiles. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

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

Odpowiedź

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

Żądanie uzupełniające

Na podstawie stałego identyfikatora profilu zwróconego w poprzednim przykładzie możesz uzyskać więcej informacji o profilu, na którym zainstalowano aplikację, za pomocą interfejsu Chrome Management Profiles API.

Wyszukiwanie informacji o wykorzystaniu SaaS

Aby wyświetlić zagregowane informacje o wykorzystaniu aplikacji SaaS w organizacji, użyj metody niestandardowej findSaasUsage. Wyniki możesz filtrować za pomocą parametru filter i sortować za pomocą parametru orderBy. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

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

Odpowiedź

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

Wyszukiwanie informacji o wykorzystaniu SaaS pogrupowanych według profili

Aby wyświetlić informacje o wykorzystaniu aplikacji SaaS w przypadku konkretnej aplikacji pogrupowane według profili, użyj metody niestandardowej findSaasUsageProfiles. Parametr app określa aplikację SaaS. Wyniki możesz filtrować za pomocą parametru filter i sortować za pomocą parametru orderBy. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

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

Odpowiedź

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

Żądanie uzupełniające

Na podstawie stałego identyfikatora profilu zwróconego w poprzednim przykładzie możesz uzyskać więcej informacji o profilu za pomocą interfejsu Chrome Management Profiles API.

Wyszukiwanie informacji o wykorzystaniu SaaS pogrupowanych według przeglądarek

Aby wyświetlić informacje o wykorzystaniu aplikacji SaaS w przypadku konkretnej aplikacji pogrupowane według przeglądarek, użyj metody niestandardowej findSaasUsageBrowsers. Parametr app określa aplikację SaaS. Wyniki możesz filtrować za pomocą parametru filter i sortować za pomocą parametru orderBy. Stronicowanie wyników możesz kontrolować za pomocą parametrów pageSize i pageToken.

Żądanie

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

Odpowiedź

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