এই ডকুমেন্টে বর্ণনা করা হয়েছে কীভাবে গুগল প্লে বিলিং লাইব্রেরি ৫ বা ৬ থেকে গুগল প্লে বিলিং লাইব্রেরি ৭-এ মাইগ্রেট করতে হয় এবং কীভাবে নতুন ঐচ্ছিক সাবস্ক্রিপশন সুবিধাগুলোর সাথে এটিকে ইন্টিগ্রেট করতে হয়।
সংস্করণ ৭.০.০-এর পরিবর্তনসমূহের পূর্ণাঙ্গ তালিকার জন্য রিলিজ নোট দেখুন।
সংক্ষিপ্ত বিবরণ
গুগল প্লে বিলিং লাইব্রেরি ৭ বিদ্যমান সাবস্ক্রিপশন ফিচারগুলোর জন্য পেমেন্ট ব্যবস্থাপনাকে উন্নত করেছে। এই ঐচ্ছিক উন্নতিগুলোর মাধ্যমে কিস্তিতে অর্থ প্রদানের সুবিধার পাশাপাশি প্রিপেইড সাবস্ক্রিপশনের জন্য অপেক্ষমান কেনাকাটার সুবিধাও যুক্ত করা হয়েছে।
পশ্চাৎ-সামঞ্জস্যপূর্ণ প্লে বিলিং লাইব্রেরি আপগ্রেড
নতুন Google Play Billing Library 7-এর সমস্ত API ঐচ্ছিক, এবং আপডেট করার জন্য ডেভেলপারদের কোনো API পরিবর্তন প্রয়োগ করার প্রয়োজন নেই।
মাইগ্রেট করার জন্য, আপনাকে এপিআই রেফারেন্স আপডেট করতে হবে এবং আপনার অ্যাপ থেকে নির্দিষ্ট কিছু এপিআই সরিয়ে ফেলতে হবে, যেমনটি রিলিজ নোটে এবং পরবর্তীতে এই মাইগ্রেশন গাইডে বর্ণনা করা হয়েছে।
PBL 5 থেকে PBL 7-এ আপগ্রেড
নিম্নলিখিত বিভাগগুলিতে পিবিএল ৫ থেকে পিবিএল ৭-এ আপগ্রেড করার পদ্ধতি বর্ণনা করা হয়েছে।
গুগল প্লে বিলিং লাইব্রেরি আপডেট করুন
আপনার অ্যাপের build.gradle ফাইলে প্লে বিলিং লাইব্রেরি ডিপেন্ডেন্সির ভার্সন আপডেট করুন।
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
এরপরে, নিম্নলিখিত বিভাগগুলিতে বর্ণিত পদ্ধতি অনুসারে আপনার API রেফারেন্সগুলি আপডেট করুন।
ব্যবহারকারীর সাবস্ক্রিপশন ক্রয় পরিবর্তন করুন
প্লে বিলিং লাইব্রেরি ৫ এবং এর পূর্ববর্তী সংস্করণগুলো ব্যবহারকারীর সাবস্ক্রিপশন ক্রয়ে আপগ্রেড বা ডাউনগ্রেডের মতো পরিবর্তনগুলো প্রয়োগ করতে ProrationMode ব্যবহার করত। এই API-টি সরিয়ে দেওয়া হয়েছে এবং এর পরিবর্তে ReplacementMode চালু করা হয়েছে।
সাবস্ক্রিপশন মূল্যের পরিবর্তন পরিচালনা করুন
পূর্বে বাতিল ঘোষিত launchPriceConfirmationFlow API-টি সরিয়ে ফেলা হয়েছে। এর বিকল্পের জন্য, মূল্য পরিবর্তন নির্দেশিকা দেখুন।
সাবস্ক্রিপশন সম্পর্কিত API পরিবর্তনগুলি পরিচালনা করুন
পূর্বে অপ্রচলিত ঘোষিত এপিআই setOldSkuPurchaseToken , setReplaceProrationMode , setReplaceSkusProrationMode সরিয়ে ফেলা হয়েছে।
-
setOldSkuPurchaseTokensetOldPurchaseTokenএ আপডেট করুন। -
setReplaceProrationModesetSubscriptionReplacementModeএ আপডেট করুন। -
setReplaceSkusProrationModesetSubscriptionReplacementModeএ আপডেট করুন।
প্লে বিলিং লাইব্রেরির ত্রুটিগুলি পরিচালনা করুন
একটি নতুন NETWORK_ERROR কোড ব্যবহারকারীর ডিভাইস এবং গুগল প্লে সিস্টেমের মধ্যেকার নেটওয়ার্ক সংযোগে সমস্যা নির্দেশ করে।
SERVICE_TIMEOUT এবং SERVICE_UNAVAILABLE কোডগুলোও আপডেট করা হয়েছে।
আরও তথ্যের জন্য, Handle BillingResult response codes দেখুন।
মুলতুবি লেনদেনগুলি পরিচালনা করুন
প্লে বিলিং লাইব্রেরি এখন আর অপেক্ষমান কেনাকাটার জন্য কোনো অর্ডার আইডি তৈরি করে না। এই কেনাকাটাগুলোর ক্ষেত্রে, ক্রয়টি 'ক্রয়কৃত' PURCHASED ) অবস্থায় যাওয়ার পরেই অর্ডার আইডিটি যুক্ত হয়। নিশ্চিত করুন যে আপনার ইন্টিগ্রেশনটি শুধুমাত্র একটি লেনদেন সম্পূর্ণরূপে সম্পন্ন হওয়ার পরেই অর্ডার আইডি আশা করে। আপনি আপনার রেকর্ডের জন্য পারচেজ টোকেনটি এখনও ব্যবহার করতে পারেন।
অপেক্ষাধীন ক্রয় পরিচালনা সম্পর্কে আরও তথ্যের জন্য, প্লে বিলিং লাইব্রেরি ইন্টিগ্রেশন গাইড এবং পারচেজ লাইফসাইকেল ম্যানেজমেন্ট গাইড দেখুন।
সরানো বিকল্প বিলিং এপিআইগুলি পরিচালনা করুন
BillingClient.Builder.enableAlternativeBilling , AlternativeBillingListener এবং AlternativeChoiceDetails সরিয়ে ফেলা হয়েছে। এর পরিবর্তে ডেভেলপারদের লিসেনার কলব্যাকে UserChoiceBillingListener এবং UserChoiceDetails সাথে BillingClient.Builder.enableUserChoiceBilling() ব্যবহার করা উচিত।
এই আপডেটে অপ্রচলিত API-গুলোর শুধু নাম পরিবর্তন করা হয়েছে, তবে এগুলোর আচরণে কোনো পরিবর্তন আনা হয়নি।
ঐচ্ছিক পরিবর্তন
PBL 7-এ দুটি নতুন ঐচ্ছিক API অন্তর্ভুক্ত করা হয়েছে।
প্রিপেইড প্ল্যানের জন্য মুলতুবি থাকা কেনাকাটা সমর্থন করুন
সাবস্ক্রিপশন এবং মুলতুবি লেনদেন পরিচালনা নির্দেশিকাটি দেখুন।
ভার্চুয়াল কিস্তি সাবস্ক্রিপশন
কিস্তি সাবস্ক্রিপশন ইন্টিগ্রেশন গাইডটি দেখুন।
PBL 6 থেকে PBL 7-এ আপগ্রেড
নিম্নলিখিত বিভাগগুলিতে পিবিএল ৬ থেকে পিবিএল ৭-এ আপগ্রেড করার পদ্ধতি বর্ণনা করা হয়েছে।
গুগল প্লে বিলিং লাইব্রেরি আপডেট করুন
আপনার অ্যাপের build.gradle ফাইলে প্লে বিলিং লাইব্রেরি ডিপেন্ডেন্সির ভার্সন আপডেট করুন।
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
এরপরে, নিম্নলিখিত বিভাগগুলিতে বর্ণিত পদ্ধতি অনুসারে আপনার API রেফারেন্সগুলি আপডেট করুন।
সাবস্ক্রিপশন সম্পর্কিত API পরিবর্তনগুলি পরিচালনা করুন
পূর্বে অপ্রচলিত ঘোষিত এপিআই setOldSkuPurchaseToken , setReplaceProrationMode , setReplaceSkusProrationMode সরিয়ে ফেলা হয়েছে।
-
setOldSkuPurchaseTokensetOldPurchaseTokenএ আপডেট করুন। -
setReplaceProrationModesetSubscriptionReplacementModeএ আপডেট করুন। -
setReplaceSkusProrationModesetSubscriptionReplacementModeএ আপডেট করুন।
সরানো বিকল্প বিলিং এপিআইগুলি পরিচালনা করুন
BillingClient.Builder.enableAlternativeBilling , AlternativeBillingListener এবং AlternativeChoiceDetails সরিয়ে ফেলা হয়েছে। এর পরিবর্তে ডেভেলপারদের লিসেনার কলব্যাকে UserChoiceBillingListener এবং UserChoiceDetails এর সাথে BillingClient.Builder.enableUserChoiceBilling() ব্যবহার করা উচিত।
ঐচ্ছিক পরিবর্তন
PBL 7-এ দুটি নতুন ঐচ্ছিক API অন্তর্ভুক্ত করা হয়েছে।
প্রিপেইড প্ল্যানের জন্য মুলতুবি থাকা কেনাকাটা সমর্থন করুন
সাবস্ক্রিপশন এবং মুলতুবি লেনদেন পরিচালনা নির্দেশিকাটি দেখুন।
ভার্চুয়াল কিস্তি সাবস্ক্রিপশন
আপনার অ্যাপে এই পরিবর্তনগুলি কীভাবে অন্তর্ভুক্ত করবেন সে সম্পর্কে তথ্যের জন্য কিস্তি সাবস্ক্রিপশন ইন্টিগ্রেশন গাইডটি দেখুন।