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

Truy cập vào API Báo cáo quản lý Chrome để tổng quan về các tính năng API.

Tất cả yêu cầu được trình bày 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ố lượng phiên bản Chrome đang 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 phân trang kết quả bằng cách sử dụng 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
}

Đếm số lượt cài đặt ứng dụng có một số quyền

Để xem số lượng thiết bị đã cài đặt một ứng dụng cụ thể bằng một ứng dụng cụ thể số lượng quyền, 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 Tham số pageSize và pageToken.

Để biết thêm các thông số bộ lọc khá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 thiết bị đã cài đặt ứng dụng này, bạn có thể sử dụng findInstalledAppDevices phương thức tuỳ chỉnh. Bạn có thể kiểm soát việc phân trang kết quả bằng cách sử dụng pageSize và pageToken tham số.

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 bổ sung

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