این سند نحوه انتقال از «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۵ یا ۶ به «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۷ و نحوه ادغام با قابلیت‌های اختیاری جدید اشتراک را شرح می‌دهد.
برای مشاهده فهرست کامل تغییرات در نسخه ۷.۰.۰، به یادداشت‌های انتشار مراجعه کنید.
نمای کلی
«کتابخانه خدمات صورت‌حساب Google Play» نسخه ۷ مدیریت پرداخت را برای ویژگی‌های اشتراک موجود بهبود می‌بخشد. این بهبودهای اختیاری پشتیبانی از پرداخت با طرح‌های اقساطی و همچنین پشتیبانی از خریدهای معلقه برای اشتراک‌های پیش‌پرداخت را اضافه می‌کند.
ارتقای «کتابخانه خدمات صورت‌حساب Play» سازگار با نسخه قدیمی
همه میاناهای برنامه‌سازی کاربردی جدید «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۷ اختیاری هستند و توسعه‌دهندگان برای به‌روزرسانی نیازی به اعمال تغییرات در میانای برنامه‌سازی کاربردی ندارند.
برای انتقال، باید مراجع میانای برنامه‌سازی کاربردی را به‌روز کنید و میاناهای برنامه‌سازی کاربردی خاصی را از برنامه‌تان بردارید، همان‌طور که در یادداشت‌های انتشار و بعداً در این راهنمای انتقال شرح داده شده است.
ارتقا از PBL 5 به PBL 7
بخش‌های زیر نحوه ارتقا دادن از PBL 5 به PBL 7 را شرح می‌دهند.
به‌روزرسانی «کتابخانه خدمات صورت‌حساب Google Play»
نسخه وابستگی «کتابخانه خدمات صورت‌حساب Play» را در فایل build.gradle برنامه‌تان به‌روز کنید.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
سپس، مراجع میانای برنامه‌سازی کاربردی را طبق توضیحات بخش‌های زیر به‌روز کنید.
تغییر خریدهای اشتراک کاربر
«کتابخانه خدمات صورت‌حساب Play» نسخه ۵ و نسخه‌های قبلی از ProrationMode
برای اعمال تغییرات در خریدهای اشتراک کاربر، مانند ارتقا
یا تنزل، استفاده می‌کردند. این میانای برنامه‌سازی کاربردی برداشته شده و با
ReplacementMode جایگزین شده است.
مدیریت تغییرات قیمت اشتراک
launchPriceConfirmationFlow API که قبلاً منسوخ شده بود برداشته شده است.
برای گزینه‌های جایگزین، راهنمای تغییرات قیمت را ببینید.
مدیریت تغییرات میانای برنامه‌سازی کاربردی مربوط به اشتراک
میاناهای برنامه‌سازی کاربردی setOldSkuPurchaseToken،
setReplaceProrationMode، setReplaceSkusProrationMode که قبلاً منسوخ شده بودند برداشته شده‌اند.
setOldSkuPurchaseTokenرا بهsetOldPurchaseTokenبه‌روز کنید.setReplaceProrationModeرا بهsetSubscriptionReplacementModeبه‌روز کنید.setReplaceSkusProrationModeرا بهsetSubscriptionReplacementModeبه‌روز کنید.
رسیدگی به خطاهای «کتابخانه خدمات صورت‌حساب Play»
کد جدید NETWORK_ERROR نشان‌دهنده وجود مشکل در اتصال شبکه
بین دستگاه کاربر و سیستم Google Play است.
کدهای SERVICE_TIMEOUT و SERVICE_UNAVAILABLE نیز به‌روزرسانی شدند.
برای اطلاعات بیشتر، به مدیریت کدهای پاسخ BillingResult مراجعه کنید.
رسیدگی به تراکنش‌های معلق
«کتابخانه خدمات صورت‌حساب Play» دیگر برای خریدهای معلقه شناسه سفارش ایجاد نمی‌کند.
برای این خریدها، شناسه سفارش پس‌از انتقال خرید به وضعیت PURCHASED تکمیل می‌شود. مطمئن شوید که یکپارچه‌سازی شما فقط پس‌از تکمیل کامل تراکنش، شناسه سفارش را انتظار دارد. همچنان می‌توانید از
کد خرید برای سوابقتان استفاده کنید.
برای اطلاعات بیشتر درباره رسیدگی به خریدهای معلقه، راهنمای ادغام «کتابخانه خدمات صورت‌حساب Play» و راهنمای مدیریت چرخه حیات خرید را ببینید.
رسیدگی به میاناهای برنامه‌سازی کاربردی صورت‌حساب جایگزین برداشته‌شده
BillingClient.Builder.enableAlternativeBilling،
AlternativeBillingListener،
و AlternativeChoiceDetails برداشته شدند.
توسعه‌دهندگان باید درعوض از BillingClient.Builder.enableUserChoiceBilling() با UserChoiceBillingListener
و UserChoiceDetails
در فراخوانی برگشتی شنونده استفاده کنند.
این به‌روزرسانی تغییر نام میاناهای برنامه‌سازی کاربردی منسوخ‌شده است و هیچ تغییری در رفتار ایجاد نمی‌کند.
تغییرات اختیاری
PBL 7 شامل دو میانای برنامه‌سازی کاربردی اختیاری جدید است.
پشتیبانی از خریدهای معلقه برای طرح‌های پیش‌پرداخت
راهنمای مدیریت اشتراک‌ها و تراکنش‌های معلق را ببینید.
اشتراک‌های قسطی مجازی
راهنمای یکپارچه‌سازی اشتراک‌های قسطی را ببینید.
ارتقا از PBL 6 به PBL 7
بخش‌های زیر نحوه ارتقا دادن از PBL 6 به PBL 7 را شرح می‌دهند.
به‌روزرسانی «کتابخانه خدمات صورت‌حساب Google Play»
نسخه وابستگی «کتابخانه خدمات صورت‌حساب Play» را در فایل build.gradle برنامه‌تان به‌روز کنید.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
سپس، مراجع میانای برنامه‌سازی کاربردی را طبق توضیحات بخش‌های زیر به‌روز کنید.
مدیریت تغییرات API مربوط به اشتراک
میاناهای برنامه‌سازی کاربردی setOldSkuPurchaseToken،
setReplaceProrationMode، setReplaceSkusProrationMode که قبلاً منسوخ شده بودند برداشته شده‌اند.
setOldSkuPurchaseTokenرا بهsetOldPurchaseTokenبه‌روز کنید.setReplaceProrationModeرا بهsetSubscriptionReplacementModeبه‌روز کنید.setReplaceSkusProrationModeرا بهsetSubscriptionReplacementModeبه‌روز کنید.
رسیدگی به میاناهای برنامه‌سازی کاربردی صورت‌حساب جایگزین برداشته‌شده
BillingClient.Builder.enableAlternativeBilling،
AlternativeBillingListener
و AlternativeChoiceDetails برداشته شد.
توسعه‌دهندگان باید درعوض از BillingClient.Builder.enableUserChoiceBilling() با UserChoiceBillingListener
و UserChoiceDetails
در فراخوانی برگشتی شنونده استفاده کنند.
تغییرات اختیاری
PBL 7 شامل دو میانای برنامه‌سازی کاربردی اختیاری جدید است.
پشتیبانی از خریدهای معلقه برای طرح‌های پیش‌پرداخت
راهنمای مدیریت اشتراک‌ها و تراکنش‌های معلق را ببینید.
اشتراک‌های قسطی مجازی
برای کسب اطلاعات درباره نحوه ادغام این تغییرات در برنامه‌تان، راهنمای ادغام اشتراک‌های قسطی را ببینید.