يمكن تأجيل شراء اشتراك المستخدِم حتى وقت انتهاء صلاحية محدَّد في المستقبل.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
packageName |
اسم حزمة التطبيق الذي تم شراء هذا الاشتراك من أجله (على سبيل المثال، "com.some.thing"). |
subscriptionId |
رقم تعريف الاشتراك الذي تم شراؤه (على سبيل المثال، "month001"). |
token |
الرمز المميّز الذي تم تقديمه لجهاز المستخدم عند شراء الاشتراك |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"deferralInfo": {
object ( |
الحقول | |
---|---|
deferralInfo |
المعلومات عن وقت انتهاء الصلاحية الجديد المطلوب للاشتراك. |
نص الاستجابة
الاستجابة لواجهة برمجة التطبيقات purchase.subscriptions.defer API
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "newExpiryTimeMillis": string } |
الحقول | |
---|---|
newExpiryTimeMillis |
وقت انتهاء الصلاحية الجديد للاشتراك بالمللي ثانية منذ تاريخ Epoch |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
SubscriptionDeferralInfo
يحتوي SubscriptionDeferralInfo على البيانات اللازمة لتأجيل شراء اشتراك إلى وقت انتهاء صلاحية مستقبلي.
تمثيل JSON |
---|
{ "expectedExpiryTimeMillis": string, "desiredExpiryTimeMillis": string } |
الحقول | |
---|---|
expectedExpiryTimeMillis |
وقت انتهاء الصلاحية المتوقَّع للاشتراك. إذا لم يكن وقت انتهاء الصلاحية الحالي للاشتراك هو القيمة المحددة هنا، لن يحدث التأجيل. |
desiredExpiryTimeMillis |
وقت انتهاء الصلاحية التالي المطلوب الذي تريد تحديده للاشتراك، بالمللي ثانية منذ تاريخ بدء حساب الفترة يجب أن يكون الوقت المحدّد لاحقًا أو أكبر من وقت انتهاء الصلاحية الحالي للاشتراك. |