Method: purchases.subscriptions.defer

تم إيقاف هذه الطريقة نهائيًا، لذا يُرجى استخدام purchases.subscriptionsv2.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)

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