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

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

ভূমিকা

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

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

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

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

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

ডেটা ধরে রাখা সম্পর্কে

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

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

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

নগদীকরণ প্রতিবেদন পৃষ্ঠাটি অন্বেষণ করা

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

প্রান্ত

Edge UI ব্যবহার করে রিপোর্ট পৃষ্ঠাটি অ্যাক্সেস করতে:

  1. apigee.com/edge- এ সাইন ইন করুন।
  2. বাম দিকের নেভিগেশন বার থেকে পাবলিশ > মনিটাইজেশন > রিপোর্টস নির্বাচন করুন।

রিপোর্ট পৃষ্ঠাটি প্রদর্শিত হয়।

চিত্রে যেমনটি তুলে ধরা হয়েছে, রিপোর্টস পেজটি আপনাকে নিম্নলিখিত কাজগুলো করতে সক্ষম করে:

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

ক্লাসিক এজ UI ব্যবহার করে রিপোর্ট পেজ অ্যাক্সেস করতে:

  1. http:// ms-ip :9000 এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম।
  2. উপরের নেভিগেশন বারে মনিটাইজেশন > মনিটাইজেশন রিপোর্ট নির্বাচন করুন।

রিপোর্ট পৃষ্ঠাটি প্রদর্শিত হয়।

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

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

একটি রিপোর্ট কনফিগার করার ধাপসমূহ

Edge UI অথবা Classic Edge UI ব্যবহার করে একটি রিপোর্ট কনফিগার করুন।

প্রান্ত

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

  1. বাম দিকের নেভিগেশন বার থেকে পাবলিশ > মনিটাইজেশন > রিপোর্টস নির্বাচন করুন।
  2. ক্লিক করুন + রিপোর্ট
  3. নিম্নলিখিত সারণীতে সংজ্ঞায়িত প্রতিবেদনের বিবরণ কনফিগার করুন।
    মাঠ বর্ণনা
    নাম রিপোর্টটির অনন্য নাম।
    বর্ণনা প্রতিবেদনের বিবরণ।
    রিপোর্টের ধরণ নগদীকরণ প্রতিবেদনের প্রকারভেদ দেখুন।
  4. নিম্নলিখিত বিভাগগুলিতে বর্ণিত পদ্ধতি অনুসারে, নির্বাচিত রিপোর্টের ধরনের উপর ভিত্তি করে রিপোর্টের বাকি বিবরণগুলি কনফিগার করুন:
  5. রিপোর্ট উইন্ডোতে তথ্য প্রবেশ করানোর পর, আপনি যা করতে পারবেন:
    • রিপোর্ট কনফিগারেশন সংরক্ষণ করতে সেভ রিপোর্ট-এ ক্লিক করুন।
    • শুধুমাত্র একটি বিস্তারিত প্রতিবেদনের জন্য, প্রতিবেদনটি অ্যাসিঙ্ক্রোনাসভাবে চালানোর জন্য এবং পরবর্তীতে ফলাফল সংগ্রহ করার জন্য 'সাবমিট জব'-এ ক্লিক করুন। আরও তথ্যের জন্য 'একটি প্রতিবেদন তৈরি এবং ডাউনলোড করা' দেখুন।

    • তৈরি হওয়া রিপোর্টটি আপনার লোকাল মেশিনে কমা-সেপারেটেড ভ্যালু (CSV) অথবা CSV ফাইলটি সম্বলিত একটি কম্প্রেসড জিপ ফাইল হিসেবে ডাউনলোড করতে 'Save as CSV' বা 'Save as Zip'-এ ক্লিক করুন। বড় রিপোর্টের জন্য জিপ ডাউনলোড করার পরামর্শ দেওয়া হয় এবং এটি আরও কার্যকরভাবে ডাউনলোড হবে।

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

