কাস্টম বৈশিষ্ট্য সহ রেট প্ল্যান কনফিগার করুন

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

ভূমিকা

কিছু ক্ষেত্রে, পরিবর্তনশীল বা কাস্টম মানের উপর ভিত্তি করে আপনার লেনদেন কাউন্টার প্রয়োজন হতে পারে। উদাহরণস্বরূপ, আপনার প্রয়োজন হতে পারে:

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

কাস্টম বৈশিষ্ট্য সহ রেট প্ল্যান ব্যবহার করে, আপনি একটি API কলের বার্তায় একটি মান সনাক্ত করতে পারেন যা কাউন্টার হিসাবে কাজ করে এবং এটি লেনদেনের সংখ্যা এবং চার্জ গণনা করতে ব্যবহৃত হয়।

কাস্টম বৈশিষ্ট্য সহ নিম্নলিখিত হার পরিকল্পনা সমর্থিত:

• কাস্টম বৈশিষ্ট্য সহ রেট কার্ড
• কাস্টম বৈশিষ্ট্য সহ সামঞ্জস্যযোগ্য বিজ্ঞপ্তি

আপনি প্রতি রেট প্ল্যানে সর্বাধিক দশটি কাস্টম বৈশিষ্ট্য সেট করতে পারেন।

কাস্টম অ্যাট্রিবিউট গণনা বোঝা

রেট প্ল্যান লেনদেনের গণনা এবং চার্জগুলিতে কাস্টম বৈশিষ্ট্যের মান কীভাবে ফ্যাক্টর করা হয় তা চার্জিং মডেলের উপর নির্ভর করে, যেমনটি নিম্নলিখিত টেবিলে সংক্ষিপ্ত করা হয়েছে।

চার্জিং মডেল	কাস্টম বৈশিষ্ট্য গণনা
ফ্ল্যাট রেট এবং ভলিউম ব্যান্ডেড	custom attribute number * rate = charge to developer ফ্ল্যাট রেটের জন্য, কাস্টম অ্যাট্রিবিউট নম্বরটি লেনদেনের সংখ্যা হয়ে যায় যা হারের বিপরীতে গুণিত হয়। ভলিউম ব্যান্ডেডের জন্য, একটি ব্যান্ডে লেনদেনের সংখ্যা কাস্টম অ্যাট্রিবিউট নম্বর দ্বারা বৃদ্ধি করা হয় এবং বিকাশকারীকে সেই লেনদেনের সংখ্যার জন্য চার্জ করা হয়। উদাহরণস্বরূপ, যদি বার্তায় একটি কাস্টম বৈশিষ্ট্যের মান 10 হয়, তাহলে বিকাশকারীকে 10টি লেনদেনের জন্য চার্জ করা হবে এবং 10টি লেনদেন বর্তমান ব্যান্ড গণনায় যোগ করা হবে। বর্তমান ব্যান্ডে ডেভেলপারের যদি মাত্র 6টি লেনদেন অবশিষ্ট থাকে, তাহলে সেই ব্যান্ডের হার দিয়ে 6 গুণ করা হয়। অবশিষ্ট 4টি পরবর্তী ব্যান্ডে যায় এবং সেই ব্যান্ডের হার দ্বারা গুণিত হয়। একটি ভলিউম ব্যান্ডেড প্ল্যানে, যদি শেষ ভলিউম ব্যান্ডের একটি সীমা থাকে ("সীমাহীন" নয়) এবং একটি লেনদেন সেই সীমা অতিক্রম করে, দুটি জিনিস ঘটে: বিকাশকারী "ওভার" পরিমাণ বিনামূল্যে পান। প্ল্যান পিরিয়ড রিসেট না হওয়া পর্যন্ত ডেভেলপার অ্যাপটিকে API-তে আরও কল করা থেকে ব্লক করা হয়েছে। দেখুন কখন পুনরাবৃত্ত ফি চার্জ করা হয় এবং বান্ডেল প্ল্যানগুলি পুনরায় সেট করা হয়? পরিকল্পনা রিসেট করা হয় যখন বিস্তারিত জানার জন্য.
বান্ডিল	যেহেতু বান্ডেলগুলি গ্রুপ দ্বারা চার্জ করা হয়, লেনদেনের দ্বারা নয়, নিম্নলিখিত গণনাটি ঘটে: custom attribute number = amount added to bundle count উদাহরণস্বরূপ, যদি বার্তার কাস্টম অ্যাট্রিবিউট নম্বরটি 10 ​​হয়, তাহলে বান্ডেলে ব্যবহৃত লেনদেনের সংখ্যার সাথে 10 যোগ করা হয়। যদি বর্তমান বান্ডেলে ডেভেলপারের মাত্র 6টি লেনদেন অবশিষ্ট থাকে, তাহলে সেই বান্ডেলটি পূরণ করা হয় এবং পরবর্তী বান্ডেলের সংখ্যা 4 দ্বারা বৃদ্ধি করা হয়। সেই পরবর্তী বান্ডেলের জন্য রেট, যদি থাকে, চার্জ করা হয়। যদি শেষ বান্ডেলের একটি সীমা থাকে ("সীমাহীন" নয়) এবং একটি লেনদেন সেই সীমা অতিক্রম করে, দুটি জিনিস ঘটে: বিকাশকারী "ওভার" পরিমাণ বিনামূল্যে পান। প্ল্যান পিরিয়ড রিসেট না হওয়া পর্যন্ত ডেভেলপার অ্যাপটিকে API-তে আরও কল করা থেকে ব্লক করা হয়েছে। দেখুন কখন পুনরাবৃত্ত ফি চার্জ করা হয় এবং বান্ডেল প্ল্যানগুলি পুনরায় সেট করা হয়? পরিকল্পনা রিসেট করা হয় যখন বিস্তারিত জানার জন্য.
সামঞ্জস্যযোগ্য বিজ্ঞপ্তি	সামঞ্জস্যযোগ্য বিজ্ঞপ্তির জন্য, নিম্নলিখিত গণনা ঘটে: custom attribute number = amount added to transaction count উদাহরণস্বরূপ, যদি বার্তার কাস্টম অ্যাট্রিবিউট নম্বরটি 10 ​​হয়, তাহলে মোট লেনদেনের সংখ্যার সাথে 10 যোগ করা হয়।

