أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
مقدمة
في خطة قائمة الأسعار، يتم تحصيل رسوم من المطوّر مقابل كل معاملة. بالنسبة إلى هذا النوع من الخطط، عليك تقديم تفاصيل إضافية، مثل نموذج الشحن والأسعار الخاصة به.
يمكنك اختياريًا تحديد خطة freemium للمنتجات الفردية (بدلاً من حزمة واجهة برمجة التطبيقات)، ولا يمكنك إجراء ذلك إلا لخطة خاصة بالمنتج.
متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحزمة؟
يمكن أن تتضمّن خطط الأسعار رسومًا متكرّرة بالإضافة إلى حِزم واجهة برمجة التطبيقات (خطط الحِزم والكميات)، ويشمل كلّ منهما أوقاتًا محدّدة يتم فيها تحصيل الرسوم وإعادة ضبط خطط الحِزم إلى الصفر. يوضّح الجدول التالي الحالات التي يتم فيها تحصيل الرسوم المتكرّرة وإعادة ضبط عدد الحِزم. إذا تم حظر تطبيقات المطوّرين من إجراء المزيد من طلبات البيانات من واجهة برمجة التطبيقات لأنّها بلغت حد المعاملة، إليك الأوقات التي تتم فيها إعادة ضبط عدد طلبات البيانات من واجهة برمجة التطبيقات إلى صفر ويمكن للتطبيقات البدء في إجراء الطلبات مرة أخرى.
| إذا كانت الخطة تتضمّن... | ...يحدث ذلك |
|---|---|
|
تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة في اليوم الأول من الشهر (الإعداد التلقائي). لإنشاء تكرار شهري في يوم محدّد، أنشئ خطة أسعار باستخدام واجهة برمجة التطبيقات الإدارية وأدخِل اليوم باستخدام السمة |
|
تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة كل 7 أيام بعد تاريخ بدء خطة الأسعار الخاصة بالمطوّر. |
|
تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة كل X يوم بعد تاريخ بدء خطة الأسعار الخاصة بالمطوّر. |
|
تتم إعادة ضبط خطط الحزمة استنادًا إلى "أساس التجميع" المحدّد في قائمة الأسعار. على سبيل المثال، إذا بدأ المطوّر خطة أسعار في اليوم 19 من الشهر، وكان أساس التجميع كل شهر واحد، تتم إعادة ضبط استخدام الحزمة كل شهر في اليوم 19. يُرجى العِلم أنّ يوم الشهر قد لا يكون هو نفسه دائمًا. على سبيل المثال، إذا بدأت خطة أسعار في 31 ديسمبر، سيصبح تاريخ إعادة الضبط هو 28 فبراير في سنة غير كبيسة، لأنّ شهر فبراير يتضمّن 28 يومًا فقط. وسيظل يوم 28 هو يوم إعادة الضبط بعد ذلك. |
ضبط خطط بطاقة السعر باستخدام واجهة المستخدم
اضبط خطط بطاقة الأسعار على النحو الموضّح أدناه.
Edge
لإعداد خطة بطاقة الأسعار، عند إنشاء أو تعديل خطة أسعار، اختَر نوع خطة الأسعار بطاقة الأسعار أو بطاقة الأسعار ومشاركة الأرباح، وفي قسم بطاقة الأسعار، اختَر أحد نماذج الفوترة التالية:
| نموذج الشحن | الوصف |
| السعر الثابت: | يتم تحصيل سعر ثابت من المطوّر مقابل كل معاملة. |
| Volume Banded | يتم تحصيل معدّل متغيّر من المطوّر حسب عدد المعاملات. |
| Bundles | يتم تحصيل مبلغ محدّد مسبقًا من المطوّر مقابل كل حزمة من المعاملات. يتم تحصيل المبلغ المحدّد من المطوّر سواء تم استخدام الحزمة بالكامل أم لا.
ملاحظة: لا يتوفّر هذا الخيار عند اختيار "بطاقة الأسعار" و"مشاركة الأرباح". |
بعد ذلك، اضبط المعلومات التالية استنادًا إلى نموذج الفوترة الذي اخترته.
| نموذج الشحن | الحقل | الوصف |
| الكل | معدّل تكرار الحساب | الفترة الزمنية التي يتم احتساب عدد المعاملات (أو عدد العناصر المرتبطة بالسمة المخصّصة) خلالها. اختَر عددًا من الأشهر (من شهر واحد إلى 24 شهرًا). |
| السعر الثابت: | السعر الثابت | المعدّل الذي يتم تحصيله مقابل كل معاملة. أدخِل رقمًا عشريًا (يمكن أن يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها للسعر الذي يتم تحصيله باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار. على سبيل المثال، إذا أدخلت القيمة 0.10 وكانت العملة هي الدولار الأمريكي، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل كل معاملة (أو إذا كان ذلك استنادًا إلى سمة مخصّصة مثل عدد وحدات البايت التي تم نقلها في المعاملة، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل نقل عدد وحدات البايت المحدّد). |
| Volume Banded | نطاقات الحجم | نطاق واحد أو أكثر من أحجام المعاملات (أو استنادًا إلى سمات العملاء) (كل نطاق هو "نطاق حجم") لنموذج التسعير المستند إلى نطاق الحجم يمكن تحديد سعر لكل نطاق حجم. يتم تطبيق السعر على جميع المعاملات في فئة الحجم السارية. حدِّد الحدّ الأعلى للنطاق الأول، مثلاً حتى 1000 (الحدّ الأدنى مضبوط مسبقًا على قيمة أكبر من 0).
انقر على +جديد لإضافة نطاقات إضافية. اترك الحدّ الأعلى للنطاق النهائي فارغًا للإشارة إلى جميع المعاملات التي تتجاوز هذا المستوى. ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها للسعر الذي يتم تحصيله باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار. على سبيل المثال، إذا حدّدت نطاقَي مستوى صوت في قسم "نطاق مستوى الصوت" (>0-1000 و1000 وما فوق)، يمكنك إدخال 0.15 لنطاق مستوى الصوت >0-1000 و0.10 لنطاق مستوى الصوت 1000 وما فوق. إذا كانت العملة المحدّدة هي الدولار الأمريكي، يكون سعر أول 1,000 معاملة هو 0.15 دولار أمريكي لكل معاملة، ويكون سعر أكثر من 1,000 معاملة هو 0.10 دولار أمريكي لكل معاملة. |
| Bundles | أسعار حِزم واجهة برمجة التطبيقات | عدد المعاملات في حزمة (أو عدد مرتبط بسمة مخصّصة، مثل إجمالي عدد وحدات البايت التي تمّ نقلها في حزمة) يمكن تحديد سعر لكل حزمة. ينطبق السعر على الحزمة بأكملها. حدِّد الحدّ الأعلى للحزمة الأولى، مثلاً، حتى 1000 (الحدّ الأدنى مضبوط مسبقًا على قيمة أكبر من 0).
انقر على +جديد لإضافة حِزم إضافية. يجب تحديد حدّ أقصى للحزمة الأخيرة ما لم تكن تريد تحصيل مبلغ ثابت من المطوّر مقابل عدد غير محدود من المعاملات في الحزمة الأخيرة. ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها للسعر الذي يتم تحصيله باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار. على سبيل المثال، إذا حدّدت حزمتَين في قسم "حجم الحزمة" (أكبر من 0 إلى 1000، وأكبر من 1000 إلى 2000)، يمكنك إدخال 50 للحزمة الأكبر من 0 إلى 1000، و40 للحزمة الأكبر من 1000 إلى 2000. إذا كانت العملة المحدّدة هي الدولار الأمريكي، يكون سعر الحزمة الأولى 50 دولارًا أمريكيًا، وسعر الحزمة الثانية 40 دولارًا أمريكيًا. يتم تحصيل سعر الحزمة الساري من المطوّر بغض النظر عن عدد المعاملات التي يستخدمها ضمن الحزمة (أي يتم تحصيل سعر الحزمة من المطوّر فور إكمال المعاملة الأولى في الحزمة). |
إذا حدّدت سمات مخصّصة لمنتج واجهة برمجة التطبيقات، يمكنك ضبط مَعلمة تقييم مخصّصة لتحصيل رسوم من مطوّر التطبيق استنادًا إلى سمة مخصّصة ضمن كل معاملة. على سبيل المثال، إذا أعددت خطة تحصّل فيها رسومًا من المطوّر مقابل كل معاملة، يمكنك تحديد سعر الخطة استنادًا إلى سمة مخصّصة، مثل عدد وحدات البايت التي يتم نقلها في الخلفية والتي يمكن أن تختلف حسب المعاملة.
في هذه الحالة، اختَر استخدام مَعلمة التقييم المخصّصة واختَر السمة المخصّصة من القائمة المنسدلة. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط خطة الأسعار باستخدام سمات مخصّصة.
Classic Edge (Private Cloud)
لضبط خطط بطاقة الأسعار باستخدام واجهة مستخدم Classic Edge، اتّبِع الخطوات التالية:
- اتّبِع الخطوات لإنشاء خطة أسعار.
- اختَر بطاقة الأسعار من القائمة المنسدلة "نوع خطة الأسعار" لإعداد نموذج الأرباح.
- إذا كانت حزمة واجهة برمجة التطبيقات المحدّدة تتضمّن منتجات متعددة من واجهات برمجة التطبيقات، اختَر أحد الخيارات التالية:
ملاحظة: إذا كانت حزمة واجهة برمجة التطبيقات تتضمّن منتجًا واحدًا من واجهات برمجة التطبيقات، يمكنك تخطّي هذه الخطوة.
- خطط خاصة بالمنتجات لضبط تفاصيل خطة الأسعار لكل منتج من منتجات واجهة برمجة التطبيقات على حدة
- خطة عامة لجميع المنتجات لضبط تفاصيل خطة الأسعار لجميع منتجات واجهة برمجة التطبيقات
- انقر على بطاقة الأسعار لخطة الأسعار العامة أو لكل خطة أسعار خاصة بمنتج API.
ملاحظة: عند إعداد خطط خاصة بمنتجات واجهة برمجة التطبيقات، عليك إعداد خطة بطاقة أسعار لكل منتج من منتجات واجهة برمجة التطبيقات على حدة.
تفتح نافذة "قائمة الأسعار".
- إعداد خطة freemium لمنتج API توفّر خطة freemium للمطوّرين استخدامًا مجانيًا لأحد منتجات واجهة برمجة التطبيقات لفترة زمنية محدّدة أو استنادًا إلى مقدار الاستخدام.
أدخل المعلومات التالية:
الحقل الوصف هل المنتج مجاني بميزات محدودة؟ مدى الفترة المجانية انقر على أحد أزرار الاختيار التالية:
- حسب الكمية تستند الفترة المجانية إلى كمية محددة في حقل Volume.
- حسب المدة تستند فترة الرسوم إلى فاصل زمني محدّد في حقل "مدة استخدام Freemium".
- أيهما أقرب. تنتهي الفترة المجانية عند بلوغ الكمية في حقل "الحجم" أو الفاصل الزمني في حقل "مدة Freemium"، أيّهما يحدث أولاً.
- لا، هذه ليست خطة مجانية. هذا هو الخيار التلقائي.
حجم الإصدار المجاني بميزات محدودة عدد المعاملات (أو عدد المعاملات المرتبط بسمة مخصّصة مسجّلة في سياسة تسجيل المعاملات) التي لا يتم تحصيل رسوم من المطوّرين مقابلها. يتم قياس الحجم لمنتج واجهة برمجة التطبيقات. أدخِل رقمًا، مثل 5000. وهذا يعني أنّه عندما يبدأ المطوّرون في استخدام الخطة، لن يتم تحصيل رسوم منهم مقابل أول 5,000 معاملة (أو مقابل أول 5,000 استخدام لعنصر ذي صلة بسمة مخصّصة). لا يتم تفعيل هذا الحقل إلا إذا اخترت "حسب الكمية" أو "أيهما يأتي أولاً" في الحقل "هل المنتج مجاني؟".
مدة الإصدار المجاني بميزات محدودة الفاصل الزمني الذي لا يتم خلاله تحصيل رسوم من المطوّرين أدخِل رقمًا واختَر فترة زمنية، مثل شهر واحد. وهذا يعني أنّه لن يتم تحصيل أي رسوم من المطوّرين لمدة شهر واحد. لا يتم تفعيل هذا الحقل إلا إذا اخترت "حسب المدة" أو "أيهما أقرب" في الحقل "المنتج المجاني المدفوع؟".
- اختَر أحد نماذج الفوترة التالية:
- السعر الثابت في هذا النموذج، يتم تحصيل سعر ثابت من المطوّر مقابل كل معاملة.
- Volume Banded. في هذا النموذج، يتم تحصيل رسوم من المطوّر بمعدّل متغيّر حسب عدد المعاملات.
- الحِزم في هذا النموذج، يتم تحصيل مبلغ محدّد (مسبقًا) من المطوّر مقابل كل حزمة من المعاملات. يتم تحصيل المبلغ المحدّد من المطوّر سواء تم استخدام الحزمة بالكامل أم لا.
بالنسبة إلى نموذج السعر الثابت: أدخِل المعلومات التالية في قسم "الأسعار" ضمن نافذة "قائمة الأسعار العامة":
الحقل الوصف المشغّل (أو المؤسسة) تمثّل هذه السمة اسم المؤسسة. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "المشغّل" (أو "المؤسسة") في الملف التعريفي للمؤسسة.
البلد تمثّل هذه السمة البلد الذي تعمل فيه مؤسستك. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة الحقل "البلد" في الملف الشخصي للمؤسسة.
السعر الثابت: المعدّل الذي يتم تحصيله مقابل كل معاملة. أدخِل رقمًا عشريًا (يمكن أن يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها للسعر الذي يتم تحصيله باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار.
على سبيل المثال، إذا أدخلت 0.10 وكانت العملة هي الدولار الأمريكي، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل كل معاملة (أو إذا كان ذلك استنادًا إلى سمة مخصّصة مثل عدد وحدات البايت التي تم نقلها في المعاملة، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل نقل عدد وحدات البايت المحدّد).
بالنسبة إلى نموذج النطاقات حسب الحجم: تعرض نافذة "بطاقة الأسعار العامة" حقولاً إضافية يمكنك استخدامها لتحديد أساس التجميع وتحديد "النطاقات حسب الحجم"، أي نطاقات حجم المعاملات التي يمكنك تطبيق أسعار مختلفة عليها.
عادةً ما يتم إعداد هذا النوع من الخطط لتشجيع المطوّرين على تحقيق أحجام أكبر من خلال تقديم أسعار مخفَّضة لنطاقات الأحجام الأكبر.
أدخِل المعلومات التالية في نافذة "بطاقة الأسعار العامة":
الحقل الوصف أساس التجميع الفترة الزمنية التي يتم خلالها تجميع عدد المعاملات (أو عدد السمات المخصّصة). يتم استخدام الحجم المجمّع لتحديد فئة الحجم والمعدّل الذي سيتم تطبيقه على كل معاملة. اختَر عدد الأشهر (من شهر واحد إلى 12 شهرًا).
لمعرفة تفاصيل حول وقت إعادة ضبط الحِزم، يُرجى الاطّلاع على متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحِزم؟
نطاقات الحجم نطاق واحد أو أكثر من أحجام المعاملات (أو استنادًا إلى سمات العملاء) (كل نطاق هو "نطاق حجم"). يمكن تحديد سعر لكل فئة من فئات الكمية (يمكنك ضبط هذا السعر في حقل "فئات الكمية" ضمن قسم "الأسعار"). ويتم تطبيق السعر على جميع المعاملات ضمن فئة الحجم المعمول بها. حدِّد الحدّ الأعلى للنطاق الأول، مثلاً، حتى 1000 (الحدّ الأدنى مضبوط مسبقًا على قيمة أكبر من 0). انقر على علامة الجمع (+) لإضافة نطاق ثانٍ، مثلاً، أكبر من 1000 وحتى 2000. انقر على علامة الجمع لإضافة المزيد من النطاقات. يمكنك ترك الحد الأعلى للنطاق الأخير فارغًا للإشارة إلى جميع المعاملات التي تتجاوز هذا المستوى.
الأسعار المشغّل (أو المؤسسة) تمثّل هذه السمة اسم المؤسسة. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "المشغّل" (أو المؤسسة) في ملف المؤسسة.
البلد تمثّل هذه السمة البلد الذي تعمل فيه مؤسستك. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة الحقل "البلد" في "الملف التعريفي للمؤسسة".
العملة العملة "الأساسية" أو عملة المحاسبة التي تستخدمها مؤسستك يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "العملة" في "الملف الشخصي للمؤسسة"، ولكن يمكن تغييره هنا.
نطاقات الحجم معدّل نطاق الحجم تحدّد معدّلًا لكل نطاق حجم. أدخِل رقمًا عشريًا لكل نطاق (يمكن أن يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها لمعدّل نطاق الصوت باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار.
على سبيل المثال، إذا حدّدت نطاقَي مستوى صوت في قسم "نطاق مستوى الصوت" (>0-1000 و1000 وما فوق)، يمكنك إدخال 0.15 لنطاق مستوى الصوت >0-1000 و0.10 لنطاق مستوى الصوت 1000 وما فوق. إذا كانت العملة المحدّدة هي الدولار الأمريكي، يكون سعر المعاملات الألف الأولى هو 0.15 دولار أمريكي لكل معاملة، ويكون سعر المعاملات التي تزيد عن 1000 معاملة هو 0.10 دولار أمريكي لكل معاملة.
بالنسبة إلى النموذج المجمّع: تعرض نافذة "بطاقة الأسعار العامة" حقولاً إضافية تستخدمها لتحديد أساس التجميع (الفترة الزمنية التي يمكن للمطوّر استخدام حزمة المعاملات فيها) ولتحديد المعلومات ذات الصلة بالحزمة، مثل حجم الحزمة.
أدخِل المعلومات التالية في نافذة "بطاقة الأسعار العامة":
الحقل الوصف أساس التجميع الفترة الزمنية التي يمكن للمطوّر خلالها استخدام حِزمة المعاملات (أو استخدام حِزمة مخصّصة مستندة إلى السمات). اختَر عدد الأشهر (من شهر واحد إلى 12 شهرًا). وبعد انتهاء هذه الفترة، تنتهي صلاحية الخطة ويجب على المطوّر شراء الخطة (والحِزم) مرة أخرى.
لمعرفة تفاصيل حول وقت إعادة ضبط الحِزم، يُرجى الاطّلاع على متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحِزم؟
حجم الحزمة عدد المعاملات في حزمة (أو رقم ذو صلة بسمة مخصّصة، مثل إجمالي عدد وحدات البايت التي تم إرسالها في حزمة) يمكن تحديد سعر لكل حزمة (يمكنك ضبط هذا السعر في حقل "حجم الحزمة" ضمن قسم "الأسعار"). وينطبق السعر على الحزمة بأكملها. حدِّد الحدّ الأعلى للحزمة الأولى، مثلاً، حتى 1000 (الحدّ الأدنى مضبوط مسبقًا على قيمة أكبر من 0). انقر على علامة الجمع (+) لإضافة حزمة ثانية، مثلاً، أكبر من 1000 وحتى 2000. انقر على علامة الجمع لإضافة المزيد من الحِزم. يجب تحديد حد أقصى للحزمة الأخيرة، إلا إذا كنت تريد تحصيل مبلغ ثابت من المطوّر مقابل عدد غير محدود من المعاملات في الحزمة الأخيرة.
الأسعار المشغّل (أو المؤسسة) تمثّل هذه السمة اسم المؤسسة. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "المشغّل" (أو المؤسسة) في ملف المؤسسة.
البلد تمثّل هذه السمة البلد الذي تعمل فيه مؤسستك. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة الحقل "البلد" في "الملف التعريفي للمؤسسة".
العملة العملة "الأساسية" أو عملة المحاسبة التي تستخدمها مؤسستك يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "العملة" في "الملف الشخصي للمؤسسة"، ولكن يمكن تغييره هنا.
حجم الحزمة (السعر) تمثّل هذه السمة سعر الحزمة. عليك تحديد سعر لكل حزمة. أدخِل رقمًا عشريًا (يمكن أن يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها لسعر الحزمة باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار.
على سبيل المثال، إذا حدّدت حزمتَين في قسم "حجم الحزمة" (أكبر من 0 وحتى 1000، وأكبر من 1000 وحتى 2000)، يمكنك إدخال 50 للحزمة الأكبر من 0 وحتى 1000، و40 للحزمة الأكبر من 1000 وحتى 2000. إذا كانت العملة المحدّدة هي الدولار الأمريكي، يكون سعر الحزمة الأولى 50 دولارًا أمريكيًا، وسعر الحزمة الثانية 40 دولارًا أمريكيًا. يتم تحصيل سعر الحزمة الساري من المطوّر بغض النظر عن عدد المعاملات التي يستخدمها ضمن الحزمة (أي يتم تحصيل سعر الحزمة من المطوّر بمجرد إكمال المعاملة الأولى في الحزمة).
- انقر على تطبيق وإغلاق لحفظ تفاصيل قائمة الأسعار والعودة إلى نافذة "خطة الأسعار العادية".
- بالنسبة إلى خطط الأسعار الخاصة بمنتجات واجهة برمجة التطبيقات، اضبط تفاصيل خطة الأسعار لمنتجات واجهة برمجة التطبيقات الإضافية، حسب الحاجة.
ضبط خطة قائمة الأسعار باستخدام واجهة برمجة التطبيقات
اضبط تفاصيل خطة قائمة الأسعار باستخدام واجهة برمجة التطبيقات، كما هو موضّح في الأقسام التالية.
تحديد تفاصيل خطة قائمة الأسعار باستخدام واجهة برمجة التطبيقات
عليك تحديد تفاصيل خطة بطاقة الأسعار عند إنشاء خطة الأسعار. يمكنك تحديد التفاصيل في السمة ratePlanDetails ضمن نص الطلب في مكالمة إلى /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. يعتمد ما تحدّده في السمة ratePlanDetails على نموذج الأسعار الذي تختاره: السعر الثابت أو السعر المتغيّر حسب الكمية أو الحِزم.
تحديد نموذج شحن بسعر ثابت
لتنفيذ نموذج فرض الرسوم الثابتة، عليك تحديد ما يلي في تفاصيل خطة الأسعار:
- مَعلمة تقييم تشير إلى أنّ خطة الأسعار تستند إلى المعاملات
(
VOLUME) أو إلى سمة مخصّصة (على سبيل المثال،MINT_CUSTOM_ATTRIBUTE_1).VOLUMEهي القيمة التلقائية. - نوع قياس الاستخدام (
UNIT) يشير إلى أنّ السعر ثابت لكل وحدة (أي أنّه لا يستند إلى عدد المعاملات، كما هو الحال في نموذج التسعير حسب عدد المعاملات أو الحِزم). - فترة استحقاق الدفع (على سبيل المثال، 30 يومًا)
- رقم تعريف مؤسستك
- العملة "الأساسية" أو عملة المحاسبة التي تستخدمها شركتك
- سعر خطة الأسعار الذي يقدّم تفاصيل حول كيفية احتساب السعر بما أنّ نموذج تحصيل الرسوم يستند إلى سعر ثابت، عليك تحديد سعر واحد فقط لخطة الأسعار.
في سعر خطة الأسعار، عليك تحديد ما يلي:
- تمثّل هذه السمة نوع سعر خطة الأسعار (
RATECARD). - سعر الخطة على سبيل المثال، إذا حدّدت القيمة 0.10 وكانت العملة هي الدولار الأمريكي، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل كل معاملة (أو إذا كان ذلك استنادًا إلى سمة مخصّصة مثل عدد وحدات البايت التي تم نقلها في المعاملة، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل نقل عدد وحدات البايت المحدّد).
- وحدة البدء لتطبيق السعر (
0)، ما يعني أنّه يتم تطبيق السعر على كل معاملة، بدءًا من المعاملة الأولى.
راجِع إعدادات ضبط تفاصيل خطة الأسعار للاطّلاع على قائمة كاملة بخيارات تفاصيل خطة الأسعار.
على سبيل المثال، ينشئ ما يلي خطة بطاقة أسعار بنموذج شحن ثابت. يتم تحديد المعدّل عند 0.10 دولار أمريكي لكل معاملة. يجب دفع الفاتورة في غضون 30 يومًا. (يتم تمييز التفاصيل المرتبطة ببطاقة السعر).
curl -H "Content-Type:application/json" -X POST -d \
'{
"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": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
تحديد نموذج شحن حسب حجم الاستخدام
في نموذج النطاقات حسب الحجم، يمكنك تحديد تفاصيل خطة الأسعار التي تتضمّن سعرًا واحدًا أو أكثر من أسعار خطة الأسعار، وينطبق كل سعر على "نطاق حسب الحجم"، أي نطاق حجم المعاملات (أو نطاق استنادًا إلى سمة مخصّصة مثل عدد وحدات البايت المنقولة). يتم عادةً إعداد هذا النوع من الخطط لتشجيع المطوّرين على تحقيق أحجام أكبر من خلال تقديم أسعار مخفَّضة لنطاقات الأحجام الأكبر.
بالإضافة إلى أسعار خطة الأسعار، يمكنك تحديد ما يلي في تفاصيل خطة الأسعار:
- مَعلمة تقييم تشير إلى أنّ خطة الأسعار تستند إلى المعاملات
(
VOLUME) أو إلى سمة مخصّصة (على سبيل المثال،CUSTOM_ATTRIBUTE_1).VOLUMEهي القيمة التلقائية. - نوع قياس (
VOLUME) يشير إلى أنّ السعر يستند إلى عدد المعاملات (أي أنّه ليس سعرًا ثابتًا لكل معاملة، كما هو الحال في نموذج التسعير بالسعر الثابت). - فترة استحقاق الدفع (على سبيل المثال، 30 يومًا)
- رقم تعريف مؤسستك
- العملة "الأساسية" أو عملة المحاسبة التي تستخدمها شركتك
- مدة ونوع مدة يحدّدان معًا الفترة الزمنية التي يتم خلالها تجميع عدد المعاملات (أو عدد المعاملات المرتبط بالسمة المخصّصة). ويُطلق على ذلك أيضًا اسم "أساس التجميع". يتم تجميع عدد المعاملات على أساس التجميع (على سبيل المثال، شهر واحد) لتحديد فئة عدد المعاملات السارية.
- عدادات التجميع المستخدَمة لتحديد نطاق الحجم الساري
بالنسبة إلى كل سعر في خطة الأسعار، عليك تحديد ما يلي:
- تمثّل هذه السمة نوع سعر خطة الأسعار (
RATECARD). - سعر الخطة على سبيل المثال، إذا حدّدت القيمة 0.10 وكانت العملة هي الدولار الأمريكي، سيتم تحصيل 0.15 دولار أمريكي من المطوّر مقابل كل معاملة (أو إذا كان ذلك استنادًا إلى سمة مخصّصة، مثل عدد وحدات البايت التي تم نقلها في المعاملة، سيتم تحصيل 0.15 دولار أمريكي من المطوّر مقابل نقل عدد وحدات البايت المحدّد).
- وحدة نطاق مستوى الصوت التي تبدأ بها وتنتهي عندها تحدّد وحدة البداية الحد الأدنى لنطاق مستوى الصوت، وتحدّد وحدة النهاية الحد الأقصى لنطاق مستوى الصوت. على سبيل المثال، إذا حدّدت وحدة بدء بقيمة 0 ووحدة انتهاء بقيمة 1000، سيشمل نطاق الحجم ما يصل إلى 1000 معاملة في فترة التجميع. إذا كانت العملة هي الدولار الأمريكي وكانت فترة التجميع شهرًا واحدًا، وكان معدّل الرسوم على أول 1, 000 معاملة هو 0.15، سيتم تحصيل 0.15 دولار أمريكي من المطوّر لكل معاملة تصل إلى 1, 000 معاملة في الشهر.
للاطّلاع على تفاصيل حول وقت إعادة ضبط الحِزم، يُرجى الاطّلاع على متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحِزم؟
في حال عدم تحديد وحدة نهائية لنطاق الحجم النهائي، يتم تطبيق السعر الخاص بهذا النطاق على جميع المعاملات بعد أن يتجاوز عدد المعاملات الوحدة الأولية لهذا النطاق. على سبيل المثال، إذا كانت الوحدة الأولى في النطاق الأخير هي 1000، ولم تحدّد وحدة أخيرة لهذا النطاق، سيتم تطبيق السعر على جميع المعاملات بعد 1000 معاملة في فترة التجميع.
راجِع إعدادات ضبط تفاصيل خطة الأسعار للاطّلاع على قائمة كاملة بخيارات تفاصيل خطة الأسعار.
على سبيل المثال، ينشئ ما يلي خطة بطاقة أسعار مع نموذج فوترة مستند إلى نطاقات الكمية. يتم تحديد السعر عند 0.15 دولار أمريكي لأول 1,000 معاملة، و0.10 دولار أمريكي لجميع المعاملات التي تزيد عن 1,000 معاملة. أساس التجميع هو شهر واحد. يجب دفع الفاتورة في غضون 30 يومًا. (يتم تمييز تفاصيل بطاقة السعر).
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Volume banded rate card plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Volume banded rate card plan",
"displayName" : "Volume banded 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"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "VOLUME",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.15",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "1000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
تحديد نموذج شحن مجمَّع
في نموذج الفوترة المجمّعة، يدفع المطوِّر (مسبقًا) مقابل "حزمة" من المعاملات (أو مقابل حزمة استنادًا إلى سمة مخصّصة، مثل عدد وحدات البايت التي تم نقلها). عليك تحديد سعر لكل حزمة وأسس تجميع، أي فترة زمنية يمكن للمطوّر استخدام الحزمة خلالها.
على سبيل المثال، لنفترض أنّك أعددت حزمتَين، حيث يكون حجم الحزمة الأولى من معاملة واحدة إلى 1000 معاملة، ويكون حجم الحزمة الثانية من 1001 معاملة إلى 2000 معاملة. يبلغ السعر 50 دولارًا أمريكيًا للحزمة الأولى و40 دولارًا أمريكيًا للحزمة الثانية، وأساس التجميع هو 1. إذا اشترى المطوِّر خطة بطاقة أسعار للحزمة الأولى، سيدفع 50 دولارًا أمريكيًا (مسبقًا) مقابل 1, 000 معاملة في الشهر. يتم تحصيل المبلغ المحدّد من المطوّر سواء تم استخدام الحزمة بالكامل أم لا. بعد انتهاء فترة التجميع، تنتهي صلاحية الخطة. إذا أراد المطوّر استخدام الحزمة مرة أخرى، عليه شراء الخطة (والحزمة) مجددًا.
إنّ ما تحدّده في تفاصيل خطة الأسعار هو نفسه ما تحدّده في تفاصيل خطة الأسعار الخاصة بنموذج التسعير المستند إلى النطاقات. في ما يلي أوجه الاختلاف:
- كل خطة أسعار تحدّدها تكون لحزمة (بدلاً من نطاق حجم).
- يجب تحديد حد أقصى للحزمة الأخيرة، إلا إذا كنت تريد تحصيل مبلغ ثابت من المطوّر مقابل عدد غير محدود من المعاملات في الحزمة الأخيرة.
راجِع إعدادات ضبط تفاصيل خطة الأسعار للاطّلاع على قائمة كاملة بخيارات تفاصيل خطة الأسعار.
على سبيل المثال، ينشئ ما يلي خطة بطاقة أسعار مع نموذج فوترة مجمّع. يتم تحديد السعر بمبلغ 50 دولارًا أمريكيًا للحزمة الأولى (ما يصل إلى 1,000 معاملة)، و40 دولارًا أمريكيًا للحزمة الثانية (أكثر من 1,000 معاملة وما يصل إلى 2,000 معاملة). أساس التجميع هو شهر واحد. تستحق الدفعة بعد 30 يومًا.
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Bundled rate plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Bundled rate plan",
"displayName" : "Bundled rate plan",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "true",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "STAIR_STEP",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "50",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "40",
"startUnit": "1000",
"endUnit": "2000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
تحديد خطة freemium للمنتجات الفردية باستخدام واجهة برمجة التطبيقات
في خطة قائمة الأسعار، يمكنك إعداد خطة freemium لمنتج فردي (بدلاً من حزمة واجهة برمجة تطبيقات). توفّر خطة freemium للمطوّرين استخدامًا مجانيًا لأحد منتجات واجهة برمجة التطبيقات لفترة زمنية محدّدة أو استنادًا إلى مقدار الاستخدام.
عند إعداد خطة freemium لمنتج API، عليك تحديد الفترة التي يمكن للمطوّر خلالها استخدام الموارد التي يوفّرها منتج API بدون أي تكلفة، وذلك في تفاصيل خطة قائمة الأسعار. يمكن أن تستند الفترة إلى أحد ما يلي:
- المدة، أي الفترة الزمنية بين تاريخ السريان وتاريخ الانتهاء
- الكمية، مثل عدد المعاملات التي تتضمّن منتج واجهة برمجة التطبيقات أو الحجم المتعلّق بسمة مخصّصة مسجّلة في سياسة تسجيل المعاملات
إذا كانت فترة الاستخدام المجاني تستند إلى الكمية، حدِّدها على أنّها عدد وحدات الاستخدام المجاني. على سبيل المثال، ينشئ ما يلي خطة بطاقة أسعار مع خطة freemium استنادًا إلى حجم يبلغ 5000 وحدة (تم تمييز المواصفات ذات الصلة بخطة freemium).
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan with freemium period",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan with freemium period",
"displayName" : "Flat rate card plan with freemium period",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "myorg"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "false",
"ratePlanDetails": [
{
"currency": {
"aggregateFreemiumCounters" : true,
"aggregateStandardCounters" : true,
"id" : "usd"
},
"product" : {
"id" : "location",
"displayName":"Location"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"freemiumUnit": "5000",
"freemiumDuration": "0",
"freemiumDurationType": "DAY",
"ratingParameterUnit":"MB",
"customPaymentTerm": "false",
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password