इस दस्तावेज़ में, 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 एपीआई को हटा दिया गया है.
अन्य विकल्पों के लिए, कीमत में बदलाव करने की गाइड देखें.
सदस्यता से जुड़े एपीआई में हुए बदलावों को मैनेज करना
पहले से बंद किए जा चुके एपीआई 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 में दो नए एपीआई शामिल हैं. हालांकि, इन्हें इस्तेमाल करना ज़रूरी नहीं है.
प्रीपेड प्लान के लिए, अधूरी खरीदारी की सुविधा
सदस्यताएं और ऐसे लेन-देन जिन्हें मंज़ूरी नहीं मिली है उन्हें मैनेज करना गाइड देखें.
वर्चुअल तौर पर ली जाने वाली किस्त वाली सदस्यताएं
किस्तों में सदस्यता लेने की सुविधा को इंटिग्रेट करने की गाइड देखें.
पीबीएल 6 से पीबीएल 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 में दो नए एपीआई शामिल हैं. हालांकि, इन्हें इस्तेमाल करना ज़रूरी नहीं है.
प्रीपेड प्लान के लिए, अधूरी खरीदारी की सुविधा
सदस्यताएं और ऐसे लेन-देन जिन्हें मंज़ूरी नहीं मिली है उन्हें मैनेज करना गाइड देखें.
वर्चुअल तौर पर ली जाने वाली किस्त वाली सदस्यताएं
अपने ऐप्लिकेशन में इन बदलावों को इंटिग्रेट करने के तरीके के बारे में जानने के लिए, किस्तों में सदस्यता लेने की सुविधा को इंटिग्रेट करना गाइड देखें.