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

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

ভূমিকা

একটি সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনায়, API প্রদানকারী প্রতিটি অ্যাপ বিকাশকারীর জন্য লেনদেনের লক্ষ্য সংখ্যা সামঞ্জস্য করতে পারে। লক্ষ্য সংখ্যার শতকরা 90%, 100%, বা 150%-এর মতো কখন পৌঁছানো হয় তার উপর ভিত্তি করে আপনি বিজ্ঞপ্তিগুলি পাঠানো হয় কিনা তা কনফিগার করতে পারেন। লক্ষ্য সংখ্যা পৌঁছানোর পরে অতিরিক্ত লেনদেন ব্লক করা হয় না.

UI ব্যবহার করে একটি সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনা কনফিগার করা হচ্ছে

নীচে বর্ণিত হিসাবে সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনা কনফিগার করুন।

প্রান্ত

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

মাঠ বর্ণনা ডিফল্ট
গণনার ফ্রিকোয়েন্সি সময়কাল যার উপর লেনদেনের পরিমাণ (বা কাস্টম বৈশিষ্ট্য-সম্পর্কিত ভলিউম) গণনা করা হয়। কয়েক মাস (1-24 মাস) নির্বাচন করুন। 1 মাস

আপনি যদি আপনার API পণ্যের জন্য কাস্টম বৈশিষ্ট্যগুলি সংজ্ঞায়িত করেন তবে আপনি একটি কাস্টম বৈশিষ্ট্যের উপর ভিত্তি করে একটি লেনদেন কাউন্টার সংজ্ঞায়িত করতে একটি কাস্টম রেটিং প্যারামিটার কনফিগার করতে পারেন৷

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

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

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

ক্লাসিক এজ (ব্যক্তিগত ক্লাউড)

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

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

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

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

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

API ব্যবহার করে একটি সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনা কনফিগার করা হচ্ছে

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

একটি সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনা নির্দিষ্ট করতে, অনুরোধের মূল অংশের রেটপ্ল্যান ডিটেইলে নিম্নলিখিত মানগুলি উল্লেখ করুন:

সম্পত্তি মান
type USAGE_TARGET এ সেট করুন।
meteringType DEV_SPECIFIC এ সেট করুন।
duration একত্রিতকরণের ভিত্তিতে সময়কাল সেট করুন, একসাথে durationType . সামঞ্জস্যযোগ্য বিজ্ঞপ্তি হার পরিকল্পনার জন্য, এটিকে 1 এবং 24-এর মধ্যে একটি পূর্ণসংখ্যা মান সেট করুন।
durationType

একত্রিতকরণের ভিত্তিতে সময়কাল সেট করুন, একসাথে durationType . সামঞ্জস্যযোগ্য বিজ্ঞপ্তি হার পরিকল্পনার জন্য, এই মানটি MONTH এ সেট করুন৷

সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনার বিবরণ নির্দিষ্ট করার সময় যে কনফিগারেশন বৈশিষ্ট্যগুলি সেট করা যেতে পারে সে সম্পর্কে আরও তথ্যের জন্য, রেট প্ল্যানের বিবরণ কনফিগারেশন সেটিংস দেখুন।

উদাহরণস্বরূপ, নিম্নলিখিতটি 1 মাসের জন্য সেট করা একত্রিতকরণের ভিত্তিতে একটি সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনা সংজ্ঞায়িত করে৷

$ 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 ব্যবহার করে প্রতিটি অ্যাপ ডেভেলপারের জন্য লেনদেনের লক্ষ্য সংখ্যা সেট করা

প্রতিটি অ্যাপ বিকাশকারীর জন্য যারা সামঞ্জস্যযোগ্য বিজ্ঞপ্তি হার পরিকল্পনা গ্রহণ করেছে, আপনাকে লেনদেনের লক্ষ্য সংখ্যা সেট করতে হবে। লক্ষ্য সংখ্যার শতকরা 90%, 100%, বা 150%-এর মতো কখন পৌঁছানো হয় তার উপর ভিত্তি করে আপনি বিজ্ঞপ্তিগুলি পাঠানো হয় কিনা তা কনফিগার করতে পারেন। লক্ষ্য সংখ্যা পৌঁছানোর পরে অতিরিক্ত লেনদেন ব্লক করা হয় না.

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

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

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

উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটি লেনদেনের লক্ষ্য সংখ্যা 4000 সেট করে যখন অ্যাপ বিকাশকারী সামঞ্জস্যযোগ্য বিজ্ঞপ্তি পরিকল্পনা গ্রহণ করে।

$ 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 সেট করুন। নির্দিষ্ট করা না থাকলে, কোটা টার্গেট ডিফল্ট 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 , যেখানে {developer_id} ইমেল হল একটি GET অনুরোধ জারি করে আপনি বিকাশকারী রেট প্ল্যানের জন্য {developer-rateplan-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 ,
   "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