- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- AnnualSubscriptionInfo
- LicenseCounts
- PerpetualLicenseInfo
- Hãy làm thử!
Lấy thông tin tổng hợp về gói thuê bao và giấy phép của một khách hàng nhất định dưới dạng một tài nguyên đơn lẻ. Lưu ý: Vì dữ liệu được chụp nhanh cho các thiết bị ChromeOS, nên số liệu chính xác có thể bị trễ tối đa 10 giây.
Yêu cầu HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số | |
|---|---|
name |
Bắt buộc. Tên tài nguyên của thông tin về gói thuê bao của khách hàng cần truy xuất. Định dạng: customers/{customer}/subscriptionInfo |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Tài nguyên singleton đại diện cho thông tin về gói thuê bao và giấy phép của một khách hàng cụ thể.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| Trường | |
|---|---|
name |
Giá trị nhận dạng. Tên tài nguyên của thông tin về gói thuê bao của khách hàng. Định dạng: customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
Chỉ có đầu ra. Thông tin chi tiết về SKU hằng năm của Bản nâng cấp Chrome Enterprise. |
kioskSignageUpgradeAnnual |
Chỉ có đầu ra. Thông tin chi tiết về SKU hằng năm của Bản nâng cấp Kiosk & Signage. |
chromePerpetualUpgrade |
Chỉ có đầu ra. Thông tin chi tiết về SKU vĩnh viễn của Bản nâng cấp Chrome Enterprise/Education. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
AnnualSubscriptionInfo
Thông tin về gói thuê bao/giấy phép gia hạn hằng năm.
| Biểu diễn dưới dạng JSON |
|---|
{
"counts": {
object ( |
| Trường | |
|---|---|
counts |
Chỉ có đầu ra. Số lượng giấy phép của gói thuê bao này. |
subscriptionEndTime |
Chỉ có đầu ra. Ngày kết thúc kỳ hạn thuê bao hiện tại. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
LicenseCounts
Số lượng tài nguyên cho một loại giấy phép cụ thể.
| Biểu diễn dưới dạng JSON |
|---|
{ "totalPurchasedCount": string, "assignedCount": string, "unassignedCount": string } |
| Trường | |
|---|---|
totalPurchasedCount |
Chỉ có đầu ra. Tổng số giấy phép đã mua. |
assignedCount |
Chỉ có đầu ra. Tổng số giấy phép hiện được cấp cho người dùng hoặc thiết bị. |
unassignedCount |
Chỉ có đầu ra. Tổng số giấy phép có thể chỉ định. |
PerpetualLicenseInfo
Thông tin về giấy phép vĩnh viễn.
| Biểu diễn dưới dạng JSON |
|---|
{
"counts": {
object ( |
| Trường | |
|---|---|
counts |
Chỉ có đầu ra. Số lượng giấy phép cho SKU vĩnh viễn. |
retiredCount |
Chỉ có đầu ra. Số lượng bản nâng cấp vĩnh viễn đã mua nhưng không còn được dùng để đăng ký. Đây là những bản nâng cấp vĩnh viễn đã được đăng ký cho một thiết bị đã ngừng hoạt động và bạn không thể chuyển hoặc sử dụng lại bản nâng cấp này trên một thiết bị khác. Giấy phép đã ngừng hoạt động là một tập hợp con của Tổng số giấy phép đã chỉ định. |
conditionallyAvailableCount |
Chỉ có đầu ra. Số lượng bản nâng cấp vĩnh viễn độc lập mà trước đó đã được đăng ký và sau đó huỷ đăng ký vì lý do uỷ quyền trả lại hàng hoá, bảo hành hoặc sửa chữa, đồng thời chỉ có thể sử dụng lại trên thiết bị có cùng kiểu máy. Giấy phép được cung cấp có điều kiện là một tập hợp con của Tổng số giấy phép được chỉ định. |