取消用户购买的订阅。订阅保持有效,直至到期。
HTTP 请求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
package |
购买的相应订阅所对应的应用的软件包名称(例如:“com.some.thing”)。 |
subscription |
所购买订阅的 ID(例如“monthly001”)。 |
token |
在用户购买订阅时向用户设备提供的令牌。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"cancellationType": enum ( |
字段 | |
---|---|
cancellation |
可选。所购买订阅的取消类型。 |
响应正文
如果成功,则响应正文为空。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/androidpublisher
CancellationType
开发者请求的取消的类型。
枚举 | |
---|---|
CANCELLATION_TYPE_UNSPECIFIED |
未指定取消类型。 |
USER_REQUESTED_STOP_RENEWALS |
用户发起的取消,并且所取消的订阅可以恢复。这只会停止订阅的下次续订。对于分期付款订阅,用户仍需完成承诺期。如需详细了解续订和付款,请参阅 https://developer.android.com/google/play/billing/subscriptions#installments |
DEVELOPER_REQUESTED_STOP_PAYMENTS |
开发者请求的取消,并且所取消的订阅无法恢复。这会停止订阅的下次付款。对于分期付款订阅,用户无需支付下一个付款并完成承诺期。如需详细了解续订和付款,请参阅 https://developer.android.com/google/play/billing/subscriptions#installments。如果未指定取消类型,则采用此默认行为。 |