इस दस्तावेज़ में, Google Play Billing Library 5 या 6 से Google Play Billing Library 7 पर माइग्रेट करने का तरीका बताया गया है. साथ ही, सदस्यता से जुड़ी नई सुविधाओं को इंटिग्रेट करने का तरीका बताया गया है.
वर्शन 7.0.0 में हुए सभी बदलावों की पूरी सूची देखने के लिए, रिलीज़ नोट देखें.
खास जानकारी
Google Play Billing Library 7, सदस्यता की मौजूदा सुविधाओं के लिए पेमेंट मैनेज करने की प्रोसेस को बेहतर बनाती है. इन वैकल्पिक सुधारों से, किस्तों में पेमेंट करने की सुविधा के साथ-साथ, प्रीपेड सदस्यताओं के लिए लंबित खरीदारी की सुविधा भी जोड़ी गई है.
Play Billing Library को पुराने वर्शन के साथ काम करने वाले नए वर्शन में अपग्रेड करना
Google Play Billing Library 7 के सभी नए एपीआई का इस्तेमाल करना ज़रूरी नहीं है. साथ ही, अपडेट करने के लिए डेवलपर को एपीआई में कोई बदलाव करने की ज़रूरत नहीं है.
माइग्रेट करने के लिए, आपको एपीआई के रेफ़रंस अपडेट करने होंगे. साथ ही, अपने ऐप्लिकेशन से कुछ एपीआई हटाने होंगे. इसके बारे में, रिलीज़ नोट में बताया गया है. साथ ही, इस माइग्रेशन गाइड में भी इसकी जानकारी दी गई है.
PBL 5 से PBL 7 में अपग्रेड करना
यहां दिए गए सेक्शन में, PBL 5 से PBL 7 पर अपग्रेड करने का तरीका बताया गया है.
Google Play Billing Library को अपडेट करना
अपने ऐप्लिकेशन की build.gradle फ़ाइल में, Play Billing Library की डिपेंडेंसी का वर्शन अपडेट करें.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
इसके बाद, यहां दिए गए सेक्शन में बताए गए तरीके से, अपने एपीआई रेफ़रंस अपडेट करें.
किसी उपयोगकर्ता की सदस्यता की खरीदारी में बदलाव करना
Play Billing Library 5 और इससे पहले के वर्शन में, किसी व्यक्ति की सदस्यता की खरीदारी में बदलाव करने के लिए ProrationMode का इस्तेमाल किया जाता था. जैसे, अपग्रेड या डाउनग्रेड करना. इस एपीआई को हटा दिया गया है. इसकी जगह ReplacementMode का इस्तेमाल किया जाएगा.
सदस्यता के शुल्क में होने वाले बदलावों को मैनेज करना
पहले से बंद किए जा चुके launchPriceConfirmationFlow API को हटा दिया गया है.
इसके विकल्पों के बारे में जानने के लिए, कीमत में बदलाव से जुड़ी गाइड देखें.
सदस्यता से जुड़े एपीआई में हुए बदलावों को मैनेज करना
पहले बंद किए गए एपीआई setOldSkuPurchaseToken,
setReplaceProrationMode, setReplaceSkusProrationMode हटा दिए गए हैं.
setOldSkuPurchaseTokenकोsetOldPurchaseTokenपर अपडेट करें.setReplaceProrationModeकोsetSubscriptionReplacementModeमें अपडेट करें.setReplaceSkusProrationModeकोsetSubscriptionReplacementModeमें अपडेट करें.
Play Billing Library की गड़बड़ियों को ठीक करना
नया NETWORK_ERROR कोड, उपयोगकर्ता के डिवाइस और Google Play सिस्टम के बीच नेटवर्क कनेक्शन में आने वाली समस्याओं के बारे में बताता है.
SERVICE_TIMEOUT और SERVICE_UNAVAILABLE कोड भी अपडेट किए गए थे.
ज़्यादा जानकारी के लिए, BillingResult रिस्पॉन्स कोड मैनेज करना लेख पढ़ें.
ऐसे लेन-देन मैनेज करना जिन्हें मंज़ूरी नहीं मिली है
Play Billing Library, अब उन खरीदारी के लिए ऑर्डर आईडी नहीं बनाती है जो पूरी नहीं हुई हैं.
इन खरीदारी के लिए, ऑर्डर आईडी तब दिखता है, जब खरीदारी की स्थिति PURCHASED पर सेट हो जाती है. पक्का करें कि आपका इंटिग्रेशन, लेन-देन पूरा होने के बाद ही ऑर्डर आईडी का इस्तेमाल करे. अपने रिकॉर्ड के लिए, खरीदारी के टोकन का इस्तेमाल अब भी किया जा सकता है.
जिन खरीदारी को मंज़ूरी नहीं मिली है उन्हें मैनेज करने के बारे में ज़्यादा जानने के लिए, Play Billing Library की इंटिग्रेशन गाइड और खरीदारी के लाइफ़साइकल को मैनेज करने की गाइड देखें.
हटाए गए अन्य बिलिंग सिस्टम के एपीआई मैनेज करना
BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener,
और AlternativeChoiceDetails को हटा दिया गया है.
इसके बजाय, डेवलपर को लिसनर कॉलबैक में UserChoiceBillingListener और UserChoiceDetails के साथ BillingClient.Builder.enableUserChoiceBilling() का इस्तेमाल करना चाहिए.
इस अपडेट में, बंद किए गए एपीआई के नाम बदले गए हैं. हालांकि, इनके काम करने के तरीके में कोई बदलाव नहीं किया गया है.
वैकल्पिक बदलाव
PBL 7 में, दो नए वैकल्पिक एपीआई शामिल हैं.
प्रीपेड प्लान के लिए, मंज़ूरी के लिए भेजी गई खरीदारी की सुविधा
सदस्यताओं और लंबित लेन-देन को मैनेज करना गाइड देखें.
वर्चुअल तौर पर ली जाने वाली किस्त की सदस्यताएं
किस्तों में सदस्यता लेने की सुविधा को इंटिग्रेट करने से जुड़ी गाइड देखें.
PBL 6 से PBL 7 में अपग्रेड करना
यहां दिए गए सेक्शन में, पीबीएल 6 से पीबीएल 7 पर अपग्रेड करने का तरीका बताया गया है.
Google Play Billing Library को अपडेट करना
अपने ऐप्लिकेशन की build.gradle फ़ाइल में, Play Billing Library की डिपेंडेंसी का वर्शन अपडेट करें.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
इसके बाद, यहां दिए गए सेक्शन में बताए गए तरीके से, अपने एपीआई रेफ़रंस अपडेट करें.
सदस्यता से जुड़े एपीआई में हुए बदलावों को मैनेज करना
पहले बंद किए गए एपीआई setOldSkuPurchaseToken,
setReplaceProrationMode, setReplaceSkusProrationMode हटा दिए गए हैं.
setOldSkuPurchaseTokenकोsetOldPurchaseTokenपर अपडेट करें.setReplaceProrationModeकोsetSubscriptionReplacementModeमें अपडेट करें.setReplaceSkusProrationModeकोsetSubscriptionReplacementModeमें अपडेट करें.
हटाए गए अन्य बिलिंग सिस्टम के एपीआई मैनेज करना
BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener
और AlternativeChoiceDetails को हटाया गया.
इसके बजाय, डेवलपर को लिसनर कॉलबैक में UserChoiceBillingListener और UserChoiceDetails के साथ BillingClient.Builder.enableUserChoiceBilling() का इस्तेमाल करना चाहिए.
वैकल्पिक बदलाव
PBL 7 में, दो नए वैकल्पिक एपीआई शामिल हैं.
प्रीपेड प्लान के लिए, मंज़ूरी के लिए भेजी गई खरीदारी की सुविधा
सदस्यताओं और लंबित लेन-देन को मैनेज करना गाइड देखें.
वर्चुअल तौर पर ली जाने वाली किस्त की सदस्यताएं
अपने ऐप्लिकेशन में इन बदलावों को इंटिग्रेट करने के तरीके के बारे में जानने के लिए, किस्तों में सदस्यता लेने की सुविधा को इंटिग्रेट करने से जुड़ी गाइड देखें.