将用户的订阅购买交易推迟到指定的未来到期时间。
HTTP 请求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
packageName |
购买了此订阅的应用的软件包名称(例如 'com.some.thing')。 |
subscriptionId |
购买的订阅 ID(例如 'monthly001')。 |
token |
购买订阅时向用户设备提供的令牌。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"deferralInfo": {
object ( |
字段 | |
---|---|
deferralInfo |
与所需的新订阅到期时间有关的信息。 |
响应正文
如果成功,则响应正文包含结构如下的数据:
对 purchase.subscriptions.defer API 的响应。
JSON 表示法 |
---|
{ "newExpiryTimeMillis": string } |
字段 | |
---|---|
newExpiryTimeMillis |
订阅的新到期时间(以毫秒为单位,从 Epoch 起算)。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/androidpublisher
订阅延迟信息
SubscriptionDeferralInfo 包含将订阅购买交易推迟到未来到期时间所需的数据。
JSON 表示法 |
---|
{ "expectedExpiryTimeMillis": string, "desiredExpiryTimeMillis": string } |
字段 | |
---|---|
expectedExpiryTimeMillis |
订阅的预期过期时间。如果订阅的当前有效期不是此处指定的值,则不会延迟。 |
desiredExpiryTimeMillis |
为订阅分配的期望下一个过期时间(以毫秒为单位,从 Epoch 起算)。指定的时间必须晚于/晚于当前订阅到期的时间。 |