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.

  • Tính phí cho gói thuê bao FLEXIBLE 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 sẽ không thay đổi ngày gia hạn đã cam kết 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 một khoảng thời gian ngắn do việc tạm ngưng trong hơn 60 ngày có thể khiến 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

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 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.