Method: purchases.subscriptionsv2.defer

تؤجّل هذه السمة تجديد الاشتراك.

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:defer

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
packageName

string

الحقل مطلوب. حزمة التطبيق التي تم شراء هذا الاشتراك فيها (على سبيل المثال، "com.some.thing").
token

string

الحقل مطلوب. الرمز المميز الذي تم تقديمه إلى جهاز المستخدم عند شراء الاشتراك

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

object (DeferralContext)

الحقل مطلوب. تفاصيل حول تأجيل الاشتراك

نص الاستجابة

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

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

تمثيل JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
الحقول
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

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

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

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

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

DeferralContext

سياق التأجيل لواجهة برمجة التطبيقات purchases.subscriptionsv2.defer.

تمثيل JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
الحقول
etag

string

الحقل مطلوب. سيتعذّر تنفيذ طلب البيانات إذا لم يتطابق etag مع أحدث etag لهذا الاشتراك. يتم استرداد etag من purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

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

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
validateOnly

boolean

إذا تم ضبطها على "true"، يكون الطلب عبارة عن تشغيل تجريبي للتحقّق من صحة تأثير subscriptionsv2.defer، ولن تتأثر الاشتراك.

ItemExpiryTimeDetails

تفاصيل وقت انتهاء صلاحية منتج الاشتراك

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

string

معرّف المنتج الخاص بالاشتراك (على سبيل المثال، premium_plan).
expiryTime

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".