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