- درخواست اچتیتیپی
- پارامترهای مسیر
- متن درخواست
- متن پاسخ
- دامنههای مجوز
- DefiniteTransition
- TentativeTransition
- امتحان کنید!
انتقال طرح را برای اشتراک زمانبندی کنید.
درخواست HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
این نشانی وب از نحو تراتبدیل 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-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
| [الزامی] حالت انتقال طرح. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: | |
definiteTransition |
هنگام استفاده از این حالت، انتقال کاربر به طرح جدید قطعی است و نمیتوان آن را لغو کرد. |
tentativeTransition |
هنگام استفاده از این حالت، انتقال کاربر به طرح جدید موقتی است و میتواند لغو شود. |
| پایان فیلدهای متقابلاً انحصاری. | |
etag |
اگر تنظیم شود، درصورتیکه etag با جدیدترین etag برای این اشتراک مطابقت نداشته باشد، API ناموفق خواهد بود. برچسب نهاد از 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
این نوع فیلدی ندارد.
برای نشان دادن اینکه انتقال طرح آزمایشی است استفاده میشود.