Method: purchases.subscriptions.cancel

Huỷ giao dịch mua gói thuê bao của người dùng. Gói thuê bao vẫn có hiệu lực cho đến thời điểm hết hạn.

Yêu cầu HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

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

Tham số đường dẫn

Thông số
packageName

string

Tên gói của ứng dụng mà bạn đã mua gói thuê bao này (ví dụ: "com.some.thing").
subscriptionId

string

Lưu ý: Kể từ ngày 21 tháng 5 năm 2025, bạn không bắt buộc phải sử dụng subscriptionId và không nên sử dụng cho gói thuê bao có tiện ích bổ sung. Mã nhận dạng gói thuê bao được mua (ví dụ: "monthly001").
token

string

Mã thông báo được cung cấp cho thiết bị của người dùng khi người dùng mua gói thuê bao.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "cancellationType": enum (CancellationType)
}
Trường
cancellationType

enum (CancellationType)

Không bắt buộc. Loại yêu cầu huỷ gói thuê bao đã mua. Xin lưu ý rằng trường này chỉ được hỗ trợ trong yêu cầu HTTP. Phương thức này không có trong thư viện ứng dụng.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Mẫu

Sau đây là một yêu cầu mẫu:

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/androidpublisher

CancellationType

Loại yêu cầu huỷ của nhà phát triển.

Enum
CANCELLATION_TYPE_UNSPECIFIED Chưa xác định loại yêu cầu huỷ.
USER_REQUESTED_STOP_RENEWALS Người dùng đã yêu cầu huỷ và gói thuê bao có thể được khôi phục. Thao tác này chỉ ngăn gói thuê bao gia hạn vào lần tiếp theo. Đối với gói thuê bao trả góp, người dùng vẫn cần hoàn tất thời hạn cam kết. Để biết thêm thông tin chi tiết về việc gia hạn và thanh toán, hãy xem https://developer.android.com/google/play/billing/subscriptions#installments
DEVELOPER_REQUESTED_STOP_PAYMENTS Nhà phát triển yêu cầu huỷ và bạn không thể khôi phục gói thuê bao. Thao tác này sẽ dừng khoản thanh toán tiếp theo của gói thuê bao. Đối với gói thuê bao trả góp, người dùng sẽ không cần thanh toán khoản thanh toán tiếp theo và hoàn tất thời hạn cam kết. Để biết thêm thông tin chi tiết về việc gia hạn và thanh toán, hãy xem https://developer.android.com/google/play/billing/subscriptions#installments. Đây là hành vi mặc định khi không chỉ định loại huỷ.