ضبط خطة بطاقة السعر

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

مقدمة

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

يمكنك اختياريًا تحديد خطة مجانية للمنتجات الفردية (بدلاً من حزمة واجهة برمجة التطبيقات)، ولا يمكنك إجراء ذلك إلا لخطة خاصة بمنتج معيّن.

متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحِزم؟

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

إذا كانت الخطة تتضمّن...	...يحدث هذا
رسوم متكرّرة غير صفرية تم ضبطها على الشهر خطة حزمة أو خطة متوفّرة بحجم محدد	تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة في اليوم الأول من الشهر (الإعداد التلقائي). لتكرار شهري في يوم محدّد، أنشئ خطة أسعار باستخدام واجهة برمجة التطبيقات لإدارة الغرف، وأشِر إلى اليوم باستخدام السمة RecurringStartUnit، كما هو موضّح في مقالة إنشاء خطط أسعار باستخدام واجهة برمجة التطبيقات.
رسوم متكررة غير صفرية تم ضبطها على الأسبوع خطة حزمة أو خطة متوفّرة بحجم محدد	تتم إعادة ضبط الرسوم المتكرّرة وخطة الحزمة كل 7 أيام بعد تاريخ بدء خطة السعر لدى المطوّر.
تم ضبط رسوم متكررة غير صفرية على يوم. خطة حزمة أو خطة متوفّرة بحجم محدد	يتم تحصيل الرسوم المتكرّرة وخطة الحزمة من جديد كل X يوم بعد تاريخ بدء خطة الأسعار الخاصة بالمطوِّر.
عدم تحصيل رسوم متكررة (أو تحصيل رسوم صفرية) خطة حزمة أو خطة متوفّرة بحجم محدد	تتم إعادة ضبط خطط الحِزم استنادًا إلى "أساس التجميع" المحدّد في بطاقة الأسعار. على سبيل المثال، إذا بدأ المطوّر خطة أسعار في اليوم التاسع عشر من الشهر، وكان أساس التجميع كل شهر، تتم إعادة ضبط استخدام الحزمة في اليوم التاسع عشر من كل شهر. يُرجى العِلم أنّ أيام الشهر قد لا تكون هي نفسها دائمًا. على سبيل المثال، إذا كانت خطة الأسعار تبدأ في 31 كانون الأول (ديسمبر)، يصبح تاريخ إعادة الضبط هو 28 في شباط (فبراير) غير القابل للقسمة على 4، لأنّه لا يتضمّن سوى 28 يومًا. ويصبح يوم 28 هو يوم إعادة الضبط من الآن فصاعدًا.

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

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

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

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

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

وتحدِّد تفاصيل خطة بطاقة الأسعار عند إنشاء خطة الأسعار. يمكنك تحديد التفاصيل في السمة 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, 000 معاملة، وحجم الحزمة الثانية من 1, 001 معاملة إلى 2, 000 معاملة. يبلغ السعر 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

تحديد خطة التطبيقات المجانية المحدودة لمنتجات فردية باستخدام واجهة برمجة التطبيقات

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

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

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

إذا كانت فترة التطبيقات المجانية المحدودة تستند إلى الكمية، حدِّدها كعدد من وحدات التطبيقات المجانية المحدودة. على سبيل المثال، يؤدي ما يلي إلى إنشاء خطة بطاقة أسعار مع خطة التطبيقات المجانية المحدودة استنادًا إلى حجم 5, 000 وحدة (مع إبراز المواصفات المتعلّقة بالتطبيقات المجانية المحدودة).

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