Przykładowy kod interfejsu Chrome Management Reports API

Więcej informacji o funkcjach interfejsu API znajdziesz na stronie Chrome Management Reports API.

Wszystkie żądania pokazane poniżej korzystają z 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ć prośbę.

Liczba wersji profili Chrome aktywnych w danym zakresie dat

Aby sprawdzić, które wersje profilu Chrome były aktywne w danym przedziale czasu, użyj wartości last_active_date w parametrze filter. Stronicowaniem wyników możesz sterować 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
}

Liczba wersji Chrome aktywnych w danym zakresie dat

Aby sprawdzić, które wersje Chrome były aktywne w danym przedziale czasu, użyj wartości last_active_date w parametrze filter. Stronicowaniem wyników możesz sterować 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
}

Rozkład liczby instalacji aplikacji z określoną liczbą uprawnień

Aby wyświetlić liczbę urządzeń, na których zainstalowano daną aplikację z określoną liczbą uprawnień, użyj wartości number_of_permissions w parametrze filter. Podział na strony 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 jest zainstalowana aplikacja

W poprzednim przykładzie pokazano aplikację zainstalowaną na 2 urządzeniach. Aby wyświetlić urządzenia, na których zainstalowano tę aplikację, możesz użyć metody niestandardowej findInstalledAppDevices. Podział na strony 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"
    }
  ]
}

Dodatkowa prośba

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ę, korzystając z interfejsu 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ć findInstalledAppProfilesmetody niestandardowej. Podział na strony 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"
    },
  ]
}

Dodatkowa prośba

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