যেখানে রেট প্ল্যান কাস্টম অ্যাট্রিবিউট মান পায়

লেনদেন রেকর্ডিং নীতি (এপিআই পণ্য বান্ডেলে) কাস্টম অ্যাট্রিবিউট মানের জন্য বার্তায় কোথায় দেখতে হবে তা নগদীকরণকে বলে। আপনি API পণ্য বান্ডেলের জন্য লেনদেন রেকর্ডিং নীতির কাস্টম বৈশিষ্ট্য বিভাগে কাস্টম বৈশিষ্ট্য সংজ্ঞায়িত করেন।

তারপর, আপনি রেট প্ল্যানে সেই কাস্টম অ্যাট্রিবিউটটি নির্বাচন করতে পারেন—আপনি একটি API পণ্য বান্ডেল তৈরি করার পরে যাতে কাস্টম বৈশিষ্ট্য সংজ্ঞায়িত করা সহ লেনদেন রেকর্ডিং নীতি রয়েছে।

এখানে উচ্চ-স্তরের প্রবাহ রয়েছে:

1. একটি API পণ্য যোগ করার সময় কাস্টম বৈশিষ্ট্য সংজ্ঞায়িত করুন।
2. একটি API পণ্য বান্ডিল তৈরি করুন যাতে পণ্যটি রয়েছে।
   API পণ্য বান্ডেলের জন্য লেনদেন রেকর্ডিং নীতিতে, কাস্টম বৈশিষ্ট্যগুলি যোগ করুন যা রেট প্ল্যানগুলিকে সংজ্ঞায়িত করতে ব্যবহার করা হবে৷
3. API পণ্য বান্ডেলের জন্য টাইপ রেট কার্ড বা সামঞ্জস্যযোগ্য বিজ্ঞপ্তির একটি রেট পরিকল্পনা তৈরি করুন এবং একটি কাস্টম রেটিং প্যারামিটার নির্দিষ্ট করুন৷

নিম্নলিখিত চিত্রটি লেনদেন রেকর্ডিং নীতিতে সংজ্ঞায়িত কাস্টম বৈশিষ্ট্য এবং রেট কার্ড প্ল্যান কনফিগারেশনের মধ্যে সম্পর্ক দেখায়। কাস্টম অ্যাট্রিবিউট রেট প্ল্যান সম্পর্ক সহ সামঞ্জস্যযোগ্য বিজ্ঞপ্তি একই রকম, যদিও ভলিউম-ব্যান্ডেড মান প্রযোজ্য নয়।

