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

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

token

string

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

نص الطلب

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

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

object (SubscriptionDeferralInfo)

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

نص الاستجابة

الاستجابة لواجهة برمجة التطبيقات purchase.subscriptions.defer API

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

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

string (int64 format)

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

نطاقات الأذونات

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

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

SubscriptionDeferralInfo

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

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

string (int64 format)

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

desiredExpiryTimeMillis

string (int64 format)

وقت انتهاء الصلاحية التالي المطلوب الذي تريد تحديده للاشتراك، بالمللي ثانية منذ تاريخ بدء حساب الفترة يجب أن يكون الوقت المحدّد لاحقًا أو أكبر من وقت انتهاء الصلاحية الحالي للاشتراك.