برنامه های نرخ آتی ایجاد کنید

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید .
اطلاعات

مقدمه

پس از انتشار یک طرح نرخ موجود، تنها ویژگی که می توانید تغییر دهید تاریخ پایان آن است. با این حال، می‌توانید نسخه جدیدی از طرح ایجاد کنید که شامل ویژگی‌های تغییر یافته است، مانند نرخ‌های طرح تغییر یافته. می‌توانید این بازبینی را تنظیم کنید تا در تاریخ آینده اعمال شود. طرح نرخ اصلی با اجرایی شدن بازبینی به پایان می رسد.

به عنوان مثال، فرض کنید یک برنامه نرخ استاندارد ایجاد کرده اید که در 31 دسامبر 2019 منقضی می شود و می خواهید آن را با طرح دیگری جایگزین کنید که از 1 ژانویه 2020 اجرایی می شود. برای انجام این کار، یک برنامه نرخ آتی ایجاد کرده و آن را تنظیم می کنید. از 1 ژانویه 2020 اجرایی می شود.

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

توسعه دهندگان در مورد طرح نرخ اصلاح شده مطلع می شوند. آن دسته از توسعه دهندگانی که طرح نرخ اصلی را می پذیرند به طور خودکار برای بازبینی ثبت نام می کنند (اما این گزینه را دارند که اصلاح را رد کنند).

همانطور که در بخش‌های زیر توضیح داده شده است، می‌توانید با استفاده از رابط کاربری مدیریت یا API کسب درآمد، یک طرح نرخ آینده ایجاد کنید.

ایجاد یک برنامه نرخ آینده با استفاده از UI

همانطور که در زیر توضیح داده شده است، یک برنامه نرخ آتی ایجاد کنید.

لبه

برای ایجاد یک نسخه آینده از یک طرح نرخ که مدتی بعد از امروز با استفاده از رابط کاربری Edge شروع می شود، مراحل زیر را انجام دهید.

  1. در صفحه Rate Plans ، مکان‌نمای خود را در ردیف مرتبط با طرح نرخی قرار دهید که می‌خواهید برای آن یک طرح نرخ آتی ایجاد کنید.
    طرح نرخ باید دارای تاریخ پایان باشد.
  2. روی +Future کلیک کنید.
  3. در بخش طرح نرخ آینده ، یکی از موارد زیر را انتخاب کنید:
    • شروع مجدد دوره کامل قرارداد در تاریخ لازم الاجرا شدن جدید : طرح نرخ آتی از تاریخ لازم الاجرا شدن اجرا می شود. مدت تمدید طرح نرخ آتی همانند طرح نرخ فعلی است.
    • کسر زمان صرف شده برای قرارداد قبلی از دوره جدید، در تاریخ لازم‌الاجرا شدن : طرح نرخ آتی از تاریخ لازم‌الاجرا شدن اجرا می‌شود. زمان صرف شده برای استفاده از طرح نرخ فعلی از دوره تمدید طرح نرخ آتی کسر می شود. این به این معنی است که اگر یک توسعه دهنده از طرح فعلی به مدت 3 ماه استفاده کند و دوره تمدید آن 3 ماه کاهش می یابد.
  4. فیلدهای زیر را در پنل بالا پیکربندی کنید:
    توجه : سایر فیلدها فقط خواندنی هستند.
    میدان توضیحات پیش فرض مورد نیاز
    نام طرح نرخ گذاری

    نام طرح نرخ شما

    توجه : لازم نیست نام با نام طرح نرخ اصلی مطابقت داشته باشد.

    نام طرح موجود بله
    تاریخ شروع تاریخ اجرایی شدن طرح نرخ تاریخ شروع را وارد کنید یا با استفاده از تقویم تاریخی را انتخاب کنید. امروز خیر
    تاریخ پایان تاریخ پایان طرح نرخ برای تعیین تاریخ پایان، تاریخ پایان را فعال کنید، سوئیچ را تغییر دهید و تاریخ پایان را وارد کنید یا با استفاده از تقویم یک تاریخ را انتخاب کنید.

    توجه : طرح نرخ تا پایان روز در تاریخ تعیین شده قابل اجرا خواهد بود. برای مثال، اگر می‌خواهید یک طرح نرخ را در 1 دسامبر 2018 منقضی کنید، باید مقدار endDate را روی 2018-11-30 تنظیم کنید. در این صورت، طرح نرخ در پایان روز 30 نوامبر 2018 منقضی می شود. همه درخواست ها در تاریخ 1 دسامبر 2018 مسدود خواهند شد.

    هیچ کدام خیر
    قابل مشاهده برای پورتال ها تنظیم کنید که طرح نرخ عمومی یا خصوصی باشد. به طرح‌های نرخ عمومی در مقابل خصوصی مراجعه کنید. فعال شد خیر
  5. هزینه ها را برای طرح نرخ پیکربندی کنید. به پیکربندی هزینه ها مراجعه کنید.
    توجه : برای برنامه های اعلان قابل تنظیم قابل اجرا نیست.
  6. اگر بسته محصولی را انتخاب می‌کنید که حاوی بیش از یک محصول API است، تنظیمات برگزیده زیر را در بخش طرح نرخ خاص یا عمومی تنظیم کنید:
    توجه : این مرحله برای برنامه های اعلان قابل تنظیم قابل اجرا نیست.
    میدان توضیحات پیش فرض
    هر محصول را به صورت جداگانه پیکربندی کنید پرچمی که مشخص می کند برای هر محصول API یک طرح نرخ جداگانه پیکربندی شود یا خیر. از کار افتاده است
    پیشنهاد فریمیوم هر محصول را به صورت جداگانه پیکربندی کنید پرچمی که مشخص می‌کند برای هر محصول API یک طرح فریمیوم پیکربندی شود یا خیر. از کار افتاده است
    یک محصول را انتخاب کنید اگر یک یا هر دو پرچم را فعال کنید، باید هر محصول را به صورت جداگانه از لیست کشویی انتخاب کنید و جزئیات طرح نرخ آن را پیکربندی کنید.

    توجه : مطمئن شوید که همه محصولات را در بسته محصول پیکربندی کرده اید.

    N/A
  7. بر اساس نوع طرح نرخ انتخاب شده، جزئیات طرح نرخ را پیکربندی کنید:
  8. یکی از موارد زیر را کلیک کنید:
    دکمه توضیحات
    به روز رسانی پیش نویس برنامه نرخ را به عنوان پیش نویس ذخیره کنید.

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

    انتشار پیش نویس طرح را منتشر کنید.

    توجه : پس از انتشار یک طرح نرخ، فقط در صورتی می توانید تاریخ پایان را تغییر دهید که قبلاً تنظیم نشده باشد. نمی‌توانید یک طرح نرخ را پس از انتشار حذف کنید، اما می‌توانید طرح نرخ را منقضی کنید و آن را با یک طرح نرخ آتی جایگزین کنید، همانطور که در Expire a Experied rate plan توضیح داده شده است.

