রিপোর্ট পরিচালনা করুন

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

ভূমিকা

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

নগদীকরণ প্রতিবেদনের প্রকার

আপনি নিম্নলিখিত ধরনের নগদীকরণ প্রতিবেদন তৈরি করতে পারেন।

তথ্য ধারণ সম্পর্কে

Apigee Edge পাবলিক ক্লাউডে, নগদীকরণ ডেটা ধারণ একটি প্ল্যান এনটাইটেলমেন্ট। https://cloud.google.com/apigee/specsheets- এ নগদীকরণ এনটাইটেলমেন্টগুলি দেখুন। আপনি যদি নগদীকরণের ডেটা এনটাইটেলমেন্ট সময়কালের পরে ধরে রাখতে চান তবে Apigee বিক্রয়ের সাথে যোগাযোগ করুন। বর্ধিত ডেটা ধারণ অনুরোধের সময় সক্রিয় করা হয় এবং মূল ডেটা ধারণ উইন্ডোর আগে ডেটা অন্তর্ভুক্ত করার জন্য পূর্ববর্তীভাবে সক্রিয় করা যায় না।

ডুপ্লিকেট লেনদেন সম্পর্কে

আপনি যদি বিশ্লেষণ ডেটার সাথে নগদীকরণ লেনদেন প্রতিবেদনের তুলনা করেন, তাহলে আপনি অল্প সংখ্যক সদৃশ লেনদেন লক্ষ্য করতে পারেন। এটি প্রত্যাশিত আচরণ কারণ নগদীকরণ সিস্টেম প্রতিদিন কয়েক মিলিয়ন লেনদেন প্রক্রিয়া করতে পারে এবং যে কোনো মুহূর্তে সমান্তরালভাবে প্রক্রিয়া করা অনেক লেনদেন। গড়ে, ~0.1% লেনদেন ডুপ্লিকেট হতে পারে।

মনিটাইজেশন রিপোর্ট পৃষ্ঠা অন্বেষণ

নীচে বর্ণিত হিসাবে, নগদীকরণ রিপোর্ট পৃষ্ঠা অ্যাক্সেস করুন।

একটি প্রতিবেদন কনফিগার করা হচ্ছে

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

একটি রিপোর্ট কনফিগার করার পদক্ষেপ

এজ UI বা Classice Edge UI ব্যবহার করে একটি প্রতিবেদন কনফিগার করুন।

একটি বিলিং রিপোর্ট কনফিগার করা হচ্ছে

একটি রিপোর্ট কনফিগার করতে পদক্ষেপগুলি অনুসরণ করুন এবং রিপোর্ট পৃষ্ঠায় নিম্নলিখিত তথ্য প্রবেশ করান:

একটি প্রিপেইড ব্যালেন্স রিপোর্ট কনফিগার করা হচ্ছে

একটি রাজস্ব প্রতিবেদন কনফিগার করা হচ্ছে

একটি রিপোর্ট কনফিগার করার জন্য ধাপগুলি অনুসরণ করুন এবং রিপোর্ট পৃষ্ঠায় নিম্নলিখিত তথ্য লিখুন:

রাজস্ব সারাংশ রিপোর্টে কাস্টম লেনদেন বৈশিষ্ট্য সহ

লেনদেন রেকর্ডিং নীতিগুলি আপনাকে লেনদেন থেকে কাস্টম অ্যাট্রিবিউট ডেটা ক্যাপচার করতে দেয় এবং আপনি সারসংক্ষেপ রাজস্ব প্রতিবেদনে সেই কাস্টম বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে পারেন। আপনার প্রতিষ্ঠানের জন্য MINT.SUMMARY_CUSTOM_ATTRIBUTES বৈশিষ্ট্য সেট করে নগদীকরণ ডাটাবেস টেবিলে অন্তর্ভুক্ত কাস্টম বৈশিষ্ট্যগুলির ডিফল্ট সেটটি সংজ্ঞায়িত করুন৷

এই বৈশিষ্ট্যটি ব্যবহার করার জন্য কিছু চিন্তাভাবনা এবং পরিকল্পনা প্রয়োজন, তাই নীচের বিবেচনাগুলি পর্যালোচনা করুন৷

