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

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

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

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

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

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

• CUSTOMER_ID: ग्राहक के प्राइमरी डोमेन का नाम या ग्राहक का यूनीक आइडेंटिफ़ायर.
• 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&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 दिनों तक आज़माने की सुविधा और ग्राहक की ज़रूरी शर्तों के बारे में ज़्यादा जानने के लिए, एडमिन सहायता केंद्र पर जाएं.

• आपके पास फ़्लेक्सिबल प्लान को सालाना कमिटमेंट प्लान में अपडेट करने का विकल्प होता है.

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

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

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

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

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

• CUSTOMER_ID: ग्राहक के प्राइमरी डोमेन का नाम या ग्राहक का यूनीक आइडेंटिफ़ायर.
• SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताओं को वापस पाने के तरीके का इस्तेमाल करके, इस वैल्यू को वापस पाया जा सकता है.

इस उदाहरण में, सदस्यता को 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

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

• CUSTOMER_ID: ग्राहक के प्राइमरी डोमेन का नाम या ग्राहक का यूनीक आइडेंटिफ़ायर.
• SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताओं को वापस पाने के तरीके का इस्तेमाल करके, इस वैल्यू को वापस पाया जा सकता है.

यहां दिए गए उदाहरण में, 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 के फ़्लेक्सिबल प्लान की सदस्यता, उपयोगकर्ता के लाइसेंस अपडेट करने के लिए request body का इस्तेमाल करती है. 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

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

• CUSTOMER_ID: ग्राहक के प्राइमरी डोमेन का नाम या ग्राहक का यूनीक आइडेंटिफ़ायर.
• SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताओं को वापस पाने के तरीके का इस्तेमाल करके, इस वैल्यू को वापस पाया जा सकता है.

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

{
  "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: मौजूदा कमिटमेंट प्लान की समयसीमा खत्म होने पर, रिन्यूअल के नए प्रस्ताव के हिसाब से रिन्यू करें. इसमें सीटों की संख्या, मौजूदा समय में सक्रिय उपयोगकर्ताओं के लाइसेंस की संख्या या प्रस्तावित ऑफ़र कमिटमेंट, जो भी ज़्यादा हो उसके हिसाब से तय की जाएगी.
• SWITCH_TO_PAY_AS_YOU_GO: सालाना कमिटमेंट वाले प्लान की अवधि खत्म होने पर, उसे ज़रूरत के हिसाब से प्लान में बदलें.
• CANCEL: सालाना प्लान की अवधि खत्म होने पर, सदस्यता निलंबित कर दी जाती है. निलंबन हटाने का तरीका जानने के लिए, Admin सहायता केंद्र पर जाएं.

अनुरोध पूरा होने पर, एचटीटीपी 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

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

• CUSTOMER_ID: ग्राहक के प्राइमरी डोमेन का नाम या ग्राहक का यूनीक आइडेंटिफ़ायर.
• SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताओं को वापस पाने के तरीके का इस्तेमाल करके, इस वैल्यू को वापस पाया जा सकता है.

इस उदाहरण में, C0123456 को customerId और 123 को subscriptionId वैल्यू के तौर पर दिखाया गया है:

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: ग्राहक के प्राइमरी डोमेन का नाम या ग्राहक का यूनीक आइडेंटिफ़ायर.

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

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