- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات الأذونات
- DefiniteTransition
- TentativeTransition
- جرِّبه الآن
جدولة عملية انتقال من خطة إلى أخرى في اشتراك معيّن
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
packageName |
الحقل مطلوب. حزمة التطبيق الذي تم شراء هذا الاشتراك من أجله (على سبيل المثال، "com.some.thing"). |
token |
الحقل مطلوب. الرمز المميّز الذي تم تقديمه إلى جهاز المستخدم عند شراء الاشتراك |
نص الطلب
يتضمن نص الطلب بيانات بالبنية التالية:
| تمثيل 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 ( |
| الحقول | |
|---|---|
productId |
الحقل مطلوب. المنتج المتوفّر عند الاشتراك (على سبيل المثال، premium_plan) الذي يجب جدولة عملية الانتقال إليه. |
earliestTransitionEffectiveTime |
الحقل مطلوب. أقرب وقت يمكن أن يسري فيه الانتقال إلى الخطة. ستتم عملية النقل الفعلية في وقت التجديد في هذا التاريخ أو بعده. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
| [مطلوب] وضع الانتقال إلى الخطة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ: | |
definiteTransition |
عند استخدام هذا الوضع، يكون انتقال المستخدم إلى الخطة الجديدة نهائيًا ولا يمكن إلغاؤه. |
tentativeTransition |
عند استخدام هذا الوضع، يكون انتقال المستخدم إلى الخطة الجديدة مؤقتًا ويمكن إلغاؤه. |
| نهاية الحقول التي يستبعد كل منها الآخر | |
etag |
في حال ضبط هذه المَعلمة، سيتعذّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات إذا لم يتطابق 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 |
تفاصيل عملية نقل الخطة لعنصر الاشتراك |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
لا يحتوي هذا النوع على أي حقول.
يُستخدَم للإشارة إلى أنّ عملية الانتقال إلى الخطة نهائية.
TentativeTransition
لا يحتوي هذا النوع على أي حقول.
يُستخدَم للإشارة إلى أنّ عملية الانتقال إلى الخطة مؤقتة.