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

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

مقدمه

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

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

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

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

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

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

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

لبه

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

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

    نام طرح تعرفه شما.

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

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

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

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

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

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

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

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

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

لبه کلاسیک (ابر خصوصی)

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

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

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

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

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

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

شما می‌توانید با استفاده از 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