Mã mẫu cho API Báo cáo quản lý Chrome

Hãy truy cập API Báo cáo quản lý của Chrome để biết thông tin tổng quan về các tính năng của API.

Tất cả yêu cầu hiển thị bên dưới đều sử dụng các biến sau:

• $TOKEN – Mã thông báo OAuth 2
• $CUSTOMER - Mã khách hàng hoặc giá trị cố định my_customer
• $ORG_UNIT_ID – Mã nhận dạng của đơn vị tổ chức tham gia mà bạn muốn tạo yêu cầu.

Số phiên bản Chrome hoạt động trong phạm vi ngày

Để xem những phiên bản Chrome nào hoạt động trong một khoảng thời gian nhất định, hãy sử dụng giá trị last_active_date trong tham số filter. Bạn có thể kiểm soát việc phân trang kết quả bằng cách sử dụng các tham số pageSize và pageToken.

Yêu cầu

  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"

Phản hồi

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

Tính số lượt cài đặt ứng dụng có một số quyền cụ thể

Để xem số lượng thiết bị đã cài đặt một ứng dụng cụ thể với một số lượng quyền nhất định, hãy sử dụng giá trị number_of_permissions trong tham số filter. Bạn có thể kiểm soát việc phân trang kết quả bằng cách sử dụng các tham số pageSize và pageToken.

Để biết thêm thông số bộ lọc, hãy truy cập tài liệu tham khảo.

Yêu cầu

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

Phản hồi

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

Tính số thiết bị đã cài đặt ứng dụng

Ví dụ trước cho thấy một ứng dụng đã được cài đặt trên 2 thiết bị. Để xem các thiết bị đã cài đặt ứng dụng này, bạn có thể sử dụng phương thức tuỳ chỉnh findInstalledAppDevices. Bạn có thể kiểm soát việc phân trang kết quả bằng cách sử dụng các tham số pageSize và pageToken.

Yêu cầu

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

Phản hồi

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

Yêu cầu theo dõi

Với mã thiết bị được trả về trong ví dụ trước, bạn có thể xem thêm thông tin về thiết bị đã cài đặt ứng dụng bằng cách sử dụng API Thư mục của SDK quản trị cho trình duyệt Chrome.