इस दस्तावेज़ में, Google Play Billing Library 4 या 5 से Google Play Billing Library 6 पर माइग्रेट करने का तरीका बताया गया है. साथ ही, सदस्यता की नई सुविधाओं को इस्तेमाल करने का तरीका बताया गया है.
वर्शन 6.0.0 में किए गए बदलावों की पूरी सूची देखने के लिए, रिलीज़ नोट पढ़ें.
खास जानकारी
Google Play Billing Library 6, वर्शन 5 में लॉन्च की गई सदस्यता की नई सुविधाओं पर आधारित है. इसमें कुछ और सुधार भी किए गए हैं. इन सुविधाओं की मदद से, सदस्यताओं को ज़्यादा तरीकों से बेचा जा सकता है. इससे, एसकेयू की संख्या को लगातार बढ़ाने और मैनेज करने की ज़रूरत नहीं पड़ती. साथ ही, कारोबार से जुड़ा खर्च भी कम होता है.
Play Billing Library 5 के साथ लॉन्च की गई नई सुविधाओं के बारे में ज़्यादा जानने के लिए, Play Console में, सदस्यताओं से जुड़े हाल ही में किए गए बदलाव देखें.
पुराने सिस्टम के साथ काम करने वाले Play Billing Library का अपग्रेड
मई 2022 में Play Billing Library 5 और नए सदस्यता प्लैटफ़ॉर्म की रिलीज़ के बाद, शुल्क लेकर सदस्यता देने वाले सभी मौजूदा प्रॉडक्ट, इस नए मॉडल में अपने-आप बदल गए. इसका मतलब है कि आपको शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट के कॉन्फ़िगरेशन में कोई बदलाव करने की ज़रूरत नहीं है. इससे आपको ऐसा कैटलॉग मिलेगा जो Play Billing Library के नए वर्शन के साथ काम करता है. सदस्यता के एसकेयू को पुराने सिस्टम के साथ काम करने वाली सदस्यताओं में बदलने के तरीके के बारे में ज़्यादा जानने के लिए, Play Console के सहायता लेख में पुरानी सदस्यताओं के साथ काम करना सेक्शन देखें.
आपके ऐप्लिकेशन के पिछले वर्शन अब भी काम करते हैं
अगर आपके पास पुराने सिस्टम के साथ काम करने वाला सदस्यता कैटलॉग है, तो आपके ऐप्लिकेशन के सभी मौजूदा वर्शन उन प्रॉडक्ट के लिए अब भी सही तरीके से काम करने चाहिए. एक बार में खरीदे जाने वाले प्रॉडक्ट भी पिछले वर्शन में बिना किसी समस्या के काम करते रहेंगे.
आपके ऐप्लिकेशन के ऐसे वर्शन जो अब इस्तेमाल नहीं किए जा रहे तरीकों (उदाहरण के लिए, querySkuDetailsAsync()) का इस्तेमाल करते हैं, वे ऐसे बुनियादी प्लान या ऑफ़र नहीं बेच पाएंगे जो पुराने सिस्टम के साथ काम करने की सुविधा नहीं देते. पुराने सिस्टम के साथ काम करने वाले ऑफ़र के बारे में ज़्यादा जानने के लिए, Play Console के सहायता केंद्र में मौजूद लेख पढ़ें.
Play Billing Library 5 या 6 पर अपग्रेड करना
Play Billing Library 5 और 6 में, अब काम न करने वाले तरीके querySkuDetailsAsync और BillingFlowParams.Builder.setSkuDetails शामिल हैं. ये तरीके, बिलिंग फ़्लो पैरामीटर के तौर पर SkuDetails का इस्तेमाल करते हैं. इसका मतलब है कि माइग्रेशन के अलग-अलग चरणों की योजना बनाकर, धीरे-धीरे Play Billing Library 6 पर माइग्रेट किया जा सकता है.
माइग्रेशन के पहले चरण के तौर पर, लाइब्रेरी के वर्शन को अपडेट किया जा सकता है. साथ ही, अपने कैटलॉग और बैकएंड को पहले जैसा ही रहने दें. इसके बाद, अपने ऐप्लिकेशन की जांच करें. भले ही, वह अब भी बंद किए जा चुके तरीकों का इस्तेमाल कर रहा हो. अगर queryPurchases, launchPriceChangeFlow या setVrPurchaseFlow का इस्तेमाल नहीं किया जा रहा है, तो भी यह सुविधा उम्मीद के मुताबिक काम करेगी. इसके बाद, मई 2022 में रिलीज़ की गई सदस्यता की नई सुविधाओं को पूरी तरह से इस्तेमाल करने के लिए, आपको बदलाव करने होंगे.
अगर आपने Google Play Billing Library 5 पर माइग्रेट करके, इन सुविधाओं को पहले ही अपना लिया है, तो सीधे Google Play Billing Library को अपडेट करें और उपयोगकर्ता की सदस्यता की खरीदारी में बदलाव करें लेबल वाले सेक्शन पर जाएं. अगर आपने पुराने वर्शन से शुरुआत की है या नई सुविधाओं को पूरी तरह से नहीं अपनाया है, तो उन्हें अपनाने का तरीका जानने के लिए, माइग्रेशन के सभी चरण पढ़ें.
पूरे माइग्रेशन के चरण
अपने बैकएंड प्रॉडक्ट कैटलॉग में नई सदस्यताएं बनाना
Play Developer Console या Play Developer API का इस्तेमाल करके, अब एक सदस्यता प्लान को कई बुनियादी प्लान के साथ कॉन्फ़िगर किया जा सकता है. इनमें से हर प्लान में कई ऑफ़र शामिल किए जा सकते हैं. सदस्यता से जुड़े हर ऑफ़र के लिए, अलग-अलग शुल्क और शर्तें तय की जा सकती हैं. साथ ही, अपने-आप रिन्यू होने वाले और प्रीपेड प्लान वाले ऑफ़र का इस्तेमाल करके, सदस्यता के पूरे लाइफ़साइकल के लिए भी कई तरह के ऑफ़र तैयार किए जा सकते हैं.
हमारा सुझाव है कि अपने ऐप्लिकेशन को माइग्रेट करने से पहले, Play Billing Library 6 के इंटिग्रेशन के लिए, सदस्यता के नए प्लैटफ़ॉर्म पर मौजूद इकाई के स्ट्रक्चर के मुताबिक नए प्रॉडक्ट बनाएं. अपने पुराने कैटलॉग में मौजूद डुप्लीकेट प्रॉडक्ट को एक ही सदस्यता के तहत इकट्ठा किया जा सकता है. इससे, एक जैसे फ़ायदे देने वाले प्रॉडक्ट को एक ही सदस्यता के तहत दिखाया जा सकता है. साथ ही, बुनियादी प्लान और ऑफ़र के कॉन्फ़िगरेशन का इस्तेमाल करके, उन सभी विकल्पों को दिखाया जा सकता है जो आपको ऑफ़र करने हैं. इस सुझाव के बारे में ज़्यादा जानने के लिए, Play Console के सहायता लेख में मौजूद, पुरानी सदस्यताओं के साथ काम करना सेक्शन देखें.
मई 2022 की रिलीज़ के बाद, शुल्क लेकर सदस्यता देने वाले उन प्रॉडक्ट में बदलाव न करें जिन्हें कन्वर्ट किया गया है. इससे, ऐप्लिकेशन के ऐसे वर्शन जो अब इस्तेमाल नहीं किए जा रहे तरीकों (जैसे, querySkuDetailsAsync()) का इस्तेमाल करते हैं वे उन बिल्ड पर असर डाले बिना, उन्हें बेचना जारी रख सकते हैं.
कन्वर्ज़न की प्रोसेस की वजह से, मई 2022 से पहले आपके कैटलॉग में मौजूद, शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट सिर्फ़ पढ़ने के लिए उपलब्ध हो गए हैं. ऐसा इसलिए किया गया है, ताकि गलती से होने वाले बदलावों से बचा जा सके. इन बदलावों की वजह से, आपके मौजूदा इंटिग्रेशन में समस्याएं आ सकती हैं. इन सदस्यताओं में बदलाव किए जा सकते हैं. हालांकि, इससे आपके फ़्रंटएंड और बैकएंड इंटिग्रेशन पर असर पड़ सकता है:
फ़्रंटएंड पर, सदस्यता वाले प्रॉडक्ट की जानकारी पाने के लिए
querySkuDetailsAsync()का इस्तेमाल करने वाले ऐप्लिकेशन के वर्शन, सिर्फ़ पुराने सिस्टम के साथ काम करने वाले बुनियादी प्लान और ऑफ़र बेच सकते हैं. साथ ही, पुराने सिस्टम के साथ काम करने वाले बुनियादी प्लान और ऑफ़र का सिर्फ़ एक कॉम्बिनेशन हो सकता है. इसलिए, अगर बदली गई सदस्यताओं में नए प्लान या ऑफ़र जोड़े जाते हैं, तो नए अतिरिक्त बुनियादी प्लान या ऑफ़र, आपके ऐप्लिकेशन के इन पिछले वर्शन पर नहीं बेचे जा सकेंगे.बैकएंड पर, अगर आपने Play Console के यूज़र इंटरफ़ेस (यूआई) में जाकर, बदली गई सदस्यताओं में बदलाव किया है, तो उन्हें
inappproductsएंडपॉइंट की मदद से मैनेज नहीं किया जा सकेगा. ऐसा तब होगा, जब आपने इस काम के लिए एंडपॉइंट को कॉल किया हो. आपको सदस्यता की खरीदारी की स्थिति वाले नए एंडपॉइंट (purchases.subscriptionsv2.get) पर भी माइग्रेट करना चाहिए, ताकि इन सदस्यताओं की खरीदारी को मैनेज किया जा सके. ऐसा इसलिए, क्योंकि खरीदारी की स्थिति वाला पुराना एंडपॉइंट (purchases.subscriptions.get) सिर्फ़ वह डेटा दिखाता है जो पुराने सिस्टम के साथ काम करने वाले बुनियादी प्लान और ऑफ़र की खरीदारी को मैनेज करने के लिए ज़रूरी है. ज़्यादा जानकारी के लिए, सदस्यता की खरीदारी की स्थिति मैनेज करना सेक्शन पढ़ें.
नए एपीआई की मदद से, बैकएंड सदस्यता कैटलॉग को मैनेज करना
अगर Google Play Developer API की मदद से, शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट के कैटलॉग को अपने-आप मैनेज किया जाता है, तो आपको सदस्यताएं, बुनियादी प्लान, और ऑफ़र बनाने और उन्हें मैनेज करने के लिए, शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट की परिभाषा के नए एंडपॉइंट इस्तेमाल करने होंगे. इस रिलीज़ के लिए, प्रॉडक्ट कैटलॉग एपीआई में हुए बदलावों के बारे में ज़्यादा जानने के लिए, मई 2022 की सदस्यता की सुविधाओं से जुड़ी गाइड पढ़ें.
Google Play Billing की सदस्यताओं के लिए, प्रॉडक्ट कैटलॉग को अपने-आप मैनेज करने वाले मॉड्यूल को माइग्रेट करने के लिए, inappproducts एपीआई को नए Subscription Publishing API से बदलें. इससे, सदस्यता के कैटलॉग को मैनेज और पब्लिश किया जा सकेगा.
तीन नए एंडपॉइंट उपलब्ध हैं:
- शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट मैनेज करने के लिए,
Monetization.subscriptions. - सदस्यताओं के बुनियादी प्लान मैनेज करने के लिए,
Monetization.basePlans. - बुनियादी प्लान के ऑफ़र मैनेज करने के लिए,
Monetization.offers.
इन नए एंडपॉइंट में, आपके कैटलॉग में मौजूद सभी नई सुविधाओं का फ़ायदा पाने के लिए ज़रूरी सभी फ़ंक्शन मौजूद हैं: बुनियादी प्लान और ऑफ़र टैग, देश/इलाके के हिसाब से टारगेटिंग, प्रीपेड प्लान वगैरह.
आपको अब भी inappproducts एपीआई का इस्तेमाल करना चाहिए, ताकि आप एक बार में खरीदे जाने वाले प्रॉडक्ट के लिए, ऐप्लिकेशन में खरीदने के लिए उपलब्ध प्रॉडक्ट का कैटलॉग मैनेज कर सकें.
आपके ऐप्लिकेशन के ऐसे वर्शन जो अब इस्तेमाल नहीं किए जा रहे तरीकों (उदाहरण के लिए, querySkuDetailsAsync()) का इस्तेमाल करते हैं, वे ऐसे बुनियादी प्लान या ऑफ़र नहीं बेच पाएंगे जो पुराने सिस्टम के साथ काम करने की सुविधा नहीं देते. Play Console के सहायता लेख में, पुराने सिस्टम के साथ काम करने वाले ऑफ़र के बारे में पढ़ा जा सकता है.
Google Play Billing Library को अपडेट करना
शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट का नया कैटलॉग बनाने के बाद, अपने ऐप्लिकेशन को Google Billing Library 5 पर माइग्रेट किया जा सकता है. अपने ऐप्लिकेशन की build.gradle फ़ाइल में, Play Billing Library की मौजूदा डिपेंडेंसी को अपडेट किए गए वर्शन से बदलें.
dependencies {
def billingVersion = "6.0.0"
implementation "com.android.billingclient:billing:$billingVersion"
}
आपका प्रोजेक्ट तुरंत बन जाना चाहिए. भले ही, आपने तरीकों के लिए किसी भी कॉल में बदलाव न किया हो. ऐसा इसलिए, क्योंकि Play Billing Library 6, पुराने सिस्टम के साथ काम करने की सुविधा देता है. एसकेयू का कॉन्सेप्ट अब पुराना हो गया है. हालांकि, ऐप्लिकेशन को पोर्ट करने की प्रोसेस को आसान और बेहतर बनाने के लिए, यह अब भी मौजूद है.
बिलिंग क्लाइंट को शुरू करना और Google Play से कनेक्शन बनाना
किसी Android ऐप्लिकेशन से खरीदारी की सुविधा लॉन्च करने के शुरुआती चरण पहले जैसे ही हैं:
खरीदारी के लिए उपलब्ध प्रॉडक्ट दिखाना
कोई उपयोगकर्ता जिन ऑफ़र को खरीद सकता है उनकी जानकारी पाने के लिए:
SkuDetailsParamsकोQueryProductDetailsParamsसे बदलेंBillingClient.queryProductDetailsAsync()का इस्तेमाल करने के लिए,BillingClient.querySkuDetailsAsync()कॉल पर स्विच करें
ध्यान दें कि क्वेरी के नतीजे अब SkuDetails के बजाय ProductDetails हैं.
हर ProductDetails आइटम में प्रॉडक्ट की जानकारी होती है. जैसे, आईडी, टाइटल, टाइप वगैरह. शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट के लिए, ProductDetails में List<ProductDetails.SubscriptionOfferDetails> शामिल होता है. यह सदस्यता के ऑफ़र की जानकारी की सूची होती है. एक बार खरीदने वाले प्रॉडक्ट के लिए,
ProductDetails में ProductDetails.OneTimePurchaseOfferDetails शामिल है. इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि उपयोगकर्ताओं को कौनसे ऑफ़र दिखाए जाएं.
नीचे दिए गए उदाहरण में दिखाया गया है कि ये बदलाव करने से पहले और बाद में, आपका ऐप्लिकेशन कैसा दिख सकता है:
पहले
Kotlin
val skuList = ArrayList<String>()
skuList.add("up_basic_sub")
val params = SkuDetailsParams.newBuilder()
params.setSkusList(skuList).setType(BillingClient.SkuType.SUBS).build()
billingClient.querySkuDetailsAsync(params) {
billingResult,
skuDetailsList ->
// Process the result
}
Java
List<String> skuList = new ArrayList<>();
skuList.add("up_basic_sub");
SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList).setType(SkuType.SUBS).build();
billingClient.querySkuDetailsAsync(params,
new SkuDetailsResponseListener() {
@Override
public void onSkuDetailsResponse(BillingResult billingResult,
List<SkuDetails> skuDetailsList) {
// Process the result.
}
}
);
बाद में
Kotlin
val productList =
listOf(
QueryProductDetailsParams.Product.newBuilder()
.setProductId("up_basic_sub")
.setProductType(BillingClient.ProductType.SUBS)
.build()
)
val params = QueryProductDetailsParams.newBuilder().setProductList(productList).build()
billingClient.queryProductDetailsAsync(params) {
billingResult,
productDetailsList ->
// Process the result
}
Java
ImmutableList<Product> productList = ImmutableList.of(Product.newBuilder()
.setProductId("up_basic_sub")
.setProductType(ProductType.SUBS)
.build());
QueryProductDetailsParams params = QueryProductDetailsParams.newBuilder()
.setProductList(productList)
.build();
billingClient.queryProductDetailsAsync(
params,
new ProductDetailsResponseListener() {
public void onProductDetailsResponse(BillingResult billingResult, List<ProductDetails> productDetailsList) {
// Process the result
}
}
);
queryProductDetailsAsync के लिए कॉलबैक, List<ProductDetails> दिखाता है.
हर ProductDetails आइटम में प्रॉडक्ट की जानकारी होती है. जैसे, आईडी, टाइटल, टाइप वगैरह. मुख्य अंतर यह है कि शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट में अब एक List<ProductDetails.SubscriptionOfferDetails> भी शामिल होता है. इसमें उपयोगकर्ता के लिए उपलब्ध सभी ऑफ़र शामिल होते हैं.
Play Billing Library के पिछले वर्शन, नए ऑब्जेक्ट (सदस्यताएं, बुनियादी प्लान, ऑफ़र वगैरह) के साथ काम नहीं करते. इसलिए, नया सिस्टम हर सदस्यता के SKU को पुराने सिस्टम के साथ काम करने वाले एक बुनियादी प्लान और ऑफ़र में बदल देता है. एक बार में खरीदे जा सकने वाले प्रॉडक्ट को भी ProductDetails ऑब्जेक्ट में पोर्ट किया जाता है. getOneTimePurchaseOfferDetails() तरीके का इस्तेमाल करके, वन-टाइम प्रॉडक्ट के ऑफ़र की जानकारी को ऐक्सेस किया जा सकता है.
कभी-कभी कुछ डिवाइसों पर ProductDetails और queryProductDetailsAsync() काम नहीं करते. आम तौर पर, ऐसा Google Play services के पुराने वर्शन की वजह से होता है. इस स्थिति में सही सहायता पाने के लिए, queryProductDetailsAsync को कॉल करने से पहले, PRODUCT_DETAILS सुविधा के लिए isFeatureSupported() पर कॉल करें. अगर जवाब OK है, तो इसका मतलब है कि डिवाइस पर यह सुविधा काम करती है. इसके बाद, queryProductDetailsAsync() को कॉल किया जा सकता है. अगर जवाब FEATURE_NOT_SUPPORTED है, तो querySkuDetailsAsync() का इस्तेमाल करके, पुराने सिस्टम के साथ काम करने वाले उपलब्ध प्रॉडक्ट की सूची का अनुरोध किया जा सकता है. पुराने सिस्टम के साथ काम करने की सुविधाओं को इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, मई 2022 की सदस्यता की सुविधाओं से जुड़ी गाइड देखें.
ऑफ़र की खरीदारी का फ़्लो लॉन्च करना
किसी ऑफ़र के लिए खरीदारी का फ़्लो लॉन्च करना, किसी SKU के लिए फ़्लो लॉन्च करने जैसा ही है. वर्शन 6 का इस्तेमाल करके खरीदारी का अनुरोध शुरू करने के लिए, यह तरीका अपनाएं:
BillingFlowParamsके लिएSkuDetailsका इस्तेमाल करने के बजाय,ProductDetailsParamsका इस्तेमाल करें.- ऑफ़र की जानकारी, जैसे कि ऑफ़र आईडी, बुनियादी प्लान आईडी वगैरह,
SubscriptionOfferDetailsऑब्जेक्ट का इस्तेमाल करके हासिल की जा सकती है.
उपयोगकर्ता के चुने गए ऑफ़र के साथ कोई प्रॉडक्ट खरीदने के लिए, चुने गए ऑफ़र का offerToken पाएं और उसे ProductDetailsParams ऑब्जेक्ट में पास करें.
BillingFlowParams ऑब्जेक्ट बनाने के बाद, BillingClient के साथ बिलिंग फ़्लो लॉन्च करने की प्रोसेस पहले जैसी ही रहती है.
नीचे दिए गए उदाहरण में दिखाया गया है कि ये बदलाव करने से पहले और बाद में, आपका ऐप्लिकेशन कैसा दिख सकता है:
पहले
Kotlin
// An activity reference from which the billing flow will be launched.
val activity : Activity = ...
// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
val billingFlowParams = BillingFlowParams.newBuilder()
.setSkuDetails(skuDetails)
.build()
val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)
Java
// An activity reference from which the billing flow will be launched.
Activity activity = ...;
// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
.setSkuDetails(skuDetails)
.build();
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)
बाद में
Kotlin
// An activity reference from which the billing flow will be launched.
val activity : Activity = ...;
val productDetailsParamsList = listOf(
BillingFlowParams.ProductDetailsParams.newBuilder()
// retrieve a value for "productDetails" by calling queryProductDetailsAsync()
.setProductDetails(productDetails)
// For One-time product, "setOfferToken" method shouldn't be called.
// For subscriptions, to get the offer token corresponding to the selected
// offer call productDetails.subscriptionOfferDetails?.get(selectedOfferIndex)?.offerToken
.setOfferToken(selectedOfferToken)
.build()
)
val billingFlowParams = BillingFlowParams.newBuilder()
.setProductDetailsParamsList(productDetailsParamsList)
.build()
// Launch the billing flow
val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)
Java
// An activity reference from which the billing flow will be launched.
Activity activity = ...;
ImmutableList<ProductDetailsParams> productDetailsParamsList =
ImmutableList.of(
ProductDetailsParams.newBuilder()
// retrieve a value for "productDetails" by calling queryProductDetailsAsync()
.setProductDetails(productDetails)
// For one-time products, "setOfferToken" method shouldn't be called.
// For subscriptions, to get the offer token corresponding to the selected
// offer call productDetails.getSubscriptionOfferDetails().get(selectedOfferIndex).getOfferToken()
.setOfferToken(selectedOfferToken)
.build()
);
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
.setProductDetailsParamsList(productDetailsParamsList)
.build();
// Launch the billing flow
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
खरीदारी प्रोसेस करना
Google Play Billing Library 6 की मदद से खरीदारी प्रोसेस करने का तरीका, पिछले वर्शन जैसा ही है.
उपयोगकर्ता की सभी चालू खरीदारी की जानकारी पाने और नई खरीदारी के बारे में क्वेरी करने के लिए, यह तरीका अपनाएं:
queryPurchasesAsync()कोBillingClient.SkuTypeवैल्यू पास करने के बजाय,QueryPurchasesParamsऑब्जेक्ट पास करें, जिसमेंBillingClient.ProductTypeवैल्यू शामिल हो.
नीचे दिए गए उदाहरण में दिखाया गया है कि ये बदलाव करने से पहले और बाद में, आपका ऐप्लिकेशन कैसा दिख सकता है:
पहले
Kotlin
billingClient.queryPurchasesAsync(BillingClient.SkuType.SUBS) {
billingResult,
purchaseList -> {
// Process the result
}
}
Java
billingClient.queryPurchasesAsync(
BillingClient.SkuType.SUBS,
new PurchasesResponseListener() {
public void onQueryPurchasesResponse(
BillingResult billingResult,
List<Purchase> purchases) {
// process the result
}
}
);
बाद में
Kotlin
billingClient.queryPurchasesAsync(
QueryPurchasesParams.newBuilder()
.setProductType(BillingClient.ProductType.SUBS)
.build()
) { billingResult, purchaseList ->
// Process the result
}
Java
billingClient.queryPurchasesAsync(
QueryPurchasesParams.newBuilder().setProductType(ProductType.SUBS).build(),
new PurchasesResponseListener() {
public void onQueryPurchasesResponse(
BillingResult billingResult,
List<Purchase> purchases) {
// Process the result
}
}
);
ऐप्लिकेशन के बाहर जाकर की जाने वाली खरीदारी और ऐसे लेन-देन जिन्हें मंज़ूरी नहीं मिली है, उन्हें मैनेज करने के तरीके में कोई बदलाव नहीं हुआ है.
अपने बैकएंड में नए एपीआई की मदद से, सदस्यता की खरीदारी की स्थिति मैनेज करना
आपको अपने बैकएंड में, सदस्यता की खरीदारी की स्थिति को मैनेज करने वाले कॉम्पोनेंट को माइग्रेट करना चाहिए. इससे, पिछले चरणों में बनाए गए नए प्रॉडक्ट की खरीदारी को मैनेज किया जा सकेगा. मई 2022 में लॉन्च होने से पहले, आपने सदस्यता वाले जिन प्रॉडक्ट को नए मॉडल में बदला था उनके लिए, सदस्यता की खरीदारी की स्थिति को मैनेज करने वाला मौजूदा कॉम्पोनेंट सामान्य तरीके से काम करना चाहिए. साथ ही, यह पुराने सिस्टम के साथ काम करने वाले ऑफ़र की खरीदारी को मैनेज करने के लिए काफ़ी होना चाहिए. हालांकि, यह किसी भी नई सुविधा के साथ काम नहीं करता.
आपको सदस्यता की खरीदारी की स्थिति को मैनेज करने वाले मॉड्यूल के लिए, नया Subscription Purchases API लागू करना होगा. यह मॉड्यूल, खरीदारी की स्थिति की जांच करता है और आपके बैकएंड में Google Play Billing की सदस्यता के एनटाइटलमेंट को मैनेज करता है. एपीआई का पुराना वर्शन, नए प्लैटफ़ॉर्म पर खरीदारी मैनेज करने के लिए ज़रूरी जानकारी नहीं दिखाता. पिछले वर्शन में हुए बदलावों के बारे में जानने के लिए, मई 2022 में सदस्यता की नई सुविधाओं की गाइड देखें.
खरीदारी की स्थिति मैनेज करने वाले मॉड्यूल को माइग्रेट करते समय:
- जब भी आपको
SubscriptionNotificationडेवलपर से जुड़ी रीयल-टाइम सूचना मिले, तब सदस्यता की स्थिति के बारे में नई जानकारी पाने के लिए, Subscription Purchases API को कॉल करें. purchases.subscriptions.getके लिए किए जाने वाले कॉल को, Subscription Purchases API के नए वर्शनpurchases.subscriptionsv2.getसे बदलें.- नए
SubscriptionPurchaseV2रिसॉर्स का इस्तेमाल करें. इससे नए मॉडल में, सदस्यताओं के लिए खरीदारी के एनटाइटलमेंट को मैनेज करने के बारे में ज़रूरी जानकारी मिलती है.
यह नया एंडपॉइंट, शुल्क लेकर सदस्यता देने वाले आपके सभी प्रॉडक्ट और आपकी सभी खरीदारी की स्थिति दिखाता है. इससे कोई फ़र्क़ नहीं पड़ता कि उन्हें बेचने वाले ऐप्लिकेशन का वर्शन कौनसा है और प्रॉडक्ट को कब तय किया गया था (मई 2022 की रिलीज़ से पहले या बाद में). इसलिए, माइग्रेशन के बाद आपको सदस्यता की खरीदारी की स्थिति मैनेज करने वाले मॉड्यूल के सिर्फ़ इस वर्शन की ज़रूरत होगी.
उपयोगकर्ता की सदस्यता की खरीदारी में बदलाव करना
Play Billing Library 5 और इससे पहले के वर्शन में, उपयोगकर्ता की सदस्यता से जुड़ी खरीदारी में बदलाव लागू करने के लिए, ProrationMode का इस्तेमाल किया जाता था. जैसे, अपग्रेड या डाउनग्रेड करना. इस नीति के इस्तेमाल पर रोक लगा दी गई है. वर्शन 6 में, इसकी जगह ReplacementMode का इस्तेमाल किया जाएगा.
सदस्यता के शुल्क में होने वाले बदलावों को मैनेज करना
पहले से बंद किए जा चुके launchPriceConfirmationFlow एपीआई को Play Billing Library 6 से हटा दिया गया है. अन्य विकल्पों के लिए, कीमत में बदलाव करने की गाइड देखें.
Play Billing Library से जुड़ी गड़बड़ियां ठीक करना
Play Billing Library 6 में, एक नया NETWORK_ERROR कोड जोड़ा गया है. इससे उपयोगकर्ता के डिवाइस और Google Play सिस्टम के बीच इंटरनेट कनेक्शन की समस्याओं का पता चलता है. SERVICE_TIMEOUT और SERVICE_UNAVAILABLE कोड में भी बदलाव किए गए थे. ज़्यादा जानकारी के लिए,
BillingResult के रिस्पॉन्स कोड मैनेज करना लेख पढ़ें.
ऐसे लेन-देन मैनेज करना जिन्हें मंज़ूरी नहीं मिली है
Play Billing Library के वर्शन 6.0.0 से, अधूरी खरीदारी के लिए ऑर्डर आईडी नहीं बनाया जाता. इन खरीदारी के लिए, ऑर्डर आईडी तब जनरेट होता है, जब खरीदारी की स्थिति PURCHASED पर सेट हो जाती है. पक्का करें कि इंटिग्रेशन, लेन-देन पूरा होने के बाद ही ऑर्डर आईडी की उम्मीद करे. हालांकि, अपने रिकॉर्ड के लिए, खरीदारी के टोकन का इस्तेमाल अब भी किया जा सकता है. अधूरी खरीदारी को मैनेज करने के बारे में ज़्यादा जानने के लिए, Play Billing Library की इंटिग्रेशन गाइड और खरीदारी के लाइफ़साइकल को मैनेज करने की गाइड देखें.