Method: customers.getSubscriptionInfo

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

string

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 (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Trường
name

string

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

object (AnnualSubscriptionInfo)

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

object (AnnualSubscriptionInfo)

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

object (PerpetualLicenseInfo)

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 (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Trường
counts

object (LicenseCounts)

Chỉ có đầu ra. Số lượng giấy phép của gói thuê bao này.

subscriptionEndTime

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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

string (int64 format)

Chỉ có đầu ra. Tổng số giấy phép đã mua.

assignedCount

string (int64 format)

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

string (int64 format)

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 (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Trường
counts

object (LicenseCounts)

Chỉ có đầu ra. Số lượng giấy phép cho SKU vĩnh viễn.

retiredCount

string (int64 format)

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

string (int64 format)

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.