আপনি যদি একজন ক্লাউড গ্রাহক হন, সম্পত্তি সেট করতে Apigee Edge সহায়তার সাথে যোগাযোগ করুন। আপনি যদি ব্যক্তিগত ক্লাউড গ্রাহকের জন্য একজন Apigee এজ হন, তাহলে সিস্টেম অ্যাডমিনিস্ট্রেটর শংসাপত্র সহ নিম্নলিখিত API-এ PUT অনুরোধ ব্যবহার করে পতাকা সেট করুন।

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:port/v1/o/{myorg} -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;partner_id&quot;,&quot;tax_source&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

এই উদাহরণে, API কল বৈশিষ্ট্যটিকে সক্ষম করে এবং নগদীকরণ ডাটাবেসে partner_id এবং tax_source কলাম যোগ করে। উল্লেখ্য যে API কলে কাস্টম অ্যাট্রিবিউটের বিন্যাসটি URL-এনকোডেড।

প্রতিবেদনে কাস্টম লেনদেনের বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করার জন্য বিবেচনা

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

আপনি বৈশিষ্ট্যটি সক্ষম করার পরে একটি সংক্ষিপ্ত আয়ের প্রতিবেদনে কাস্টম বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে, MintCriteria তে transactionCustomAttributes যোগ করে প্রতিবেদন API ব্যবহার করুন। মানদণ্ড কনফিগারেশন বিকল্পগুলি দেখুন।

একটি বৈকল্পিক প্রতিবেদন কনফিগার করা হচ্ছে (অপ্রচলিত)

একটি রিপোর্ট কনফিগার করার জন্য ধাপগুলি অনুসরণ করুন এবং রিপোর্ট পৃষ্ঠায় নিম্নলিখিত তথ্য লিখুন:

একটি প্রতিবেদন তৈরি এবং ডাউনলোড করা হচ্ছে

আপনি একটি প্রতিবেদন তৈরি করার পরে, আপনি রিপোর্টের ফলাফলগুলি CSV বা জিপ ফাইল ফর্ম্যাটে ডাউনলোড করতে পারেন৷ আপনি সিঙ্ক্রোনাস বা অ্যাসিঙ্ক্রোনাসভাবে CSV বা জিপ ফাইল তৈরি করতে পারেন।

• একটি সিঙ্ক্রোনাস রিপোর্টের জন্য , আপনি প্রতিবেদনের অনুরোধটি চালান এবং বিশ্লেষণ সার্ভার একটি প্রতিক্রিয়া প্রদান না করা পর্যন্ত অনুরোধটি অবরুদ্ধ করা হয়। যাইহোক, যেহেতু একটি প্রতিবেদনের জন্য প্রচুর পরিমাণে ডেটা প্রক্রিয়া করার প্রয়োজন হতে পারে (উদাহরণস্বরূপ, 100 এর GB), একটি সিঙ্ক্রোনাস রিপোর্ট একটি সময় শেষ হওয়ার কারণে ব্যর্থ হতে পারে।

  একটি সারাংশ রিপোর্ট স্তর শুধুমাত্র সিঙ্ক্রোনাস জেনারেশন সমর্থন করে।

• একটি অ্যাসিঙ্ক্রোনাস রিপোর্টের জন্য , আপনি রিপোর্ট অনুরোধ চালান এবং পরবর্তী সময়ে ফলাফল পুনরুদ্ধার করুন। কিছু পরিস্থিতিতে যখন অ্যাসিঙ্ক্রোনাস কোয়েরি প্রক্রিয়াকরণ একটি ভাল বিকল্প হতে পারে:

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

  একটি বিশদ প্রতিবেদন স্তর অ্যাসিঙ্ক্রোনাস প্রজন্মকে সমর্থন করে।

CSV বা জিপ ফাইল ফরম্যাটে একটি প্রতিবেদন তৈরি এবং ডাউনলোড করতে, নিম্নলিখিত কাজগুলির মধ্যে একটি সম্পাদন করুন:

1. রিপোর্ট পৃষ্ঠা অ্যাক্সেস করুন.
2. আপনি যে প্রতিবেদনটি ডাউনলোড করতে চান তার উপরে কার্সারটি রাখুন।

