Method: purchases.subscriptions.defer

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
packageName

string

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

subscriptionId

string

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

token

string

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

درخواست بدن

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

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

object ( SubscriptionDeferralInfo )

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

بدن پاسخگو

پاسخ برای API buys.subscriptions.defer.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

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

string ( int64 format)

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

نمونه

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

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

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

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

string ( int64 format)

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

desiredExpiryTimeMillis

string ( int64 format)

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