Method: purchases.subscriptionsv2.revoke

对用户购买的订阅执行 subscriptionsv2.revoke 操作。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
packageName

string

必需。购买相应订阅所对应的应用的软件包（例如“com.some.thing”）。
token

string

必需。在用户购买订阅时向用户设备提供的令牌。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
字段
revocationContext

object (RevocationContext)

必需。有关撤消订阅的其他详细信息。

响应正文

如果成功，则响应正文为空。

示例

以下是一个示例请求：

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": {}
    }
  }'

授权范围

需要以下 OAuth 范围：

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

RevocationContext

purchases.subscriptionsv2.revoke API 的撤消上下文。

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.
}
字段
联合字段 RefundType。确定应批准的退款类型。必须在有效请求中指定退款类型。RefundType 只能是下列其中一项：
fullRefund

object (FullRefund)

可选。应当将订阅中每个项的最新扣款金额全额退还给用户时，使用此字段。
proratedRefund

object (ProratedRefund)

可选。应当根据订阅的剩余时间按比例退还用户支付的订阅费时，使用此字段。
itemBasedRefund

object (ItemBasedRefund)

可选。当订阅包含附加项时，应针对特定项退款时使用。

FullRefund

此类型没有字段。

用于确定 RevocationContext 中的退款类型是不是全额退款。

ProratedRefund

此类型没有字段。

用于确定 RevocationContext 中的退款类型是不是按比例退款。

ItemBasedRefund

用于确定要从包含多个项的订阅中撤消哪个具体项。

JSON 表示法 
{
  "productId": string
}
字段
productId

string

必需。如果订阅包含附加内容，则为要撤消的订阅项的商品 ID。