Method: purchases.subscriptionsv2.defer

تمدید اشتراک را به تعویق می‌اندازد.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
packageName

string

الزامی. بسته‌ی برنامه‌ای که این اشتراک برای آن خریداری شده است (برای مثال، 'com.some.thing').

token

string

الزامی. توکنی که هنگام خرید اشتراک به دستگاه کاربر ارائه شده است.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
فیلدها
deferralContext

object ( DeferralContext )

الزامی. جزئیات مربوط به تعویق اشتراک.

بدنه پاسخ

پاسخ برای API خریدهای نسخه ۲.اشتراک‌ها.تعویق.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
فیلدها
itemExpiryTimeDetails[]

object ( ItemExpiryTimeDetails )

زمان انقضای جدید برای هر مورد اشتراک.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

DeferralContext

زمینه‌ی تعویق API مربوط به purchases.subscriptionsv2.defer.

نمایش JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
فیلدها
etag

string

الزامی. اگر etag با آخرین etag برای این اشتراک مطابقت نداشته باشد، API با شکست مواجه خواهد شد. etag از purchases.subscriptionsv2.get بازیابی می‌شود: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

deferDuration

string ( Duration format)

الزامی. مدت زمانی که تمام اقلام اشتراک باید به تعویق بیفتند.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

validateOnly

boolean

اگر روی "true" تنظیم شود، درخواست یک اجرای آزمایشی برای اعتبارسنجی تأثیر subscriptionsv2.defer است و اشتراک تحت تأثیر قرار نمی‌گیرد.

جزئیات زمان انقضای کالا

جزئیات زمان انقضای یک مورد اشتراک.

نمایش JSON 
{
  "productId": string,
  "expiryTime": string
}
فیلدها
productId

string

شناسه محصول مربوط به کالای اشتراکی (برای مثال، 'premium_plan').

expiryTime

string ( Timestamp format)

زمان انقضای جدید برای این مورد اشتراک.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .