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 đượ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ã của khách hàng hoặc giá trị cố địnhmy_customer$ORG_UNIT_ID– Mã 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 hồ sơ Chrome đang 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 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: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 đang 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
}
Đếm 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 tham số bộ lọc, hãy tham khảo tài liệu này .
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 mộ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 tiếp theo
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 Admin SDK Directory API cho Trình duyệt Chrome.
Đếm số hồ sơ đã cài đặt một ứng dụng
Để 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 tiếp theo
Với Mã vĩnh viễn của hồ sơ được trả về trong ví dụ trước, bạn có thể xem thêm thông tin về hồ sơ đã cài đặt ứng dụng bằng cách sử dụng API Hồ sơ quản lý Chrome.