أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
مقدمة
بعد نشر خطة أسعار حالية، يمكنك تغيير تاريخ انتهائها فقط. ومع ذلك، يمكنك إنشاء نسخة جديدة من الخطة تتضمّن خصائص معدَّلة، مثل أسعار خطة الأسعار المعدَّلة. يمكنك إعداد المراجعة ليتم تطبيقها في تاريخ مستقبلي. تنتهي صلاحية خطة الأسعار الأصلية عند بدء سريان التعديل.
على سبيل المثال، لنفترض أنّك أنشأت خطة أسعار عادية تنتهي صلاحيتها في 31 ديسمبر 2019، وتريد استبدالها بخطة أخرى تسري اعتبارًا من 1 يناير 2020. لإجراء ذلك، عليك إنشاء خطة أسعار مستقبلية وإعدادها لكي تسري اعتبارًا من 1 يناير 2020.
إذا لم يتم تحديد تاريخ انتهاء لخطة الأسعار الحالية، يمكنك استبدال خطة أسعار حالية بخطة أسعار مستقبلية تبدأ في أقرب وقت ممكن من اليوم. عليك إنهاء صلاحية خطة الأسعار الحالية، كما هو موضّح في مقالة إنهاء صلاحية خطة أسعار منشورة.
يتم إعلام المطوّرين بخطة الأسعار المعدَّلة. يتم تلقائيًا تسجيل المطوّرين الذين يقبلون خطة الأسعار الأصلية في الخطة المعدَّلة (ولكن يمكنهم رفض الخطة المعدَّلة).
يمكنك إنشاء خطة أسعار مستقبلية باستخدام واجهة المستخدم الإدارية أو واجهة برمجة التطبيقات لتحقيق الربح، كما هو موضّح في الأقسام التالية.
إنشاء خطة أسعار مستقبلية باستخدام واجهة المستخدم
أنشئ خطة أسعار مستقبلية، كما هو موضّح أدناه.
Edge
لإنشاء إصدار مستقبلي من خطة أسعار يبدأ في وقت ما بعد اليوم باستخدام واجهة مستخدم Edge، اتّبِع الخطوات التالية.
- في صفحة "خطط الأسعار"،
ضَع المؤشر داخل الصف المرتبط بخطة الأسعار التي تريد إنشاء خطة أسعار مستقبلية لها.
يجب أن تتضمّن خطة الأسعار تاريخ انتهاء. - انقر على +المستقبل.
- في قسم خطة الأسعار المستقبلية، حدِّد أحد الخيارات التالية:
- إعادة بدء فترة العقد الكاملة في تاريخ السريان الجديد: يبدأ سريان خطة الأسعار المستقبلية في تاريخ السريان. مدة تجديد خطة الأسعار المستقبلية هي نفسها مدة تجديد خطة الأسعار الحالية.
- خصم الوقت المنقضي في العقد السابق من الفترة الجديدة، في تاريخ السريان: يبدأ سريان خطة الأسعار المستقبلية في تاريخ السريان. يتم خصم الوقت الذي تم استخدامه في خطة الأسعار الحالية من مدة تجديد خطة الأسعار المستقبلية. وهذا يعني أنّه إذا استخدم المطوِّر الخطة الحالية لمدة 3 أشهر، سيتم تقليل فترة التجديد بمقدار 3 أشهر.
- اضبط الحقول التالية في اللوحة العلوية:
ملاحظة: الحقول الأخرى للقراءة فقط.الحقل الوصف تلقائي مطلوب اسم خطة الأسعار اسم خطة الأسعار.
ملاحظة: ليس من الضروري أن يتطابق الاسم مع اسم خطة الأسعار الأصلية.
اسم الخطة الحالية نعم تاريخ البدء تاريخ بدء سريان خطة الأسعار أدخِل تاريخ البدء أو اختَر تاريخًا باستخدام التقويم. اليوم لا تاريخ الانتهاء تاريخ انتهاء خطة الأسعار. لتحديد تاريخ انتهاء، فعِّل خيار تضمين تاريخ انتهاء وأدخِل تاريخ انتهاء أو اختَر تاريخًا باستخدام التقويم. ملاحظة: ستكون خطة الأسعار سارية حتى نهاية اليوم في التاريخ المحدّد. إذا أردت انتهاء صلاحية خطة أسعار في 1 كانون الأول (ديسمبر) 2018 مثلاً، عليك ضبط قيمة endDate على 2018-11-30. في هذه الحالة، ستنتهي صلاحية خطة الأسعار في نهاية يوم 30 تشرين الثاني (نوفمبر) 2018، وسيتم حظر جميع الطلبات في 1 كانون الأول (ديسمبر) 2018.
بلا لا مرئية للبوابات اضبط ما إذا كانت خطة الأسعار علنية أو خاصة. مقارنة خطط الأسعار العامة بخطط الأسعار الخاصة الأجهزة المفعّلة لا - اضبط الرسوم لخطة الأسعار. اطّلِع على ضبط الرسوم.
ملاحظة: لا ينطبق ذلك على خطط الإشعارات القابلة للتعديل. - إذا اخترت حزمة منتجات تحتوي على أكثر من منتج واحد من منتجات واجهة برمجة التطبيقات، اضبط الإعدادات المفضّلة التالية في قسم خطة الأسعار المحدّدة أو العامة:
ملاحظة: لا تنطبق هذه الخطوة على خطط الإشعارات القابلة للتعديل.
الحقل الوصف تلقائي ضبط كل منتج على حدة علامة تحدّد ما إذا كان سيتم إعداد خطة أسعار فردية لكل منتج من منتجات واجهة برمجة التطبيقات. غير مفعّل ضبط عرض freemium لكل منتج على حدة علامة تحدّد ما إذا كان سيتم إعداد خطة freemium لكل منتج من منتجات واجهة برمجة التطبيقات. غير مفعّل اختيار منتج في حال تفعيل أحد العلامتَين أو كلتيهما، يجب اختيار كل منتج على حدة من القائمة المنسدلة وتحديد تفاصيل خطة الأسعار الخاصة به. ملاحظة: تأكَّد من إعداد كل المنتجات في حزمة المنتجات.
لا ينطبق - اضبط تفاصيل خطة الأسعار استنادًا إلى نوع خطة الأسعار المحدّدة:
- انقر على أحد الخيارات التالية:
زرّ الوصف تعديل المسودّة احفظ خطة الأسعار كمسودة. لن يظهر سعر الاشتراك لمطوّري التطبيقات إلا بعد نشره. يمكنك تعديل أي حقل في خطة أسعار مسودّة.
نشر المسودة انشر الخطة. ملاحظة: بعد نشر خطة أسعار، يمكنك تعديل تاريخ الانتهاء فقط إذا لم يتم ضبطه من قبل. لا يمكنك حذف خطة أسعار بعد نشرها، ولكن يمكنك إنهاء صلاحية خطة الأسعار واستبدالها بخطة أسعار مستقبلية، كما هو موضّح في مقالة إنهاء صلاحية خطة أسعار منشورة.
Classic Edge (Private Cloud)
لإنشاء إصدار مستقبلي من خطة أسعار تبدأ في وقت ما بعد اليوم باستخدام واجهة مستخدم Classic Edge، اتّبِع الخطوات التالية.
- في قائمة الحزم، انقر على +Future في عمود "المسودة/المستقبل" لخطة الأسعار التي تريد استبدالها.
سيؤدي ذلك إلى فتح نافذة "خطة الأسعار" المستقبلية.
يتمثّل الفرق الأساسي بين نافذة خطة الأسعار المستقبلية ونافذة خطة الأسعار الحالية في إضافة قسم "المشتركون الحاليون".
- كما تفعل مع أي خطة أسعار:
- أدخِل اسمًا للخطة في حقل "اسم خطة الأسعار". ليس من الضروري أن يتطابق الاسم مع اسم خطة الأسعار الأصلية.
- ضبط الرسوم لخطة أسعار (اختياري)
- اضبط تفاصيل خطة الأسعار استنادًا إلى نوع خطة الأسعار المحدّد:
- حدِّد تاريخًا يبدأ فيه تطبيق خطة الأسعار المستقبلية (راجِع خطط الأسعار المتاحة للجمهور)، وتاريخ انتهاء (يمكنك أيضًا اختيار "بدون تاريخ انتهاء" إذا كنت لا تريد أن تنتهي خطة الأسعار المستقبلية في تاريخ محدّد). إذا تم تحديد تاريخ انتهاء للخطة الحالية، يجب أن يكون تاريخ سريان الخطة المستقبلية بعد تاريخ انتهاء الخطة الحالية.
- في قسم "المشتركون الحاليون"، اختَر أحد الخيارَين التاليَين:
- إعادة بدء فترة العقد الكاملة في تاريخ السريان الجديد تسري خطة الأسعار المستقبلية اعتبارًا من تاريخ السريان. مدة تجديد خطة الأسعار المستقبلية هي نفسها مدة تجديد خطة الأسعار الحالية.
- اطرح الوقت الذي تم استخدامه في العقد السابق من الفترة الجديدة، وذلك في تاريخ السريان. ستصبح خطة الأسعار المستقبلية سارية في تاريخ السريان. يتم خصم الوقت الذي تم استخدامه في خطة الأسعار الحالية من مدة تجديد خطة الأسعار المستقبلية. وهذا يعني أنّه إذا استخدم المطوِّر الخطة الحالية لمدة 3 أشهر، سيتم تقليل فترة التجديد بمقدار 3 أشهر.
- في حقل "تاريخ السريان"، أدخِل تاريخ بدء يقع بعد تاريخ انتهاء خطة الأسعار الحالية.
إنشاء خطة أسعار مستقبلية باستخدام واجهة برمجة التطبيقات
يمكنك إنشاء خطة أسعار مستقبلية باستخدام واجهة برمجة التطبيقات من خلال إصدار طلب 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