প্লে ক্যাটালগ এপিআই গুগল প্লে-তে নিবন্ধিত থার্ড-পার্টি অ্যাপ স্টোরগুলোকে (3PAS) গুগল প্লে অ্যাপ ক্যাটালগের আপডেটের জন্য পোল করার সুযোগ দেয়। পোলকারীরা শেষ দৈনিক ক্যাটালগ এক্সপোর্টের পর থেকে পরিবর্তিত বা অপসারিত অ্যাপগুলোর ক্যাটালগ বিবরণ সংগ্রহ করতে পারে।
এন্ডপয়েন্ট, মেথড এবং রিসোর্স স্কিমার সম্পূর্ণ তালিকার জন্য, প্লে ক্যাটালগ এপিআই রেফারেন্স দেখুন।
শুরু করার আগে
প্লে ক্যাটালগ এপিআই-তে কল করার আগে, আপনাকে অবশ্যই মূল গেটিং স্টার্টেড গাইডটি সম্পূর্ণ করে আপনার এপিআই অ্যাক্সেস, সার্ভিস ক্রেডেনশিয়াল এবং গুগল ক্লাউড প্রজেক্ট সেট আপ করতে হবে।
এপিআই ডিজাইন ও আর্কিটেকচার
প্লে ক্যাটালগ এক্সপোর্ট প্রতি ২৪ ঘণ্টায় তৈরি হয়। শেষ এক্সপোর্টের পর থেকে হওয়া আপডেটগুলো সংগ্রহ করার জন্য প্লে ক্যাটালগ এপিআই একটি ইন্ট্রাডে পোলিং ব্যবস্থা প্রদান করে:
- আপডেট ইভেন্টের জন্য পোল : কোন প্যাকেজের নামগুলো পরিবর্তন বা মুছে ফেলা হয়েছে তা খুঁজে বের করতে, আপনি একটি
startTimeএবংendTimeউইন্ডো দিয়েappstorecatalog.recentUpdateEvents.listএ কোয়েরি করেন। - বিস্তারিত ভিউ সংগ্রহ করুন : পরিবর্তিত প্রতিটি প্যাকেজ নামের জন্য, বিস্তারিত
CatalogAppViewমেটাডেটা সংগ্রহ করতে আপনিappstorecatalog.recentAppViews.getকল করবেন।
এপিআইটি শুধুমাত্র পঠনযোগ্য এবং এটি কেবল গত ৩৬ ঘণ্টার মধ্যে ঘটা ইভেন্টগুলোই ফেরত দেবে। এপিআইটির একটি QPS সীমা রয়েছে যা ২ এবং এটি উভয় পদ্ধতির জন্য প্রযোজ্য।
১. ক্যাটালগ আপডেট ইভেন্টের জন্য পোলিং
একটি নির্দিষ্ট সময়সীমার মধ্যে পরিবর্তিত প্যাকেজগুলির তালিকা পেতে, appstorecatalog.recentUpdateEvents.list মেথডটি কল করুন।
শুধুমাত্র যোগ্য অ্যাপগুলির আপডেট ইভেন্টগুলি ফেরত দেওয়া হয়। যোগ্য অ্যাপগুলিকে অবশ্যই হতে হবে:
- কলিং অ্যাপ স্টোরের ক্যাটালগে অন্তর্ভুক্তির জন্য সম্মতি দেওয়া হয়েছে।
- মার্কিন যুক্তরাষ্ট্রে (US) গুগল প্লে স্টোরে প্রকাশিত ও উপলব্ধ।
আপডেটের প্রকারভেদ বোঝা
-
MODIFICATION: যখন কোনো যোগ্য অ্যাপ পরিবর্তন করা হয়, প্রথমবারের মতো প্রকাশ করা হয়, মার্কিন যুক্তরাষ্ট্রকে লক্ষ্য করে প্রচার শুরু করে, অথবা যখন অ্যাপটি নতুনভাবে আপনার ক্যাটালগে অন্তর্ভুক্ত হয়, তখন এটি সক্রিয় হয়। -
DELETION: যখন কোনো অ্যাপ অপ্রকাশিত করা হয়, ক্যাটালগে অন্তর্ভুক্ত হওয়া থেকে বিরত থাকে, স্থগিত বা ব্লক করা হয়, অথবা মার্কিন যুক্তরাষ্ট্রকে লক্ষ্য করা বন্ধ করে দেয়, তখন এটি সক্রিয় হয়।
২. ক্যাটালগ অ্যাপ ভিউ পুনরুদ্ধার করা
MODIFICATION ইভেন্টের মাধ্যমে ফেরত আসা প্রতিটি প্যাকেজের জন্য, আপনি appstorecatalog.recentAppViews.get মেথডটি কল করে সেটির আপডেট করা ক্যাটালগের বিবরণ পেতে পারেন।
৩. সর্বোত্তম অনুশীলন ও সমন্বয়
আপনার স্টোরে একটি সামঞ্জস্যপূর্ণ ক্যাটালগ ডেটাবেস বজায় রাখতে, এই ইন্টিগ্রেশন নির্দেশিকাগুলো অনুসরণ করুন:
- দৈনিক এক্সপোর্ট সিঙ্ক : দৈনিক ক্যাটালগ এক্সপোর্ট ব্যবহার করে যোগ্য অ্যাপগুলির সম্পূর্ণ তালিকা ইম্পোর্ট করুন।
- (ঐচ্ছিক) ইন্ট্রাডে সিঙ্ক : একটি পরিবর্তনশীল টাইম উইন্ডো ব্যবহার করে
appstorecatalog.recentUpdateEvents.listএন্ডপয়েন্টটি নিয়মিতভাবে (যেমন, প্রতি মিনিটে) পোল করুন।nextPageTokenব্যবহার করে পেজিনেশন পরিচালনা করা নিশ্চিত করুন।- প্রক্রিয়া আপডেট :
-
MODIFICATIONইভেন্টের ক্ষেত্রে,appstorecatalog.recentAppViews.getব্যবহার করে আপডেট করাCatalogAppViewটি ফেচ করুন এবং আপনার লোকাল ডাটাবেস আপডেট করুন। -
DELETIONক্ষেত্রে, আপনার স্টোরের তালিকা থেকে অ্যাপটি সরিয়ে দিন অথবা ব্যবহারকারীদের কাছ থেকে এটি লুকিয়ে ফেলুন।
-
- পুনরাবৃত্ত পরিবর্তনের ইভেন্টগুলি পরিচালনা করুন : আপনি একই অ্যাপের জন্য একাধিক MODIFICATION ইভেন্ট দেখতে পারেন। এর মানে হলো, কোয়েরি করা সময়সীমার মধ্যে অ্যাপটি একাধিকবার পরিবর্তিত হয়েছে।
appstorecatalog.recentAppViews.getসর্বদা সর্বশেষ পরিবর্তিত অ্যাপ ভিউটি ফেরত দেবে।
- প্রক্রিয়া আপডেট :