3. পরিবর্তিত কলামের অধীনে, যেকোনো একটিতে ক্লিক করুন:

   1. দ আইকন বা আইকন (একটি সংক্ষিপ্ত প্রতিবেদনের জন্য)। প্রতিবেদনটি সিঙ্ক্রোনাসভাবে একটি CSV বা জিপ ফাইলে সংরক্ষিত হয়।
   2. চাকরি জমা দিন (বিস্তারিত প্রতিবেদনের জন্য)। অ্যাসিঙ্ক্রোনাস কাজ শুরু হয়।

      1. পরিবর্তিত কলামে কাজের অবস্থা নিরীক্ষণ করুন।

         প্রতিবেদনটি ডাউনলোডের জন্য প্রস্তুত হলে ডিস্ক আইকনটি উপস্থিত হয়:

         
      2. কাজ শেষ হওয়ার পরে, রিপোর্টটি ডাউনলোড করতে ডিস্ক আইকনে ক্লিক করুন।

নিম্নলিখিত একটি সারাংশ বিলিং রিপোর্টের জন্য একটি CSV ফাইলের একটি উদাহরণ প্রদান করে৷

একটি প্রতিবেদন সম্পাদনা

একটি প্রতিবেদন সম্পাদনা করতে:

1. রিপোর্ট পৃষ্ঠা অ্যাক্সেস করুন .
2. আপনি যে প্রতিবেদনটি সম্পাদনা করতে চান তার উপরে কার্সারটি রাখুন এবং ক্লিক করুন অ্যাকশন মেনুতে।
3. প্রয়োজন অনুযায়ী রিপোর্ট কনফিগারেশন আপডেট করুন।
4. আপডেট রিপোর্ট কনফিগারেশন সংরক্ষণ করতে আপডেট রিপোর্ট ক্লিক করুন.

একটি প্রতিবেদন মুছে ফেলা হচ্ছে

একটি প্রতিবেদন মুছে ফেলতে:

1. রিপোর্ট পৃষ্ঠা অ্যাক্সেস করুন .
2. আপনি যে প্রতিবেদনটি মুছতে চান তার উপর কার্সারটি রাখুন।
3. ক্লিক করুন অ্যাকশন মেনুতে।

API ব্যবহার করে নগদীকরণ প্রতিবেদন পরিচালনা করা

নিম্নলিখিত বিভাগগুলি API ব্যবহার করে নগদীকরণ প্রতিবেদনগুলি কীভাবে পরিচালনা করতে হয় তা বর্ণনা করে।

API ব্যবহার করে একটি প্রতিবেদন কনফিগার করা

একটি সম্পূর্ণ প্রতিষ্ঠানের জন্য একটি প্রতিবেদন কনফিগার করতে, /organizations/{org_name}/report-definitions এ একটি POST অনুরোধ জারি করুন।

একটি নির্দিষ্ট বিকাশকারীর জন্য একটি প্রতিবেদন কনফিগার করতে, /organizations/{org_name}/developers/{dev_id}/report-definitions এ একটি POST অনুরোধ জারি করুন, যেখানে {dev_id} হল ডেভেলপারের পরিচয়৷

আপনি যখন অনুরোধ করবেন, আপনাকে রিপোর্টের নাম এবং প্রকার উল্লেখ করতে হবে। প্রকারটি নিম্নলিখিতগুলির মধ্যে একটি: BILLING , REVENUE , VARIANCE (অপ্রচলিত), বা PREPAID_BALANCE । উপরন্তু, আপনি mintCriteria বৈশিষ্ট্যে মানদণ্ড নির্দিষ্ট করতে পারেন যা প্রতিবেদনটিকে আরও কনফিগার করে। মানদণ্ডের বিস্তৃত পরিসর রয়েছে যা আপনি নির্দিষ্ট করতে পারেন। এটি আপনাকে রিপোর্ট কনফিগার করার ক্ষেত্রে অনেক নমনীয়তা দেয়। মানদণ্ড হিসাবে আপনি নির্দিষ্ট করতে পারেন এমন কিছু জিনিস হল:

• বিলিং বা প্রিপেইড ব্যালেন্স রিপোর্টের জন্য, রিপোর্টের জন্য বিলিং মাস
• একটি রাজস্ব প্রতিবেদনের জন্য, প্রতিবেদনে কভার করা লেনদেনের ধরন, যেমন, ক্রয় লেনদেন, চার্জ লেনদেন এবং ফেরত
• প্রিপেইড ব্যালেন্স রিপোর্টের জন্য, ডেভেলপার যার কাছে রিপোর্টটি প্রযোজ্য
• একটি রাজস্ব প্রতিবেদনের জন্য, API পণ্য বান্ডেল (বা API প্যাকেজ), পণ্য, রেট প্ল্যান এবং অ্যাপ্লিকেশনগুলি যেখানে প্রতিবেদনটি প্রযোজ্য
• একটি রাজস্ব বা প্রকরণ প্রতিবেদনের জন্য, প্রতিবেদনের জন্য প্রযোজ্য মুদ্রা
• বিলিং, প্রিপেইড ব্যালেন্স বা রাজস্ব প্রতিবেদনের জন্য, প্রতিবেদনটি একটি সারাংশ প্রতিবেদন বা একটি বিশদ প্রতিবেদন কিনা
• একটি রাজস্ব সারাংশ প্রতিবেদনের জন্য, প্রতিবেদনে কাস্টম লেনদেনের বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করুন৷

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

