Method: subscriptions.suspend

Tạm ngưng một gói thuê bao đang hoạt động.

Bạn có thể sử dụng phương thức này để tạm ngưng một gói thuê bao có tính phí hiện đang ở trạng thái ACTIVE.

  • Đối với gói thuê bao FLEXIBLE, việc thanh toán sẽ bị tạm dừng.
  • Đối với gói thuê bao ANNUAL_MONTHLY_PAY hoặc ANNUAL_YEARLY_PAY:
    • Việc tạm ngưng gói thuê bao không làm thay đổi ngày gia hạn ban đầu.
    • Gói thuê bao bị tạm ngưng sẽ không gia hạn.  Nếu bạn kích hoạt gói thuê bao sau ngày gia hạn ban đầu, thì một gói thuê bao hằng năm mới sẽ được tạo, bắt đầu từ ngày kích hoạt.

Bạn chỉ nên tạm ngưng gói thuê bao trong thời gian ngắn vì việc tạm ngưng trong hơn 60 ngày có thể dẫn đến việc gói thuê bao bị huỷ.

Yêu cầu HTTP

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

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 phải trống.

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.