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

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন
.info- তে যান।

ভূমিকা

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

UI ব্যবহার করে একটি পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যান কনফিগার করা

নিচে বর্ণিত পদ্ধতি অনুযায়ী পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যান কনফিগার করুন।

প্রান্ত

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

মাঠ বর্ণনা ডিফল্ট
গণনার ফ্রিকোয়েন্সি যে সময়কালের উপর ভিত্তি করে লেনদেনের পরিমাণ (বা কাস্টম অ্যাট্রিবিউট-সম্পর্কিত পরিমাণ) গণনা করা হয়। মাস সংখ্যা নির্বাচন করুন (১-২৪ মাস)। ১ মাস

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

উদাহরণস্বরূপ, আপনার প্রয়োজন হতে পারে:

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

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

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

ক্লাসিক এজ UI ব্যবহার করে পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যান কনফিগার করতে:

  1. রেট প্ল্যান উইন্ডোর প্ল্যান ডিটেইলস ট্যাবে থাকা রেট প্ল্যান টাইপ ফিল্ডে অ্যাডজাস্টেবল নোটিফিকেশন নির্বাচন করুন।

    রেট প্ল্যান উইন্ডোতে প্রবেশ করার পদ্ধতি সম্পর্কে জানতে , UI ব্যবহার করে রেট প্ল্যান তৈরি করা দেখুন।

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

    একটি রেট প্ল্যান প্রকাশ করার পর, আপনি শুধুমাত্র এর শেষ তারিখ পরিবর্তন করতে পারবেন। একবার প্রকাশ হয়ে গেলে আপনি কোনো রেট প্ল্যান মুছে ফেলতে পারবেন না, কিন্তু আপনি রেট প্ল্যানটির মেয়াদ শেষ করে দিতে পারেন এবং ‘প্রকাশিত রেট প্ল্যানের মেয়াদ শেষ করুন’ অংশে বর্ণিত পদ্ধতি অনুযায়ী এটিকে ভবিষ্যতের কোনো রেট প্ল্যান দিয়ে প্রতিস্থাপন করতে পারেন।

এপিআই ব্যবহার করে একটি পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যান কনফিগার করা

/organizations/{org_name}/monetization-packages/{package_id}/rate-plans -এ একটি POST অনুরোধ পাঠানোর সময়, অনুরোধের বডিতে থাকা ratePlanDetails প্রপার্টিতে পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যানের বিস্তারিত তথ্য উল্লেখ করুন।

একটি পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যান নির্দিষ্ট করতে, রিকোয়েস্ট বডির 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

এপিআই ব্যবহার করে প্রতিটি অ্যাপ ডেভেলপারের জন্য লেনদেনের লক্ষ্যমাত্রা নির্ধারণ করা।

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

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

রেট প্ল্যান গ্রহণ করার সময় লেনদেনের লক্ষ্যমাত্রা নির্ধারণ করা

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

উদাহরণস্বরূপ, যখন অ্যাপ ডেভেলপার পরিবর্তনযোগ্য নোটিফিকেশন প্ল্যানটি গ্রহণ করেন, তখন নিম্নলিখিত অনুরোধটি লেনদেনের লক্ষ্য সংখ্যা ৪০০০-এ নির্ধারণ করে।

$ 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
}

বিকল্পভাবে, আপনি /organizations/{org_name}/developers/{developer_id}/developer-accepted-rateplans একটি GET অনুরোধ পাঠিয়ে ডেভেলপার রেট প্ল্যানের জন্য {developer-rateplan-id} পেতে পারেন, যেখানে {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