Method: purchases.subscriptions.cancel

उपयोगकर्ता की सदस्यता की खरीदारी रद्द करता है. सदस्यता, खत्म होने की तय अवधि तक मान्य रहती है. क्लाइंट लाइब्रेरी के बेहतर सपोर्ट के लिए, नया वर्शन purchases.subscriptionsv2.cancel पर उपलब्ध है.

एचटीटीपी अनुरोध

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
packageName

string

उस ऐप्लिकेशन के पैकेज का नाम जिसके लिए यह सदस्यता खरीदी गई थी. उदाहरण के लिए, 'com.some.thing'.

subscriptionId

string

ध्यान दें: 21 मई, 2025 से subscriptionId की ज़रूरत नहीं है. साथ ही, ऐड-ऑन वाली सदस्यता के लिए इसका इस्तेमाल करने का सुझाव नहीं दिया जाता. खरीदी गई सदस्यता का आईडी. उदाहरण के लिए, 'monthly001'.

token

string

यह टोकन, उपयोगकर्ता के डिवाइस को तब दिया जाता है, जब सदस्यता खरीदी जाती है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "cancellationType": enum (CancellationType)
}
फ़ील्ड
cancellationType

enum (CancellationType)

ज़रूरी नहीं. खरीदी गई सदस्यता को रद्द करने का टाइप. ध्यान दें कि इस फ़ील्ड का इस्तेमाल सिर्फ़ एचटीटीपी अनुरोध में किया जा सकता है. यह क्लाइंट लाइब्रेरी में उपलब्ध नहीं है. क्लाइंट लाइब्रेरी के उपयोगकर्ता, इसके बजाय purchases.subscriptionsv2.cancel का इस्तेमाल कर सकते हैं.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में कोई डेटा नहीं होता.

नमूना

अनुरोध का एक उदाहरण यहां दिया गया है:

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/androidpublisher

CancellationType

डेवलपर ने किस तरह से सदस्यता रद्द करने का अनुरोध किया है.

Enums
CANCELLATION_TYPE_UNSPECIFIED रद्द करने के टाइप की जानकारी नहीं दी गई है.
USER_REQUESTED_STOP_RENEWALS उपयोगकर्ता ने सदस्यता रद्द करने का अनुरोध किया है और सदस्यता वापस लाई जा सकती है. इससे सिर्फ़ सदस्यता का अगला रिन्यूअल रुकता है. किस्तों में सदस्यता लेने वाले लोगों को, सदस्यता की तय अवधि पूरी करनी होगी. रिन्यूअल और पेमेंट के बारे में ज़्यादा जानकारी के लिए, https://developer.android.com/google/play/billing/subscriptions#installments पर जाएं
DEVELOPER_REQUESTED_STOP_PAYMENTS डेवलपर ने सदस्यता रद्द करने का अनुरोध किया है. सदस्यता को वापस नहीं लाया जा सकता. इससे सदस्यता के लिए होने वाला अगला पेमेंट रुक जाता है. किस्तों में सदस्यता लेने वाले लोगों को, अगली किस्त का पेमेंट करने और बिना सदस्यता रद्द किए तय अवधि पूरी करने की ज़रूरत नहीं होगी. रिन्यूअल और पेमेंट के बारे में ज़्यादा जानकारी के लिए, https://developer.android.com/google/play/billing/subscriptions#installments पर जाएं. अगर रद्द करने का कोई टाइप नहीं चुना जाता है, तो यह डिफ़ॉल्ट तरीका होता है.