পরিবর্তনযোগ্য বিজ্ঞপ্তি প্ল্যান কনফিগার করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন।
তথ্য

ভূমিকা

অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যানে, API প্রদানকারী প্রতিটি অ্যাপ ডেভেলপারের জন্য ট্রানজ্যাকশনের টার্গেট সংখ্যা অ্যাডজাস্ট করতে পারে। টার্গেট নম্বরের কোনও শতাংশ, যেমন ৯০%, ১০০% বা ১৫০% পূরণ হলে, বিজ্ঞপ্তি পাঠানো হবে কিনা এবং কখন পাঠানো হবে তা আপনি কনফিগার করতে পারবেন। লক্ষ্যমাত্রায় পৌঁছানোর পরেও অতিরিক্ত ট্রানজ্যাকশন ব্লক করা হয় না।

UI ব্যবহার করে অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যান কনফিগার করা

নিচে বর্ণিত পদ্ধতিতে অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যান কনফিগার করুন।

Edge

Edge UI ব্যবহার করে অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যান কনফিগার করতে, কোনও রেট প্ল্যান যোগ করার বা এডিট করার সময় অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি রেট প্ল্যানের ধরন বেছে নিন এবং অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি বিভাগে, নিম্নলিখিত তথ্য কনফিগার করুন:

ফিল্ড বিবরণ ডিফল্ট
গণনার ফ্রিকোয়েন্সি যে সময়সীমার মধ্যে ট্রানজ্যাকশনের ভলিউম (বা কাস্টম অ্যাট্রিবিউট-সম্পর্কিত ভলিউম) গণনা করা হয়। কত মাসের জন্য (১-২৪ মাস) পেমেন্ট হোল্ডে রাখতে চান তা বেছে নিন। ১ মাস

আপনার API প্রোডাক্টের জন্য কাস্টম অ্যাট্রিবিউট নির্ধারণ করে থাকলে, কাস্টম অ্যাট্রিবিউটের উপর ভিত্তি করে ট্রানজ্যাকশন কাউন্টার নির্ধারণ করতে, আপনি কাস্টম রেটিং প্যারামিটার কনফিগার করতে পারবেন।

যেমন, আপনাকে এগুলি করতে হতে পারে:

  • API কলের মেসেজে প্রদান করা ভ্যালুর উপর ভিত্তি করে ডেভেলপারদের থেকে পরিবর্তনশীল পরিমাণ চার্জ করা।
    যেমন, API অনুরোধে ট্রান্সমিট করা বাইটের সংখ্যার উপর ভিত্তি করে আপনি অ্যাপ ডেভেলপারদের চার্জ করতে পারেন।
  • একটি ট্রানজ্যাকশনে একাধিক API কল বান্ডেল করুন।
    এই ক্ষেত্রে, কাস্টম রেটিং প্যারামিটার ব্যবহার করুন বিকল্প বেছে নিন এবং ড্রপ-ডাউন তালিকা থেকে কাস্টম অ্যাট্রিবিউট বেছে নিন।

আরও তথ্যের জন্য, কাস্টম অ্যাট্রিবিউট সহ রেট প্ল্যান কনফিগার করা দেখুন।

ক্লাসিক Edge (প্রাইভেট ক্লাউড)

ক্লাসিক Edge UI ব্যবহার করে অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যান কনফিগার করতে:

  1. রেট প্ল্যান উইন্ডোতে প্ল্যানের বিবরণ ট্যাবে রেট প্ল্যানের ধরন ফিল্ডে পরিবর্তনযোগ্য বিজ্ঞপ্তি বিকল্প বেছে নিন।

    রেট প্ল্যান উইন্ডো অ্যাক্সেস করা সংক্রান্ত তথ্যের জন্য UI ব্যবহার করে রেট প্ল্যান তৈরি করা লিঙ্ক দেখুন।

  2. রিনিউয়াল মেয়াদ ফিল্ডে সেই মাসের সংখ্যা সেট করুন যে সময় প্ল্যানটি অটোমেটিক রিনিউ হয় (যদি না ডেভেলপার সেই তারিখের আগে চুক্তি বাতিল করে দেন)। আপনি এই ভ্যালু ০ হিসেবে সেট করলে, ডেভেলপার এটি বন্ধ না করা পর্যন্ত প্ল্যানটি চালু থাকবে।
  3. সাধারণ রেট প্ল্যানের অধীনে বিবরণ বিকল্পে ক্লিক করুন।
  4. এগ্রিগেশন বেসিস-কে সেই সময়সীমা হিসেবে সেট করুন যার মধ্যে ট্রানজ্যাকশনের ভলিউম এগ্রিগেট করা হয়। ১ থেকে ২৪ মাসের মধ্যে একটি সংখ্যা বেছে নিন। এই ভ্যালু ডিফল্ট হিসেবে ১ মাস হিসেবে সেট করা থাকে।
  5. প্রয়োগ করুন ও বন্ধ করুন বিকল্পে ক্লিক করুন।
  6. ড্রাফ্ট সেভ করুন বিকল্পে ক্লিক করুন।
  7. প্ল্যানটি চূড়ান্ত হয়েছে বলে আপনি নিশ্চিত হলে তবেই সেটি প্রকাশ করুন। প্রকাশের তারিখ সেট করা ও প্ল্যান প্রকাশ করা সংক্রান্ত তথ্যের জন্য প্রকাশনা রেট প্ল্যান দেখুন।

    আপনি কোনও রেট প্ল্যান প্রকাশ করার পরে, শুধুমাত্র শেষ তারিখ পরিবর্তন করতে পারবেন। প্রকাশ করার পরে আপনি কোনও রেট প্ল্যান মুছতে পারবেন না, তবে আপনি রেট প্ল্যানের মেয়াদ শেষ করতে এবং এটিকে ভবিষ্যতের রেট প্ল্যান দিয়ে পরিবর্তন করতে পারবেন, যেমন প্রকাশিত রেট প্ল্যানের মেয়াদ শেষ করা নিবন্ধে বর্ণনা করা হয়েছে।