ক্লাসিক এজ UI ব্যবহার করে একটি রিপোর্ট তৈরি করতে:

  1. উপরের নেভিগেশন বারে মনিটাইজেশন > মনিটাইজেশন রিপোর্ট নির্বাচন করুন।
  2. ড্রপ-ডাউন মেনু থেকে আপনি যে ধরনের রিপোর্ট তৈরি করতে চান তা নির্বাচন করুন। মনিটাইজেশন রিপোর্টের প্রকারভেদ দেখুন।
  3. + রিপোর্ট-এ ক্লিক করুন।
  4. নিম্নলিখিত বিভাগগুলিতে বর্ণিত পদ্ধতি অনুসারে, নির্বাচিত বিলিং ধরণের উপর ভিত্তি করে রিপোর্টের বিবরণ কনফিগার করুন:
  5. রিপোর্ট উইন্ডোতে তথ্য প্রবেশ করানোর পর, আপনি যা করতে পারবেন:
    • রিপোর্টের কনফিগারেশন সংরক্ষণ করতে এবং পরবর্তীতে রিপোর্টটি ডাউনলোড করতে 'Save as ...'- এ ক্লিক করুন।
    • শুধুমাত্র একটি বিস্তারিত প্রতিবেদনের জন্য, প্রতিবেদনটি এককালীন চালানোর জন্য এবং পরবর্তীতে ফলাফল সংগ্রহ করার জন্য 'সাবমিট জব'-এ ক্লিক করুন। আরও তথ্যের জন্য 'প্রতিবেদন তৈরি এবং ডাউনলোড করা' দেখুন।

    • দেখার জন্য রিপোর্টটি আপনার স্থানীয় মেশিনে একটি কমা-বিভাজিত মান (CSV) ফাইল হিসাবে তৈরি ও ডাউনলোড করতে 'ডাউনলোড CSV'-তে ক্লিক করুন।

বিলিং রিপোর্ট কনফিগার করা

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

মাঠ বর্ণনা
বিলিং মাস

রিপোর্টটির বিল করার মাস।

রিপোর্টিং স্তর

রিপোর্টিং স্তর। বৈধ মানগুলো হলো:

  • বিস্তারিত : প্রতিটি লেনদেন আলাদা লাইনে প্রদর্শন করে এবং রেট প্ল্যানগুলো সঠিকভাবে প্রয়োগ করা হয়েছে কিনা তা যাচাই করার সুযোগ দেয়। এতে কোনো সারাংশ থাকে না।
  • সারাংশ : প্রতিটি এপিআই পণ্য এবং ডেভেলপারের মোট রাজস্বের সারসংক্ষেপ প্রদান করে।
পণ্য বান্ডেল

দ্রষ্টব্য : ক্লাসিক এজ UI-তে, API প্রোডাক্ট বান্ডেলগুলোকে API প্যাকেজ বলা হয়।

রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই প্রোডাক্ট বান্ডেলগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সমস্ত এপিআই প্রোডাক্ট বান্ডেল রিপোর্টে অন্তর্ভুক্ত করা হবে।

রিপোর্টটিতে প্রতিটি নির্বাচিত এপিআই প্রোডাক্ট বান্ডেলের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত রয়েছে।

সারাংশ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প'-এ 'প্রদর্শন করবেন না' বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) এপিআই প্রোডাক্ট বান্ডেলের তথ্য একত্রিত করে (এবং প্রতিটি এপিআই প্রোডাক্ট বান্ডেলের তথ্য আলাদাভাবে তালিকাভুক্ত করে না)।

পণ্য

রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই প্রোডাক্টগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সমস্ত এপিআই প্রোডাক্ট রিপোর্টে অন্তর্ভুক্ত করা হবে।

প্রতিবেদনে প্রতিটি নির্বাচিত এপিআই পণ্যের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত করা হয়েছে।

সারাংশ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প'-এ 'প্রদর্শন করবেন না ' বিকল্পটি নির্বাচন করতে পারেন। এক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) ডেভেলপারদের তথ্য একত্রিত করে (এবং প্রতিটি নির্বাচিত ডেভেলপারের তথ্য আলাদাভাবে তালিকাভুক্ত করে না)।

কোম্পানিগুলি

প্রতিবেদনে অন্তর্ভুক্ত করার জন্য কোম্পানিগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সব কোম্পানিই প্রতিবেদনে অন্তর্ভুক্ত হবে।

রেট প্ল্যান

প্রতিবেদনে অন্তর্ভুক্ত করার জন্য রেট প্ল্যানসমূহ। নিম্নলিখিতগুলির মধ্যে একটি নির্বাচন করুন:

  • সকল রেট প্ল্যান : রিপোর্টে সকল রেট প্ল্যান অন্তর্ভুক্ত করুন।
  • স্ট্যান্ডার্ড রেট প্ল্যান : রিপোর্টে শুধুমাত্র স্ট্যান্ডার্ড রেট প্ল্যানগুলো অন্তর্ভুক্ত করুন।
  • ডেভেলপার-নির্দিষ্ট রেট প্ল্যান : রিপোর্টে শুধুমাত্র ডেভেলপারদের প্ল্যান অন্তর্ভুক্ত করুন।

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

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

মাঠ বর্ণনা
বিলিং মাস

রিপোর্টটির বিল করার মাস।

রিপোর্টিং স্তর

