Method: purchases.subscriptionsv2.revoke

• HTTP 请求
• 路径参数
• 请求正文
  • JSON 表示法
• 响应正文
• 授权范围
• RevocationContext
  • JSON 表示法
• FullRefund
• ProratedRefund
• ItemBasedRefund
  • JSON 表示法
• 试试看！

对用户购买的订阅执行 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。