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

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

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 अनुरोध में डील कोड शामिल करना ज़रूरी है. इस प्रॉपर्टी का इस्तेमाल करना ज़रूरी नहीं है. अगर किसी सदस्यता में डील कोड पहले से ही जोड़ दिया गया है, तो इस प्रॉपर्टी को खाली छोड़ा जा सकता है. ऐसा करने पर भी, सदस्यता के लिए तय की गई मौजूदा छूट वाली दर लागू रहेगी. अगर यह प्रॉपर्टी खाली नहीं है, तो सिर्फ़ वह डील कोड दें जो सदस्यता में पहले से मौजूद है. अगर किसी सदस्यता में डील कोड कभी नहीं जोड़ा गया है और इस प्रॉपर्टी को खाली छोड़ दिया गया है, तो सदस्यता की सामान्य कीमत लागू होगी.