রিপোর্টিং স্তর। বৈধ মানগুলো হলো:

  • বিস্তারিত : প্রতিটি ব্যালেন্স রিফিল আলাদাভাবে প্রদর্শন করে এবং আপনার পেমেন্ট প্রসেসর থেকে প্রাপ্ত পেমেন্টের সাথে তা মিলিয়ে নেওয়ার সুযোগ দেয়।
  • সারাংশ : প্রতিটি ডেভেলপারের মোট ব্যালেন্স রিফিলের সারসংক্ষেপ প্রদান করে।
কোম্পানিগুলি

প্রতিবেদনে অন্তর্ভুক্ত করার জন্য কোম্পানিগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সব কোম্পানিই প্রতিবেদনে অন্তর্ভুক্ত হবে।

রাজস্ব প্রতিবেদন কনফিগার করা

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

মাঠ বর্ণনা
তারিখের পরিসর

প্রতিবেদনের জন্য তারিখের পরিসর। নিম্নলিখিতগুলির মধ্যে একটি নির্বাচন করুন:

  • প্রিসেট : ড্রপ-ডাউন মেনু থেকে স্ট্যান্ডার্ড তারিখের পরিসরগুলোর (যেমন গত ক্যালেন্ডার মাস) মধ্যে একটি নির্বাচন করুন।
  • কাস্টম : ক্যালেন্ডার পপ-আপ থেকে পরিসীমাটির জন্য একটি শুরুর তারিখ এবং একটি শেষের তারিখ বেছে নিন।
মুদ্রা নির্বাচন করুন

প্রতিবেদনের জন্য মুদ্রা। বৈধ মানগুলো হলো:

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

রিপোর্টিং স্তর। বৈধ মানগুলো হলো:

  • বিস্তারিত : প্রতিটি লেনদেন আলাদা লাইনে দেখানো হয়। কোনো সারাংশ থাকে না।
  • সারাংশ : আপনার নির্বাচিত প্যারামিটারগুলোর ওপর নির্ভর করে প্রতিটি এপিআই পণ্য এবং ডেভেলপারের মোট রাজস্বের সারসংক্ষেপ প্রদান করে।
পণ্য বান্ডেল

দ্রষ্টব্য : ক্লাসিক এজ UI-তে, API প্রোডাক্ট বান্ডেলগুলোকে API প্যাকেজ বলা হয়।

রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই প্রোডাক্ট বান্ডেলগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সমস্ত এপিআই প্রোডাক্ট বান্ডেল রিপোর্টে অন্তর্ভুক্ত করা হবে।

রিপোর্টটিতে প্রতিটি নির্বাচিত এপিআই প্রোডাক্ট বান্ডেলের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত রয়েছে।

সারাংশ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প'-এ 'প্রদর্শন করবেন না' বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) এপিআই প্রোডাক্ট বান্ডেলের তথ্য একত্রিত করে (এবং প্রতিটি এপিআই প্রোডাক্ট বান্ডেলের তথ্য আলাদাভাবে তালিকাভুক্ত করে না)।

পণ্য

রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই প্রোডাক্টগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সমস্ত এপিআই প্রোডাক্ট রিপোর্টে অন্তর্ভুক্ত করা হবে।

প্রতিবেদনে প্রতিটি নির্বাচিত এপিআই পণ্যের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত করা হয়েছে।

সারাংশ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প'-এ 'প্রদর্শন করবেন না ' বিকল্পটি নির্বাচন করতে পারেন। এক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) ডেভেলপারদের তথ্য একত্রিত করে (এবং প্রতিটি নির্বাচিত ডেভেলপারের তথ্য আলাদাভাবে তালিকাভুক্ত করে না)।

কোম্পানিগুলি

প্রতিবেদনে অন্তর্ভুক্ত করার জন্য কোম্পানিগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সব কোম্পানিই প্রতিবেদনে অন্তর্ভুক্ত হবে।

সারাংশ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প' (Summary Display Options) বিভাগে 'প্রদর্শন করবেন না' (Do not display ) বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) কোম্পানির তথ্য একত্রিত করে (এবং প্রতিটি নির্বাচিত কোম্পানির তথ্য আলাদাভাবে তালিকাভুক্ত করে না)।

অ্যাপস

রিপোর্টে অন্তর্ভুক্ত করার জন্য অ্যাপ্লিকেশনগুলো নির্বাচন করুন। কোনোটি নির্বাচন করা না হলে, সমস্ত অ্যাপ্লিকেশনই রিপোর্টে অন্তর্ভুক্ত হবে।

প্রতিবেদনে প্রতিটি নির্বাচিত অ্যাপ্লিকেশনের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত করা হয়েছে।

সারাংশ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প' (Summary Display Options) বিভাগে 'প্রদর্শন করবেন না' (Do not display ) বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) অ্যাপ্লিকেশন জুড়ে তথ্য একত্রিত করে (এবং প্রতিটি নির্বাচিত অ্যাপ্লিকেশনের জন্য আলাদাভাবে তথ্য তালিকাভুক্ত করে না)।

