將使用者的訂閱購買交易延後到指定的未來到期時間為止。
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
SubscriptionDeferralInfo 包含將訂閱項目購買交易延後到未來到期時間所需的資料。
JSON 表示法 |
---|
{ "expectedExpiryTimeMillis": string, "desiredExpiryTimeMillis": string } |
欄位 | |
---|---|
expectedExpiryTimeMillis |
訂閱的預期到期時間。如果訂閱的當前到期時間不是此處指定的值,系統就不會執行延後動作。 |
desiredExpiryTimeMillis |
指派給訂閱項目的下一個到期時間,以 Epoch 紀元時間起算的毫秒為單位。指定的時間必須晚於/晚於目前訂閱的到期時間。 |