Method: subscriptions.changePlan

یک طرح اشتراک را به روز می کند. از این روش برای به روز رسانی یک طرح برای یک آزمایش 30 روزه یا یک اشتراک طرح انعطاف پذیر در یک برنامه تعهدی سالانه با پرداخت های ماهانه یا سالانه استفاده کنید.

نحوه به روز رسانی یک طرح بسته به طرح و محصولات متفاوت است. برای اطلاعات بیشتر، به توضیحات در مدیریت اشتراک‌ها مراجعه کنید.

درخواست HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

این می تواند نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری باشد. اگر نام دامنه برای یک مشتری تغییر کند، نام دامنه قدیمی را نمی توان برای دسترسی به مشتری استفاده کرد، اما شناسه منحصر به فرد مشتری (که توسط API برگردانده شده است) همیشه می تواند استفاده شود. توصیه می کنیم شناسه منحصر به فرد را در صورت لزوم در سیستم های خود ذخیره کنید.

subscriptionId

string

این یک ویژگی مورد نیاز است. subscriptionId شناسه اشتراک است و برای هر مشتری منحصر به فرد است. از آنجایی که هنگام به‌روزرسانی اشتراک، subscriptionId تغییر می‌کند، توصیه می‌کنیم از این شناسه به عنوان کلیدی برای داده‌های دائمی استفاده نکنید. و subscriptionId می توان با استفاده از روش retrieve all reseller subscriptions پیدا کرد.

درخواست بدن

بدنه درخواست شامل یک نمونه از ChangePlanRequest است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Subscription است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/apps.order

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

ChangePlanRequest

قالب JSON برای درخواست subscriptions.changePlan rpc.

نمایندگی JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
فیلدها
kind

string

منبع را به عنوان یک درخواست طرح تغییر اشتراک شناسایی می کند. ارزش: subscriptions#changePlanRequest

planName

string

ویژگی planName مورد نیاز است. این نام طرح پرداخت اشتراک است. برای اطلاعات بیشتر درباره طرح‌های پرداخت Google، به مفاهیم API مراجعه کنید.

مقادیر ممکن عبارتند از:

  • ANNUAL_MONTHLY_PAY - طرح تعهد سالانه با پرداخت های ماهانه
  • ANNUAL_YEARLY_PAY - طرح تعهد سالانه با پرداخت سالانه
  • FLEXIBLE - طرح انعطاف پذیر
  • TRIAL - طرح آزمایشی رایگان 30 روزه

seats

object ( Seats )

این یک ویژگی مورد نیاز است. ویژگی seats تعداد مجوزهای صندلی کاربر است.

purchaseOrderId

string

این یک ویژگی اختیاری است. این اطلاعات سفارش خرید (PO) برای فروشندگان است تا برای استفاده ردیابی شرکت خود استفاده کنند. اگر مقدار purchaseOrderId داده شود، در پاسخ‌های API ظاهر می‌شود و در صورت‌حساب نشان داده می‌شود. این ویژگی حداکثر 80 کاراکتر متن ساده را می پذیرد.

dealCode

string

کد صادر شده توسط Google (حداکثر 100 کاراکتر) برای قیمت های تخفیف دار در طرح های اشتراک. برای دریافت نرخ تخفیف، کد معامله باید در درخواست changePlan گنجانده شود. این ویژگی اختیاری است. اگر کد معامله قبلاً به اشتراک اضافه شده باشد، ممکن است این ویژگی خالی بماند و نرخ تخفیف موجود همچنان اعمال می‌شود (اگر خالی نیست، فقط کد معامله‌ای را ارائه کنید که از قبل در اشتراک موجود است). اگر کد معامله هرگز به اشتراک اضافه نشده باشد و این ویژگی خالی بماند، قیمت گذاری معمولی اعمال خواهد شد.