সারাংশ প্রদর্শনের বিকল্পগুলি

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

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

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

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

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

আপনি যদি একজন ক্লাউড গ্রাহক হন, তাহলে প্রপার্টিটি সেট করার জন্য Apigee Edge Support-এর সাথে যোগাযোগ করুন। আপনি যদি Apigee Edge for Private Cloud-এর গ্রাহক হন, তাহলে সিস্টেম অ্যাডমিনিস্ট্রেটর ক্রেডেনশিয়াল ব্যবহার করে নিম্নলিখিত 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>"

এই উদাহরণে, এপিআই কলটি ফিচারটি সক্রিয় করে এবং মনিটাইজেশন ডেটাবেসে partner_idtax_source কলাম যোগ করে। উল্লেখ্য যে, এপিআই কলের কাস্টম অ্যাট্রিবিউটের অ্যারেটি ইউআরএল-এনকোডেড।

রিপোর্টে কাস্টম ট্রানজ্যাকশন অ্যাট্রিবিউট অন্তর্ভুক্ত করার বিবেচ্য বিষয়সমূহ

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

ফিচারটি চালু করার পর একটি সারসংক্ষেপ রাজস্ব প্রতিবেদনে কাস্টম অ্যাট্রিবিউট অন্তর্ভুক্ত করতে, রিপোর্ট API ব্যবহার করে MintCriteria তে transactionCustomAttributes যোগ করুন। Criteria কনফিগারেশন অপশনগুলো দেখুন।

বৈষম্য প্রতিবেদন কনফিগার করা (অপ্রচলিত)

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

মাঠ বর্ণনা
তারিখের পরিসর

প্রতিবেদনের জন্য তারিখের পরিসর। নিম্নলিখিতগুলির মধ্যে একটি নির্বাচন করুন:

  • প্রিসেট : ড্রপ-ডাউন মেনু থেকে স্ট্যান্ডার্ড তারিখের পরিসরগুলোর (যেমন গত ক্যালেন্ডার মাস) মধ্যে একটি নির্বাচন করুন।
  • কাস্টম : ক্যালেন্ডার পপ-আপ থেকে পরিসীমাটির জন্য একটি শুরুর তারিখ এবং একটি শেষের তারিখ বেছে নিন।
প্যাকেজ

রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই প্যাকেজসমূহ। নিম্নলিখিতগুলো থেকে যেকোনো একটি নির্বাচন করুন:

  • সব : রিপোর্টে সমস্ত এপিআই প্যাকেজ অন্তর্ভুক্ত রয়েছে।
  • নির্বাচিত : একটি তালিকা প্রদর্শন করে যেখান থেকে আপনি রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই প্যাকেজগুলো নির্বাচন করতে পারেন। আপনি যদি কোনো প্যাকেজ নির্বাচন না করেন, তাহলে সমস্ত প্যাকেজ রিপোর্টে অন্তর্ভুক্ত করা হবে।

রিপোর্টটিতে প্রতিটি নির্বাচিত এপিআই প্যাকেজের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত রয়েছে।

একটি সারসংক্ষেপ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প' (Summary Display Options) বিভাগে 'প্রদর্শন করবেন না (প্যাকেজ)' (Don't Display (Packages)) বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) এপিআই প্যাকেজ জুড়ে তথ্য একত্রিত করে (এবং প্রতিটি এপিআই প্যাকেজের জন্য আলাদাভাবে তথ্য তালিকাভুক্ত করে না)।

পণ্য

রিপোর্টে অন্তর্ভুক্ত করার জন্য এপিআই পণ্যগুলো। নিম্নলিখিতগুলো থেকে যেকোনো একটি নির্বাচন করুন:

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

প্রতিবেদনে প্রতিটি নির্বাচিত এপিআই পণ্যের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত করা হয়েছে।

একটি সারসংক্ষেপ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প' (Summary Display Options) বিভাগে 'প্রদর্শন করবেন না (পণ্য)' (Don't Display (Products)) বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) এপিআই (API) পণ্য জুড়ে তথ্য একত্রিত করে (এবং প্রতিটি এপিআই পণ্যের জন্য আলাদাভাবে তথ্য তালিকাভুক্ত করে না)।

কোম্পানিগুলি