উদাহরণস্বরূপ, নিম্নলিখিতটি একটি রাজস্ব প্রতিবেদন তৈরি করে যা জুলাই, 2015 মাসের লেনদেনের কার্যকলাপের সংক্ষিপ্ত বিবরণ দেয়। প্রতিবেদনে transactionTypes সম্পত্তিতে নির্দিষ্ট করা বিভিন্ন ধরনের লেনদেন অন্তর্ভুক্ত রয়েছে এবং এটি পেমেন্ট API পণ্য বান্ডেল এবং পেমেন্ট API পণ্যের জন্য বিশেষভাবে প্রযোজ্য। যেহেতু রিপোর্টের সংজ্ঞায় কোনো নির্দিষ্ট ডেভেলপার বা অ্যাপ্লিকেশন নির্দিষ্ট করা নেই, রিপোর্টটি সমস্ত ডেভেলপার এবং অ্যাপ্লিকেশনের জন্য প্রযোজ্য। এবং যেহেতু currencyOption প্রপার্টি LOCAL এ সেট করা হয়েছে, রিপোর্টের প্রতিটি লাইন প্রযোজ্য হার পরিকল্পনার মুদ্রা ব্যবহার করে প্রদর্শিত হবে। উপরন্তু, groupBy প্রপার্টি উল্লেখ করে যে রিপোর্টের কলামগুলিকে নিম্নলিখিত ক্রমে গোষ্ঠীবদ্ধ করা হবে: PACKAGE, PRODUCT, DEVELOPER, APPLICATION, এবং RATEPLAN (প্রতিবেদনে রেট প্ল্যানের নাম এবং আইডি অন্তর্ভুক্ত)।

$ curl -H "Content-Type: application/json" -X POST -d \
'{
      "name": "July 2015 revenue report",
      "description": " July 2015 revenue report for Payment product",
      "type": "REVENUE",     
      "mintCriteria":{
         "fromDate":"2015-07-01 00:00:00",
         "toDate":"2015-08-01 13:35:00",
         "showTxDetail":true,
         "showSummary":true,
         "transactionTypes":[
            "PURCHASE",
            "CHARGE",
            "REFUND",
            "CREDIT",
            "SETUPFEES",
            "TERMINATIONFEES",
            "RECURRINGFEES"
         ],
         "monetizationPackageIds":[
            "payment"
         ],
         "productIds":[
            "payment"
         ],
         "currencyOption":"LOCAL",
         "groupBy":[
            "PACKAGE",
            "PRODUCT",
            "DEVELOPER",
            "APPLICATION",
            "RATEPLAN"
         ]
      }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions" \
-u email:password

নিম্নলিখিতটি একটি বিশদ বিলিং প্রতিবেদন তৈরি করে যা জুন, 2015-এর জন্য ডেভেলপার DEV FIVE-এর কার্যকলাপ দেখায়৷

$ curl -H "Content-Type:application/json" -X POST -d \
'{
      "name": "June billing report, DEV FIVE",
      "description": "June billing report, DEV FIVE",
      "type": "BILLING",      
      "mintCriteria":{
         "billingMonth": "JUNE",
         "billingYear": 2015,
         "showTxDetail":true,
         "showSummary":false,         
         "currencyOption":"LOCAL"         
      },
      "devCriteria":[{
         "id":"RtHAeZ6LtkSbEH56",
         "orgId":"myorg"}]
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xU/report-definitions" \
-u email:password

API ব্যবহার করে রিপোর্ট কনফিগারেশন দেখা

আপনি একটি নির্দিষ্ট রিপোর্ট কনফিগারেশন বা একটি প্রতিষ্ঠানের জন্য সমস্ত রিপোর্ট কনফিগারেশন দেখতে পারেন। আপনি একটি পৃথক বিকাশকারীর জন্য রিপোর্ট কনফিগারেশনও দেখতে পারেন।

