Method: subscriptions.suspend

किसी चालू सदस्यता को निलंबित करता है.

इस तरीके का इस्तेमाल करके, पैसे चुकाकर ली गई उस सदस्यता को निलंबित किया जा सकता है जो फ़िलहाल ACTIVE स्थिति में है.

  • FLEXIBLE की सदस्यताओं के लिए, बिलिंग रोक दी गई है.
  • ANNUAL_MONTHLY_PAY या ANNUAL_YEARLY_PAY की सदस्यताओं के लिए:
    • सदस्यता निलंबित करने से, रिन्यूअल की उस तारीख में कोई बदलाव नहीं होता जिस पर आपने पहले सहमति दी थी.
    • निलंबित की गई सदस्यता रिन्यू नहीं होती.  अगर आपने सदस्यता को रिन्यू करने की मूल तारीख के बाद चालू किया है, तो एक नई सालाना सदस्यता बन जाएगी. यह सदस्यता, चालू करने के दिन से शुरू होगी.

हमारा सुझाव है कि आप सदस्यताओं को सिर्फ़ कुछ समय के लिए निलंबित करें. ऐसा इसलिए, क्योंकि 60 दिनों से ज़्यादा समय तक निलंबित रहने पर, सदस्यता रद्द हो सकती है.

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

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

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

पाथ पैरामीटर

पैरामीटर
customerId

string

यह ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर हो सकता है. अगर किसी ग्राहक का डोमेन नेम बदल जाता है, तो ग्राहक को ऐक्सेस करने के लिए पुराने डोमेन नेम का इस्तेमाल नहीं किया जा सकता. हालांकि, ग्राहक के यूनीक आइडेंटिफ़ायर (जैसा कि एपीआई से मिलता है) का इस्तेमाल हमेशा किया जा सकता है. हमारा सुझाव है कि जहां भी लागू हो, अपने सिस्टम में यूनीक आइडेंटिफ़ायर सेव करें.
subscriptionId

string

यह एक ज़रूरी प्रॉपर्टी है. subscriptionId, सदस्यता का आइडेंटिफ़ायर है और यह हर ग्राहक के लिए यूनीक होता है. सदस्यता अपडेट होने पर subscriptionId बदल जाता है. इसलिए, हमारा सुझाव है कि इस आईडी का इस्तेमाल, हमेशा सेव रहने वाले डेटा के लिए कुंजी के तौर पर न करें. सभी रीसेलर सदस्यताओं को वापस पाने के तरीके का इस्तेमाल करके, subscriptionId को ढूंढा जा सकता है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में Subscription का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

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

  • https://www.googleapis.com/auth/apps.order

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.