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

Hãy truy cập vào Chrome Management Reports API để xem thông tin tổng quan về các tính năng của API.

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

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

Đếm 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 đang 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
}

Phân bổ số lượt cài đặt ứng dụng theo số lượng quyền

Để 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 các thông số bộ lọc, hãy truy cập vào 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"
      ]
    },
  ]
}

Đếm 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 những thiết bị đã cài đặt ứng dụng này, bạn có thể 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 nối tiếp

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

Đếm số hồ sơ có ứng dụng đã cài đặt

Để xem danh sách các hồ sơ đã cài đặt một ứng dụng, bạn có thể sử dụng phương thức tuỳ chỉnh findInstalledAppProfiles. 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:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Phản hồi

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

Yêu cầu nối tiếp

Với mã nhận dạng vĩnh viễn của hồ sơ được trả về trong ví dụ trước, bạn có thể nhận thêm thông tin về hồ sơ đã cài đặt ứng dụng bằng cách sử dụng Chrome Management Profiles API.