একটি প্রতিষ্ঠানের জন্য একটি নির্দিষ্ট রিপোর্ট কনফিগারেশন দেখতে, /organizations/{org_name}/report-definitions/{report_definition_id} এ একটি GET অনুরোধ জারি করুন, যেখানে {report_definition_id} হল নির্দিষ্ট রিপোর্ট কনফিগারেশনের শনাক্তকরণ (আইডিটি প্রতিক্রিয়াতে ফেরত দেওয়া হয় যখন আপনি রিপোর্ট কনফিগারেশন তৈরি করেন)। যেমন:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions/1f7fa53b-de5a-431d-9438-62131e1396c5" \
-u email:password

সংস্থার সমস্ত রিপোর্ট কনফিগারেশন দেখতে, /organizations/{org_name}/report-definitions এ একটি GET অনুরোধ জারি করুন।

ফলাফলগুলি ফিল্টার এবং সাজানোর জন্য আপনি নিম্নলিখিত ক্যোয়ারী প্যারামিটারগুলি পাস করতে পারেন:

উদাহরণস্বরূপ, নিম্নলিখিত সংস্থার জন্য রিপোর্ট কনফিগারেশন প্রদান করে এবং সর্বাধিক পাঁচটি রিপোর্ট কনফিগারেশনের মধ্যে পুনরুদ্ধার সীমাবদ্ধ করে:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions?size=5" \ 
-u email:password

প্রতিক্রিয়াটি এইরকম দেখতে হবে (প্রতিক্রিয়ার শুধুমাত্র অংশ দেখানো হয়েছে):

{
  "reportDefinition" : [ {
    "description" : "Test revenue report",
    "developer" : null,
    "id" : "1f7fa53b-de5a-431d-9438-62131e1396c5",
    "lastModified" : "2015-08-27 15:44:03",
    "mintCriteria" : {
      "asXorg" : false,
      "currencyOption" : "LOCAL",
      "fromDate" : "2015-07-01 00:00:00",
      "groupBy" : [ "PACKAGE", "PRODUCT", "DEVELOPER", "APPLICATION", "RATEPLAN" ],
      "monetizationPackageIds" : [ "payment" ],
      "productIds" : [ "payment" ],
      "showRevSharePct" : false,
      "showSummary" : true,
      "showTxDetail" : true,
      "showTxType" : false,
      "toDate" : "2015-08-01 00:05:00",
      "transactionTypes" : [ "PURCHASE", "CHARGE", "REFUND", "CREDIT", "SETUPFEES", "TERMINATIONFEES", "RECURRINGFEES" ]
    },
    "name" : "Test revenue report",
    "organization" : {
      ...
    },
    "type" : "REVENUE"
  }, {
    "description" : "June billing report, DEV FIVE",
    "developer" : null,
    "id" : "fedac696-ce57-469b-b62c-a77b535fd0eb",
    "lastModified" : "2015-08-27 17:13:20",
    "mintCriteria" : {
      "asXorg" : false,
      "billingMonth" : "JUNE",
      "billingYear" : 2015,
      "currencyOption" : "LOCAL",
      "showRevSharePct" : false,
      "showSummary" : false,
      "showTxDetail" : true,
      "showTxType" : false
    },
    "name" : "June billing report, DEV FIVE",
    "organization" : {
      ...
    },
    "type" : "BILLING"
  } ],
  "totalRecords" : 2
}

একটি নির্দিষ্ট ডেভেলপারের জন্য রিপোর্ট কনফিগারেশন দেখতে, /organizations/{org_name}/developers/{dev_id}/report-definitions এ একটি GET অনুরোধ জারি করুন, যেখানে {dev_id} হল ডেভেলপারের পরিচয়। আপনি যখন অনুরোধ করবেন, আপনি ডেটা ফিল্টার এবং সাজানোর জন্য উপরে বর্ণিত ক্যোয়ারী প্যারামিটারগুলি নির্দিষ্ট করতে পারেন৷

উদাহরণস্বরূপ, নিম্নলিখিতগুলি একটি নির্দিষ্ট বিকাশকারীর জন্য রিপোর্ট কনফিগারেশন প্রদান করে এবং প্রতিবেদনের নাম অনুসারে প্রতিক্রিয়া সাজায়:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xUreport-definitions?sort=name" \ 
-u email:password

