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