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