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

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

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

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

अगर आप इस ग्राहक को मैनेज नहीं करते हैं, तो 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 क्वेरी स्ट्रिंग हैं. हालांकि, इनका इस्तेमाल करना ज़रूरी नहीं है.

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

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

इन्हें बदलें:

  • 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 उपयोगकर्ता लाइसेंस थे और आपके पास 5 नए लाइसेंस का ग्राहक ऑर्डर है, तो अनुरोध के मुख्य भाग में 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: तय किए गए सालाना प्लान के बीच का समय खत्म होने पर, सदस्यता का प्लान अपने-आप रिन्यू हो जाता है. इसके लिए, सदस्यता प्लान numberOfSeats में ही रिन्यू होते हैं.ANNUAL_MONTHLY_PAY
  • 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

इन्हें बदलें:

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

नीचे दिए गए उदाहरण में C0123456, customerId के तौर पर और 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 पेज पर जाकर, अपग्रेड और डाउनग्रेड के बारे में ज़्यादा जानकारी पाएं.