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

أنت تعرض مستندات 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