বার্তায় কাস্টম অ্যাট্রিবিউট মান কীভাবে তৈরি করবেন

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

রেসপন্স হেডারে রিকোয়েস্ট পেলোড সাইজ যোগ করা হচ্ছে

প্রতিটি মেসেজ রিকোয়েস্টে একটি client.received.content.length ভেরিয়েবল থাকে যাতে রিকোয়েস্ট পেলোডে বাইটের সংখ্যা থাকে। প্রক্সি এন্ডপয়েন্ট রেসপন্সের সাথে একটি অ্যাসাইন মেসেজ পলিসি সংযুক্ত করে, আমরা messageSize নামে একটি রেসপন্স হেডার তৈরি করতে পারি যাতে দৈর্ঘ্যের মান থাকে:

<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
    <DisplayName>Assign Message 1</DisplayName>
    <Set>
        <Headers>
          <Header name="messageSize">{client.received.content.length}</Header> 
        </Headers>  
    </Set>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

হেডারে একটি অ্যাপ কাস্টম অ্যাট্রিবিউট মান যোগ করা হচ্ছে

অনেকটা একইভাবে, আমরা একটি অ্যাপে একটি কাস্টম অ্যাট্রিবিউটের মান সহ একটি হেডার তৈরি করতে পারি। উদাহরণস্বরূপ, আপনি যদি প্রতিটি ডেভেলপার অ্যাপে apprating নামক একটি কাস্টম বৈশিষ্ট্য অন্তর্ভুক্ত করেন, নিম্নরূপ:

যাচাই API কী নীতি ব্যবহার করার সময় (যা নগদীকরণের জন্য প্রয়োজন), এই মানটি verifyapikey.{policy_name}.apprating । প্রক্সি এন্ডপয়েন্ট রেসপন্সের সাথে সংযুক্ত অ্যাসাইন মেসেজ পলিসি ব্যবহার করে, আপনি apprating নামে একটি হেডার তৈরি করতে পারেন যাতে অ্যাপের apprating মান রয়েছে:

<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
    <DisplayName>Assign Message 1</DisplayName>
    <Set>
        <Headers>
          <Header name="apprating">{verifyapikey.Verify-API-Key-1.apprating}</Header> 
        </Headers>  
    </Set>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

হার পরিকল্পনা সেট আপ

উপরে বর্ণিত কাস্টম অ্যাট্রিবিউট সেটআপ ব্যতীত, রেট প্ল্যানটি একইভাবে সেট আপ করা হয়েছে যেমন আপনি সাধারণত করেন (কাস্টম বৈশিষ্ট্য ছাড়াই রেট প্ল্যানের জন্য), তবে নিম্নলিখিত প্রয়োজনীয়তাগুলি অবশ্যই মেনে চলতে হবে।

UI ব্যবহার করে কাস্টম অ্যাট্রিবিউট সহ রেট কার্ড প্ল্যান কনফিগার করা হচ্ছে

নিম্নলিখিত বিভাগে বর্ণিত এজ UI বা ক্লাসিক এজ UI ব্যবহার করে কাস্টম বৈশিষ্ট্য সহ রেট কার্ড পরিকল্পনা কনফিগার করুন।

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

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

API ব্যবহার করে কাস্টম বৈশিষ্ট্য সহ একটি রেট প্ল্যানের বিশদ বিবরণ উল্লেখ করা

নিম্নলিখিত পূর্বশর্ত পদক্ষেপগুলি সম্পাদন করুন:

1. একটি API পণ্যের লেনদেন রেকর্ডিং নীতিতে, কাস্টম বৈশিষ্ট্যগুলি যোগ করুন যা রেট প্ল্যানগুলি সংজ্ঞায়িত করতে ব্যবহৃত হবে৷ বিস্তারিত জানার জন্য, এই বিষয়ে ভূমিকা দেখুন, সেইসাথে একটি লেনদেন রেকর্ডিং নীতি তৈরি করুন । আপনি API প্যাকেজে অন্তর্ভুক্ত করতে চান এমন প্রতিটি API পণ্যের জন্য এটি করুন।
2. একবার API পণ্য এবং লেনদেন রেকর্ডিং নীতিগুলি আপনি যেভাবে চান ঠিক সেভাবে কনফিগার হয়ে গেলে, একটি API প্যাকেজ তৈরি করুন যাতে পণ্যটি রয়েছে৷ API প্যাকেজ তৈরি করুন দেখুন।

