Google Play Developer API

এক নজরে

Google Play Console, REST-ভিত্তিক ওয়েব পরিষেবা API-এর একটি স্যুট প্রদান করে যা আপনাকে সরাসরি আপনার অ্যাপের জন্য প্রকাশনা, রিপোর্টিং এবং অন্যান্য অ্যাপ-ম্যানেজমেন্ট ফাংশন সম্পাদন করতে দেয়।

সব ডেভেলপারকে এই ডেভেলপার API ব্যবহার করতে হয় না — বেশিরভাগ ক্ষেত্রে আপনি Google Play Console ব্যবহার করে সরাসরি আপনার অ্যাপ ম্যানেজ করা চালিয়ে যেতে পারেন। তবে, আপনার কাছে ম্যানেজ করার জন্য প্রচুর সংখ্যক APK থাকলে অথবা ব্যবহারকারীর কেনাকাটা ও সাবস্ক্রিপশন ট্র্যাক করতে হলে, আপনি এইসব API-কে উপযোগী বলে মনে করতে পারেন।

কী কী অন্তর্ভুক্ত আছে

Google Play Developer API আপনাকে অ্যাপ ডিজাইন ও ডেভেলপ করার কাজে ফোকাস করতে সাহায্য করে। এর ফলে, নতুন মার্কেটে অ্যাপ রিলিজ করার সময়ও, রিলিজ ম্যানেজ করার জন্য আপনাকে কম সময় ও পরিশ্রম দিতে হয়।

Google Play Console-এ API-এর একটি স্যুট অন্তর্ভুক্ত থাকে যা আপনি নিজের অ্যাপ ম্যানেজ করতে ব্যবহার করতে পারেন:

  • Publishing API আপনাকে অ্যাপ আপলোড ও প্রকাশ করতে এবং প্রকাশনা-সম্পর্কিত অন্যান্য টাস্ক সম্পূর্ণ করতে দেয়।
  • Subscriptions and In-App Purchases API আপনাকে অ্যাপ-মধ্যস্থ কেনাকাটা ও সাবস্ক্রিপশন ম্যানেজ করতে দেয়। (এটি আগে "Purchase Status API" নামে পরিচিত ছিল।)
  • Reporting API আপনাকে Android Vitals থেকে আপনার অ্যাপের কোয়ালিটি সম্পর্কে তথ্য উদ্ধার করতে দেয়।
  • Reply to Reviews API-এর সাহায্যে আপনি নিজের অ্যাপের রিভিউ দেখতে ও তার উত্তর দিতে পারবেন।
  • Permissions API আপনাকে Play Console-এর মধ্যে অনুমতি ম্যানেজমেন্ট অটোমেট করতে দেয়।
  • Play Games Services Management API আপনাকে REST কল ইস্যু করার অনুমতি দেয় যাতে Google Play Games Services ফিচারের অন্তর্নিহিত মেটাডেটা প্রোগ্রাম্যাটিক্যালি কন্ট্রোল করা যায়।
  • Voided Purchases API এমন অর্ডারের তালিকা প্রদান করে যা ব্যবহারকারীর বাতিল করা কেনাকাটার সাথে সম্পর্কিত।

শুরু করা

Google Play Developer API ব্যবহার শুরু করতে, শুরু করা সংক্রান্ত ডকুমেন্টেশন দেখুন।

Publishing API

Publishing API আপনাকে অ্যাপ ডিস্ট্রিবিউশন সম্পর্কিত ঘন ঘন টাস্ক অটোমেট করতে দেয়। এটি Play Console-এর মাধ্যমে একজন ডেভেলপারের কাছে উপলভ্য ফাংশনের মতো ফাংশন প্রদান করে, যেমন:

  • কোনও অ্যাপের নতুন ভার্সন আপলোড করা
  • বিভিন্ন ট্র্যাকে (আলফা, বিটা, পর্যায়ক্রমিক প্রকাশ বা প্রোডাকশন) APK অ্যাসাইন করার মাধ্যমে অ্যাপ রিলিজ করা
  • লোকালাইজ করা টেক্সট, গ্রাফিক্স ও মাল্টি-ডিভাইস স্ক্রিনশট সহ Google Play Store তালিকা তৈরি ও পরিবর্তন করা

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

