أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
مقدمة
في خطة قائمة الأسعار، يتم تحصيل رسوم من المطوّر مقابل كل معاملة. بالنسبة إلى هذا النوع من الخطط، عليك تقديم تفاصيل إضافية، مثل نموذج الشحن والتسعير الخاص به.
يمكنك اختياريًا تحديد خطة freemium للمنتجات الفردية (بدلاً من حزمة API)، ولا يمكنك إجراء ذلك إلا لخطة خاصة بمنتج معيّن.
متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحزمة؟
يمكن أن تتضمّن خطط الأسعار رسومًا متكرّرة بالإضافة إلى حِزم واجهات برمجة التطبيقات (خطط الحِزم والكميات)، ويشمل كلّ منهما أوقاتًا محدّدة يتم فيها تحصيل الرسوم وإعادة ضبط خطط الحِزم إلى الصفر. يوضّح الجدول التالي الحالات التي يتم فيها تحصيل الرسوم المتكرّرة وإعادة ضبط عدد الحِزم. إذا تم حظر تطبيقات المطوّرين من إجراء المزيد من طلبات البيانات من واجهة برمجة التطبيقات لأنّها بلغت حد المعاملة، إليك الأوقات التي تتم فيها إعادة ضبط عدد طلبات البيانات من واجهة برمجة التطبيقات إلى صفر ويمكن للتطبيقات البدء في إجراء الطلبات مرة أخرى.
| إذا كانت الخطة تتضمّن... | ...يحدث ذلك |
|---|---|
|
تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة في اليوم الأول من الشهر (الإعداد التلقائي). لإنشاء تكرار شهري في يوم محدّد، أنشئ خطة أسعار باستخدام واجهة برمجة التطبيقات الخاصة بالإدارة وأدخِل اليوم باستخدام السمة |
|
يتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة كل 7 أيام بعد تاريخ بدء خطة الأسعار الخاصة بالمطوّر. |
|
تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة كل X يوم بعد تاريخ بدء خطة الأسعار الخاصة بالمطوّر. |
|
تتم إعادة ضبط خطط الحِزم استنادًا إلى "أساس التجميع" المحدّد في قائمة الأسعار. على سبيل المثال، إذا بدأ المطوّر خطة أسعار في اليوم 19 من الشهر، وكان أساس التجميع كل شهر واحد، تتم إعادة ضبط استخدام الحزمة كل شهر في اليوم 19. يُرجى العِلم أنّ يوم الشهر قد لا يكون هو نفسه دائمًا. على سبيل المثال، إذا بدأت خطة أسعار في 31 ديسمبر، يصبح تاريخ إعادة الضبط هو 28 فبراير في سنة غير كبيسة، لأنّ شهر فبراير يتضمّن 28 يومًا فقط. وسيظل يوم 28 هو يوم إعادة الضبط بعد ذلك. |
ضبط خطط بطاقة السعر باستخدام واجهة المستخدم
اضبط خطط قائمة الأسعار على النحو الموضّح أدناه.
Edge
لإعداد خطة بطاقة الأسعار، عند إنشاء أو تعديل خطة أسعار، اختَر نوع خطة الأسعار بطاقة الأسعار أو بطاقة الأسعار ومشاركة الأرباح، وفي قسم بطاقة الأسعار، اختَر أحد نماذج الفوترة التالية:
| نموذج الشحن | الوصف |
| السعر الثابت: | يتم تحصيل سعر ثابت من المطوّر مقابل كل معاملة. |
| مستويات الصوت المحدّدة | يتم تحصيل رسوم متغيرة من المطوّر حسب عدد المعاملات. |
| Bundles | يتم تحصيل مبلغ محدّد مسبقًا من المطوّر مقابل كل حزمة من المعاملات. يتم تحصيل المبلغ المحدّد من المطوِّر سواء تم استخدام الحزمة بالكامل أم لا.
ملاحظة: لا يتوفّر هذا الخيار عند اختيار "بطاقة الأسعار" و"مشاركة الأرباح". |
بعد ذلك، اضبط المعلومات التالية استنادًا إلى نموذج الفوترة الذي اخترته.
| نموذج الشحن | الحقل | الوصف |
| الكل | معدّل تكرار الاحتساب | الفترة الزمنية التي يتم احتساب عدد المعاملات (أو عدد العناصر المرتبطة بالسمة المخصّصة) خلالها. اختَر عددًا من الأشهر (من شهر واحد إلى 24 شهرًا). |
| السعر الثابت: | السعر الثابت | المعدّل الذي يتم تحصيله لكل معاملة أدخِل رقمًا عشريًا (يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها للسعر الذي يتم تحصيله باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطط الأسعار. على سبيل المثال، إذا أدخلت القيمة 0.10 وكانت العملة هي الدولار الأمريكي، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل كل معاملة (أو إذا كان ذلك استنادًا إلى سمة مخصّصة مثل عدد وحدات البايت التي تم نقلها في المعاملة، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل نقل عدد وحدات البايت المحدّد). |
| مستويات الصوت المحدّدة | نطاقات الحجم | نطاق واحد أو أكثر من نطاقات حجم المعاملات (أو حجم المعاملات المستند إلى سمات العملاء) (كل نطاق هو "نطاق حجم") لنموذج فرض الرسوم المستند إلى نطاقات الحجم يمكن تحديد سعر لكل نطاق حجم. يتم تطبيق السعر على جميع المعاملات في فئة الحجم السارية. حدِّد الحدّ الأعلى للنطاق الأول، مثلاً حتى 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 (السحابة الإلكترونية الخاصة)
لضبط خطط بطاقة الأسعار باستخدام واجهة مستخدم Classic Edge، اتّبِع الخطوات التالية:
- اتّبِع الخطوات اللازمة لإنشاء خطة أسعار.
- انقر على بطاقة الأسعار في القائمة المنسدلة "نوع خطة الأسعار" من أجل ضبط نموذج الأرباح.
- إذا كانت حزمة واجهات برمجة التطبيقات المحدّدة تتضمّن منتجات متعددة من واجهات برمجة التطبيقات، اختَر أحد الخيارات التالية:
ملاحظة: إذا كانت حزمة واجهة برمجة التطبيقات تتضمّن منتجًا واحدًا من واجهة برمجة التطبيقات، يمكنك تخطّي هذه الخطوة.
- خطط خاصة بالمنتج لإعداد تفاصيل خطة الأسعار لكل منتج من منتجات واجهة برمجة التطبيقات على حدة
- خطة عامة لجميع المنتجات لضبط تفاصيل خطة الأسعار لجميع منتجات واجهة برمجة التطبيقات
- انقر على بطاقة الأسعار لخطة الأسعار العامة أو لكل خطة أسعار خاصة بمنتج API.
ملاحظة: عند إعداد خطط خاصة بمنتجات واجهة برمجة التطبيقات، عليك إعداد خطة بطاقة أسعار لكل منتج من منتجات واجهة برمجة التطبيقات على حدة.
يتم فتح نافذة "بطاقة الأسعار".
- إعداد خطة freemium لمنتج API توفّر خطة Freemium للمطوّرين استخدامًا مجانيًا لأحد منتجات واجهة برمجة التطبيقات لفترة زمنية معيّنة أو استنادًا إلى مقدار الاستخدام.
أدخل المعلومات التالية:
الحقل الوصف هل المنتج مجاني بميزات محدودة؟ مدى الفترة المجانية اختَر أحد أزرار الاختيار التالية:
- حسب الكمية تستند الفترة المجانية إلى كمية محدّدة في الحقل Volume.
- حسب المدة تستند فترة الرسوم إلى فاصل زمني محدّد في حقل Freemium Duration.
- أيهما يحدث أولاً. تنتهي الفترة المجانية عند بلوغ الكمية في حقل "الحجم" أو الفاصل الزمني في حقل "مدة Freemium"، أيهما يحدث أولاً.
- لا، هذه ليست خطة مجانية. هذا هو الخيار التلقائي.
حجم الإصدار المجاني بميزات محدودة عدد المعاملات (أو عدد المعاملات المرتبطة بسمة مخصّصة مسجّلة في سياسة تسجيل المعاملات) التي لا يتم تحصيل رسوم من المطوّرين مقابلها. يتم قياس الحجم لمنتج واجهة برمجة التطبيقات. أدخِل رقمًا، مثل 5000. وهذا يعني أنّه عندما يبدأ المطوّرون استخدام الخطة، لن يتم تحصيل رسوم منهم مقابل أول 5,000 معاملة (أو مقابل أول 5,000 استخدام لعنصر ذي صلة بسمة مخصّصة). لا يتم تفعيل هذا الحقل إلا إذا اخترت "حسب الكمية" أو "أيهما أقرب" في الحقل "هل المنتج مجاني؟".
مدة الإصدار المجاني بميزات محدودة الفاصل الزمني الذي لا يتم خلاله تحصيل رسوم من المطوّرين أدخِل رقمًا واختَر فترة زمنية، مثل شهر واحد. وهذا يعني أنّه لن يتم تحصيل رسوم من المطوّرين لمدة شهر واحد. لا يتم تفعيل هذا الحقل إلا إذا اخترت "حسب المدة" أو "أيهما أقرب" في الحقل "المنتج المجاني المدفوع؟".
- اختَر أحد نماذج الفوترة التالية:
- السعر الثابت في هذا النموذج، يتم تحصيل سعر ثابت من المطوّر مقابل كل معاملة.
- Volume Banded. في هذا النموذج، يتم تحصيل رسوم من المطوّر بمعدّل متغيّر حسب عدد المعاملات.
- الحِزم في هذا النموذج، يتم تحصيل مبلغ محدّد (مسبقًا) من المطوّر مقابل كل حزمة من المعاملات. يتم تحصيل المبلغ المحدّد من المطوِّر سواء تم استخدام الحزمة بالكامل أم لا.
بالنسبة إلى نموذج السعر الثابت: أدخِل المعلومات التالية في قسم "الأسعار" ضمن نافذة "قائمة الأسعار العامة" (Generic Rate Card):
الحقل الوصف المشغّل (أو المؤسسة) تمثّل هذه السمة اسم المؤسسة. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "المشغّل" (أو "المؤسسة") في الملف الشخصي للمؤسسة.
البلد تمثّل هذه السمة البلد الذي تنفّذ فيه مؤسستك مشروعها. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة الحقل "البلد" في الملف الشخصي للمؤسسة.
السعر الثابت: المعدّل الذي يتم تحصيله مقابل كل معاملة أدخِل رقمًا عشريًا (يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها للسعر الذي يتم تحصيله باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار.
على سبيل المثال، إذا أدخلت القيمة 0.10 وكانت العملة هي الدولار الأمريكي، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل كل معاملة (أو إذا كان ذلك استنادًا إلى سمة مخصّصة، مثل عدد وحدات البايت التي تم نقلها في المعاملة، سيتم تحصيل 0.10 دولار أمريكي من المطوِّر مقابل نقل عدد وحدات البايت المحدّد).
بالنسبة إلى نموذج النطاقات حسب الحجم: تعرض نافذة "بطاقة الأسعار العامة" حقولاً إضافية يمكنك استخدامها لتحديد أساس التجميع وتحديد "النطاقات حسب الحجم"، أي نطاقات حجم المعاملات التي يمكنك تطبيق أسعار مختلفة عليها.
عادةً ما يتم إعداد هذا النوع من الخطط لتشجيع المطوّرين على تحقيق أحجام أكبر من خلال تقديم أسعار مخفَّضة لنطاقات الأحجام الأكبر.
أدخِل المعلومات التالية في نافذة "بطاقة الأسعار العامة":
الحقل الوصف أساس التجميع هي الفترة الزمنية التي يتم خلالها تجميع عدد المعاملات (أو عدد المعاملات المرتبط بالسمة المخصّصة). يتم استخدام الحجم المجمّع لتحديد فئة الحجم والمعدّل الذي سيتم تطبيقه على كل معاملة. اختَر عدد الأشهر (من شهر واحد إلى 12 شهرًا).
للاطّلاع على تفاصيل حول وقت إعادة ضبط الحِزم، يُرجى الاطّلاع على متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحِزم؟
نطاقات مستوى الصوت نطاق واحد أو أكثر من أحجام المعاملات (أو استنادًا إلى سمات العملاء) (كل نطاق هو "نطاق حجم"). يمكن تحديد سعر لكل فئة من فئات الكمية (يمكنك ضبط هذا السعر في حقل "فئات الكمية" ضمن قسم "الأسعار"). ويتم تطبيق السعر على جميع المعاملات في فئة الحجم السارية. حدِّد الحدّ الأعلى للنطاق الأول، مثلاً حتى 1000 (الحدّ الأدنى مضبوط مسبقًا على قيمة أكبر من 0). انقر على + لإضافة نطاق ثانٍ، مثلاً، أكبر من 1000 وحتى 2000. انقر على علامة الجمع (+) لإضافة المزيد من النطاقات. يمكنك ترك الحدّ الأعلى للنطاق الأخير فارغًا للإشارة إلى جميع المعاملات التي تتجاوز هذا المستوى.
الأسعار المشغّل (أو المؤسسة) تمثّل هذه السمة اسم المؤسسة. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة الحقل "المشغّل" (أو المؤسسة) في ملف المؤسسة.
البلد تمثّل هذه السمة البلد الذي تنفّذ فيه مؤسستك مشروعها. يتم ضبط هذا الحقل مسبقًا باستخدام قيمة الحقل "البلد" في ملف المؤسسة.
العملة العملة "الأساسية" أو عملة المحاسبة التي تستخدمها مؤسستك يتم ضبط هذا الحقل مسبقًا باستخدام قيمة حقل "العملة" في "الملف التعريفي للمؤسسة"، ولكن يمكن تغييره هنا.
نطاقات الحجم معدّل نطاق الحجم تحدّد معدّلًا لكل نطاق حجم. أدخِل رقمًا عشريًا لكل نطاق (يمكن أن يتضمّن ما يصل إلى أربع خانات عشرية).
ملاحظة: يمكنك ضبط عدد المنازل العشرية التي يمكن تحديدها لمعدّل نطاق مستوى الصوت باستخدام واجهة برمجة التطبيقات (وليس واجهة المستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على ضبط عدد المنازل العشرية لأسعار خطة الأسعار.
على سبيل المثال، إذا حدّدت نطاقَي مستوى صوت في قسم "نطاق مستوى الصوت" (>0-1000 و1000 وما فوق)، يمكنك إدخال 0.15 لنطاق مستوى الصوت >0-1000 و0.10 لنطاق مستوى الصوت 1000 وما فوق. إذا كانت العملة المحدّدة هي الدولار الأمريكي، يكون سعر أول 1,000 معاملة هو 0.15 دولار أمريكي لكل معاملة، ويكون سعر أكثر من 1,000 معاملة هو 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
تحديد نموذج شحن مجمَّع
في نموذج الفوترة المجمّعة، يدفع المطوِّر (مسبقًا) مقابل "حزمة" من المعاملات (أو مقابل حزمة استنادًا إلى سمة مخصّصة، مثل عدد وحدات البايت التي تم نقلها). تحدّد معدّلًا لكل حزمة وأسس تجميع، أي فترة زمنية يمكن للمطوّر استخدام الحزمة خلالها.
على سبيل المثال، لنفترض أنّك أعددت حزمتَين، حيث يكون حجم الحزمة الأولى من 1 إلى 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 لمنتج 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