वर्शन 5 या 6 से Google Play Billing Library 7 में माइग्रेट करें

इस दस्तावेज़ में, 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 पर अपग्रेड करने का तरीका बताया गया है.