ایجاد طرح‌های نرخ آینده

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

مقدمه

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

برای مثال، فرض کنید طرح نرخ استانداردی ایجاد کرده‌اید که در ۳۱ دسامبر ۲۰۱۹ منقضی می‌شود و می‌خواهید آن را با طرح دیگری که از ۱ ژانویه ۲۰۲۰ اجرایی می‌شود جایگزین کنید. برای انجام این کار، طرح نرخ آینده‌ای ایجاد می‌کنید و آن را طوری تنظیم می‌کنید که از ۱ ژانویه ۲۰۲۰ اجرایی شود.

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

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

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

ایجاد طرح نرخ آینده بااستفاده از واسط کاربر

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

Edge

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

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

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

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

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

    توجه: طرح نرخ تا پایان روز در تاریخ مشخص‌شده اعمال خواهد شد. اگر می‌خواهید طرح قیمت در ۱ دسامبر ۲۰۱۸ منقضی شود، برای مثال، باید مقدار endDate را روی ۲۰۱۸-۱۱-۳۰ تنظیم کنید. در این مورد، طرح نرخ در پایان روز ۳۰ نوامبر ۲۰۱۸ منقضی خواهد شد؛ همه درخواست‌های ۱ دسامبر ۲۰۱۸ مسدود خواهد شد.

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

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

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

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

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

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

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

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

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

    با این کار، پنجره «طرح قیمت» آینده باز می‌شود.

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

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

ایجاد طرح نرخ آینده بااستفاده از API

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

مکان:

  • ‫{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