Method: purchases.subscriptions.defer

منسوخ شده: به جای آن از purchases.subscriptionsv2.defer استفاده کنید. خرید اشتراک کاربر را تا زمان انقضای مشخصی در آینده به تعویق می‌اندازد.

درخواست HTTP

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

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

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

پارامترها
packageName

string

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

subscriptionId

string

شناسه اشتراک خریداری شده (برای مثال، 'monthly001').

token

string

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

درخواست بدنه

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

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

object ( SubscriptionDeferralInfo )

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

بدنه پاسخ

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

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

نمایش JSON 
{
  "newExpiryTimeMillis": string
}
فیلدها
newExpiryTimeMillis

string ( int64 format)

زمان انقضای جدید برای اشتراک بر حسب میلی‌ثانیه از زمان Epoch.

نمونه

نمونه درخواست زیر:

curl -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "deferralInfo": {
      "desiredExpiryTimeMillis": "1735689600000",
      "expectedExpiryTimeMillis": "1704067200000"
    }
  }' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'

نمونه پاسخ زیر است:

{
  "newExpiryTimeMillis": "1776004800000"
}

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

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

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

اطلاعات تعویق اشتراک

اطلاعات مربوط به اشتراک (SubscriptionDeferralInfo) شامل داده‌های مورد نیاز برای به تعویق انداختن خرید اشتراک به زمان انقضای آینده است.

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

string ( int64 format)

زمان انقضای مورد انتظار برای اشتراک. اگر زمان انقضای فعلی اشتراک، مقداری که در اینجا مشخص شده است نباشد، تعویق رخ نخواهد داد.

desiredExpiryTimeMillis

string ( int64 format)

زمان انقضای بعدی مورد نظر برای اختصاص به اشتراک، بر حسب میلی‌ثانیه از زمان شروع اشتراک. زمان داده شده باید دیرتر/بیشتر از زمان انقضای فعلی اشتراک باشد.