Google Play Developer API के रिलीज़ नोट

इस दस्तावेज़ में, 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

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

नई सुविधाएं

21 मई, 2025

Deprecations

नई सुविधाएं

  • SubscriptionPurchaseV2 में ये नए फ़ील्ड उपलब्ध हैं:

    • SubscriptionPurchaseLineItem.latest_successful_order_id
    • PriceChangeState.CANCELED
  • subscriptionsv2.revoke तरीके में अब item_based_refund विकल्प उपलब्ध है.

  • Orders API में अब get और batchGet तरीके उपलब्ध हैं.

अन्य बदलाव

  • purchases.subscriptions एपीआई में, subscriptionId पैरामीटर ज़रूरी नहीं है.