Method: purchases.subscriptionsv2.scheduleplantransition

جدولة عملية انتقال من خطة إلى أخرى في اشتراك معيّن

طلب HTTP

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

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

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

المعلمات
packageName

string

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

token

string

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

نص الطلب

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

تمثيل JSON
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
الحقول
productId

string

الحقل مطلوب. المنتج المتوفّر عند الاشتراك (على سبيل المثال، premium_plan) الذي يجب جدولة عملية الانتقال إليه.

earliestTransitionEffectiveTime

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"

[مطلوب] وضع الانتقال إلى الخطة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
definiteTransition

object (DefiniteTransition)

عند استخدام هذا الوضع، يكون انتقال المستخدم إلى الخطة الجديدة نهائيًا ولا يمكن إلغاؤه.

tentativeTransition

object (TentativeTransition)

عند استخدام هذا الوضع، يكون انتقال المستخدم إلى الخطة الجديدة مؤقتًا ويمكن إلغاؤه.

نهاية الحقول التي يستبعد كل منها الآخر
etag

string

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

نص الاستجابة

الردّ على طلب واجهة برمجة التطبيقات purchases.subscriptionsv2.schedulePlanTransition

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

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

object (PlanTransitionDetails)

تفاصيل عملية نقل الخطة لعنصر الاشتراك

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

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

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

DefiniteTransition

لا يحتوي هذا النوع على أي حقول.

يُستخدَم للإشارة إلى أنّ عملية الانتقال إلى الخطة نهائية.

TentativeTransition

لا يحتوي هذا النوع على أي حقول.

يُستخدَم للإشارة إلى أنّ عملية الانتقال إلى الخطة مؤقتة.