सदस्यता वापस पाएं और उसे अपडेट करें

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

सदस्यता वापस पाना

ऑर्डर की गई या ट्रांसफ़र की गई सदस्यता को वापस पाने के लिए, यहां दिए गए GETएचटीटीपी अनुरोध का इस्तेमाल करें.

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID

इनकी जगह ये डालें:

इस ऑपरेशन के अनुरोध बॉडी में कोई पैरामीटर नहीं है.

सही जवाब में, एचटीटीपी 200 स्टेटस कोड और सदस्यता की सेटिंग दिखती है. नीचे दिए गए उदाहरण के रिस्पॉन्स में, isInTrial प्रॉपर्टी false है, लेकिन कोई trialEndTime प्रॉपर्टी नहीं है. इसका मतलब है कि इस ग्राहक ने इस प्लान के साथ, 30 दिनों के मुफ़्त ट्रायल की सुविधा कभी इस्तेमाल नहीं की है.

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "billingMethod": "ONLINE",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
  "skuName": "Google Workspace Business Standard"
}

किसी ग्राहक की सभी सदस्यताएं वापस पाना

किसी खास रीसेलर ग्राहक की उन सभी सदस्यताओं को वापस पाने के लिए जिन्हें ऑर्डर किया गया है या ट्रांसफ़र किया गया है, नीचे दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें और अनुमति टोकन शामिल करें:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER

इनकी जगह ये डालें:

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • START_DATE: शुरू होने की तारीख, YYYY-MM-DD फ़ॉर्मैट में होनी चाहिए.
  • MAX_NUMBER: रिस्पॉन्स पेज पर दिखाए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या.

इस ऑपरेशन के अनुरोध बॉडी में कोई पैरामीटर नहीं है.

सही जवाब में, एचटीटीपी 200 स्टेटस कोड और ग्राहक की सदस्यताओं और सेटिंग की सूची दिखती है. सदस्यताओं की सूची में ऐसे प्रॉडक्ट शामिल हो सकते हैं जिन्हें Reseller API के इस वर्शन में मैनेज नहीं किया जाता.

अगर आपने इस ग्राहक को मैनेज नहीं किया है, तो आपको 403 "Forbidden" गड़बड़ी का मैसेज दिखेगा.

किसी ग्राहक की ऐसी सभी सदस्यताएं वापस पाना जिन्हें ट्रांसफ़र किया जा सकता है

किसी ग्राहक की उन सभी सदस्यताओं को वापस पाने के लिए जिन्हें रीसेलर के मैनेजमेंट को ट्रांसफ़र किया जा सकता है, नीचे दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें और अनुमति देने वाला टोकन शामिल करें. customerId की वैल्यू देना ज़रूरी है. यह ग्राहक का यूनीक आइडेंटिफ़ायर होता है. यह वैल्यू, फिर से बेचे गए ग्राहक के खाते को वापस पाने पर दिखती है. customerAuthToken, आपके ग्राहक से मिला ट्रांसफ़र टोकन है. यह आपके रीसेलर आईडी के हिसाब से होता है. ग्राहक के जनरेट करने के बाद, यह कोड 30 दिनों तक मान्य होता है. ग्राहक टोकन कैसे जनरेट करते हैं, इस बारे में ज़्यादा जानने के लिए, अपना Google Workspace खाता किसी रीसेलर को ट्रांसफ़र करना लेख पढ़ें.

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER

इनकी जगह ये डालें:

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • AUTH_TOKEN: आपके ग्राहक से मिला ट्रांसफ़र टोकन, जो आपके रीसेलर आईडी के हिसाब से होता है. ग्राहक के जनरेट करने के बाद, यह कोड 30 दिनों तक मान्य रहता है. ग्राहक टोकन कैसे जनरेट करते हैं, इस बारे में ज़्यादा जानने के लिए, अपना Google Workspace खाता किसी रीसेलर को ट्रांसफ़र करना लेख पढ़ें. अगर यह वैल्यू मान्य नहीं है या इसकी समयसीमा खत्म हो गई है, तो एपीआई के जवाब में 403 "Forbidden" गड़बड़ी दिखती है.
  • START_DATE: शुरू होने की तारीख, YYYY-MM-DD फ़ॉर्मैट में होनी चाहिए.
  • MAX_NUMBER: रिस्पॉन्स पेज पर दिखाए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या.

इस ऑपरेशन के अनुरोध बॉडी में कोई पैरामीटर नहीं है.