পেশাদার পদ্ধতি

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

Subscriptions and In-App Purchases API

Subscriptions and In-App Purchases API আপনাকে অ্যাপ-মধ্যস্থ প্রোডাক্ট ও সাবস্ক্রিপশনের ক্যাটালগ ম্যানেজ করতে দেয়। এছাড়াও, Subscriptions and In-App Purchases API-এর মাধ্যমে, আপনি স্ট্যান্ডার্ড GET অনুরোধ ব্যবহার করে যেকোনও কেনাকাটার বিবরণ দ্রুত খুঁজে পেতে পারেন।

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

আপনি বিভিন্ন উপায়ে এই API ব্যবহার করতে পারবেন, যেমন:

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

পেশাদার পদ্ধতি

  • অপ্রয়োজনীয় API কল এড়াতে আপনার সার্ভারে সাবস্ক্রিপশন সংক্রান্ত তথ্য স্টোর করুন। আপনার অ্যাপকে কোনও সাবস্ক্রিপশন যাচাই করতে হলে, Google-এ API কল রিপিট করার পরিবর্তে আপনার সার্ভারে ক্যাশে করা তথ্যের উপর নির্ভর করা উচিত।
  • দুটি পরিস্থিতিতে আপনার সুরক্ষিত সার্ভার সাবস্ক্রিপশন সংক্রান্ত তথ্য পেতে Google Play Developer API ব্যবহার করতে পারে:
    • আপনার সার্ভার একটি নতুন কেনাকাটার টোকেন পায় যা আগে দেখা যায়নি।
    • আপনার সার্ভার রিয়েল-টাইম ডেভেলপার বিজ্ঞপ্তি (RTDN) পায়, যা ইঙ্গিত করে যে নতুন সাবস্ক্রিপশন সংক্রান্ত তথ্য পেতে আপনাকে পারচেজ টোকেন ব্যবহার করতে হবে।
  • সাবস্ক্রিপশন স্ট্যাটাসের জন্য নিয়মিত API পোল করবেন না। যেমন, প্রতিটি সাবস্ক্রিপশন চেক করার জন্য প্রতিদিন API কল করবেন না।
  • সাবস্ক্রিপশনের মেয়াদ শেষ বা রিনিউ হলে আপনি RTDN পান, তাই শিডিউল করা মেয়াদ শেষ হওয়ার সময়ের উপর ভিত্তি করে আপনাকে API কল শিডিউল করতে হয় না।

API কে প্রতিবেদন করা হচ্ছে

Reporting API হল সেইসব ডেভেলপারদের জন্য যারা Play Console ডেটার উপরে অটোমেটেড ওয়ার্কফ্লো তৈরি করতে চান অথবা যারা অভ্যন্তরীণ ব্যবসার রিপোর্টিং ও বিশ্লেষণের জন্য Play Console ডেটা ব্যবহার করেন, সম্ভবত অন্যান্য ডেটাসেটের সাথে। এটি আপনাকে ইন্টার্নাল রিপোর্টিং, বিশ্লেষণ ও অটোমেশনের জন্য অ্যাপ-লেভেল ডেটা ও মেট্রিক্সে প্রোগ্র্যামাটিক অ্যাক্সেস দেয়।

রিপোর্টিং API, Android ভাইটাল ডেটা অ্যাক্সেস করার সুবিধা প্রদান করে, যার মধ্যে ক্র্যাশ রেট, ANR রেট, ওয়েক-আপ ও ওয়েক-লক সংক্রান্ত সমস্যা এবং এরর স্ট্যাক ট্রেস অন্তর্ভুক্ত।

পেশাদার পদ্ধতি

  • Reporting API-এর এই ভার্সনে প্রতি সেকেন্ডে ১০টি কোয়েরির ডিফল্ট সীমা রয়েছে। আপনি Google Cloud Console-এর কোটা বিভাগ থেকে কোটার ব্যবহার দেখতে পারবেন। আপনাকে এই সীমা অতিক্রম করতে হলে, Google Play Developer Reporting API কোটা অনুরোধ ফর্ম ব্যবহার করে অনুরোধ জমা দিন।

