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

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

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

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

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

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

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

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

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

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

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