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