এরপরে, আপনি রেট প্ল্যান তৈরি করতে API ব্যবহার করেন।

আপনি যখন রেট প্ল্যান তৈরি করেন তখন কাস্টম বৈশিষ্ট্য সহ একটি রেট প্ল্যানের বিশদ বিবরণ উল্লেখ করেন। আপনি /organizations/{org_name}/monetization-packages/{package_id}/rate-plans কে কল করার জন্য অনুরোধের বডির মধ্যে ratePlanDetails প্রপার্টিতে বিস্তারিত উল্লেখ করুন। বিশদ বিবরণে, আপনি একটি রেটিং প্যারামিটার মান নির্দিষ্ট করেন যা কাস্টম বৈশিষ্ট্যের নাম সনাক্ত করে। আপনি একটি রেটিং প্যারামিটার মানও নির্দিষ্ট করতে পারেন যা একটি নির্দিষ্ট সময়ের ব্যবধানে কাস্টম বৈশিষ্ট্যকে একত্রিত করে।

রেট প্ল্যান বিশদ বিকল্পগুলির একটি সম্পূর্ণ তালিকার জন্য রেট প্ল্যানের বিবরণ কনফিগারেশন সেটিংস দেখুন।

উদাহরণস্বরূপ, নিম্নলিখিতটি কাস্টম অ্যাট্রিবিউট প্ল্যান সহ একটি রেট কার্ড তৈরি করে messageSize নামে একটি কাস্টম বৈশিষ্ট্যের উপর ভিত্তি করে ( বোল্ডে আইটেমগুলি দেখুন)।

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "Custom attribute-based rate card plan",
   "developer":null,
   "developerCategory":null,
   "currency": {
     "id" : "usd"
     },     
   "description": "Custom attribute-based rate card plan",
   "displayName" : "Custom attribute-based rate card plan",
   "frequencyDuration": "1",
   "frequencyDurationType": "MONTH",
   "earlyTerminationFee": "10",
   "monetizationPackage": {
      "id": "location"
        },
      "organization": {
       "id": "{org_name}"
      },    
   "paymentDueDays": "30",
   "prorate": "false",
   "published": "false",     
   "ratePlanDetails":[
      {
        "currency":{
           "id":"usd"
        },
      "duration":1,
      "durationType":"MONTH",
      "meteringType":"VOLUME",
      "paymentDueDays":"30",
      "ratingParameter":"messageSize",
      "ratingParameterUnit":"MB",
      "organization":{
         "id":"{org_name}"
      },
      "ratePlanRates":[
         {
           "rate":0.15,
           "startUnit":0,
           "type":"RATECARD",
           "endUnit":1000
         },
         {
           "rate":0.1,
           "startUnit":1000,
           "type":"RATECARD",
           "endUnit":null
         }
      ],
      "freemiumUnit":0,
      "freemiumDuration":0,
      "freemiumDurationType":"MONTH",
      "type":"RATECARD",
      "customPaymentTerm":false
      }
    ],
    "freemiumUnit":0,
    "freemiumDuration":0,
    "freemiumDurationType":"MONTH",
    "contractDuration":"1",
    "contractDurationType":"YEAR", 
    "recurringStartUnit": 1,
    "recurringType": "CALENDAR",
    "recurringFee": "10",
    "setUpFee": "10",
    "startDate": "2013-09-15 00:00:00",
    "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

নিম্নলিখিতটি কাস্টম অ্যাট্রিবিউট রেট প্ল্যান সহ একটি সামঞ্জস্যযোগ্য বিজ্ঞপ্তি তৈরি করে messageSize নামে একটি কাস্টম বৈশিষ্ট্যের উপর ভিত্তি করে ( বোল্ডে আইটেম দেখুন)।

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "AdjustableNotification",
     "displayName": "Custom attribute-based adjustable notification plan",
     "description": "Custom attribute-based 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": "messageSize",
           "ratingParameterUnit": "MB",
           "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