এই নির্দেশিকা থেকে জানতে পারবেন যে কীভাবে Google Play Developer API ব্যবহার করে আপনার Play অ্যাপের জন্য প্রোডাক্ট ক্যাটালগ তৈরি ও ম্যানেজ করতে হয়।
Google Play-র বিলিং সিস্টেমের মাধ্যমে আপনার অ্যাপে প্রোডাক্ট বিক্রি করতে, ব্যবহারকারীদের কেনার জন্য উপলভ্য করতে চান এমন সব প্রোডাক্টের একটি ক্যাটালগ আপনাকে সেট-আপ করতে হবে। এটি Play Console-এর মাধ্যমে করা যেতে পারে অথবা আপনি Google Play Developer API ব্যবহার করে ক্যাটালগ ম্যানেজমেন্ট অটোমেট করতে পারেন। অটোমেশন আপনার ক্যাটালগ সবসময় আপ-টু-ডেট রাখতে সাহায্য করতে পারে এবং বড় ক্যাটালগের ক্ষেত্রে স্কেল করতে পারে যেখানে ম্যানুয়াল কোঅর্ডিনেশন অবাস্তব। এই নির্দেশিকায় আপনি দেখতে পাবেন কীভাবে Play Developer API ব্যবহার করে আপনার Play অ্যাপের জন্য প্রোডাক্ট ক্যাটালগ তৈরি ও ম্যানেজ করতে হয়। আপনার ব্যাকএন্ড ইন্টিগ্রেশনের জন্য Google Play Developer API কীভাবে সেট-আপ করবেন সেই সংক্রান্ত নির্দেশাবলীর জন্য আমাদের শুরু করা নির্দেশিকা পর্যালোচনা করুন।
ক্যাটালগ ম্যানেজমেন্ট API
Google Play-এর বিলিং সিস্টেমের মাধ্যমে আপনি যেসব বিভিন্ন ধরনের প্রোডাক্ট বিক্রি করতে পারবেন, সেই সম্পর্কে জানতে, অ্যাপ-মধ্যস্থ প্রোডাক্টের ধরন ও ক্যাটালগ সংক্রান্ত বিবেচনা বোঝা নিবন্ধটি পড়ুন। Google, Play-তে ক্যাটালগ ম্যানেজমেন্টের জন্য দুটি প্রধান API সেট অফার করে, যা দুটি প্রধান প্রোডাক্ট বিভাগের সাথে সম্পর্কিত:
- এককালীন প্রোডাক্ট
- সাবস্ক্রিপশন প্রোডাক্ট
এককালীন প্রোডাক্ট
এককালীন প্রোডাক্ট (আগে অ্যাপ-মধ্যস্থ প্রোডাক্ট হিসেবে উল্লেখ করা হত) এককালীন প্রোডাক্ট অবজেক্ট মডেল ব্যবহার করে যা আপনাকে এককালীন প্রোডাক্টের জন্য একাধিক কেনাকাটার বিকল্প ও অফার কনফিগার করতে দেয়। এককালীন প্রোডাক্ট অবজেক্ট মডেল আপনাকে প্রোডাক্ট বিক্রি করার ক্ষেত্রে আরও বেশি নমনীয়তা প্রদান করে এবং সেগুলি ম্যানেজ করার জটিলতা কমায়। আপনার আগে থেকে থাকা অ্যাপ-মধ্যস্থ প্রোডাক্ট এককালীন প্রোডাক্ট অবজেক্ট মডেলে মাইগ্রেট করা হবে। আরও তথ্যের জন্য অ্যাপ-মধ্যস্থ প্রোডাক্টের মাইগ্রেশন দেখুন।
monetization.onetimeproducts এবং
inappproducts এন্ডপয়েন্ট আপনাকে
ব্যাকএন্ড থেকে এককালীন প্রোডাক্ট ম্যানেজ করতে দেয়। এর মধ্যে প্রোডাক্ট তৈরি, আপডেট ও মুছে দেওয়া এবং দাম ও উপলভ্যতা ম্যানেজ করা অন্তর্ভুক্ত। আপনি এককালীন প্রোডাক্ট কেনাকাটা কীভাবে ম্যানেজ করেন তার উপর নির্ভর করে, আপনি কনজিউমেবল প্রোডাক্ট (যতবার ইচ্ছা কেনা যায়) বা স্থায়ী এনটাইটেলমেন্ট (একই ব্যবহারকারী দুবার কিনতে পারেন না) মডেল করবেন। আপনি সিদ্ধান্ত নিতে পারেন যে কোন এককালীন প্রোডাক্ট ব্যবহারযোগ্য হবে বা হবে না।
সাবস্ক্রিপশন প্রোডাক্ট
monetization.subscriptions এন্ডপয়েন্ট আপনাকে ডেভেলপার ব্যাকএন্ড থেকে সাবস্ক্রিপশন
প্রোডাক্ট ম্যানেজ করতে সাহায্য করে। আপনি সাবস্ক্রিপশন তৈরি, আপডেট ও মুছে ফেলার মতো কাজ করতে পারেন
অথবা সেগুলির আঞ্চলিক উপলভ্যতা ও দাম নিয়ন্ত্রণ করতে পারেন। monetization.subscriptions এন্ডপয়েন্ট ছাড়াও, আমরা সাবস্ক্রিপশনের বেস প্ল্যান ও অফার ম্যানেজ করার জন্য যথাক্রমে
monetization.subscriptions.basePlans এবং
monetization.subscriptions.basePlans.offers প্রদান করি।
ব্যাচ পদ্ধতি
onetimeproducts,
inappproducts এবং monetization.subscriptions
এন্ডপয়েন্টগুলি বেশ কয়েকটি ব্যাচ পদ্ধতি প্রদান করে যা একই সময়ে একই অ্যাপের অধীনে সর্বাধিক ১০০টি এন্টিটি
উদ্ধার বা ম্যানেজ করার অনুমতি দেয়।
ব্যাচ পদ্ধতি, লেটেন্সি টলারেন্স চালু করে ব্যবহার করা হলে, আরও বেশি থ্রুপুট সাপোর্ট করে এবং প্রাথমিক ক্যাটালগ তৈরি বা ক্যাটালগ রিকনসিলিয়েশনের জন্য বড়-ক্যাটালগ ডেভেলপারদের জন্য বিশেষভাবে উপযোগী।
প্রোপাগেশন লেটেন্সি বনাম থ্রুপুট আপডেট করুন
প্রোডাক্ট তৈরি বা পরিবর্তন করার অনুরোধ সম্পূর্ণ হওয়ার পরে, নেটওয়ার্ক বা ব্যাকএন্ড প্রসেসিংয়ে দেরি হওয়ার কারণে ব্যবহারকারীরা তাদের ডিভাইসে
পরিবর্তনগুলি সাথে সাথে দেখতে নাও পেতে পারেন। ডিফল্ট হিসেবে, প্রোডাক্টে পরিবর্তন করার সব অনুরোধ
লেটেন্সি-সেনসিটিভ হয়। এর অর্থ হল, ব্যাকএন্ড সিস্টেমের মাধ্যমে দ্রুত প্রচারের জন্য এগুলি অপ্টিমাইজ করা হয়েছে, যা সাধারণত কয়েক মিনিটের মধ্যে ব্যবহারকারীর ডিভাইসে প্রতিফলিত হয়।
তবে, এই ধরনের পরিবর্তনের অনুরোধের সংখ্যার উপর প্রতি ঘণ্টার সীমা রয়েছে।
যেসব ক্ষেত্রে আপনাকে অনেক প্রোডাক্ট তৈরি বা আপডেট করতে হবে (যেমন, প্রাথমিক বড় ক্যাটালগ তৈরির সময়), আপনি
latencyToleranceফিল্ড
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT-এ সেট করে ব্যাচ পদ্ধতি ব্যবহার করতে পারেন। এটি
আপডেট থ্রুপুট উল্লেখযোগ্যভাবে বৃদ্ধি করবে। লেটেন্সি-টলারেন্ট আপডেট ব্যবহারকারীর ডিভাইসে
পৌঁছাতে ২৪ ঘণ্টা পর্যন্ত সময় লাগবে।
কোটা কনফিগারেশন
Play Developer API ব্যবহার করে আপনার প্রোডাক্ট ক্যাটালগ ম্যানেজ করার সময় আপনাকে বেশ কিছু কোটা সীমা সম্পর্কে সচেতন থাকতে হবে:
- Google Play Developer API-কে বাকেট নামক বিভাগে সাজানো হয়, যেখানে প্রতিটি বাকেটের নিজস্ব প্রতি-মিনিট কোটার সীমা থাকে। আরও তথ্যের জন্য, কোটা দেখুন।
- প্রোডাক্ট পরিবর্তন করার এন্ডপয়েন্টও প্রতি ঘণ্টায় ৭,২০০ কোয়েরির সীমা প্রয়োগ করে। এটি এককালীন প্রোডাক্ট ও সাবস্ক্রিপশন এবং তৈরি, আপডেট, অ্যাক্টিভেট, মুছে দেওয়া সহ সব পরিবর্তন সংক্রান্ত অনুরোধের ক্ষেত্রে প্রযোজ্য একটি সীমা। ব্যাচ মডিফিকেশন মেথড কল এই কোটার জন্য একটি কোয়েরি হিসেবে গণনা করা হয়, এতে অন্তর্ভুক্ত স্বতন্ত্র অনুরোধের সংখ্যা বা তাদের লেটেন্সি সংবেদনশীলতা যাই হোক না কেন।
- এছাড়াও, লেটেন্সি সংবেদনশীল পরিবর্তনের ক্ষেত্রে প্রতি ঘণ্টায় ৭,২০০টি পরিবর্তনের সীমা রয়েছে। ব্যাচ পদ্ধতির ক্ষেত্রে, এই কোটার উদ্দেশ্যে প্রতিটি নেস্টেড পরিবর্তনের অনুরোধ আলাদাভাবে গণনা করা হয়। এই কোটা শুধুমাত্র ব্যাচ API ব্যবহারকারীদের জন্য প্রযোজ্য যারা লেটেন্সি-সংবেদনশীল আপডেট করেন, কারণ অন্যান্য ক্ষেত্রে কোটা ২ এই কোটার আগে বা একই সময়ে শেষ হয়ে যাবে।
বিভিন্ন অনুরোধের কোটা ব্যবহার বোঝার জন্য এখানে বেশ কয়েকটি উদাহরণ দেওয়া হল:
- একটি আইটেম ফেচ করার জন্য একটি
getঅনুরোধ কোটা ১-এর ১টি টোকেন ব্যবহার করবে এবং কোটা ২ এবং ৩-এর কোনও টোকেন ব্যবহার করবে না (কারণ সেগুলি শুধুমাত্র পরিবর্তন এন্ডপয়েন্টের সাথে সম্পর্কিত)। - ১০০টি পর্যন্ত আইটেম ফেচ করার জন্য একটি ব্যাচ
getঅনুরোধও কোটা ১-এর ১টি টোকেন ব্যবহার করবে এবং কোটা ২ ও ৩-এর কোনও টোকেন ব্যবহার করবে না। - একটি আইটেমের জন্য একটি
modificationঅনুরোধ কোটা ১-এর ১টি টোকেন , কোটা ২-এর ১টি টোকেন ব্যবহার করবে। অনুরোধটি লেটেন্সি সংবেদনশীল হলে, এটি কোটা ৩-এর ১টি টোকেনও ব্যবহার করবে। যেহেতু কোটা C-এর সীমা কোটা 2-এর মতোই, তাই শুধুমাত্র একটি পরিবর্তন পদ্ধতি ব্যবহারকারী ব্যবহারকারীদের জন্য এর কোনও ব্যবহারিক প্রভাব নেই। - ১০০টি লেটেন্সি টলারেন্ট আইটেমের জন্য একটি ব্যাচ
modificationঅনুরোধ কোটা ১-এর ১টি টোকেন, কোটা ২-এর ১টি টোকেন ব্যবহার করবে। এই কোটা সেট-আপের মাধ্যমে আপনার ক্যাটালগ আপডেট রাখার জন্য পর্যাপ্ত মার্জিন পাওয়া যাবে, তবে আপনার অ্যালগরিদম এই কোটা সম্পর্কে সচেতন না হলে এবং এই রেটের বাইরে গেলে, আপনি প্রতিটি অতিরিক্ত কলের জন্য একটি ত্রুটি পেতে পারেন। - ১০০টি লেটেন্সি সংবেদনশীল আইটেমের জন্য একটি ব্যাচ
modificationঅনুরোধ কোটা ১-এর ১টি টোকেন, কোটা ২-এর ১টি টোকেন এবং কোটা ৩-এর ১০০টি টোকেন ব্যবহার করবে।
Catalog Management API ব্যবহার সংক্রান্ত সাজেশন
এইসব নির্দেশিকা মেনে চলার মাধ্যমে, আপনি API-এর সাথে আপনার ইন্টার্যাকশন অপ্টিমাইজ করেন, যা একটি মসৃণ এবং দক্ষ ক্যাটালগ ম্যানেজমেন্ট অভিজ্ঞতা নিশ্চিত করে।
আপনার ব্যবহার মনিটর করা
আপনাকে অবশ্যই জানতে হবে যে কোন কোন প্রসেস বেশি রিসোর্স ব্যবহার করে। যেমন, ইন্টিগ্রেশনের শুরুতে আপনার ক্যাটালগ ম্যানেজমেন্ট এন্ডপয়েন্ট, সম্পূর্ণ প্রাথমিক ক্যাটালগ তৈরি করতে আরও বেশি কোটা ব্যবহার করতে পারে এবং আপনি সামগ্রিক ব্যবহারের সীমার কাছাকাছি থাকলে, এটি সম্ভাব্যভাবে কেনাকাটার স্ট্যাটাস API-এর মতো অন্যান্য এন্ডপয়েন্টের প্রোডাকশন ব্যবহারকে প্রভাবিত করতে পারে। API কোটা যাতে অতিক্রম না হয় তা নিশ্চিত করতে আপনাকে কোটা ব্যবহার মনিটর করতে হবে। ব্যবহার মনিটর করার একাধিক উপায় আছে। যেমন, আপনি Google Cloud API কোটা ড্যাশবোর্ড, অথবা আপনার পছন্দের অন্য কোনও ইন-হাউস বা থার্ড-পার্টি API মনিটরিং টুল ব্যবহার করতে পারেন।
API কোটার ব্যবহার অপ্টিমাইজ করা
API সংক্রান্ত সমস্যার সম্ভাবনা কমাতে রেট কনজাম্পশন অপ্টিমাইজ করার জন্য বিশেষভাবে সাজেস্ট করা হয়। এটি কার্যকরভাবে প্রয়োগ করতে, আমরা আপনাকে সাজেস্ট করি যে:
- সঠিক ক্যাটালগ ম্যানেজমেন্ট স্ট্র্যাটেজি বেছে নিন। API কোটা সম্পর্কে বুঝে নেওয়ার পরে, আপনার ক্যাটালগ ম্যানেজমেন্টের লক্ষ্য দক্ষতার সাথে পূরণ করার জন্য আপনার অ্যাপ্লিকেশনের জন্য সঠিক কৌশল বেছে নিতে হবে।
- আপনার পরিবর্তনগুলি প্রতিফলিত করার জন্য আপনার প্রয়োজনীয় ন্যূনতম সংখ্যক কল করুন।
- API-তে অপ্রয়োজনীয় বা অতিরিক্ত মডিফিকেশন কল পাঠাবেন না। এর জন্য আপনাকে ব্যাকএন্ড ক্যাটালগে চেঞ্জলগ রাখতে হতে পারে।
- প্রোডাক্ট পরিবর্তন করার ক্ষেত্রে প্রতি ঘণ্টায় ৭,২০০ কোয়েরির সীমা মেনে চলুন। আপনি হয়ত এমন সিঙ্ক প্রসেস তৈরি করতে চান যার জন্য আপনাকে অল্প সময়ের মধ্যে প্রোডাক্টে অনেক পরিবর্তন করতে হবে (যেমন, প্রাথমিক ক্যাটালগ তৈরি করা)। আপনি যদি মনে করেন যে এইসব প্রসেস প্রতি ঘণ্টার সীমা অতিক্রম করে যাবে, তাহলে ব্যবহারকে নিরাপদ লেভেলে নামিয়ে আনার জন্য প্রয়োজনীয় অপেক্ষা করার সময় সেট করুন। আরও বেশি থ্রুপুট পেতে, লেটেন্সি টলারেন্ট আপডেটের সাথে ব্যাচ পদ্ধতি ব্যবহার করার কথা বিবেচনা করুন।
- স্কেল করার জন্য আগে থেকেই প্রস্তুত থাকুন। আপনার অ্যাপ্লিকেশন আরও বড় হওয়ার সাথে সাথে, আপনাকে API এবং বিভিন্ন এন্ডপয়েন্টের ব্যবহার বাড়াতে হতে পারে। সর্বাধিক ব্যবহারের কাছাকাছি পৌঁছে গেলে কীভাবে আপনার কোটা বাড়াবেন সেই সম্পর্কে বিস্তারিত জানতে Google Play Developer API কোটা ডকুমেন্টেশন পড়ুন।
- কৌশলগতভাবে ভারী প্রসেস শিডিউল করুন। আপনার ক্যাটালগের ভারী প্রসেসগুলি গুরুত্বপূর্ণ ব্যবহারের পিক আওয়ারের কাছাকাছি শিডিউল করার চেষ্টা করুন, উদাহরণস্বরূপ আপনি সপ্তাহের পিক সেলস টাইমে সম্পূর্ণ ক্যাটালগ সিঙ্ক করা এড়াতে পারেন।
কোটা সংক্রান্ত সমস্যা ম্যানেজ করার লজিক যোগ করুন
আপনি যত দক্ষতার সাথেই ক্যাটালগ ম্যানেজমেন্ট লজিক তৈরি করুন না কেন, আপনাকে
এটি অপ্রত্যাশিত কোটা সীমার সাথে মানানসই করে তুলতে হবে, কারণ দৈনিক কোটা
আপনার ইন্টিগ্রেশনের স্বাধীন মডিউলে ব্যবহৃত এন্ডপয়েন্ট দ্বারা শেয়ার করা হয়। আপনার সমস্যা ম্যানেজ করার সময় কোটা থ্রটলিং সংক্রান্ত সমস্যা অন্তর্ভুক্ত করতে এবং উপযুক্ত সময় অপেক্ষা করার বিষয়টি প্রয়োগ করতে ভুলবেন না। Google Play Developer API-তে করা প্রতিটি কলের জন্য একটি উত্তর
জেনারেট করা হবে। কল ব্যর্থ হলে, আপনি একটি ব্যর্থতার রেসপন্স পাবেন
যার মধ্যে একটি HTTP রেসপন্স স্ট্যাটাস কোড এবং একটি errors অবজেক্ট অন্তর্ভুক্ত থাকে, যা
সমস্যার ডোমেন এবং একটি ডিবাগ মেসেজ সম্পর্কে আরও বিবরণ প্রদান করে। যেমন, আপনি দৈনিক সীমা পেরিয়ে গেলে, নিচে উল্লেখ করা সমস্যার মেসেজের মতো মেসেজ দেখতে পেতে পারেন:
{
"code" : 403,
"errors" : [ {
"domain" : "usageLimits",
"message" : "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API
Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxxx",
"reason" : "dailyLimitExceeded",
"extendedHelp" : "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxx"
} ],
}
ক্যাটালগ ম্যানেজমেন্ট প্রয়োগ করা
ডেভেলপাররা Google Play Developer API প্রোডাক্ট প্রকাশ করার এন্ডপয়েন্ট ব্যবহার করে তাদের ব্যাকএন্ড এবং Google Play-এর মধ্যে ক্যাটালগ সিঙ্ক করে রাখেন। আপনার Google Play ক্যাটালগ সবসময় ব্যাকএন্ড ক্যাটালগের লেটেস্ট তথ্যের সাথে আপ-টু-ডেট আছে কিনা তা নিশ্চিত করলে, ব্যবহারকারীকে আরও ভালো অভিজ্ঞতা প্রদান করা যায়। যেমন:
- আপনি উপলভ্য অফারের সম্পূর্ণ তালিকা দেখতে এবং অফার ও বেস প্ল্যান ট্যাগ ম্যানেজ করতে পারবেন, যাতে আপনার নিজের যোগ্যতা এবং অফার দেখানোর লজিক প্রভাবিত হয়।
- আপনি বিভিন্ন প্ল্যাটফর্ম জুড়ে ব্যবহারকারীদের দেখানো বিভিন্ন প্রাইস পয়েন্ট এবং প্রোডাক্টের বিবরণ চেক করতে পারেন এবং সেগুলি সামঞ্জস্যপূর্ণ কিনা তা নিশ্চিত করতে পারেন।
- নতুন কেনাকাটা প্রসেস করার সময় আপনার ব্যাকএন্ডে প্রোডাক্টের বিবরণ থাকবে, তাই ব্যবহারকারীর ক্রিটিক্যাল ফ্লো চলাকালীন Google Play Developer API-তে অতিরিক্ত কল করার প্রয়োজন হবে না। এর ফলে লেটেন্সি এবং ব্যর্থতার ঝুঁকিও কমবে।
Google Play-তে আপনার প্রোডাক্ট ক্যাটালগ তৈরি করার সময় আপনাকে নির্দিষ্ট কিছু সীমা ও বিষয় মনে রাখতে হবে। এইসব সীমাবদ্ধতা বুঝে নেওয়ার পরে এবং আপনার ক্যাটালগ কীভাবে সাজাতে চান তা জানার পরে, আপনার সিঙ্ক করার স্ট্র্যাটেজি সম্পর্কে সিদ্ধান্ত নেওয়ার সময় এসে গেছে।
ক্যাটালগ সিঙ্ক্রোনাইজেশন স্ট্র্যাটেজি
Google Play Developer API-এর প্রকাশনা এন্ডপয়েন্ট আপনাকে ক্যাটালগে পরিবর্তন হওয়ার সাথে সাথে তা আপডেট করার অনুমতি দেয়। মাঝে মাঝে, আপনাকে হয়ত পর্যায়ক্রমিক আপডেট পদ্ধতি অনুসরণ করতে হবে, যেখানে আপনি একই প্রসেসে অনেক পরিবর্তন পাঠান। প্রতিটি পদ্ধতির জন্য আলাদা ডিজাইন বেছে নিতে হয়। প্রতিটি সিঙ্ক করার কৌশল কিছু ব্যবহারের ক্ষেত্রে অন্যদের চেয়ে ভাল মানানসই হবে এবং আপনার পরিস্থিতির উপর নির্ভর করে এমন কিছু প্রয়োজন থাকতে পারে যা উভয়ের জন্যই প্রয়োজন।
কখনও কখনও আপনি কোনও নতুন পরিবর্তন সম্পর্কে সচেতন হওয়ার সাথে সাথেই কোনও প্রোডাক্টে আপডেট করতে চাইতে পারেন, যেমন একটি জরুরি প্রোডাক্ট আপডেট প্রসেস করা (যেমন, যত তাড়াতাড়ি সম্ভব একটি ভুল দাম সংশোধন করা প্রয়োজন)। অন্যান্য সময়ে আপনি পর্যায়ক্রমিক ব্যাকগ্রাউন্ড সিঙ্ক ব্যবহার করতে পারেন যাতে আপনার ব্যাকএন্ড এবং Play ক্যাটালগ সবসময় একই থাকে। আপনি এইসব বিভিন্ন ক্যাটালগ ম্যানেজমেন্ট স্ট্র্যাটেজি প্রয়োগ করতে চাইতে পারেন এমন কিছু সাধারণ ব্যবহারের উদাহরণ পড়ুন।
আপনার স্থানীয় ক্যাটালগ পরিবর্তন হলে কখন আপডেট পাঠাতে হবে
আদর্শগতভাবে, আপনার ব্যাকএন্ডের প্রোডাক্ট ক্যাটালগে কোনও পরিবর্তন হলে, যত তাড়াতাড়ি সম্ভব আপডেট করা উচিত, যাতে অমিল কম হয়।
এই ধরনের আপডেট এইসব ক্ষেত্রে ভাল বিকল্প:
- আপনার প্রোডাক্ট যাতে সবসময় আপ-টু-ডেট থাকে তা আপনাকে নিশ্চিত করতে হবে।
- আপনাকে প্রতিদিন আপনার প্রোডাক্টে কিছু পরিবর্তন করতে হবে।
- যেসব প্রোডাক্ট আগে থেকেই প্রোডাকশনে আছে এবং বিক্রি করা হচ্ছে সেগুলি আপনাকে আপডেট করতে হবে।
এই পদ্ধতি প্রয়োগ করা সহজ এবং এর মাধ্যমে আপনি ক্যাটালগ সিঙ্ক করে রাখতে পারবেন এবং অমিল হওয়ার সম্ভাবনাও কম থাকবে।
পর্যায়ক্রমিক আপডেট কখন ব্যবহার করতে হবে
আপনার ব্যাকএন্ডে প্রোডাক্ট সংস্করণে পর্যায়ক্রমিক আপডেটগুলি অ্যাসিঙ্ক্রোনাসভাবে চালানো হয়, এবং সেগুলি একটি ভাল বিকল্প যখন:
- আপনার প্রোডাক্টগুলি অল্প সময়ের মধ্যে আপডেট করা হয়েছে কিনা তা আপনাকে নিশ্চিত করতে হবে না।
- আপনাকে বাল্ক আপডেট বা সমঝোতা প্রক্রিয়ার পরিকল্পনা করতে হবে।
- আপনার ডিজিটাল প্রোডাক্ট ম্যানেজ করার জন্য আগে থেকেই কন্টেন্ট বা ক্যাটালগ ম্যানেজমেন্ট সিস্টেম আছে এবং সেটি আপনার ক্যাটালগ ক্রমাগত আপডেট করে
ক্যাটালগ বড় হলে, সর্বাধিক থ্রুপুট পেতে লেটেন্সি টলারেন্ট আপডেট সহ ব্যাচ পদ্ধতি ব্যবহার করার কথা বিবেচনা করুন।
আপনার প্রোডাক্ট ক্যাটালগ তৈরি করুন
Google Play-তে আপলোড করার জন্য আপনার কাছে বড় ক্যাটালগ থাকলে, আপনি প্রাথমিক লোড অটোমেট করতে চাইবেন। এই ধরনের ভারী প্রসেস সবচেয়ে ভাল কাজ করে যদি লেটেন্সি টলারেন্ট ব্যাচ পদ্ধতির সাথে পর্যায়ক্রমিক স্ট্র্যাটেজি অনুসরণ করা হয়।
এককালীন প্রোডাক্ট তৈরি করা
প্রাথমিক এককালীন প্রোডাক্ট ক্যাটালগ তৈরির জন্য, আমরা
monetization.onetimeproducts.batchUpdate
বা inapp_products.insert পদ্ধতি ব্যবহার করার সাজেশন দিই, যেখানে
allowMissing ফিল্ড true-এ সেট করা থাকে এবং latencyTolerance ফিল্ড
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT-এ সেট করা থাকে। এটি কোটা সীমার মধ্যে ক্যাটালগ তৈরি করতে
লাগা সময় কমিয়ে দেবে।
সাবস্ক্রিপশন প্রোডাক্ট তৈরি করা
প্রাথমিক সাবস্ক্রিপশনের জন্য বড় ক্যাটালগ তৈরি করতে, আমরা সাজেস্ট করি যে আপনি
monetization.subscriptions.batchUpdate পদ্ধতি ব্যবহার করুন
যেখানে allowMissing ফিল্ড true-এ সেট করা থাকবে এবং latencyToleranceফিল্ড
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT-এ সেট করা থাকবে। এর ফলে কোটা সীমার মধ্যে ক্যাটালগ তৈরি করতে
কম সময় লাগবে।
ছোট সাবস্ক্রিপশন ক্যাটালগের জন্য Play Developer API
monetization.subscriptions.create পদ্ধতি প্রদান করে।
এছাড়াও, আপনি প্রোডাক্ট আপডেট বিভাগে বর্ণনা করা
allowMissing প্যারামিটার সহ
monetization.subscriptions.patch পদ্ধতি ব্যবহার করে সাবস্ক্রিপশন তৈরি করতে পারবেন।
আগের সব পদ্ধতি সাবস্ক্রিপশন অবজেক্টের মধ্যে দেওয়া বেস প্ল্যানের সাথে সাবস্ক্রিপশন তৈরি করে। এইসব বেস প্ল্যান প্রাথমিকভাবে
বন্ধ থাকে। বেস প্ল্যানের স্ট্যাটাস ম্যানেজ করতে, আপনি
monetization.subscriptions.basePlans এন্ডপয়েন্ট ব্যবহার করতে পারেন, যার মধ্যে কেনাকাটার জন্য উপলভ্য করতে
বেস প্ল্যান অ্যাক্টিভেট করাও অন্তর্ভুক্ত। এছাড়াও,
monetization.subscriptions.basePlans.offers এন্ডপয়েন্ট আপনাকে অফার তৈরি ও
ম্যানেজ করতে দেয়।
প্রোডাক্ট সম্পর্কিত আপডেট
নিম্নলিখিত পদ্ধতিগুলি আপনাকে আপনার বিদ্যমান প্রোডাক্টগুলি দক্ষতার সাথে পরিবর্তন করতে সক্ষম করে, আপনার অফারগুলি আপনার সাম্প্রতিক অ্যাডজাস্টমেন্টের সাথে সামঞ্জস্যপূর্ণ তা নিশ্চিত করে।
এককালীন প্রোডাক্ট আপডেট করুন
আগে থেকে থাকা এককালীন প্রোডাক্ট আপডেট করার জন্য নিম্নলিখিত পদ্ধতিগুলি উপলভ্য।
- monetization.onetimeproducts.batchUpdate
inappproducts.patch: রিসোর্স আংশিকভাবে আপডেট করতে প্যাচ এন্ডপয়েন্ট ব্যবহার করা হয়। এর অর্থ হল, আপনি অনুরোধের প্রধান অংশে নির্দিষ্ট করা ফিল্ড আপডেট করতে পারবেন। সাধারণত, কোনও রিসোর্সের মাত্র কয়েকটি ফিল্ড আপডেট করার প্রয়োজন হলে, প্যাচ এন্ডপয়েন্ট ব্যবহার করা হয়।inappproducts.update: আপডেট এন্ডপয়েন্ট ব্যবহার করে কোনও রিসোর্স সম্পূর্ণভাবে আপডেট করা হয়। এর অর্থ হল, আপনাকে অনুরোধের প্রধান অংশে সম্পূর্ণ রিসোর্স অবজেক্ট পাঠাতে হবে। সাধারণত আপডেট এন্ডপয়েন্ট ব্যবহার করা হয় যখন আপনাকে কোনও রিসোর্সের সব ফিল্ড আপডেট করতে হয়।allowMissingপ্যারামিটারtrue-এ সেট করা থাকলে এবং প্রদত্ত প্রোডাক্ট আইডি আগে থেকে না থাকলে, এন্ডপয়েন্ট ব্যর্থ হওয়ার পরিবর্তে প্রোডাক্টটি যোগ করবে।inappproducts.batchUpdate: এটি আপডেট এন্ডপয়েন্টের ব্যাচ ভার্সন, যা আপনাকে একটি কোয়েরির মাধ্যমে একাধিক প্রোডাক্ট পরিবর্তন করতে দেয়। আরও বেশি থ্রুপুট পেতেlatencyToleranceফিল্ডের সাথে এটি ব্যবহার করুন,PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT-এ সেট করুন।
সাবস্ক্রিপশন প্রোডাক্ট আপডেট করা
আগে থেকে থাকা সাবস্ক্রিপশন আপডেট করতে, আপনি
monetization.subscriptions.patch পদ্ধতি ব্যবহার করতে পারেন। এই পদ্ধতিতে
নিম্নলিখিত প্রয়োজনীয় প্যারামিটারগুলি ব্যবহার করা হয়:
packageName: যে অ্যাপের সাবস্ক্রিপশন, সেটির প্যাকেজের নাম।productId: সাবস্ক্রিপশনের অনন্য প্রোডাক্ট আইডি।
regionsVersion: অঞ্চল সংক্রান্ত কনফিগারেশন ভার্সন।
আপনি allowMissing প্যারামিটার ব্যবহার করে নতুন সাবস্ক্রিপশন তৈরি না করলে
, আপনাকে অবশ্যই updateMask প্যারামিটার প্রদান করতে হবে। এই প্যারামিটার হল
কমা দিয়ে আলাদা করা ফিল্ডের তালিকা যা আপনি আপডেট করতে চান।
যেমন, আপনি যদি শুধু সাবস্ক্রিপশন প্রোডাক্টের তালিকা আপডেট করতে চান, তাহলে
updateMask প্যারামিটারে listings ফিল্ড উল্লেখ করতে হবে।
একই সময়ে একাধিক সাবস্ক্রিপশন আপডেট করতে আপনি monetization.subscriptions.batchUpdate ব্যবহার করতে পারবেন।
আরও বেশি থ্রুপুট পেতে, latencyTolerance ফিল্ডের সাথে এটি ব্যবহার করুন, যা
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT-এ সেট করা আছে।
বেস প্ল্যান অ্যাক্টিভেট, ডিঅ্যাক্টিভেট, মুছে দিতে অথবা সাবস্ক্রাইবারদের লেটেস্ট বেস প্ল্যানের দামের ভার্সনে মাইগ্রেট করতে monetization.subscriptions.basePlans এন্ডপয়েন্ট ব্যবহার করুন।
এছাড়াও, আপনি
monetization.subscriptions.basePlans.offers.patch
পদ্ধতির মাধ্যমে আপনার বেস প্ল্যানের অফার আপডেট করতে পারবেন।
ক্যাটালগ রিকনসিলিয়েশন
আপনার ব্যাকএন্ডের ক্যাটালগ পরিবর্তন হলে বা নির্দিষ্ট সময় অন্তর, আপনি প্রতিবার Google Play ক্যাটালগ আপডেট করার বিকল্প বেছে নিলে, Google Play ক্যাটালগের বাইরে আপনার ক্যাটালগ ম্যানেজমেন্ট সিস্টেম বা ডেটাবেস থাকলে, এমন পরিস্থিতি তৈরি হতে পারে যেখানে Play-তে আপনার অ্যাপ কনফিগারেশনের ক্যাটালগের সাথে এটি সিঙ্ক হয় না। এটি কনসোলে জরুরি ম্যানুয়াল ক্যাটালগ পরিবর্তন, আপনার ক্যাটালগ ম্যানেজমেন্ট সিস্টেমে আউটেজ বা আপনার লেটেস্ট ডেটা হারিয়ে যাওয়ার কারণে হতে পারে।
দীর্ঘ সময় ধরে অমিল হওয়ার সমস্যা এড়াতে আপনি ক্যাটালগ রিকনসিলিয়েশন প্রসেস তৈরি করতে পারেন।
পার্থক্য সিস্টেম বিবেচনা
আমরা সাজেস্ট করি যে আপনি একটি ডিফারেন্স সিস্টেম তৈরি করুন যাতে অসঙ্গতি শনাক্ত করা যায় এবং দুটি সিস্টেমের মধ্যে সামঞ্জস্য আনা যায়। আপনার ক্যাটালগ সিঙ্ক করে রাখতে সাহায্য করার জন্য একটি ডিফারেন্স সিস্টেম তৈরি করার সময় কিছু বিষয় বিবেচনা করতে হবে:
- ডেটা মডেল বোঝা: প্রথম ধাপ হল ডেভেলপার CMS এবং Google Play Developer API-এর ডেটা মডেল বোঝা। এর মধ্যে প্রতিটি সিস্টেমে স্টোর করা বিভিন্ন ধরনের ডেটা এবং কীভাবে বিভিন্ন ডেটা এলিমেন্ট একে অপরের সাথে ম্যাপ করে তা জানা অন্তর্ভুক্ত।
- diff নিয়ম নির্ধারণ করা: ডেটা মডেল বুঝে নেওয়ার পরে আপনাকে diff নিয়ম নির্ধারণ করতে হবে। দুটি সিস্টেমের ডেটা কীভাবে তুলনা করা হবে তা এই নিয়মগুলি নির্ধারণ করবে। যেমন, আপনি হয়ত প্রোডাক্ট আইডি ম্যাচ করতে এবং সাবস্ক্রিপশন ও তার সাথে সম্পর্কিত বেস প্ল্যান ও অফারের মূল অ্যাট্রিবিউট তুলনা করতে চাইবেন।
- ডিফ অ্যালগরিদম প্রয়োগ করা: ডিফ রুল সংজ্ঞায়িত করার পরে, আপনাকে ডিফ অ্যালগরিদম প্রয়োগ করতে হবে। এই অ্যালগরিদম দুটি সিস্টেম থেকে ডেটা নেবে এবং আপনার সংজ্ঞায়িত নিয়ম অনুযায়ী তুলনা করবে। Google Play থেকে
ক্যাটালগ ডেটা পেতে, আপনি
monetization.onetimeproducts.list,monetization.onetimeproducts.batchGet,inappproducts.list,inappproducts.batchGet,monetization.subscriptions.listএবংmonetization.subscriptions.batchGetপদ্ধতি ব্যবহার করতে পারেন। - ডিফ রিপোর্ট তৈরি করা: ডিফ অ্যালগরিদম একটি ডিফ রিপোর্ট তৈরি করবে। এই রিপোর্টে দুটি সিস্টেমের মধ্যে পার্থক্য দেখানো হবে।
- পার্থক্য রিকনসাইল করা: ডিফারেন্স রিপোর্ট তৈরি করার পরে, আপনাকে পার্থক্যগুলি সমাধান করতে হবে। এর মধ্যে আপনার CMS-এ ডেটা আপডেট করা, অথবা Developer API ক্যাটালগ ম্যানেজমেন্ট এন্ডপয়েন্ট ব্যবহার করে Google Play-এর দিকে ডেটা আপডেট করা অন্তর্ভুক্ত থাকতে পারে, এটি নির্ভর করে আপনি সাধারণত কীভাবে আপনার ক্যাটালগ আপডেট করেন তার উপর। সিঙ্ক না হওয়া প্রোডাক্ট রিকনসাইল করতে, প্রোডাক্ট আপডেট বিভাগে বর্ণনা করা আপডেট এন্ডপয়েন্ট ব্যবহার করুন।
প্রোডাক্টের অবচিতি
Google Play Developer API আপনার প্রোডাক্ট বন্ধ করার ব্যাপারে সাহায্য করার জন্য নিম্নলিখিত পদ্ধতিগুলি প্রদান করে:
এককালীন প্রোডাক্টের জন্য:
monetization.onetimeproducts.deletemonetization.onetimeproducts.batchDeleteinappproducts.deleteinappproducts.batchDelete
সাবস্ক্রিপশন প্রোডাক্টের জন্য:
monetization.subscriptions.deleteসাবস্ক্রিপশনের জন্য। অন্তত একটি বেস প্ল্যান অ্যাক্টিভেট করা হয়ে গেলে সাবস্ক্রিপশন সরানো যাবে না।
বিভিন্ন পরিস্থিতিতে কোনও প্রোডাক্ট বন্ধ করে দেওয়া প্রয়োজন হতে পারে, যেমন:
- ভুল করে তৈরি করা হয়েছে।
- কোনও ফিচার বা পরিষেবা বন্ধ করে দেওয়া।
আপনার ক্যাটালগ ম্যানেজমেন্ট স্ট্র্যাটেজিতে প্রোডাক্ট বন্ধ করার বিষয়টি অন্তর্ভুক্ত করার জন্য আমরা সাজেস্ট করি।