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

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

string

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

نص الطلب

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

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

object (SubscriptionDeferralInfo)

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

نص الاستجابة

استجابة واجهة برمجة التطبيقات purchases.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)

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