API ব্যবহার করে একটি রিপোর্ট কনফিগারেশন আপডেট করা হচ্ছে

একটি রিপোর্ট কনফিগারেশন আপডেট করতে, /organizations/{org_name}/report-definitions/{report_definition_id} এ একটি PUT অনুরোধ জারি করুন, যেখানে {report_definition_id} হল নির্দিষ্ট রিপোর্ট কনফিগারেশনের শনাক্তকরণ। আপনি যখন আপডেট করবেন, আপনাকে অনুরোধের বডিতে আপডেট করা কনফিগারেশন মান এবং রিপোর্ট কনফিগারেশনের আইডি উল্লেখ করতে হবে। উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটি একটি সারাংশ প্রতিবেদনে রিপোর্ট আপডেট করে (আপডেট করা বৈশিষ্ট্যগুলি হাইলাইট করা হয়েছে):

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
       "id": "fedac696-ce57-469b-b62c-a77b535fd0eb",
       "name": "June billing report, DEV FIVE",
       "description": "June billing report, DEV FIVE",
       "type": "BILLING",      
       "mintCriteria":{      
         "billingMonth": "JUNE",
         "billingYear": 2015,
         "showTxDetail":false,
         "showSummary":true    
        }     
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions/fedac696-ce57-469b-b62c-a77b535fd0eb" \
-u email:password

প্রতিক্রিয়াটি এইরকম দেখতে হবে (প্রতিক্রিয়ার শুধুমাত্র অংশ দেখানো হয়েছে):

{
 "description" : "June billing report, DEV FIVE",
  "developer" : null,
  "id" : "fedac696-ce57-469b-b62c-a77b535fd0eb",
  "lastModified" : "2015-08-27 17:47:29",
  "mintCriteria" : {
    "asXorg" : false,
    "billingMonth" : "JUNE",
    "billingYear" : 2015,
    "showRevSharePct" : false,
    "showSummary" : true,
    "showTxDetail" : false,
    "showTxType" : false
  },
  "name" : "June billing report, DEV FIVE",
  "organization" : {
    ... 
  },
  "type" : "BILLING"
}

API ব্যবহার করে একটি রিপোর্ট কনফিগারেশন মুছে ফেলা হচ্ছে

একটি রিপোর্ট কনফিগারেশন মুছে ফেলার জন্য, /organizations/{org_namer}/report-definitions/{report_definition_id} এ একটি DELETE অনুরোধ জারি করুন, যেখানে {report_definition_id} হল রিপোর্ট কনফিগারেশন মুছে ফেলার শনাক্তকরণ৷ যেমন:

$ curl -H "Accept:application/json" -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions/fedac696-ce57-469b-b62c-a77b535fd0eb" \
-u email:password

API ব্যবহার করে একটি প্রতিবেদন তৈরি করা হচ্ছে

আপনি একটি প্রতিবেদন কনফিগার করার পরে, আপনি দেখার জন্য কমা-বিভাজিত মান (CSV) ফাইল বিন্যাসে প্রতিবেদন তৈরি করতে পারেন।

একটি প্রতিবেদন তৈরি করতে organizations/{org_id}/{report_type} একটি পোস্ট করার অনুরোধ {report_type} প্রকারগুলি হল:

• billing-reports
• revenue-reports
• prepaid-balance-reports
• variance-reports

উদাহরণ স্বরূপ, একটি বিলিং রিপোর্ট তৈরি করতে, organizations/{org_name}/billing-reports কে একটি POST অনুরোধ জারি করুন।

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

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

$ curl -H "Content-Type:application/json" -H "Accept: application/octet-stream" -X POST -d \
'{
      "fromDate":"2015-07-01 00:00:00",
      "toDate":"2015-08-01 13:35:00",
      "showTxDetail":true,
      "showSummary":true,                
      "transactionTypes":[
        "PURCHASE",
        "CHARGE",
        "REFUND",
        "CREDIT",
        "SETUPFEES",
        "TERMINATIONFEES",
        "RECURRINGFEES"
      ],
      "currencyOption":"LOCAL",
      "groupBy":[
        "PACKAGE",
        "PRODUCT",
        "DEVELOPER",
        "APPLICATION",
        "RATEPLAN"]
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/revenue-reports" \
-u email:password

পাওয়া গেলে, রাজস্ব প্রতিবেদন CSV ফাইল বিন্যাসে তৈরি করা হয়। নিম্নলিখিত রিপোর্ট আউটপুট একটি উদাহরণ প্রদান করে:

