Method: subscriptions.changePlan

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

Cách cập nhật gói 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 phần 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

Tham số
customerId

string

Đây có thể là tên miền chính của khách hàng hoặc giá trị nhận dạng riêng biệt của khách hàng. Nếu tên miền dành cho khách hàng thay đổi, bạn không thể sử dụng tên miền cũ để truy cập vào khách hàng nhưng luôn có thể sử dụng giá trị nhận dạng duy nhất của khách hàng (do API trả về). Bạn nên lưu trữ giá trị nhận dạng duy nhất vào 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à giá trị riêng biệt cho từng khách hàng. Vì subscriptionId thay đổi khi gói thuê bao được cập nhật, bạn không nên sử dụng mã nhận dạng này làm khoá cho dữ liệu cố định. 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ả cá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 subscription.changePlan rpc.

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

string

Xác định tài nguyên là một 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 bài viết Khái niệm về API.

Bạn có thể sử dụng các giá trị sau:

  • ANNUAL_MONTHLY_PAY – Gói cam kết hằng năm thanh toán hằng tháng
  • ANNUAL_YEARLY_PAY – Gói cam kết hằng năm 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 giấy phép là số lượng giấy phép giấy phép người dùng.
purchaseOrderId

string

Đây là thuộc tính không bắt buộc. Thông tin đơn đặt hàng (PO) này là dành cho người bán lại để sử dụng cho việc sử dụng tính năng theo dõi của công ty. Nếu bạn cung cấp giá trị purchaseOrderId, thì giá trị đó sẽ xuất hiện trong phản hồi của API và xuất hiện trong hoá đơn. Thuộc tính này 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 đưa mã ưu đãi vào 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 gói thuê bao, thì thuộc tính này có thể để trống và mức chiết khấu hiện có sẽ vẫn áp dụng (nếu không để trống, bạn chỉ nên cung cấp mã ưu đãi đã có trong gói thuê bao). Nếu mã giao dịch chưa từng được thêm vào gói thuê bao và thuộc tính này được để trống, thì mức giá thông thường sẽ được áp dụng.