প্রতিবেদনে অন্তর্ভুক্ত করার জন্য কোম্পানিগুলো। নিম্নলিখিতগুলো থেকে একটি নির্বাচন করুন:

  • সব : প্রতিবেদনে অন্তর্ভুক্ত সকল কোম্পানি।
  • নির্বাচিত : একটি তালিকা প্রদর্শন করে যেখান থেকে আপনি প্রতিবেদনে অন্তর্ভুক্ত করার জন্য কোম্পানিগুলো নির্বাচন করতে পারেন। আপনি যদি কোনো কোম্পানি নির্বাচন না করেন, তাহলে সব কোম্পানিই প্রতিবেদনে অন্তর্ভুক্ত হবে।

প্রতিবেদনে প্রতিটি নির্বাচিত কোম্পানির জন্য একটি আলাদা লাইন অন্তর্ভুক্ত করা হয়েছে।

একটি সারসংক্ষেপ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প' (Summary Display Options) বিভাগে 'প্রদর্শন করবেন না (কোম্পানি)' (Don't Display (Companies)) বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) কোম্পানির তথ্য একত্রিত করে (এবং প্রতিটি নির্বাচিত কোম্পানির তথ্য আলাদাভাবে তালিকাভুক্ত করে না)।

অ্যাপস

প্রতিবেদনে অন্তর্ভুক্ত করার জন্য আবেদনপত্রগুলো। নিম্নলিখিতগুলো থেকে একটি নির্বাচন করুন:

  • সব : প্রতিবেদনে অন্তর্ভুক্ত সকল অ্যাপ্লিকেশন।
  • নির্বাচিত : একটি তালিকা প্রদর্শন করে যেখান থেকে আপনি রিপোর্টে অন্তর্ভুক্ত করার জন্য অ্যাপ্লিকেশনগুলি নির্বাচন করতে পারেন। আপনি যদি কোনো অ্যাপ্লিকেশন নির্বাচন না করেন, তাহলে সমস্ত অ্যাপ্লিকেশন রিপোর্টে অন্তর্ভুক্ত করা হবে।

প্রতিবেদনে প্রতিটি নির্বাচিত অ্যাপ্লিকেশনের জন্য একটি আলাদা লাইন অন্তর্ভুক্ত করা হয়েছে।