Reply to Reviews API

Reply to Reviews API-এর সাহায্যে আপনি নিজের অ্যাপের জন্য ব্যবহারকারীর মতামত দেখতে এবং এই মতামতের উত্তর দিতে পারবেন। আপনি এই API ব্যবহার করে আপনার বর্তমান গ্রাহক সহায়তা টুলকিটের মধ্যে থেকে সরাসরি ব্যবহারকারীদের সাথে ইন্টার‍্যাক্ট করতে পারবেন, যেমন CRM সিস্টেম।

Reply to Reviews API আপনাকে শুধু আপনার অ্যাপের প্রোডাকশন ভার্সনের জন্য ফিডব্যাক অ্যাক্সেস করতে দেয়। আপনি যদি আপনার অ্যাপের আলফা বা বিটা ভার্সনের ফিডব্যাক দেখতে চান, তাহলে পরিবর্তে Google Play Console ব্যবহার করুন। এছাড়াও, মনে রাখবেন যে API শুধুমাত্র সেইসব রিভিউ দেখায় যেগুলিতে কমেন্ট অন্তর্ভুক্ত থাকে। কোনও ব্যবহারকারী আপনার অ্যাপকে রেটিং দিলেও কোনও কমেন্ট না করলে, API থেকে তার মতামত অ্যাক্সেস করা যায় না।

Permissions API

Permissions API ডেভেলপারদের Play Console-এর মধ্যে অটোমেটিক অনুমতি ম্যানেজ করার ক্ষমতা দেয়। এর ফলে, ম্যানুয়ালি কিছু না করেই, আপনার ডেভেলপার অ্যাকাউন্টে কার অ্যাক্সেস আছে তা আপনি ফ্লেক্সিবলভাবে নিয়ন্ত্রণ করতে পারবেন।

Permissions API-এর মাধ্যমে আপনি এইসব অ্যাডমিনিস্ট্রেটিভ কাজ করতে পারবেন:

  • ব্যবহারকারী আপনার কোম্পানি ছেড়ে চলে গেলে তার অ্যাক্সেস সরিয়ে দেওয়া।
  • ব্যবহারকারী প্রাসঙ্গিক টিমে যোগ দিলে অ্যাপে অ্যাক্সেস দেওয়া।

Voided purchases API

Voided Purchases API এমন অর্ডারের তালিকা প্রদান করে যা ব্যবহারকারীর বাতিল করা কেনাকাটার সাথে সম্পর্কিত। আপনি এই তালিকা থেকে তথ্য ব্যবহার করে একটি প্রত্যাহার সিস্টেম প্রয়োগ করতে পারেন যা ব্যবহারকারীকে সেইসব অর্ডার থেকে প্রোডাক্ট অ্যাক্সেস করতে বাধা দেয়।

এই API এককালীন অ্যাপ-মধ্যস্থ অর্ডার ও অ্যাপ সাবস্ক্রিপশনের ক্ষেত্রে প্রযোজ্য।

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

  • ব্যবহারকারী তার অর্ডারের জন্য রিফান্ডের অনুরোধ করেছেন।
  • ব্যবহারকারী তার অর্ডার বাতিল করেন।
  • কোনও অর্ডারের জন্য চার্জব্যাক করা হয়।
  • ডেভেলপার অর্ডার বাতিল বা রিফান্ড করে। মনে রাখবেন: Voided Purchases API-তে শুধু প্রত্যাহার করা অর্ডার দেখানো হবে। ডেভেলপার যদি রিভোক বিকল্প সেট না করে রিফান্ড করেন, তাহলে API-তে অর্ডার দেখা যাবে না।
  • Google অর্ডার বাতিল বা রিফান্ড করে।

এই API ব্যবহার করে, আপনি আপনার অ্যাপের সব ব্যবহারকারীর জন্য আরও ভারসাম্যপূর্ণ এবং ন্যায্য অভিজ্ঞতা তৈরি করতে সাহায্য করেন, বিশেষ করে যদি আপনার অ্যাপটি একটি গেম হয়।