Contoh Kode untuk Chrome Management Reports API

Buka Chrome Management Reports API untuk mengetahui ringkasan fitur API.

Semua permintaan yang ditampilkan di bawah menggunakan variabel berikut:

  • $TOKEN - Token OAuth 2
  • $CUSTOMER - ID pelanggan atau literal my_customer
  • $ORG_UNIT_ID - ID unit organisasi tertentu yang ingin Anda buat permintaannya.

Menghitung versi Chrome yang aktif dalam rentang tanggal

Untuk melihat versi Chrome mana yang aktif selama rentang waktu tertentu, gunakan nilai last_active_date dalam parameter filter. Anda dapat mengontrol penomoran halaman hasil menggunakan parameter pageSize dan pageToken.

Permintaan

  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"

Respons

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

Menghitung distribusi penginstalan aplikasi dengan sejumlah izin

Untuk melihat jumlah perangkat yang telah menginstal aplikasi tertentu dengan sejumlah izin tertentu, gunakan nilai number_of_permissions dalam parameter filter. Anda dapat mengontrol penomoran halaman hasil menggunakan parameter pageSize dan pageToken.

Untuk mengetahui parameter filter lainnya, buka referensi.

Permintaan

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

Respons

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

Menghitung perangkat yang telah menginstal aplikasi

Contoh sebelumnya menunjukkan aplikasi yang telah diinstal di 2 perangkat. Untuk melihat perangkat yang telah menginstal aplikasi ini, Anda dapat menggunakan metode kustom findInstalledAppDevices. Anda dapat mengontrol penomoran halaman hasil menggunakan parameter pageSize dan pageToken.

Permintaan

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

Respons

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

Permintaan lanjutan

Dengan ID perangkat yang ditampilkan dalam contoh sebelumnya, Anda bisa mendapatkan informasi selengkapnya tentang perangkat yang telah menginstal aplikasi menggunakan Admin SDK Directory API untuk Browser Chrome.

Menghitung profil yang telah menginstal aplikasi

Untuk melihat daftar profil yang telah menginstal aplikasi, Anda dapat menggunakan metode kustom findInstalledAppProfiles. Anda dapat mengontrol penomoran halaman hasil menggunakan parameter pageSize dan pageToken.

Permintaan

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

Respons

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

Permintaan lanjutan

Dengan ID permanen Profil yang ditampilkan dalam contoh sebelumnya, Anda bisa mendapatkan informasi selengkapnya tentang profil yang telah menginstal aplikasi menggunakan Chrome Management Profiles API.