इस दस्तावेज़ में, Google Play Developer API के लिए रिलीज़ नोट शामिल हैं.
19 नवंबर, 2026
नई सुविधाएं
सदस्यता बनाए रखने के लिए ऑफ़र: अब सदस्यता बनाए रखने के लिए ऑफ़र बनाए जा सकते हैं. ये ऑफ़र, Google Play पर उन सदस्यों को दिखाए जाते हैं जो सदस्यता रद्द करने की कोशिश करते हैं.
- सदस्यता बनाए रखने के लिए टारगेट करना:
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchयाmonetization.subscriptions.basePlans.offers.batchUpdateतरीके का इस्तेमाल करके, सदस्यता बनाए रखने के लिए ऑफ़र बनाने या उसे अपडेट करने के लिए, ऑफ़र केtargetingफ़ील्ड मेंretentionRuleकोRetentionTargetingRuleऑब्जेक्ट पर सेट करें.scope,minDuration,allowMultipleClaims, औरminOfferCooldownDurationफ़ील्ड का इस्तेमाल करके यह तय करें कि किन सदस्यों को ऑफ़र मिल सकता है. साथ ही, यह भी तय करें कि वे ऑफ़र पर एक से ज़्यादा बार दावा कर सकते हैं या नहीं. - ऑफ़र उपलब्ध रहने की अवधि:
SubscriptionOfferरिसॉर्स में अबstartTimeऔरendTimeफ़ील्ड शामिल हैं. हालांकि, इन्हें भरना ज़रूरी नहीं है. इनसे यह सेट किया जाता है कि कोई ऑफ़र, जैसे कि सदस्यता बनाए रखने के लिए दिया जाने वाला ऑफ़र, कब उपलब्ध होगा और कब उपलब्ध नहीं होगा. - हर उपयोगकर्ता के हिसाब से टारगेट करना: अगर आपको सदस्यता बनाए रखने का ऑफ़र सिर्फ़ कुछ खास सदस्यों को उपलब्ध कराना है, तो ऑफ़र के
targetingफ़ील्ड मेंretentionPerUserRule(RetentionPerUserTargetingRule) सेट करें. किसी सदस्यता के लिए ऑफ़र को टारगेट करने के लिए,purchaseTokenऔरofferIdके साथpurchases.subscriptionsv2.activateOfferTargetingतरीके को कॉल करें. टारगेटिंग हटाने के लिए,purchases.subscriptionsv2.deactivateOfferTargetingतरीके को कॉल करें. SubscriptionPurchaseV2 रिसॉर्स, उन ऑफ़र की सूची दिखाता है जिन्हेंdeveloperTargetedOffersफ़ील्ड में मौजूद हर लाइन आइटम के लिए टारगेट किया गया है. इसमें हर ऑफ़र काofferIdऔरactivateTimeशामिल होता है. - प्लान ट्रांज़िशन की सूचनाएं: जब कोई सदस्य, सदस्यता बनाए रखने का ऑफ़र स्वीकार करता है, तो सदस्यता के लिए आरटीडीएन का एक नया टाइप,
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21) भेजा जाता है. - प्लान ट्रांज़िशन की जानकारी: SubscriptionPurchaseV2 रिसॉर्स में अब
autoRenewingPlanमेंplanTransitionDetailsऑब्जेक्ट शामिल है. यहofferIdमें, स्वीकार किए गए ऑफ़र की पहचान करता है. साथ ही,transitionInfoमें ट्रांज़िशन की स्थिति की जानकारी देता है.
- सदस्यता बनाए रखने के लिए टारगेट करना:
सदस्यता रद्द करने और उसे वापस लेने के लिए, ई-टैग की पुष्टि करना:
purchases.subscriptionsv2.cancelऔरpurchases.subscriptionsv2.revokeतरीके, अबCancellationContextऔरRevocationContextमेंetagफ़ील्ड के लिए काम करते हैं. हालांकि, इस फ़ील्ड का इस्तेमाल करना ज़रूरी नहीं है.etagफ़ील्ड का इस्तेमाल करें, ताकि एक ही समय पर कई अनुरोधों से एक ही सदस्यता में बदलाव होने पर, कोई समस्या न हो. अपने सबसे हाल ही केpurchases.subscriptionsv2.getकॉल से मिले टॉप-लेवलetagफ़ील्ड सेetagवैल्यू पाएं.
6 जुलाई, 2026
नई सुविधाएं
चार्जबैक की लागत की ज़िम्मेदारी से जुड़े अपडेट: Google Play अब चार्जबैक के लिए मिलकर काम करने की सुविधा देता है.
रिफ़ंड की समीक्षा बाकी होने की सूचनाएं: डेवलपर से जुड़ी रीयल-टाइम सूचना (आरटीडीएन) का एक नया टाइप,
PendingRefundReviewNotification, तब भेजा जाता है, जब कोई उपयोगकर्ता ऐसे चार्जबैक का अनुरोध करता है जिसकी आपको समीक्षा करनी होती है. जिन समीक्षाओं की स्थिति 'मंज़ूरी बाकी है' है उनके लिए, रिफ़ंड की वजह के तौर पर सिर्फ़CHARGEBACKको चुना जा सकता है.ReviewRefund API: नए
orders.reviewrefundएपीआई को कॉल करके, इन अनुरोधों का आकलन किया जा सकता है और 24 घंटों के अंदर जवाब दिया जा सकता है. एपीआई कॉल में, आपको रिफ़ंड की प्राथमिकता (जैसे,APPROVE,DECLINEयाNEUTRAL) और खरीदारी के इस्तेमाल से जुड़ा कोई भी ज़रूरी सबूत (जैसे, उपयोगकर्ता का आईपी पता, कुल खपत का प्रतिशत, और अनुमानित भौगोलिक जगह) देना होगा. इससे Google Play को चार्जबैक का विरोध करने में मदद मिलेगी.
19 मई, 2026
नई सुविधाएं
- पेंडिंग ऑर्डर आईडी: SubscriptionPurchaseV2 एपीआई में अब
onHoldStateContextऔरinGracePeriodStateContextफ़ील्ड शामिल हैं. इन फ़ील्ड से अतिरिक्त जानकारी मिलती है. जैसे, ऑर्डर आईडी का पूरा न होना या पूरा न हो पाना. ऐसा तब होता है, जब रिन्यूअल के लिए पेमेंट अस्वीकार होने की वजह से, सदस्यताON_HOLDयाIN_GRACE_PERIODस्थिति में चली जाती है.
Deprecations
- सदस्यता से जुड़े कुछ एपीआई अब काम नहीं करते. ज़्यादा जानकारी के लिए, मई 2026 में Subscription API का इस्तेमाल बंद होने के बारे में जानकारी देखें.
27 जनवरी, 2026
नई सुविधाएं
ऐड-ऑन के साथ सदस्यता की बिलिंग को बाद में करने की सुविधा: पहले, Google Play Developer API की मदद से, सिर्फ़ एक सदस्यता के लिए बिलिंग को बाद में करने की सुविधा मिलती थी. सदस्यता की बिलिंग की तारीख को आगे बढ़ाने की सुविधा, अब सिंगल सदस्यताओं और ऐड-ऑन वाली सदस्यताओं, दोनों के लिए उपलब्ध है. इसके लिए,
purchases.subscriptionsv2.deferतरीके का इस्तेमाल करें. ऐड-ऑन वाली सदस्यता के लिए बिलिंग की तारीख को आगे बढ़ाने पर, सदस्यता में शामिल सभी आइटम के लिए बिलिंग की तारीख को तय की गई अवधि के लिए आगे बढ़ा दिया जाता है.OfferPhase:
OfferPhaseफ़ील्ड अब SubscriptionPurchaseV2 एपीआई में उपलब्ध है. यह फ़ील्ड, सदस्यता के मौजूदा ऑफ़र के चरण की जानकारी देता है. जैसे, सदस्यता के लिए तय की गई अवधि, मुफ़्त में आज़माने की सुविधा, शुरुआती कीमत, और बुनियादी प्लान की कीमत.
19 नवंबर, 2025
नई सुविधाएं
फिर से सदस्यता लेने की प्रोसेस को बेहतर बनाना.
outOfAppPurchaseContextफ़ील्ड अब SubscriptionPurchaseV2 में उपलब्ध है. इससे Play Store से फिर से खरीदी गई सदस्यताओं को लिंक करने में मदद मिलती है. इसके लिए, खत्म हो चुकी सदस्यता की जानकारी देनी होती है.- purchases.subscriptions.acknowledge तरीके में, अब अनुरोध के मुख्य हिस्से में वैकल्पिक
externalAccountIdको शामिल किया जा सकता है. इससे, फिर से ली गई सदस्यता की खरीदारी को अपने यूज़र आइडेंटिफ़ायर से जोड़ा जा सकता है.
SubscriptionPurchaseLineItem.itemReplacementफ़ील्ड अब SubscriptionPurchaseV2 में उपलब्ध है. इसमें, बदले जा रहे आइटम की जानकारी दी जाती है. हालांकि, ऐसा तब होता है, जब यह फ़ील्ड लागू हो.Orders API में अब
offerPhaseDetailsफ़ील्ड शामिल है. इससे, सदस्यता की अवधि के हिसाब से शुल्क चुकाने वाले ऑर्डर के बारे में ज़्यादा जानकारी मिलती है.
11 सितंबर, 2025
नई सुविधाएं
SubscriptionPurchaseV2 एपीआई अब
cancelतरीका उपलब्ध कराता है.यह तरीका, purchases.subscriptions.cancel की मौजूदा सुविधा को बेहतर बनाता है. इसके लिए, क्लाइंट लाइब्रेरी में
cancellationTypeपैरामीटर के लिए सहायता उपलब्ध कराई जाती है.कीमत बढ़ाने के लिए सहमति की सुविधाएं उपलब्ध हैं:
SubscriptionPurchaseV2 में एक नया फ़ील्ड जोड़ा गया है:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.डेवलपर से जुड़ी रीयल-टाइम सूचना का एक नया टाइप SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED उपलब्ध है.
30 जून, 2025
नई सुविधाएं
- नया ProductPurchaseV2 एपीआई उपलब्ध है. इसमें वन-टाइम प्रॉडक्ट के लिए, खरीदारी के कई विकल्प और ऑफ़र उपलब्ध हैं.
21 मई, 2025
Deprecations
- सदस्यता से जुड़े कुछ एपीआई अब काम नहीं करते. ज़्यादा जानकारी के लिए, Subscription API का इस्तेमाल बंद करना लेख पढ़ें.
नई सुविधाएं
SubscriptionPurchaseV2 में ये नए फ़ील्ड उपलब्ध हैं:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
subscriptionsv2.revokeतरीके में अबitem_based_refundविकल्प उपलब्ध है.
अन्य बदलाव
- purchases.subscriptions एपीआई में, subscriptionId पैरामीटर ज़रूरी नहीं है.