सही रिस्पॉन्स में, एचटीटीपी 200 स्टेटस कोड और ग्राहक की उन सदस्यताओं की सूची दिखती है जिन्हें ट्रांसफ़र किया जा सकता है. साथ ही, ट्रांसफ़र टोकन की समयसीमा और ट्रांसफ़र ऑर्डर में ज़रूरी सीटों की कम से कम संख्या भी दिखती है. हो सकता है कि ग्राहक के पास ऐसी अतिरिक्त सदस्यताएं हों जिन्हें ट्रांसफ़र नहीं किया जा सकता.

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "432",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1331647980142",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "maximumNumberOfSeats": 500,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183980142",
        "minimumTransferableSeats": "20"
      },
      "purchaseOrderId": "PO_890",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "140",
      "skuId": "1010020028",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183780159",
        "minimumTransferableSeats": "10"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

अगर आपको एक साथ कई सदस्यताओं को ट्रांसफ़र करना है, तो सभी सदस्यताओं को ट्रांसफ़र करें. हर सदस्यता को एक-एक करके ट्रांसफ़र करने पर गड़बड़ी होती है. इसके अलावा, एक साथ कई सदस्यताओं को ट्रांसफ़र करने की सुविधा सिर्फ़ उन सदस्यताओं के लिए काम करती है जिनका स्टेटस ACTIVE है. ज़्यादा जानकारी के लिए, सदस्यता ट्रांसफ़र करना लेख पढ़ें.

रीसेलर की सभी सदस्यताएं वापस पाना

किसी रीसेलर की उन सभी सदस्यताओं को वापस पाने के लिए जिन्हें ऑर्डर किया गया है या ट्रांसफ़र किया गया है, नीचे दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें और अनुमति वाला टोकन शामिल करें. 

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER

इनकी जगह ये डालें:

  • PREFIX: उस ग्राहक के नाम का पहला हिस्सा जिसकी सदस्यताएं आपको देखनी हैं.
  • TOKEN: यह टोकन, नतीजों के उस पेज की पहचान करता है जिसे सर्वर को दिखाना चाहिए.
  • MAX_NUMBER: रिस्पॉन्स पेज पर दिखाए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या.

इस ऑपरेशन में, OAuth के रीड-ओनली ऐक्सेस स्कोप का इस्तेमाल किया जा सकता है. customerNamePrefix, pageToken, और maxResults वैकल्पिक क्वेरी स्ट्रिंग हैं.

इस उदाहरण में, रीसेलर की उन सभी सदस्यताओं की जानकारी मिलती है जो 'exam' से शुरू होने वाले नाम वाले ग्राहकों की हैं:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "C0123456",
      "subscriptionId": "123",
      "skuId": "1010020028",
      "creationTime": "1331647980142",
      "billingMethod": "ONLINE",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "purchaseOrderId": "PO_135",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-5678",
      "subscriptionId": "1404686",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "AUTO_RENEW"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

सदस्यता प्लान अपडेट करना

Google Workspace के प्लान को अपडेट करने का तरीका, प्लान के हिसाब से अलग-अलग होता है. प्लान को अपडेट करने से पहले, इन बातों का ध्यान रखें:

  • सदस्यता बनाने और ग्राहक के ज़रूरी शर्तें पूरी करने पर, सदस्यता के प्लान में 30 दिनों का ट्रायल शामिल किया जा सकता है. ज़रूरत के हिसाब से और सालाना पैसे चुकाने के प्लान, दोनों को 30 दिनों तक मुफ़्त में आज़माया जा सकता है. मुफ़्त में आज़माने की अवधि के दौरान, सदस्यता के पेमेंट प्लान को जितनी बार चाहें उतनी बार, फ़्लेक्सिबल या सालाना कमिटमेंट वाले प्लान में बदला जा सकता है. हालांकि, मुफ़्त में आज़माने की अवधि खत्म होने और प्लान चालू होने के बाद, प्लान को अपडेट करने के लिए वही नियम लागू होते हैं जो अन्य सदस्यताओं के चालू प्लान के लिए लागू होते हैं. मुफ़्त में आज़माने की सुविधा वाली सदस्यता को तुरंत चालू प्लान में बदलने के लिए, 30 दिनों के लिए मुफ़्त में आज़माने की सुविधा वाली सदस्यता से पैसे चुकाकर ली जाने वाली सदस्यता लें. 30 दिनों के ट्रायल की ज़्यादा जानकारी और ग्राहक की ज़रूरी शर्तों के बारे में जानने के लिए, एडमिन सहायता केंद्र पर जाएं.

  • आपके पास, फ़्लेक्सिबल प्लान को सालाना प्लान में बदलने का विकल्प होता है.

  • सालाना तय की गई कीमत वाले प्लान को अपडेट नहीं किया जा सकता.

  • सभी प्लान, सभी प्रॉडक्ट के साथ काम नहीं करते. इन प्लान में किन प्रॉडक्ट का इस्तेमाल किया जाता है, इस बारे में ज़्यादा जानने के लिए प्रॉडक्ट और SKU देखें.