Reporting Period:,From:,2015-07-01,  To:,2015-07-31
API Product:,All
Developer:,All
Application:,All
Currency:,Local
Type of Report:,Summary Revenue Report

Monetization Package,Package ID,API Product,Product ID,Developer Name,Developer ID,Application Name,Application ID,Rate Plan,Plan ID,Currency,Transaction Type,Provider Status,Total Volume,Charged Rate,
Location,location,foo_product,foo_product,Apigee,QQ7uxeMGf3w9W08B,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,
Location,location,foo_product,foo_product,BarCompany,barcompany,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,
Location,location,foo_product,foo_product,fremont,fremont,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,
Location,location,foo_product,foo_product,Juan's Taco Shack,juan-s-taco-sha,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,

API ব্যবহার করে রাজস্ব প্রতিবেদনে বিকাশকারীর কাস্টম বৈশিষ্ট্যগুলি সহ

শুধুমাত্র রাজস্ব প্রতিবেদনের জন্য, আপনি প্রতিবেদনে কাস্টম বৈশিষ্ট্য অন্তর্ভুক্ত করতে পারেন, যদি কাস্টম বৈশিষ্ট্য বিকাশকারীর জন্য সংজ্ঞায়িত করা হয়। আপনার প্রতিষ্ঠানে ডেভেলপারদের যোগ করার সময় আপনি কাস্টম অ্যাট্রিবিউটগুলি সংজ্ঞায়িত করেন, যেমনটি অ্যাপ ডেভেলপারদের পরিচালনায় বর্ণিত।

একটি রাজস্ব প্রতিবেদনে কাস্টম বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে, organizations/{org_name}/revenue-reports এ একটি POST অনুরোধ জারি করুন এবং অনুরোধের বডিতে devCustomAttributes অ্যারে অন্তর্ভুক্ত করুন:

"devCustomAttributes": [
    "custom_attribute1",
    "custom_attribute2",
    ...
]

দ্রষ্টব্য: devCustomAttributes অ্যারেতে পূর্বনির্ধারিত MINT_* এবং ADMIN_* বৈশিষ্ট্যগুলি নির্দিষ্ট করবেন না৷

উদাহরণস্বরূপ, নিম্নলিখিত উদাহরণে তিনটি কাস্টম বৈশিষ্ট্য রয়েছে, BILLING_TYPE , SFID , এবং ORG_EXT , প্রতিবেদনে (যদি বিকাশকারীর জন্য সংজ্ঞায়িত করা হয়):

$ curl -H "Content-Type:application/json" -H "Accept: application/octet-stream" -X POST -d \
'{
      "fromDate":"2015-07-01 00:00:00",
      "toDate":"2015-08-01 13:35:00",
      "showTxDetail":true,
      "showSummary":true,                
      "transactionTypes":[
        "PURCHASE",
        "CHARGE",
        "REFUND",
        "CREDIT",
        "SETUPFEES",
        "TERMINATIONFEES",
        "RECURRINGFEES"
      ],
      "currencyOption":"LOCAL",
      "groupBy":[
        "PACKAGE",
        "PRODUCT",
        "DEVELOPER",
        "APPLICATION",
        "RATEPLAN"
      ],
      "devCustomAttributes": [
         "BILLING_TYPE",
         "SFID",
         "ORG_EXT"
      ]
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/revenue-reports" \
-u email:password

নিম্নলিখিত দুটি কাস্টম বৈশিষ্ট্যের মান অন্তর্ভুক্ত করে রিপোর্ট আউটপুটের একটি উদাহরণ প্রদান করে:

Reporting Period:,From:,2015-07-01,  To:,2015-07-31
API Product:,All
Developer:,All
Application:,All
Currency:,Local
Type of Report:,Summary Revenue Report

Monetization Package,Package ID,API Product,Product ID,Developer Name,Developer ID,Application Name,Application ID,Rate Plan,Plan ID,Currency,Transaction Type,Provider Status,Total Volume,Charged Rate,BILLING_TYPE,SFID,ORG_EXT 
Location,location,foo_product,foo_product,Apigee,QQ7uxeMGf3w9W08B,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,
Location,location,foo_product,foo_product,BarCompany,barcompany,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,
Location,location,foo_product,foo_product,fremont,fremont,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,
Location,location,foo_product,foo_product,Juan's Taco Shack,juan-s-taco-sha,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,

