إنشاء خطط أسعار مستقبلية

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

مقدمة

بعد نشر خطة أسعار حالية، يكون تاريخ الانتهاء هو الموقع الوحيد الذي يمكنك تغييره. مع ذلك، يمكنك إنشاء نسخة جديدة من الخطة تتضمّن سمات تم تغييرها، مثل أسعار الخطة المتغيّرة. يمكنك إعداد النسخة لتكون سارية المفعول في تاريخ مستقبلي. تنتهي خطة السعر الأصلية عند دخول المراجعة حيز التنفيذ.

على سبيل المثال، لنفترض أنّك أنشأت خطة سعر عادية تنتهي صلاحيتها في 31 كانون الأول (ديسمبر) 2019 وتريد استبدالها بخطة أخرى سارية في 1 كانون الثاني (يناير) 2020. لإجراء ذلك، يجب وضع خطة أسعار مستقبلية وإعدادها لتدخل حيّز التنفيذ في 1 كانون الثاني (يناير) 2020.

يتم إعلام المطوّرين بخطة السعر المعدَّلة. يتم تسجيل مطوّري البرامج الذين يقبلون خطة السعر الأصلية تلقائيًا في المراجعة (ولكن يتوفّر لديهم خيار رفض المراجعة).

يمكنك وضع خطة أسعار مستقبلية باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات لتحقيق الربح، كما هو موضّح في الأقسام التالية.

وضع خطة سعر مستقبلية باستخدام واجهة المستخدم

أنشئ خطة أسعار مستقبلية، كما هو موضّح أدناه.

وضع خطة أسعار مستقبلية باستخدام واجهة برمجة التطبيقات

يمكنك وضع خطة أسعار مستقبلية باستخدام واجهة برمجة التطبيقات من خلال إصدار طلب بقيمة POST إلى /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.

المكان:

• {org_id} هو اسم المؤسسة.
• {package_id} هو تعريف حزمة واجهة برمجة التطبيقات.
• {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