30 दिनों के ट्रायल या महीने के हिसाब से पैसे चुकाकर लिए जाने वाले प्लान की सदस्यता को, सालाना पैसे चुकाकर लिए जाने वाले प्लान में अपडेट करने के लिए, यहां दिए गए POST एचटीटीपी अनुरोध का इस्तेमाल करें:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan

इनकी जगह ये डालें:

इस उदाहरण में, subscriptionId की वैल्यू 123 के साथ सदस्यता अपडेट की गई है. customerId, C0123456 है.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan

अनुरोध के मुख्य हिस्से में ये चीज़ें शामिल होती हैं:

{
  "kind": "reseller#changePlanRequest",
  "planName": "ANNUAL_MONTHLY_PAY",
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "purchaseOrderId": "123_March2012"
}

सही जवाब मिलने पर, एचटीटीपी 201 स्टेटस कोड दिखता है. साथ ही, सदस्यता प्लान की अपडेट की गई सेटिंग दिखती हैं:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "123_March2012",
  "status": "ACTIVE",
  "skuName": "Google Workspace Business Standard"
}

सदस्यता की सीटों की जानकारी अपडेट करना

सालाना प्लान की सदस्यता को अपडेट करने के लिए, Google Workspace के महीने के हिसाब से प्लान की सदस्यता को अपडेट करने के मुकाबले, सदस्यता की अलग-अलग प्रॉपर्टी का इस्तेमाल किया जाता है.

सालाना प्लान की सदस्यता के लिए, सीटों की संख्या अपडेट करना

सालाना प्लान की सदस्यता के उपयोगकर्ता लाइसेंस की सेटिंग अपडेट करने के लिए, यहां दिए गए POST एचटीटीपी अनुरोध का इस्तेमाल करें:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats

इनकी जगह ये डालें:

इस उदाहरण में, सदस्यता को 123 subscriptionId से अपडेट किया गया है. customerId, C0123456 है. प्लान के टाइप के हिसाब से, अनुरोध का मुख्य हिस्सा अलग-अलग होता है:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats

Google Workspace के सालाना प्लान की सदस्यता, उपयोगकर्ता के लाइसेंस की संख्या अपडेट करने के लिए, इस अनुरोध बॉडी का इस्तेमाल करती है. numberOfSeats की वैल्यू कुल है. उदाहरण के लिए, अगर आपके पास पहले 10 उपयोगकर्ता लाइसेंस थे और आपके पास पांच नए लाइसेंस के लिए ग्राहक का ऑर्डर है, तो numberOfSeats के लिए अनुरोध के मुख्य हिस्से में कुल 15 लाइसेंस होंगे, जैसा कि इस उदाहरण में दिखाया गया है:

{
    "kind": "subscriptions#seats",
    "numberOfSeats": 15
}

ज़रूरत के हिसाब से बदलाव किए जा सकने वाले प्लान की सदस्यता के लिए, सीटों की जानकारी अपडेट करना

Google Workspace के फ़्लेक्सिबल प्लान की सदस्यता, उपयोगकर्ता के लाइसेंस अपडेट करने के लिए अनुरोध बॉडी का इस्तेमाल करती है. maximumNumberOfSeats वैल्यू, मौजूदा लाइसेंस और नए लाइसेंस की कुल संख्या होती है. यह उपयोगकर्ता के लाइसेंस की वह ज़्यादा से ज़्यादा संख्या है जो खाते से जारी की जा सकती है.

{
  "kind": "subscriptions#seats",
  "maximumNumberOfSeats": 15
}

सही जवाब में, एचटीटीपी 201 स्टेटस कोड और सदस्यता के लाइसेंस की अपडेट की गई सेटिंग दिखती हैं:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 15,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "skuName": "Google Workspace Business Standard"
}

सदस्यता के रिन्यूअल की सेटिंग अपडेट करना

साल भर के लिए खरीदी गई सदस्यता के रिन्यूअल की सेटिंग अपडेट करने के लिए, यहां दिए गए POST एचटीटीपी अनुरोध का इस्तेमाल करें:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings

इनकी जगह ये डालें:

अनुरोध के मुख्य हिस्से का उदाहरण यहां दिया गया है:

{
  "kind": "subscriptions#renewalSettings",
  "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}

renewalType प्रॉपर्टी की वैल्यू इनमें से कोई भी हो सकती है:

  • AUTO_RENEW_YEARLY_PAY: साल भर के लिए खरीदे गए प्लान की अवधि खत्म होने पर, सदस्यता के प्लान को ANNUAL_YEARLY_PAY के तौर पर अपने-आप रिन्यू करें. इसके लिए, वही numberOfSeats इस्तेमाल करें.
  • AUTO_RENEW_MONTHLY_PAY: सालाना प्लान की अवधि खत्म होने के बाद, सदस्यता के प्लान को ANNUAL_MONTHLY_PAY के तौर पर अपने-आप रिन्यू करें. इसके लिए, वही numberOfSeats इस्तेमाल करें.
  • RENEW_CURRENT_USERS_YEARLY_PAY: सालाना प्लान की अवधि खत्म होने पर, सदस्यता के प्लान को ANNUAL_YEARLY_PAY के तौर पर रिन्यू करें. हालांकि, मौजूदा सक्रिय उपयोगकर्ताओं के लाइसेंस की कुल संख्या का इस्तेमाल करें. यह सालाना प्लान के लिए डिफ़ॉल्ट सेटिंग है. इसमें हर साल पैसे चुकाने होते हैं.
  • RENEW_CURRENT_USERS_MONTHLY_PAY: सालाना प्लान की अवधि खत्म होने पर, सदस्यता के प्लान को ANNUAL_MONTHLY_PAY के तौर पर रिन्यू करें. हालांकि, मौजूदा सक्रिय उपयोगकर्ताओं के लाइसेंस की कुल संख्या का इस्तेमाल करें. यह, सालाना प्लान (हर महीने पैसे चुकाने वाले) के लिए डिफ़ॉल्ट सेटिंग है.
  • RENEW_ON_PROPOSED_OFFER: मौजूदा कमिटमेंट प्लान के इंटरवल के आखिर में, रिन्यूअल के नए प्रस्ताव पर रिन्यू करें. इसमें, numberOfSeats की वैल्यू, मौजूदा सक्रिय उपयोगकर्ताओं के लाइसेंस की संख्या या ऑफ़र के लिए सुझाई गई कमिटमेंट की संख्या में से जो भी ज़्यादा हो, उसी के हिसाब से सेट करें.
  • SWITCH_TO_PAY_AS_YOU_GO: सालाना प्लान की अवधि खत्म होने पर, सालाना प्लान को ज़रूरत के हिसाब से प्लान में बदलें.
  • CANCEL: सालाना प्लान की अवधि खत्म होने पर, सदस्यता निलंबित कर दी जाती है. निलंबन हटाने का तरीका जानने के लिए, एडमिन के लिए सहायता केंद्र पर जाएं.

सही जवाब में, एचटीटीपी 201 स्टेटस कोड और सदस्यता के रिन्यूअल की अपडेट की गई सेटिंग दिखती हैं:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

मुफ़्त में आज़माने की सदस्यता से, पैसे चुकाकर ली जाने वाली सेवा शुरू करना

अगर मुफ़्त में आज़माने की सुविधा वाली सदस्यता के लिए, पेमेंट का कोई प्लान पहले से सेट अप किया जा चुका है, तो 30 दिनों तक मुफ़्त में आज़माने की सुविधा वाली सदस्यता को तुरंत पैसे चुकाकर ली जाने वाली सदस्यता में बदलने के लिए, यहां दिए गए POST एचटीटीपी अनुरोध का इस्तेमाल करें. 

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService

इनकी जगह ये डालें:

नीचे दिए गए उदाहरण में, customerId के तौर पर C0123456 और subscriptionId की वैल्यू 123 है:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService

इस ऑपरेशन के अनुरोध बॉडी में कोई पैरामीटर नहीं है.

सही जवाब में, एचटीटीपी 201 स्टेटस कोड और सदस्यता की अपडेट की गई सेटिंग दिखती हैं:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

सदस्यता को अपग्रेड या डाउनग्रेड करना

सालाना प्लान के लिए, रिन्यूअल की सेटिंग का इस्तेमाल करके प्लान को डाउनग्रेड नहीं किया जा सकता. साथ ही, प्लान की अवधि के बीच में भी प्लान को डाउनग्रेड नहीं किया जा सकता. हमारा सुझाव है कि आप FLEXIBLE पर स्विच करने के लिए, रिन्यूअल की सेटिंग सेट करें. इसके बाद, रिन्यूअल के समय के बाद डाउनग्रेड करें.

किसी सदस्यता को अपग्रेड या डाउनग्रेड करने के लिए, उस skuId के साथ नई सदस्यता बनाएं जिसे आपको अपग्रेड या डाउनग्रेड करना है.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

इनकी जगह ये डालें:

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.

इस कॉल से पिछली सदस्यता खत्म हो जाती है और एक नई सदस्यता बन जाती है.

प्रॉडक्ट और SKU पेज पर, अपग्रेड और डाउनग्रेड के बारे में ज़्यादा जानें.