Method: subscriptions.changePlan

Cập nhật gói thuê bao. Hãy 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 thuê bao linh hoạt thành gói thuê bao cam kết hằng năm với phương thức thanh toán hằng tháng hoặc hằng năm.

Cách cập nhật kế hoạch sẽ khác nhau tuỳ thuộc vào kế hoạch và sản phẩm. Để biết thêm thông tin, hãy xem nội dung mô tả trong phần 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

Thông 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 duy nhất của khách hàng. Nếu tên miền của 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 bạn 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 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à giá trị nhận dạng gói thuê bao và là giá trị duy nhất cho mỗi khách hàng. Vì subscriptionId thay đổi khi gói thuê bao được cập nhật, nên bạn không nên sử dụng mã nhận dạng này làm khoá cho dữ liệu ổn đị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ả 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
}
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 của 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 phần Khái niệm về API.

Các giá trị có thể có 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 phương thức thanh toán hằng năm
  • FLEXIBLE – Gói linh hoạt
  • TRIAL – Gói dùng thử miễn phí trong 30 ngày

seats

object (Seats)

Đây là thuộc tính bắt buộc. Thuộc tính số lượng ghế là số lượng giấy phép cho mỗi 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à để người bán lại sử dụng cho mục đích theo dõi mức sử dụng của công ty. Nếu bạn cung cấp giá trị purchaseOrderId, giá trị này sẽ xuất hiện trong phản hồi 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 phát hành (tối đa 100 ký tự) để giảm giá cho các gói thuê bao. Bạn phải thêm mã ưu đãi vào yêu cầu changePlan để nhận được mức giá chiết khấu. Thuộc tính này là không bắt buộc. Nếu bạn đã thêm mã ưu đãi vào một gói thuê bao, thì bạn có thể để trống thuộc tính này và mức giá chiết khấu hiện tại vẫn sẽ được áp dụng (nếu không để trống, bạn chỉ cần cung cấp mã ưu đãi đã có trên gói thuê bao). Nếu bạn chưa bao giờ thêm mã ưu đãi vào gói thuê bao và để trống thuộc tính này, thì giá thông thường sẽ được áp dụng.