Method: purchases.subscriptions.defer

تؤجل شراء اشتراك المستخدم حتى وقت انتهاء صلاحية محدّد في المستقبل.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
packageName

string

اسم حزمة التطبيق الذي تم شراء هذا الاشتراك له (على سبيل المثال، "com.some.thing").
subscriptionId

string

رقم تعريف الاشتراك الذي تم شراؤه (على سبيل المثال، "شهريًا001").
token

string

الرمز المميّز الذي تم تقديمه إلى جهاز المستخدم عند شراء الاشتراك

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
الحقول
deferralInfo

object (SubscriptionDeferralInfo)

المعلومات المتعلقة بوقت انتهاء الصلاحية الجديد المطلوب للاشتراك.

نص الاستجابة

الردّ على واجهة برمجة التطبيقات purchase.subscriptions.defer

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "newExpiryTimeMillis": string
}
الحقول
newExpiryTimeMillis

string (int64 format)

وقت انتهاء الصلاحية الجديد للاشتراك بالمللي ثانية منذ "الحقبة".

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

SubscriptionDeferralInfo

يحتوي SubscriptionDeferralInfo على البيانات اللازمة لتأجيل شراء الاشتراك إلى وقت انتهاء صلاحية مستقبلي.

تمثيل JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
الحقول
expectedExpiryTimeMillis

string (int64 format)

وقت انتهاء الصلاحية المتوقع للاشتراك. إذا لم يكن وقت انتهاء الصلاحية الحالي للاشتراك هو القيمة المُحدَّدة هنا، لن يحدث التأجيل.
desiredExpiryTimeMillis

string (int64 format)

وقت انتهاء الصلاحية التالي المطلوب تعيينه للاشتراك بالملي ثانية منذ الحقبة. يجب أن يكون الوقت المحدَّد بعد أو أكبر من وقت انتهاء الصلاحية الحالي للاشتراك.