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

Prośba o dalsze informacje

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 Admin SDK Directory API do przeglądarek Chrome.

Zliczanie profili, na których jest zainstalowana aplikacja

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

Prośba o dalsze informacje

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ę, za pomocą interfejsu Chrome Management Profiles API.