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

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

مقدمة

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

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

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

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

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

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

الموقع	القيمة
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

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

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

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

عند قبول خطة الأسعار، لضبط العدد المستهدف من المعاملات، حدِّد السمة 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":{
 "iddevrate@my-08", } 
email:password