Method: subscriptions.changePlan

सदस्यता की योजना को अपडेट करता है. 30-दिन के ट्रायल वाले प्लान या ज़रूरत के हिसाब से प्लान वाली सदस्यता को, महीने या साल के हिसाब से पैसे चुकाने वाले सालाना प्लान में अपडेट करने के लिए, यह तरीका अपनाएं.

प्लान और प्रॉडक्ट के हिसाब से, प्लान को अपडेट करने का तरीका अलग-अलग होता है. ज़्यादा जानकारी के लिए, सदस्यताएं मैनेज करें में दिया गया ब्यौरा देखें.

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

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

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

पाथ के पैरामीटर

पैरामीटर
customerId

string

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

string

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

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

अनुरोध के मुख्य भाग में ChangePlanRequest का उदाहरण है.

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

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

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

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

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

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

ChangePlanRequest

Subscription.changePlan rpc अनुरोध के लिए JSON टेंप्लेट.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
फ़ील्ड
kind

string

यह संसाधन की पहचान, सदस्यता बदलने के प्लान के अनुरोध के तौर पर करता है. मान: subscriptions#changePlanRequest
planName

string

planName प्रॉपर्टी ज़रूरी है. यह सदस्यता के पैसे चुकाने के प्लान का नाम है. Google पेमेंट प्लान के बारे में ज़्यादा जानकारी के लिए, एपीआई के सिद्धांत देखें.

इसके लिए ये वैल्यू डाली जा सकती हैं:

  • ANNUAL_MONTHLY_PAY - हर महीने पैसे चुकाने के प्लान के साथ, तय किए गए सालाना प्लान
  • ANNUAL_YEARLY_PAY - सालाना पेमेंट के साथ, सालाना प्लान वाला प्लान
  • FLEXIBLE - महीने के हिसाब से प्लान
  • TRIAL - 30 दिन तक मुफ़्त में आज़माने का प्लान

seats

object (Seats)

यह एक ज़रूरी प्रॉपर्टी है. सीट प्रॉपर्टी का मतलब, उपयोगकर्ता सीट के लाइसेंस की संख्या से है.
purchaseOrderId

string

यह प्रॉपर्टी ज़रूरी नहीं है. यह परचेज़ ऑर्डर (पीओ) जानकारी रीसेलर के लिए है, जिसका इस्तेमाल वे अपनी कंपनी की ट्रैकिंग के इस्तेमाल के लिए कर सकते हैं. अगर purchaseOrderId वैल्यू दी जाती है, तो वह एपीआई से मिले रिस्पॉन्स में दिखती है और इनवॉइस में दिखती है. प्रॉपर्टी में, ज़्यादा से ज़्यादा 80 सादे टेक्स्ट वाले वर्ण स्वीकार किए जाते हैं.
dealCode

string

सदस्यता के प्लान पर छूट वाली कीमत के लिए, Google की ओर से जारी किया गया कोड (ज़्यादा से ज़्यादा 100 वर्ण). छूट वाली कीमत पाने के लिए, डील कोड को changePlan के अनुरोध में शामिल करना ज़रूरी है. यह प्रॉपर्टी ज़रूरी नहीं है. अगर किसी सदस्यता में पहले से ही कोई डील कोड जोड़ा जा चुका है, तो इस प्रॉपर्टी को खाली छोड़ा जा सकता है. साथ ही, छूट वाली मौजूदा दर अब भी लागू रहेगी. अगर यह फ़ील्ड खाली नहीं है, तो सिर्फ़ वही डील कोड डालें जो सदस्यता में पहले से मौजूद है. अगर सदस्यता में कभी भी डील कोड नहीं जोड़ा गया है और इस प्रॉपर्टी को खाली छोड़ दिया जाता है, तो सामान्य कीमत लागू होगी.