ضبط خطة الإشعارات القابلة للتعديل

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

مقدمة

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

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

اضبط خطط الإشعارات القابلة للتعديل، كما هو موضَّح أدناه.

Edge

لإعداد خطة إشعارات قابلة للتعديل باستخدام واجهة مستخدم Edge، عند إضافة أو تعديل معدّل اختَر نوع خطة معدّل إشعار قابل للتعديل، وفي قسم إشعار قابل للتعديل، اضبط المعلومات التالية:

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

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

على سبيل المثال، قد تحتاج إلى:

  • حصِّل من المطوّرين مبلغًا متغيرًا استنادًا إلى القيمة المقدَّمة في رسالة طلب بيانات من واجهة برمجة التطبيقات.
    على سبيل المثال، قد تحتاج إلى تحصيل الرسوم من مطوّري التطبيقات بناءً على عدد وحدات البايت المنقولة في طلب البيانات من واجهة برمجة التطبيقات.
  • تجميع طلبات بيانات متعددة من واجهة برمجة التطبيقات في معاملة واحدة
    في هذه الحالة، اختَر "استخدام مَعلمة تقييم مخصّصة" واختَر السمة المخصّصة من القائمة المنسدلة.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط خطة الأسعار باستخدام السمات المخصّصة.

الإصدار الكلاسيكي Edge (السحابة الإلكترونية الخاصة)

لضبط خطط الإشعارات القابلة للتعديل باستخدام واجهة مستخدم Edge الكلاسيكي:

  1. اختَر إشعار قابل للتعديل في نوع خطة السعر. ضمن علامة التبويب "تفاصيل الخطة" في نافذة "خطة الأسعار".

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

  2. اضبط حقل مدة التجديد على عدد الأشهر التي تم خلالها الاشتراك في الخطة. يتم تجديدها تلقائيًا (ما لم ينهي المطوّر الاتفاقية قبل ذلك التاريخ). في حال حذف عند ضبط هذه القيمة على 0، ستظل الخطة سارية إلى أن يختار مطوّر البرامج إنهائها.
  3. انقر على التفاصيل ضمن خطة الأسعار العامة.
  4. اضبط أساس التجميع على الفترة الزمنية التي يتم خلالها ضبط حجم تجميع المعاملات. اختَر رقمًا بين شهر واحد و24 شهرًا. يتم ضبط هذه القيمة تلقائيًا على 1. شهر.
  5. انقر على تطبيق وإغلاق.
  6. انقر على حفظ المسودة.
  7. لا تنشر الخطة إلا عندما تكون متأكدًا تمامًا من أنها نهائية. اطّلِع على خطط معدّلات النشر لمعرفة معلومات حول تحديد تاريخ النشر ونشر الخطة.

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

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

تحديد تفاصيل خطة الإشعارات القابلة للتعديل في السمة ratePlanDetails في نص الطلب في طلب POST /organizations/{org_name}/monetization-packages/{package_id}/rate-plans

لتحديد خطة إشعارات قابلة للتعديل، حدِّد القيم التالية في ratePlanDetails لنص الطلب:

الموقع القيمة
type اضبط النوع على USAGE_TARGET.
meteringType اضبط النوع على DEV_SPECIFIC.
duration يتم تعيينها على الفترة الزمنية لأساس التجميع، إلى جانب durationType بالنسبة إلى خطط معدّل الإشعارات القابلة للتعديل، يجب ضبط هذا الإعداد على عدد صحيح. بين 1 و24.
durationType

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

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

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

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "AdjustableNotification",
     "displayName": "Adjustable notification plan",
     "description": "Adjustable notification plan",
     "published": "true",  
     "organization": {
      "id": "myorg"
     },
     "startDate": "2016-04-15 00:00:00",
     "type": "STANDARD",
     "monetizationPackage": {
        "id": "p1",
        "name": "test"
     },
     "currency": {
        "id" : "usd",
        "name" : "USD"
     },
     "ratePlanDetails": [
        {
           "type": "USAGE_TARGET",
           "meteringType": "DEV_SPECIFIC",
           "duration": 1,
           "durationType": "MONTH",
           "ratingParameter": "VOLUME",
           "organization": {
             "id": "myorg"
           },
           "currency": {
             "id": "usd",
             "name": "USD"
           }
        }
     ]
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/monetization-packages/p1/rate-plans"  \
-u email:password

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

