Tài nguyên: Gói thuê bao
Mẫu JSON cho một gói thuê bao.
Biểu diễn dưới dạng JSON |
---|
{ "customerId": string, "subscriptionId": string, "skuId": string, "creationTime": string, "kind": string, "seats": { object ( |
Các trường | |
---|---|
customerId |
Thuộc tính này sẽ luôn được trả về trong phản hồi dưới dạng giá trị nhận dạng duy nhất do Google tạo. Trong một yêu cầu, tài sản này có thể là miền chính hoặc giá trị nhận dạng duy nhất do Google tạo. |
subscriptionId |
|
skuId |
Một thuộc tính bắt buộc. |
creationTime |
Thuộc tính |
kind |
Xác định tài nguyên dưới dạng Gói thuê bao. Giá trị: |
seats |
Đây là thuộc tính bắt buộc. Số lượng và hạn mức giấy phép chỗ ngồi của người dùng trong gói. |
renewalSettings |
Chế độ cài đặt gia hạn cho gói cam kết hằng năm. Để biết thêm thông tin chi tiết, hãy xem các tùy chọn gia hạn trong trung tâm trợ giúp quản trị viên. |
purchaseOrderId |
Đây là một thuộc tính không bắt buộc. Thông tin đơn đặt hàng (PO) này là để đại lý sử dụng cho việc sử dụng tính năng theo dõi công ty của họ. Nếu bạn cung cấp giá trị |
status |
Đây là một thuộc tính không bắt buộc. |
resourceUiUrl |
URL đến trang Đăng ký của khách hàng trong Bảng điều khiển dành cho quản trị viên. Dịch vụ API tạo URL chỉ có thể đọc. Lệnh này được sử dụng nếu ứng dụng của bạn yêu cầu khách hàng hoàn thành một nhiệm vụ bằng trang Gói thuê bao trong Bảng điều khiển dành cho quản trị viên. |
billingMethod |
Trường chỉ đọc trả về phương thức thanh toán hiện tại cho một gói thuê bao. |
suspensionReasons[] |
Trường chỉ đọc chứa danh sách liệt kê tất cả các lý do khiến gói thuê bao hiện tại bị tạm ngưng. Một gói thuê bao có thể có nhiều lý do tạm ngưng, đồng thời bị trùng lặp.
|
customerDomain |
Tên miền chính của khách hàng |
dealCode |
Mã do Google cấp (tối đa 100 ký tự) cho giá chiết khấu đối với các gói thuê bao. Mã ưu đãi phải được đưa vào |
skuName |
Tên hiển thị bên ngoài chỉ có thể đọc cho SKU của sản phẩm được chỉ định cho khách hàng trong gói thuê bao. Tên SKU có thể thay đổi theo quyết định riêng của Google. Đối với các sản phẩm và SKU có trong phiên bản API này, hãy xem Mã sản phẩm và SKU. |
plan |
Bạn bắt buộc phải thêm thuộc tính |
plan.planName |
Bạn bắt buộc phải thêm thuộc tính
|
plan.isCommitmentPlan |
Giá trị boolean của thuộc tính
|
plan.commitmentInterval |
Trong phiên bản này của API, khoảng thời gian của gói cam kết 1 năm là một năm. |
plan.commitmentInterval.startTime |
Gói thời gian cam kết hằng năm là |
plan.commitmentInterval.endTime |
Gói thời gian cam kết hằng năm là |
trialSettings |
Bạn có thể dùng thử miễn phí 30 ngày các gói thanh toán linh hoạt và gói thanh toán G Suite hằng năm. Để biết thêm thông tin, hãy xem các khái niệm về API. |
trialSettings.isInTrial |
Xác định xem gói thuê bao có đang trong thời gian dùng thử miễn phí 30 ngày hay không:
|
trialSettings.trialEndTime |
Ngày hết hạn dùng thử. Giá trị tính bằng mili giây sử dụng định dạng UNIX Epoch. Xem ví dụ về Trình chuyển đổi Epoch. |
transferInfo |
Thông tin liên quan đến việc chỉ có thể đọc cho gói thuê bao đó. Để biết thêm thông tin, hãy xem cách truy xuất gói thuê bao có thể chuyển nhượng cho khách hàng. |
transferInfo.transferabilityExpirationTime |
Thời điểm khi mã thông báo chuyển hoặc ý định chuyển sẽ hết hạn. Thời gian tính bằng mili giây sử dụng định dạng UNIX Epoch. |
transferInfo.minimumTransferableSeats |
Khi chèn gói thuê bao, đây là số chỗ ngồi tối thiểu nêu trong đơn đặt hàng chuyển sản phẩm này. Ví dụ: nếu khách hàng có 20 người dùng, thì người bán lại không thể đặt yêu cầu chuyển 15 chỗ. Tối thiểu là 20 chỗ ngồi. |
transferInfo.currentLegacySkuId |
|
Ghế
Mẫu JSON cho chỗ ngồi đăng ký.
Biểu diễn dưới dạng JSON |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
Các trường | |
---|---|
numberOfSeats |
Đây là một tài sản bắt buộc và chỉ dành cho các gói thuê bao có |
maximumNumberOfSeats |
Đây là một tài sản bắt buộc và chỉ dành cho các gói đăng ký có gói |
licensedNumberOfSeats |
Trường chỉ có thể đọc chứa số người dùng hiện tại đã được cấp giấy phép cho sản phẩm được xác định trong |
kind |
Xác định tài nguyên là một chế độ cài đặt vị trí đăng ký. Giá trị: |
Các chế độ cài đặt gia hạn
Mẫu JSON cho một chế độ cài đặt gia hạn gói đăng ký.
Biểu diễn dưới dạng JSON |
---|
{ "renewalType": string, "kind": string } |
Các trường | |
---|---|
renewalType |
Chế độ cài đặt gia hạn cho gói cam kết hằng năm. Để biết thêm thông tin chi tiết, hãy xem các tùy chọn gia hạn trong trung tâm trợ giúp quản trị viên. Khi gia hạn gói thuê bao, |
kind |
Xác định tài nguyên là một chế độ cài đặt gia hạn gói thuê bao. Giá trị: |
Phương pháp |
|
---|---|
|
Kích hoạt gói thuê bao đã bị đại lý tạm ngưng trước đó. |
|
Cập nhật gói thuê bao. |
|
Cập nhật các chế độ cài đặt gia hạn giấy phép của người dùng. |
|
Cập nhật chế độ cài đặt giấy phép của người dùng cho gói đăng ký. |
|
Hủy, tạm ngưng hoặc chuyển gói đăng ký để thanh toán trực tiếp. |
|
Nhận một gói thuê bao cụ thể. |
|
Tạo hoặc chuyển gói thuê bao. |
|
Danh sách gói thuê bao do đại lý quản lý. |
|
Chuyển ngay gói đăng ký dùng thử miễn phí 30 ngày sang gói đăng ký dịch vụ có tính phí. |
|
Tạm ngưng một gói thuê bao đang hoạt động. |