Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke a subscription purchase for the user.

Yêu cầu HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

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

Tham số đường dẫn

Thông số
packageName

string

Bắt buộc. Gói của ứng dụng mà người dùng đã mua gói thuê bao này (ví dụ: "com.some.thing").
token

string

Bắt buộc. 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 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Trường
revocationContext

object (RevocationContext)

Bắt buộc. Thông tin bổ sung về việc thu hồi gói thuê bao.

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 \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Phạm vi uỷ quyền

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

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

RevocationContext

Ngữ cảnh thu hồi của API purchases.subscriptionsv2.revoke.

Biểu diễn dưới dạng JSON 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Trường
Trường hợp hợp nhất RefundType. Xác định loại khoản tiền hoàn lại cần được cấp. Bạn phải chỉ định một loại khoản hoàn tiền trong một yêu cầu hợp lệ. RefundType chỉ có thể là một trong những loại sau:
fullRefund

object (FullRefund)

Không bắt buộc. Được dùng khi người dùng cần được hoàn lại toàn bộ số tiền của khoản phí mới nhất trên từng mục trong gói thuê bao.
proratedRefund

object (ProratedRefund)

Không bắt buộc. Được dùng khi người dùng cần được hoàn lại một khoản tiền theo tỷ lệ mà họ đã trả cho gói thuê bao dựa trên khoảng thời gian còn lại trong gói thuê bao.
itemBasedRefund

object (ItemBasedRefund)

Không bắt buộc. Được dùng khi cần hoàn tiền cho một mặt hàng cụ thể trong gói thuê bao có các mặt hàng bổ sung.

FullRefund

Loại này không có trường nào.

Dùng để xác định xem loại khoản hoàn tiền trong RevocationContext có phải là hoàn tiền toàn bộ hay không.

ProratedRefund

Loại này không có trường nào.

Dùng để xác định xem loại tiền hoàn lại trong RevocationContext có phải là tiền hoàn lại theo tỷ lệ hay không.

ItemBasedRefund

Dùng để xác định mục cụ thể cần thu hồi trong một gói thuê bao có nhiều mục.

Biểu diễn dưới dạng JSON 
{
  "productId": string
}
Trường
productId

string

Bắt buộc. Nếu gói thuê bao có các tiện ích bổ sung, hãy cung cấp mã sản phẩm của mặt hàng thuê bao cần thu hồi.