API ব্যবহার করে অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যান কনফিগার করা

ratePlanDetails প্রপার্টিতে অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যানের বিবরণ নির্দিষ্ট করুন /organizations/{org_name}/monetization-packages/{package_id}/rate-plans-এ POST অনুরোধের বডিতে।

পরিবর্তনযোগ্য বিজ্ঞপ্তির প্ল্যান নির্দিষ্ট করতে, অনুরোধের বডির ratePlanDetails-এ নিম্নলিখিত ভ্যালু নির্দিষ্ট করুন:

প্রপার্টি মান
type USAGE_TARGET হিসেবে সেট করুন।
meteringType DEV_SPECIFIC হিসেবে সেট করুন।
duration অ্যাগ্রিগেশন বেসিসের জন্য সময়সীমা সেট করা আছে, সাথে durationType. বিজ্ঞপ্তির রেট প্ল্যান অ্যাডজাস্ট করা যায় এমন হলে, ১ থেকে ২৪-এর মধ্যে পূর্ণসংখ্যায় এটি সেট করুন।
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

API ব্যবহার করে প্রতিটি অ্যাপ ডেভেলপারদের জন্য ট্রানজ্যাকশনের টার্গেট সংখ্যা সেট করা

যেসব অ্যাপ ডেভেলপার অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তির হার সংক্রান্ত প্ল্যান গ্রহণ করেছেন, তাদের প্রত্যেককে ট্রানজ্যাকশনের টার্গেট সংখ্যা সেট করতে হবে। টার্গেট নম্বরের কোনও শতাংশ, যেমন ৯০%, ১০০% বা ১৫০% পূরণ হলে, বিজ্ঞপ্তি পাঠানো হবে কিনা এবং কখন পাঠানো হবে তা আপনি কনফিগার করতে পারবেন। লক্ষ্যমাত্রায় পৌঁছানোর পরে অতিরিক্ত ট্রানজ্যাকশন ব্লক করা হয় না।

অ্যাপ ডেভেলপার রেট প্ল্যান গ্রহণ করলে, আপনি তার জন্য টার্গেট করা ট্রানজ্যাকশনের সংখ্যা সেট করতে পারবেন এবং পরে সেই সংখ্যা আপডেট করতে পারবেন।

রেট প্ল্যান গ্রহণ করার সময় ট্রানজ্যাকশনের টার্গেট সংখ্যা সেট করা

রেট প্ল্যান গ্রহণ করার সময়, ট্রানজ্যাকশনের টার্গেট সংখ্যা সেট করতে, quotaTarget প্রপার্টিটি /organizations/{org_name}/developers/{developer_id}/developer-rateplans রিসোর্সে করা POST অনুরোধের অনুরোধের বডিতে উল্লেখ করুন। অ্যাপ ডেভেলপারের জন্য বিজ্ঞপ্তি বন্ধ করতে quotaTarget-কে ধনাত্মক পূর্ণসংখ্যা বা ০ হিসেবে সেট করুন। নির্দিষ্ট করা না থাকলে, quotaTarget ডিফল্ট হিসেবে ০ হয়।

যেমন, অ্যাপ ডেভেলপার অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি প্ল্যান গ্রহণ করলে, নিম্নলিখিত অনুরোধটি ট্রানজ্যাকশনের টার্গেট সংখ্যা ৪০০০ হিসেবে সেট করে।

$ 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-এর মান ধনাত্মক পূর্ণসংখ্যা বা ০ হিসেবে সেট করুন । নির্দিষ্ট করা না থাকলে, quotaTarget ডিফল্ট হিসেবে ০ হয়।

প্রকাশিত রেট প্ল্যান গ্রহণ করলে, উত্তরের মধ্যে {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-এ GET অনুরোধ করতে পারেন, যেখানে {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 
}
        

নিম্নলিখিত অনুরোধটি ট্রানজ্যাকশনের টার্গেট সংখ্যাকে ৪০০০-এ আপডেট করে।

$ 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,
   "suppressWarning":false
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans/b1c600b8-f871-496d-8173-12b9950d6ab1"
-u email:password