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

Hãy truy cập vào API Báo cáo quản lý Chrome để 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.

Số lượng phiên bản hồ sơ Chrome hoạt động trong phạm vi ngày

Để xem những phiên bản hồ sơ 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 thông 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

Phản hồi

{
  "profileBrowserVersions": [
    {
      "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": 6
}

Đế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ã nhận dạng 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 SDK dành cho quản trị viên Directory API cho trình duyệt Chrome.

Đếm những 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ể 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.

Tìm mức sử dụng SaaS

Để xem mức sử dụng ứng dụng SaaS tổng hợp trên toàn tổ chức của bạn, hãy sử dụng phương thức tuỳ chỉnh findSaasUsage. Bạn có thể lọc kết quả bằng cách sử dụng tham số filter và sắp xếp bằng orderBy. 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:findSaasUsage"

Phản hồi

{
  "saasReports": [
    {
      "app": "GitHub",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "visitsCount": "100",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "0",
      "encryptionProtocols": [
        "TLS_1_3"
      ]
    },
    {
      "app": "Slack",
      "firstNavigationTime": "2026-01-02T00:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "visitsCount": "25",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "2",
      "encryptionProtocols": [
        "QUIC",
        "TLS_1_2"
      ]
    }
  ],
  "totalSize": "2"
}

Tìm mức sử dụng SaaS được nhóm theo hồ sơ

Để xem mức sử dụng ứng dụng SaaS cho một ứng dụng cụ thể được nhóm theo hồ sơ, hãy sử dụng phương thức tuỳ chỉnh findSaasUsageProfiles. Tham số app chỉ định ứng dụng SaaS. Bạn có thể lọc kết quả bằng cách sử dụng tham số filter và sắp xếp bằng orderBy. 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:findSaasUsageProfiles?app=Slack"

Phản hồi

{
  "profileReports": [
    {
      "email": "user1@example.com",
      "profilePermanentId": "profile-permanent-id-1",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19044"
    },
    {
      "email": "user2@example.com",
      "profilePermanentId": "profile-permanent-id-2",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_MAC",
      "osVersion": "12.3.1"
    }
  ],
  "totalSize": "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ơ bằng cách sử dụng Chrome Management Profiles API.

Tìm mức sử dụng SaaS được nhóm theo trình duyệt

Để xem mức sử dụng ứng dụng SaaS cho một ứng dụng cụ thể được nhóm theo trình duyệt, hãy sử dụng phương thức tuỳ chỉnh findSaasUsageBrowsers. Tham số app chỉ định ứng dụng SaaS. Bạn có thể lọc kết quả bằng cách sử dụng tham số filter và sắp xếp bằng orderBy. 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:findSaasUsageBrowsers?app=GitHub"

Phản hồi

{
  "saasUsageBrowsers": [
    {
      "machine": "machine1",
      "devicePermanentId": "device1",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205b",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19042"
    }
  ],
  "totalSize": "1"
}