Method: subscriptions.changePlan

Cập nhật một gói thuê bao. Sử dụng phương thức này để cập nhật một gói dùng thử 30 ngày hoặc gói đăng ký gói linh hoạt sang gói cam kết hằng năm với khoản thanh toán hằng tháng hoặc hằng năm.

Cách cập nhật một kế hoạch sẽ khác nhau tuỳ thuộc vào gói và sản phẩm. Để biết thêm thông tin, hãy xem nội dung mô tả trong bài viết quản lý gói thuê bao.

Yêu cầu HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

Đây có thể là tên miền chính của khách hàng hoặc mã nhận dạng duy nhất của khách hàng. Nếu tên miền cho một khách hàng thay đổi, tên miền cũ không thể dùng để truy cập vào khách hàng, nhưng luôn có thể sử dụng mã nhận dạng duy nhất của khách hàng (do API trả về). Bạn nên lưu trữ mã nhận dạng duy nhất trong hệ thống của mình (nếu có).
subscriptionId

string

Đây là thuộc tính bắt buộc. subscriptionId là mã nhận dạng gói thuê bao và là mã nhận dạng duy nhất của mỗi khách hàng. Vì subscriptionId thay đổi khi gói thuê bao được cập nhật, bạn không nên dùng mã này làm khoá cho dữ liệu cố định. Và bạn có thể tìm thấy subscriptionId bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của ChangePlanRequest.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Subscription.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/apps.order

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

ChangePlanRequest

Mẫu JSON cho yêu cầu rpc subscriptions.changePlan.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Các trường
kind

string

Xác định tài nguyên là yêu cầu thay đổi gói thuê bao. Giá trị: subscriptions#changePlanRequest
planName

string

Thuộc tính planName là bắt buộc. Đây là tên gói thanh toán của gói thuê bao. Để biết thêm thông tin về các gói thanh toán của Google, hãy xem Khái niệm API.

Các giá trị có thể là:

  • ANNUAL_MONTHLY_PAY – Gói cam kết hằng năm với khoản thanh toán hằng tháng
  • ANNUAL_YEARLY_PAY – Gói cam kết hằng năm với gói thanh toán hằng năm
  • FLEXIBLE - Gói linh hoạt
  • TRIAL – Gói dùng thử miễn phí 30 ngày

seats

object (Seats)

Đây là thuộc tính bắt buộc. Thuộc tính chỗ là số lượng giấy phép giấy phép của người dùng.
purchaseOrderId

string

Đây là thuộc tính không bắt buộc. Thông tin về đơn đặt hàng (PO) này dành cho đại lý sử dụng để theo dõi mức sử dụng của công ty. Nếu bạn cung cấp một giá trị purchaseOrderId, thì giá trị đó sẽ xuất hiện trong các phản hồi của API và trong hoá đơn. Cơ sở lưu trú chấp nhận tối đa 80 ký tự văn bản thuần tuý.
dealCode

string

Mã do Google cấp (tối đa 100 ký tự) để áp dụng giá chiết khấu cho gói thuê bao. Bạn phải thêm mã ưu đãi trong yêu cầu changePlan để được hưởng mức giá chiết khấu. Thuộc tính này là không bắt buộc. Nếu mã ưu đãi đã được thêm vào một gói thuê bao, thì tài sản này có thể để trống và mức giá chiết khấu hiện có sẽ vẫn áp dụng (nếu không để trống, bạn chỉ cung cấp mã ưu đãi đã có trong gói thuê bao). Nếu bạn chưa thêm mã giao dịch vào gói thuê bao và tài sản này bị để trống, thì mức giá thông thường sẽ được áp dụng.