عليك تنفيذ ما يلي لكل مطوّر تطبيقات وافق على خطة معدّل الإشعارات القابلة للتعديل. لتعيين العدد المستهدف للمعاملات. يمكنك ضبط إعدادات تلقّي الإشعارات ووقت إرسالها يستند ذلك إلى وقت الوصول إلى نسبة مئوية من الرقم المستهدف، مثل %90 أو %100 أو %150. ولا يتم حظر المعاملات الإضافية بعد الوصول إلى الرقم المستهدَف.

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

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

عند قبول خطة الأسعار، يجب تحديد العدد المستهدف للمعاملات عند السمة quotaTarget في نص الطلب في طلب POST إلى مرجع /organizations/{org_name}/developers/{developer_id}/developer-rateplans يمكنك ضبط quotaTarget على عدد صحيح موجب أو 0 لإيقاف الإشعارات الخاصة بالتطبيق. مطور البرامج. إذا لم يتم تحديد قيمة، سيتم ضبط القيمة التلقائية quotaTarget على 0.

على سبيل المثال، يضبط الطلب التالي العدد المستهدَف للمعاملات على 4, 000 عندما يكون التطبيق. يقبل المطور خطة الإشعارات القابلة للتعديل.

$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "developer":{
     "id":"dev@mycompany.org"
   },
   "ratePlan":{
     "id":"p1_adjustable-notification-plan"
   },
   "startDate": "2016-03-24 00:00:00",
   "quotaTarget": 4000,
   "suppressWarning": false
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans" \
-u email:password

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

لضبط العدد المستهدَف للمعاملات، يمكنك تعديل خطة الأسعار المقبولة وتحديد السمة quotaTarget في نص الطلب في طلب PUT إلى /organizations/{org_name}/developers/{developer_id}/developer-rateplans/{developer_rateplan_id} المصدر. اضبط quotaTarget على عدد صحيح موجب أو 0 لإيقاف الميزة. لمطوِّر التطبيق. إذا لم يتم تحديد قيمة، سيتم ضبط القيمة التلقائية quotaTarget على 0.

يتم عرض {developer_rateplan_id} في الردّ عند قبولك خطة الأسعار المنشورة.

على سبيل المثال:

{
  "created": "2016-03-31 18:59:54",
  "developer": {
    ...
  },
  "id": "b1c600b8-f871-496d-8173-12b9950d6ab1",
  "quotaTarget": 3000,
  "ratePlan": {
    ...
  },
  "startDate": "2016-03-31 00:00:00",
  "updated": "2016-03-31 18:59:54",
  "waiveTerminationCharge": false
}

بدلاً من ذلك، يمكنك الحصول على {developer-rateplan-id} للسعر الخاص بالمطوّرين. عن طريق إصدار طلب استرداد بيانات باستخدام GET إلى /organizations/{org_name}/developers/{developer_id}/developer-accepted-rateplans, حيث يشير {developer_id} إلى عنوان البريد الإلكتروني للمطوّر. لمزيد من المعلومات راجع عرض جميع خطط الأسعار المقبولة في مطوّر برامج.

على سبيل المثال:

{
  "developerRatePlan": [
    {
      "created": "2016-03-31 14:52:30",
      "developer": {
        ...
      },
      "id": "b1c600b8-f871-496d-8173-12b9950d6ab1",
      "quotaTarget": 3000,
      "ratePlan": { 
        ... 
      }, 
      "startDate": "2016-03-31 00:00:00", 
      "updated": "2016-03-31 18:59:54" 
    } 
  ], 
  "totalRecords": 1 
}
        

يعمل الطلب التالي على تعديل العدد المستهدف من المعاملات إلى 4000.

$ curl -H "Content-Type:application/json" -X PUT -d \
{ 
   "id" : "b1c600b8-f871-496d-8173-12b9950d6ab1",
   "developer":{
     "id":"dev@mycompany.com"
   },
   "ratePlan":{
     "id":"p1_adjustable-notification-plan"
   },
   "startDate": "2016-04-15 00:00:00",
   "quotaTarget": 4000,
   "suppressتحذير":خطأ
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans/b1c600b8-f871-496d-8173-12b9950d6ab1"
-u email:password