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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

مقدمة

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

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

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

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

إذا كانت الخطة تحتوي على...	...يحدث هذا
تم ضبط رسوم متكرّرة بقيمة غير صفرية على الشهر. خطة حزمة أو نطاق وحدات تخزين	يتم تطبيق الرسوم المتكررة وإعادة ضبط خطة الحزمة في اليوم الأول من الشهر (الإعداد التلقائي). بالنسبة إلى التكرار الشهري في يوم محدّد، أنشِئ خطة أسعار باستخدام واجهة برمجة تطبيقات الإدارة وأشِر إلى اليوم باستخدام السمة RecurringStartUnit، على النحو الموضّح في إنشاء خطط أسعار باستخدام واجهة برمجة التطبيقات.
تم ضبط رسوم متكرّرة بقيمة غير صفرية على الأسبوع. خطة حزمة أو نطاق وحدات تخزين	يتم تحصيل الرسوم المتكررة وإعادة ضبط خطة الحزمة كل 7 أيام بعد تاريخ بدء خطة السعر للمطوِّر.
تم ضبط رسوم متكرّرة بقيمة غير صفرية على Day. خطة حزمة أو نطاق وحدات تخزين	يتم إعادة ضبط الرسوم المتكررة وخطة الحزمة كل X أيام بعد تاريخ بدء خطة السعر التي حدّدها المطوّر.
لا رسوم متكررة (أو صفر دولار) خطة حزمة أو نطاق وحدات تخزين	تتم إعادة ضبط خطط الحِزم استنادًا إلى أساس التجميع المحدّد في بطاقة السعر. على سبيل المثال، إذا بدأ مطوّر البرامج خطة أسعار في اليوم التاسع عشر من الشهر، وكانت قيمة أساس تجميع البيانات كل شهر، تتم إعادة ضبط استخدام الحزمة كل شهر في اليوم التاسع عشر. ويُرجى العلم بأنّ اليوم من الشهر قد لا يكون كما هو في اليوم نفسه. على سبيل المثال، إذا كانت خطة السعر تبدأ في 31 كانون الأول (ديسمبر)، يصبح تاريخ إعادة الضبط هو 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، سيغطّي نطاق الحجم ما يصل إلى 1,000 معاملة خلال فترة تجميع البيانات. إذا كانت العملة هي الدولار الأمريكي، تكون فترة التجميع شهرًا واحدًا، وكان السعر لأول 1000 معاملة يبلغ 0.15، يتم تحصيل 0.15 دولار أمريكي من مطوّر البرامج لكل معاملة مقابل ما يصل إلى 1000 معاملة في الشهر.
  
  للحصول على تفاصيل حول موعد إعادة ضبط الحزم، يمكنك الاطّلاع على متى يتم تحصيل الرسوم المتكرّرة وإعادة ضبط خطط الحزمة؟
  

  إذا لم تحدّد وحدة نهاية لنطاق الحجم النهائي، يتم تطبيق السعر لذلك النطاق على جميع المعاملات بعد أن يزيد عدد المعاملات عن وحدة البداية لذلك النطاق. على سبيل المثال، إذا كانت وحدة البداية للنطاق الأخير هي 1000 ولم تحدّد وحدة نهاية لهذا النطاق، سيتم تطبيق سعر النطاق على جميع المعاملات بعد 1,000 معاملة في فترة تجميع البيانات.

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

على سبيل المثال، ينشئ ما يلي خطة بطاقة أسعار مع نموذج شحن متنوع الحجم. يتم ضبط السعر على 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

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

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

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

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

إذا كانت فترة التطبيقات المجانية المحدودة تستند إلى الكمية، يجب تحديدها كعدد من وحدات التطبيقات المجانية المحدودة. على سبيل المثال، يتم في ما يلي إنشاء خطة بطاقة سعر مع خطة الإصدار المجاني بميزات محدودة استنادًا إلى حجم 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