API ব্যবহার করে লেনদেনের কার্যকলাপের প্রতিবেদন করা

আপনি /organizations/{org_name}/transaction-search এ একটি POST অনুরোধ জারি করে একটি প্রতিষ্ঠানের জন্য লেনদেনের কার্যকলাপ দেখতে পারেন। আপনি যখন অনুরোধ করবেন, আপনাকে পুনরুদ্ধারের জন্য মানদণ্ড নির্দিষ্ট করতে হবে। মানদণ্ড হিসাবে আপনি নির্দিষ্ট করতে পারেন এমন কিছু জিনিস হল:

• এক বা একাধিক API পণ্যের আইডি যার জন্য লেনদেন জারি করা হয়েছিল।
• বিলিং মাস এবং লেনদেনের বছর।
• বিকাশকারী(গুলি) যারা লেনদেন জারি করেছেন৷
• ক্রয় এবং সেটআপফির মত লেনদেনের প্রকার।
• লেনদেনের অবস্থা যেমন সফল এবং ব্যর্থ।

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

উদাহরণস্বরূপ, বিলিং মাসের জুন, 2015 এর জন্য একটি নির্দিষ্ট বিকাশকারী দ্বারা জারি করা নিম্নলিখিত রিটার্ন লেনদেনগুলি:

$ curl -H "Content-Type:application/json" -X POST -d \
 '{        
    "billingMonth": "JUNE",
    "billingYear": 2015,
    "devCriteria": [{
      "id": "RtHAeZ6LtkSbEH56",
      "orgId":"myorg"}],
    "transactionTypes": ["PURCHASE", "CHARGE", "SETUPFEES"],
    "transactionStatus": ["SUCCESS", "FAILED"]
    }'
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/transaction-search \
-u email:password

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

লেনদেন কার্যকলাপ সম্পর্কে তথ্য দেখতে, নিম্নলিখিত সংস্থানগুলির মধ্যে একটিতে একটি GET অনুরোধ জারি করুন:

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

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers-with-transactions?START_DATE=2015-08-01&END_DATE=2015-08-31" \
-u email:password

প্রতিক্রিয়াটি এইরকম দেখতে হবে (প্রতিক্রিয়ার শুধুমাত্র অংশ দেখানো হয়েছে):

{
  "developer" : [ {
    "address" : [ {
      "address1" : "Dev Five Address",
      "city" : "Pleasanton",
      "country" : "US",
      "id" : "0917f15f-9521-4e69-9376-07aa7b7b32ca",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "94588"
    } ],
    "approxTaxRate" : 0.0900,
    "billingType" : "POSTPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev5@myorg.com",
    "hasSelfBilling" : false,
    "id" : "tJZG6broTpGGGeLV",
    "legalName" : "DEV FIVE",
    "name" : "Dev Five",
    "organization" : {
      ...
    },
    "registrationId" : "dev5",
    "status" : "ACTIVE",
    "type" : "UNTRUSTED"
  }, {
    "address" : [ {
      "address1" : "Dev Seven Address",
      "city" : "Pleasanton",
      "country" : "US",
      "id" : "f86d8c9f-6ed1-4323-b050-6adf494096c9",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "94588"
    } ],
    "approxTaxRate" : 0.0900,
    "billingType" : "POSTPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev7@myorg.com",
    "hasSelfBilling" : false,
    "id" : "VI3l8m8IPAvJTvjS",
    "legalName" : "DEV SEVEN",
    "name" : "Dev Seven",
    "organization" : {
      ...
    },
    "registrationId" : "dev7",
    "status" : "ACTIVE",
    "type" : "UNTRUSTED"
  }, ...
  ]
}

API-এর জন্য কনফিগারেশন বিকল্পগুলি প্রতিবেদন করুন

নিম্নলিখিত রিপোর্ট কনফিগারেশন বিকল্প API-এ উপলব্ধ:

মানদণ্ড কনফিগারেশন বিকল্প

mintCriteria সম্পত্তির মাধ্যমে রিপোর্টের জন্য নিম্নলিখিত কনফিগারেশন বিকল্পগুলি উপলব্ধ:

"devCriteria":[{
    "id":"RtHAeZ6LtkSbEH56",
    "orgId":"my_org"}
]
                

"devCustomAttributes": [
    "custom_attribute1",
    "custom_attribute2",
    ...
]