Classic Edge (ابر خصوصی)

برای ایجاد یک نسخه آینده از طرح نرخ که مدتی بعد از امروز با استفاده از رابط کاربری Classic Edge شروع می‌شود، مراحل زیر را انجام دهید.

  1. در کاتالوگ بسته، روی +Future در ستون پیش نویس/آینده برای طرح نرخی که می خواهید جایگزین کنید، کلیک کنید.

    این پنجره برنامه نرخ آینده را باز می کند.

    تفاوت اصلی بین پنجره طرح نرخ آتی و پنجره طرح نرخ فعلی اضافه کردن بخش مشترکین موجود است.

  2. همانطور که برای هر طرح نرخی انجام می دهید:
    • در قسمت Rate Plan Name نامی برای طرح وارد کنید. لازم نیست نام با نام طرح نرخ اصلی مطابقت داشته باشد.
    • پیکربندی هزینه‌ها برای طرح نرخ (اختیاری).
    • بر اساس نوع طرح نرخ انتخاب شده، جزئیات طرح نرخ را پیکربندی کنید:
    • تاریخ اجرایی شدن طرح آتی را مشخص کنید ( به انتشار طرح‌های نرخ‌گذاری رجوع کنید) و تاریخ پایان (همچنین می‌توانید «بدون تاریخ پایان» را انتخاب کنید اگر نمی‌خواهید برنامه نرخ آتی در تاریخ خاصی به پایان برسد). اگر تاریخ پایانی برای طرح فعلی تعیین شده باشد، تاریخ اجرایی شدن برنامه آینده باید پس از تاریخ پایان برنامه جاری باشد.
  3. در بخش مشترکین موجود، یکی از موارد زیر را انتخاب کنید:
    • شروع مجدد دوره کامل قرارداد در تاریخ اجرایی جدید. طرح نرخ آتی از تاریخ لازم الاجرا شدن اجرا می شود. مدت تمدید طرح نرخ آتی همانند طرح نرخ فعلی است.
    • زمان صرف شده برای قرارداد قبلی را از دوره جدید در تاریخ لازم الاجرا کسر کنید. طرح نرخ آتی از تاریخ لازم الاجرا شدن اجرا می شود. زمان صرف شده برای استفاده از طرح نرخ فعلی از دوره تمدید طرح نرخ آتی کسر می شود. این به این معنی است که اگر یک توسعه دهنده از طرح فعلی به مدت 3 ماه استفاده کند و دوره تمدید آن 3 ماه کاهش می یابد.
  4. در قسمت تاریخ اجرایی، تاریخ شروعی را وارد کنید که بعد از تاریخ پایان برنامه نرخ موجود رخ می دهد.

ایجاد یک برنامه نرخ آینده با استفاده از API

با ارسال یک درخواست POST به /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision می‌توانید با استفاده از API، یک طرح نرخ آینده ایجاد کنید.

کجا:

  • {org_id} نام سازمان است.
  • {package_id} شناسه بسته API است.
  • {plan_Id} شناسایی طرح نرخ است.
هنگامی که ویرایش را ایجاد می کنید، باید ویژگی های زیر را در بدنه درخواست مشخص کنید:
  • parentRatePlan شناسه طرح نرخ اصلی را مشخص می کند.
  • startDate تاریخ اجرایی شدن طرح جدید را مشخص می کند.

نام طرح نرخ آتی نباید با نام طرح اصلی مطابقت داشته باشد. همچنین، باید در بین همه برنامه های نرخ شما منحصر به فرد باشد. اگر می خواهید تاریخ شروع اصلی را برای توسعه دهندگان ثبت کنید، پرچم keepOriginalStartDate را روی true تنظیم کنید. این پرچم به طور پیش فرض false است.

برای اطلاعات بیشتر در مورد تنظیمات پیکربندی، تنظیمات پیکربندی برای طرح‌های نرخ را ببینید.

به عنوان مثال، درخواست زیر یک برنامه نرخ آتی ایجاد می کند:

$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "parentRatePlan": {
       "id": "monetization_package_flat_rate_card_plan_1379513833409"
     },
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "myorg"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.05",
        "startUnit": "0"       
       }      
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2014-01-01 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password