একটি সারসংক্ষেপ প্রতিবেদনের জন্য, আপনি ঐচ্ছিকভাবে 'সারাংশ প্রদর্শন বিকল্প' (Summary Display Options) বিভাগে 'প্রদর্শন করবেন না (অ্যাপ্লিকেশন)' (Don't Display (Applications)) বিকল্পটি নির্বাচন করতে পারেন। এই ক্ষেত্রে, প্রতিবেদনটি সমস্ত (বা নির্বাচিত) অ্যাপ্লিকেশন জুড়ে তথ্য একত্রিত করে (এবং প্রতিটি নির্বাচিত অ্যাপ্লিকেশনের জন্য আলাদাভাবে তথ্য তালিকাভুক্ত করে না)।

মুদ্রা

প্রতিবেদনের জন্য মুদ্রা। বৈধ মানগুলো হলো:

  • স্থানীয় মুদ্রা : রিপোর্টের প্রতিটি লাইন প্রযোজ্য রেট প্ল্যান ব্যবহার করে প্রদর্শিত হয়। এর মানে হলো, ডেভেলপারদের যদি ভিন্ন ভিন্ন মুদ্রা ব্যবহার করে এমন প্ল্যান থাকে, তাহলে একটি রিপোর্টে একাধিক মুদ্রা থাকতে পারে।
  • ইউরো : রিপোর্টে স্থানীয় মুদ্রার লেনদেনগুলো ইউরোতে রূপান্তর করে দেখানো হয়।
  • GPB : রিপোর্টে স্থানীয় মুদ্রার লেনদেনগুলো পাউন্ডে রূপান্তর করে দেখানো হয়।
  • ইউএসডি : প্রতিবেদনে স্থানীয় মুদ্রার লেনদেনগুলো ডলারে রূপান্তর করে দেখানো হয়।
সারাংশ প্রদর্শনের বিকল্পগুলি

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

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

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

রিপোর্ট তৈরি করার পর, আপনি সেই রিপোর্টের ফলাফল CSV বা zip ফাইল ফরম্যাটে ডাউনলোড করতে পারবেন। আপনি CSV বা zip ফাইলটি সিনক্রোনাসলি অথবা অ্যাসিনক্রোনাসলি তৈরি করতে পারেন।

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

    সামারি রিপোর্ট লেভেল শুধুমাত্র সিনক্রোনাস জেনারেশন সমর্থন করে।

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

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

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

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

  1. রিপোর্ট পৃষ্ঠাটি অ্যাক্সেস করুন।
  2. যে রিপোর্টটি ডাউনলোড করতে চান, সেটির উপর কার্সারটি রাখুন।
  3. পরিবর্তিত কলামের অধীনে, নিম্নলিখিতগুলির যেকোনো একটিতে ক্লিক করুন:

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

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

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

নিচে একটি সংক্ষিপ্ত বিলিং রিপোর্টের CSV ফাইলের উদাহরণ দেওয়া হলো।

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

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

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

একটি রিপোর্ট মুছে ফেলা

একটি রিপোর্ট মুছে ফেলতে:

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

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

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

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

পুরো প্রতিষ্ঠানের জন্য একটি রিপোর্ট কনফিগার করতে, /organizations/{org_name}/report-definitions একটি POST রিকোয়েস্ট পাঠান।

কোনো নির্দিষ্ট ডেভেলপারের জন্য একটি রিপোর্ট কনফিগার করতে, /organizations/{org_name}/developers/{dev_id}/report-definitions -এ একটি POST রিকোয়েস্ট পাঠান, যেখানে {dev_id} হলো ডেভেলপারের শনাক্তকরণ।

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

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

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

উদাহরণস্বরূপ, নিম্নলিখিত কোডটি একটি রাজস্ব প্রতিবেদন তৈরি করে যা ২০১৫ সালের জুলাই মাসের লেনদেন কার্যক্রমের সারসংক্ষেপ তুলে ধরে। প্রতিবেদনটিতে transactionTypes প্রপার্টিতে নির্দিষ্ট করা বিভিন্ন ধরণের লেনদেন অন্তর্ভুক্ত রয়েছে এবং এটি বিশেষভাবে `Payment API` প্রোডাক্ট বান্ডেল এবং `Payment 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

নিম্নলিখিতটি একটি বিস্তারিত বিলিং রিপোর্ট তৈরি করে, যা ২০১৫ সালের জুন মাসের জন্য ডেভেলপার 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

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

আপনি একটি নির্দিষ্ট রিপোর্ট কনফিগারেশন অথবা একটি প্রতিষ্ঠানের সমস্ত রিপোর্ট কনফিগারেশন দেখতে পারেন। এছাড়াও আপনি একজন স্বতন্ত্র ডেভেলপারের রিপোর্ট কনফিগারেশন দেখতে পারেন।

কোনো প্রতিষ্ঠানের একটি নির্দিষ্ট রিপোর্ট কনফিগারেশন দেখতে, /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 অনুরোধ পাঠান।

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

কোয়েরি প্যারামিটার বর্ণনা
all সমস্ত এপিআই প্রোডাক্ট বান্ডেল ফেরত দেওয়া হবে কিনা তা নির্দিষ্ট করার ফ্ল্যাগ। যদি এটি false- এ সেট করা হয়, তাহলে প্রতি পৃষ্ঠায় ফেরত আসা এপিআই প্রোডাক্ট বান্ডেলের সংখ্যা size কোয়েরি প্যারামিটার দ্বারা নির্ধারিত হয়। ডিফল্ট মান false
size প্রতি পৃষ্ঠায় ফেরত আসা এপিআই প্রোডাক্ট বান্ডেলের সংখ্যা। ডিফল্ট মান ২০। যদি all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়।
page আপনি যে পৃষ্ঠাটি ফেরত পেতে চান তার নম্বর (যদি বিষয়বস্তু পৃষ্ঠাঙ্কিত হয়)। যদি ' all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়।
sort যে ফিল্ডের ভিত্তিতে তথ্য সাজানো হবে। যদি ' all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়। ডিফল্ট মান হলো UPDATED:DESC

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

$ 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

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

একটি রিপোর্ট কনফিগারেশন আপডেট করতে, /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"
}

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

একটি রিপোর্ট কনফিগারেশন ডিলিট করতে, /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

এপিআই ব্যবহার করে একটি প্রতিবেদন তৈরি করা

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

একটি রিপোর্ট তৈরি করতে organizations/{org_id}/{report_type} -এ একটি POST অনুরোধ পাঠান, যেখানে {report_type} নির্দিষ্ট করে আপনি কোন ধরনের রিপোর্ট তৈরি করতে চান। প্রকারগুলো হলো:

  • billing-reports
  • revenue-reports
  • prepaid-balance-reports
  • variance-reports
এছাড়াও, আপনি একজন নির্দিষ্ট ডেভেলপারের জন্য একটি রাজস্ব প্রতিবেদন তৈরি করতে পারেন, যেমনটি "একজন ডেভেলপারের জন্য একটি রাজস্ব প্রতিবেদন তৈরি করুন" অংশে বর্ণনা করা হয়েছে।

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

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

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

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

এপিআই ব্যবহার করে রাজস্ব প্রতিবেদনে ডেভেলপার কাস্টম অ্যাট্রিবিউট অন্তর্ভুক্ত করা

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

একটি রাজস্ব প্রতিবেদনে কাস্টম অ্যাট্রিবিউট অন্তর্ভুক্ত করতে, 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,

এপিআই ব্যবহার করে লেনদেন কার্যক্রমের প্রতিবেদন তৈরি করা

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

  • এক বা একাধিক এপিআই পণ্যের আইডি, যেগুলোর জন্য লেনদেন জারি করা হয়েছিল।
  • লেনদেনগুলোর বিলিং মাস ও বছর।
  • যে ডেভেলপার(গণ) লেনদেনটি জারি করেছেন।
  • লেনদেনের ধরণ, যেমন ক্রয় এবং সেটআপ ফি।
  • লেনদেনের অবস্থা যেমন সফল এবং ব্যর্থ।

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

উদাহরণস্বরূপ, নিম্নলিখিতটি জুন, ২০১৫ বিলিং মাসের জন্য একজন নির্দিষ্ট ডেভেলপার কর্তৃক ইস্যুকৃত লেনদেনগুলো প্রদর্শন করে:

$ 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

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

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

সম্পদ ফেরত
/organizations/{org_name}/applications-with-transactions

লেনদেন সহ অ্যাপ্লিকেশন

/organizations/{org_name}/developers-with-transactions

লেনদেন সহ ডেভেলপাররা

/organizations/{org_name}/products-with-transactions

লেনদেন সহ পণ্য

/organizations/{org_name}/packages-with-transactions

লেনদেন সহ এপিআই পণ্য বান্ডেল (বা এপিআই প্যাকেজ)

অনুরোধটি পাঠানোর সময়, আপনাকে কোয়েরি প্যারামিটার হিসেবে তারিখের পরিসরের জন্য একটি শুরুর তারিখ এবং শেষের তারিখ উল্লেখ করতে হবে। উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটি ২০১৫ সালের আগস্ট মাসে লেনদেনকারী ডেভেলপারদের ফেরত দেয়।

$ 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"
  }, ...
  ]
}

এপিআই-এর জন্য রিপোর্ট কনফিগারেশন বিকল্পগুলি

The following report configuration options are available to the API:

নাম বর্ণনা ডিফল্ট প্রয়োজন?
name

The name of the report.

প্রযোজ্য নয় হ্যাঁ
description

A description of the report.

প্রযোজ্য নয় না
mintCriteria

The criteria for configuring a report. See Criteria configuration options for further details.

প্রযোজ্য নয় না
type

The type of the report. The value can be one of the following:

  • BILLING
  • REVENUE
  • VARIANCE
  • PREPAID_BALANCE
প্রযোজ্য নয় হ্যাঁ

Criteria configuration options

The following configuration options are available for reports through the mintCriteria property:

নাম বর্ণনা ডিফল্ট প্রয়োজন?
appCriteria

ID and organization for a specific application to be included in the report. If this property is not specified, all applications are included in the report.

প্রযোজ্য নয় না
billingMonth

Note: This property is not valid for revenue reports.

Billing month for the report, such as JULY.

প্রযোজ্য নয় হ্যাঁ
billingYear

Note: This property is not valid for revenue reports.

Billing year for the report, such as 2015.

প্রযোজ্য নয় হ্যাঁ
currCriteria

ID and organization for a specific currency to be included in the report. If this property is not specified, all supported currencies are included in the report.

প্রযোজ্য নয় না
currencyOption

Currency for the report. Valid values include:

  • LOCAL . Each line of the report is displayed using the applicable rate plan. This means that there may be multiple currencies in one report if the developers have plans that use different currencies.
  • EUR . Local currency transactions are converted and displayed in Euros.
  • GPB . Local currency transactions are converted and displayed in United Kingdom pounds.
  • USD . Local currency transactions are converted and displayed in United States dollars.
প্রযোজ্য নয় না
devCriteria

Developer ID (email address), and organization name for a specific developer to be included in the report. If this property is not specified, all developers are included in the report. For example:

"devCriteria":[{
    "id":"RtHAeZ6LtkSbEH56",
    "orgId":"my_org"}
]
                
প্রযোজ্য নয় না
devCustomAttributes

Note: This property applies only to revenue reports.

Custom attributes to include in the report, if defined for a developer. For example:

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

Note: Do not specify the predefined MINT_* and ADMIN_* attributes in the devCustomAttributes array.

প্রযোজ্য নয় না
fromDate

Note: This property applies only to revenue, variance, and transaction activity reports.

Starting date of the report in UTC.

প্রযোজ্য নয় Required for revenue reports; not required for other report types.
groupBy

Order in which columns are grouped in the report. Valid values include:

  • APPLICATION
  • BALANCE
  • DEVELOPER
  • ORG
  • PACKAGE
  • PRODUCT
  • RATEPLAN
প্রযোজ্য নয় না
monetizationPackageId

ID of one or more API product bundles to include in the report. If this property is not specified, all API product bundles are included in the report.

Note: This property is not valid when viewing the transaction activity ( /transaction-search ).

প্রযোজ্য নয় না
pkgCriteria

ID and organization for a specific API product bundle to be included in the report. If this property is not specified, all API product bundles are included in the report. This property can be specified instead of the monetizationpackageIds property.

Note: This property is not valid when viewing the transaction activity ( /transaction-search ).

প্রযোজ্য নয় না
prevFromDate

Note: This property applies only to variance reports.

Starting date of a previous period in UTC. Used to create a report for a previous period for comparison against a current report.

প্রযোজ্য নয় না
prevToDate

Note: This property applies only to variance reports.

Ending date of a previous period in UTC. Used to create a report for a previous period for comparison against a current report.

প্রযোজ্য নয় না
prodCriteria

ID and organization for a specific API product to be included in the report. If this property is not specified, all API products are included in the report. This property can be specified instead of the productIds property.

Note: This property is not valid when viewing the transaction activity ( /transaction-search ).

প্রযোজ্য নয় না
productIds

ID of one or more API products to include in the report. If this property is not specified, all API products are included in the report.

API product IDs should be specified as org-name@@@product-name . For example: "productIds": ["myorg@@@myproduct", "myorg@@@myproduct2"]

প্রযোজ্য নয় না
pricingTypes

Pricing type of rate plan to be included in the report. Valid values include:

  • REVSHARE . Revenue share plan.
  • REVSHARE_RATECARD . Revenue share and rate card rate plan.
  • RATECARD . Rate card plan.

If this property is not specified, rate plans of all pricing types are included in the report.

প্রযোজ্য নয় না
ratePlanLevels

Type of rate plan to be included in the report. Valid values include:

  • DEVELOPER . Developer rate plan.
  • STANDARD . Standard rate plan.

If this property is not specified, both developer-specific and standard rate plans are included in the report.

প্রযোজ্য নয় না
showRevSharePct

Flag that specifies whether the report shows revenue share percentages. Valid values include:

  • true . Show revenue share percentages.
  • false . Do not show revenue share percentages.
প্রযোজ্য নয় না
showSummary

Flag that specifies whether the report is a summary. Valid values include:

  • true . Report is a summary.
  • false . Report is not a summary.
প্রযোজ্য নয় না
showTxDetail

Note: This property applies only to revenue reports.

Flag that specifies whether the report shows transaction level details. Valid values include:

  • true . Show transaction-level details.
  • false . Do not show transaction-level details.
প্রযোজ্য নয় না
showTxType

Flag that specifies whether the report shows the type of each transaction. Valid values include:

  • true . Show the type of each transaction.
  • false . Do not show the type of each transaction.
প্রযোজ্য নয় না
toDate

Note: This property applies only to revenue, variance, and transaction activity reports.

End date of the report in UTC.

The report includes data collected up to the end of day before the date specified. Report data collected on the specified end date will be excluded from the report. If you want to expire a rate plan on December 31, 2016, for example, you should set the toDate value to 2017-01-01. In this case, the report will include report data up to the end of the day on December 31, 2016; report data on January 1, 2017 will be excluded.

প্রযোজ্য নয় Required for revenue reports; not required for other report types.
transactionStatus

Status of transactions to include in the report. Valid values include:

  • SUCCESS . Successful transaction.
  • DUPLICATE . Duplicate transaction. These transactions can be ignored. The data pipeline from the Apigee runtime to the rating server can sometimes generate duplicate transactions in order to be fault tolerant and monetization recognizes and marks them as duplicate.
  • FAILED . Failed transaction. This status is triggered when the validation of a precondition fails. For example:
    • Rating attempted even though the developer has not purchased rate plan. This can occur if the Monetization Limits Check policy is not configured.
    • Quota is exceeded, but calls still continue. This can occur if the Monetization Limits Check policy is not configured.
    • Negative custom attribute value was sent for custom attribute-based plan.
  • INVALID_TSC . Transaction is invalid. This status is triggered when the txProviderStatus runtime criteria does not match the success criteria specified at the API product bundle-level.
  • REVIEW . Transactions requiring review. This status is triggered for flexible revenue share rate plans if the value falls within a revenue range that is not configured.
প্রযোজ্য নয় না
transactionCustomAttributes

Custom transaction attributes to include in summary revenue reports. You must enable this feature in your organization. See Including custom transaction attributes in revenue summary reports .

প্রযোজ্য নয় না
transactionTypes

Type of transactions to be included in the report. Valid values include:

If this property is not specified, all transaction types are included in the report.

প্রযোজ্য নয় না