अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान को कॉन्फ़िगर करें

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं.
जानकारी

शुरुआती जानकारी

अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान में, एपीआई सेवा देने वाली कंपनी हर ऐप्लिकेशन डेवलपर के लिए लेन-देन की टारगेट संख्या में बदलाव कर सकती है. सूचनाएं भेजने का समय, इस आधार पर कॉन्फ़िगर किया जा सकता है कि टारगेट की गई संख्या का कितना प्रतिशत हिस्सा, जैसे कि 90%, 100% या 150% तक पहुंच गया है. टारगेट की गई संख्या पूरी होने के बाद, दूसरे लेन-देन पर रोक नहीं लगाई जाती है.

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान को कॉन्फ़िगर करना

अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान कॉन्फ़िगर करें. इसके बारे में यहां बताया गया है.

Edge

Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान कॉन्फ़िगर करने के लिए, रेट प्लान को जोड़ते या बदलाव करते समय, अडजस्टबल नोटिफ़िकेशन वाले रेट प्लान का टाइप चुनें. इसके बाद, अडजस्टेबल नोटिफ़िकेशन सेक्शन में, यह जानकारी कॉन्फ़िगर करें:

फ़ील्ड ब्यौरा डिफ़ॉल्ट
कैलकुलेशन की फ़्रीक्वेंसी वह समयावधि जिसके दौरान लेन-देन की संख्या या कस्टम एट्रिब्यूट से जुड़े वॉल्यूम का हिसाब लगाया जाता है. महीनों की संख्या (1 से 24 महीने) चुनें. एक महीना

अगर आपने अपने एपीआई प्रॉडक्ट के लिए कस्टम एट्रिब्यूट तय किए हैं, तो कस्टम एट्रिब्यूट के आधार पर लेन-देन का काउंटर तय करने के लिए, कस्टम रेटिंग पैरामीटर को कॉन्फ़िगर किया जा सकता है.

उदाहरण के लिए, आपको ये काम करने पड़ सकते हैं:

  • एपीआई कॉल के मैसेज में दी गई वैल्यू के आधार पर, डेवलपर से अलग-अलग रकम का शुल्क लें.
    उदाहरण के लिए, हो सकता है कि आप ऐप्लिकेशन डेवलपर से, एपीआई अनुरोध में ट्रांसमिट की गई बाइट की संख्या के हिसाब से शुल्क लेना चाहें.
  • एक ही ट्रांज़ैक्शन में कई एपीआई कॉल इकट्ठा करें.
    इस मामले में, 'कस्टम रेटिंग पैरामीटर का इस्तेमाल करें' को चुनें और ड्रॉप-डाउन सूची से कस्टम एट्रिब्यूट चुनें.

ज़्यादा जानकारी के लिए, कस्टम एट्रिब्यूट की मदद से रेट प्लान कॉन्फ़िगर करना लेख पढ़ें.

क्लासिक एज (प्राइवेट क्लाउड)

क्लासिक एज यूआई का इस्तेमाल करके अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान कॉन्फ़िगर करने के लिए:

  1. रेट प्लान की विंडो में, प्लान की जानकारी टैब पर जाकर, दर प्लान का टाइप फ़ील्ड में जाकर, ज़रूरत के हिसाब से अडजस्ट की जा सकने वाली सूचना चुनें.

    किराया प्लान की विंडो को ऐक्सेस करने के बारे में जानने के लिए, यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके किराया प्लान बनाना देखें.

  2. रिन्यूअल की अवधि वाले फ़ील्ड को, उतने महीनों के लिए सेट करें जितने समय में प्लान अपने-आप रिन्यू होगा. ऐसा तब तक होगा, जब तक डेवलपर समझौते को उस तारीख से पहले खत्म नहीं कर देता. अगर आप इस वैल्यू को 0 पर सेट करते हैं, तो प्लान तब तक लागू रहता है, जब तक डेवलपर इसे खत्म नहीं करता.
  3. सामान्य दर प्लान में जाकर, जानकारी पर क्लिक करें.
  4. उस समयावधि के लिए एग्रीगेशन के आधार को सेट करें जिस दौरान ट्रांज़ैक्शन की संख्या एग्रीगेट की गई है. 1 से 24 महीनों के बीच की कोई संख्या चुनें. यह वैल्यू, डिफ़ॉल्ट तौर पर एक महीना होती है.
  5. लागू करें और बंद करें पर क्लिक करें.
  6. ड्राफ़्ट सेव करें पर क्लिक करें.
  7. प्लान को पब्लिश करने के बाद ही, आपको पूरा भरोसा हो कि प्लान फ़ाइनल हो गया है. पब्लिश करने की तारीख सेट करने और प्लान को पब्लिश करने के बारे में जानकारी के लिए, पब्लिश करने की दर के प्लान देखें.

    रेट प्लान को पब्लिश करने के बाद, सिर्फ़ खत्म होने की तारीख में बदलाव किया जा सकता है. रेट प्लान को पब्लिश होने के बाद मिटाया नहीं जा सकता. हालांकि, रेट प्लान की समयसीमा खत्म की जा सकती है और उसे आने वाले समय में लॉन्च होने वाले प्लान से बदला जा सकता है. इस बारे में, पब्लिश किए गए रेट प्लान की समयसीमा खत्म करना लेख में बताया गया है.

एपीआई का इस्तेमाल करके, अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान को कॉन्फ़िगर करना

/organizations/{org_name}/monetization-packages/{package_id}/rate-plans के पोस्ट अनुरोध में, ratePlanDetails प्रॉपर्टी में बदलाव किए जा सकने वाले नोटिफ़िकेशन प्लान की जानकारी दें. इसके लिए, अनुरोध के मुख्य हिस्से में जाएं.

अडजस्ट किए जा सकने वाले नोटिफ़िकेशन प्लान के बारे में बताने के लिए, अनुरोध के मुख्य हिस्से के 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 प्रॉपर्टी के बारे में बताएं. यह प्रॉपर्टी, /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

स्वीकार किए गए रेट प्लान को अपडेट करते समय, ट्रांज़ैक्शन की टारगेट संख्या सेट करना

ट्रांज़ैक्शन की टारगेट संख्या सेट करने के लिए, स्वीकार किए गए रेट प्लान को अपडेट किया जा सकता है. साथ ही, /organizations/{org_name}/developers/{developer_id}/developer-rateplans/{developer_rateplan_id} संसाधन में PUT अनुरोध के मुख्य हिस्से में, quotaTarget प्रॉपर्टी की जानकारी दी जा सकती है. ऐप्लिकेशन डेवलपर के लिए सूचनाएं बंद करने के लिए, 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} पाया जा सकता है. इसके लिए, आपको /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 
}
        

नीचे दिए गए अनुरोध से, लेन-देन की टारगेट संख्या अपडेट करके 4,000 कर दी जाती है.

$ curl -H "Content-Type:application/json" -X PUT -d \
'{ 
 "id" : "b1c600b8-f871-496d-8173-12b9950d6ab1",
 "developer":{
 "id प्रॉपर्टी/mycompany16}
 mycompany.कीemail:password