Method: purchases.subscriptionsv2.scheduleplantransition

انتقال طرح را برای اشتراک زمان‌بندی کنید.

درخواست HTTP

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

این نشانی وب از نحو تراتبدیل 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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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 برای این اشتراک مطابقت نداشته باشد، API ناموفق خواهد بود. برچسب نهاد از 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

این نوع فیلدی ندارد.

برای نشان دادن اینکه انتقال طرح آزمایشی است استفاده می‌شود.