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òn hiệu lực cho đến khi hết hạn. Phiên bản mới hơn có tại purchases.subscriptionsv2.cancel để hỗ trợ thư viện ứng dụng tố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à người dùng đã 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 dùng subscriptionId và không nên 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 huỷ đối với gói thuê bao đã mua. Xin lưu ý rằng trường này chỉ được hỗ trợ trong yêu cầu HTTP. Không có trong thư viện ứng dụng. Người dùng thư viện ứng dụng có thể sử dụng purchases.subscriptionsv2.cancel.

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ỷ mà nhà phát triển đưa ra.

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ỉ dừng gia hạn gói thuê bao 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 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à 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 lần tiếp theo và hoàn tất thời hạn cam kết. Để biết thêm thông tin về việc gia hạn và thanh toán, hãy xem bài viết https://developer.android.com/google/play/billing/subscriptions#installments. Đây là hành vi mặc định khi bạn không chỉ định loại huỷ.