सदस्यता बनाना या ट्रांसफ़र करना

ग्राहक के खाते का ऑर्डर देने के बाद, कई तरह की सदस्यताएं बनाई जा सकती हैं:

  • सालाना प्लान की सदस्यता
  • इस्तेमाल के हिसाब से प्लान के विकल्प की सदस्यता
  • 30 दिनों के लिए बिना किसी शुल्क के आज़माने की सुविधा
  • छूट वाली सदस्यता

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

अगर आपने इस ग्राहक के खाते से सदस्यता नहीं ली है, तो सदस्यता ट्रांसफ़र करें.

customerType = 'team' का इस्तेमाल करने वाले ग्राहक, Google Workspace के सिर्फ़ Essentials और Enterprise Essentials वर्शन खरीद सकते हैं. अगर Google Workspace की कोई दूसरी सदस्यता खरीदने की कोशिश की जाती है, तो आपको यह गड़बड़ी दिखेगी—Customer is not eligible to purchase this subscription. Essentials या इस्तेमाल के आधार पर सदस्यताएं खरीदने वाले ग्राहक, सालाना कमिटमेंट वाले प्लान को मैनेज नहीं कर पाते. साथ ही, उनके पास अपग्रेड और डाउनग्रेड करने के सीमित विकल्प होते हैं.

सदस्यता बनाना

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

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

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

तय किए गए सालाना प्लान बनाना

सालाना प्लान वाली सदस्यताओं के लिए, सभी एसकेयू में रिन्यूअल की डिफ़ॉल्ट सेटिंग एक जैसी नहीं होती हैं. हमारा सुझाव है कि हमेशा renewalSettings पास करें. 10 सीटों के लिए, सालाना प्लान वाली सदस्यता बनाएं:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

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

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • SKU_ID: यूनीक स्टॉक कीपिंग यूनिट (एसकेयू) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और एसकेयू आईडी लेख पढ़ें.
  • PURCHASE_ORDER_ID: यह खरीदारी के ऑर्डर का आईडी होता है. इसका इस्तेमाल, इस्तेमाल को ट्रैक करने के लिए किया जा सकता है. हालांकि, इसे देना ज़रूरी नहीं है.

अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस और सालाना कमिटमेंट प्लान के लिए नई सदस्यता की सेटिंग दिखती हैं. ANNUAL_MONTHLY_PAY को सभी एपीआई रिस्पॉन्स में ANNUAL के तौर पर दिखाया जाता है.

सालाना प्लान के जवाब का एक उदाहरण यहां दिया गया है:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

महीने के हिसाब से प्लान बनाना

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

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

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

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • SKU_ID: यूनीक स्टॉक कीपिंग यूनिट (एसकेयू) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और एसकेयू आईडी लेख पढ़ें.
  • PURCHASE_ORDER_ID: यह खरीदारी के ऑर्डर का आईडी होता है. इसका इस्तेमाल, इस्तेमाल को ट्रैक करने के लिए किया जा सकता है. हालांकि, इसे देना ज़रूरी नहीं है.

फ़्लेक्सिबल प्लान के जवाब का एक उदाहरण यहां दिया गया है:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": false
  },
  "purchaseOrderId": "my_example_flex_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

मुफ़्त में आज़माने की सुविधा बनाना

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

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

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

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • SKU_ID: यूनीक स्टॉक कीपिंग यूनिट (एसकेयू) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और एसकेयू आईडी लेख पढ़ें.
  • PURCHASE_ORDER_ID: यह खरीदारी के ऑर्डर का आईडी होता है. इसका इस्तेमाल, इस्तेमाल को ट्रैक करने के लिए किया जा सकता है. हालांकि, इसे देना ज़रूरी नहीं है.

यहां 30 दिनों तक बिना किसी शुल्क के आज़माने की सुविधा वाली योजना के जवाब का उदाहरण दिया गया है:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "TRIAL",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": true,
    "trialEndTime": "1331648420142"
  },
  "purchaseOrderId": "my_example_trial_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

सदस्यता लेने पर मिलने वाली छूट का ऑफ़र बनाना

Google, छूट वाली दर पर सदस्यताएं बनाने के लिए, डील कोड दे सकता है. सदस्यता पर छूट देने के लिए, आपको सदस्यता insert कॉल में डील कोड देना होगा. अगर ग्राहक अपने ओरिजनल एसकेयू से किसी दूसरे एसकेयू पर स्विच करता है, तो छूट हटा दी जाती है.

नए ग्राहक के खाते के लिए, सालाना शुल्क पर छूट वाली सदस्यता बनाने के लिए, यहां दिया गया POST एचटीटीपी अनुरोध इस्तेमाल करें और इसमें अनुमति देने वाला टोकन शामिल करें:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}

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

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • SKU_ID: यूनीक स्टॉक कीपिंग यूनिट (एसकेयू) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और एसकेयू आईडी लेख पढ़ें.
  • PURCHASE_ORDER_ID: यह खरीदारी के ऑर्डर का आईडी होता है. इसका इस्तेमाल, इस्तेमाल को ट्रैक करने के लिए किया जा सकता है. हालांकि, इसे देना ज़रूरी नहीं है.
  • GOOGLE_CONTRACT_DEAL_CODE: Google से मिला छूट वाला कोड.

यहां छूट वाले सालाना प्लान के जवाब का एक उदाहरण दिया गया है:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
  "skuName": "Google Workspace Business Standard"
}

सदस्यता ट्रांसफ़र करना

अगर आपने नए ग्राहक खाते का ऑर्डर दें ऑपरेशन का इस्तेमाल करके, ग्राहक के खाते का ऑर्डर नहीं दिया है, तो उस ग्राहक के लिए सदस्यता बनाते समय, उसके ट्रांसफ़र टोकन का इस्तेमाल करें.

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

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

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

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • TOKEN_VALUE: यह आपके खरीदार की ओर से दिया गया ट्रांसफ़र टोकन है. ग्राहक के टोकन जनरेट करने के बाद, यह 30 दिनों तक मान्य रहता है.

ग्राहकों को ट्रांसफ़र टोकन कैसे मिलता है, इस बारे में ज़्यादा जानने के लिए, Google Workspace सहायता केंद्र पर जाएं.

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

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

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

  • CUSTOMER_ID: ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
  • SKU_ID: यूनीक स्टॉक कीपिंग यूनिट (एसकेयू) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और एसकेयू आईडी लेख पढ़ें.
  • PURCHASE_ORDER_ID: यह खरीदारी के ऑर्डर का आईडी होता है. इसका इस्तेमाल, इस्तेमाल को ट्रैक करने के लिए किया जा सकता है. हालांकि, इसे देना ज़रूरी नहीं है.

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

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

ट्रांसफ़र से जुड़ी सीमाएं

अगर आपको Google Drive या Google Vault की सदस्यता के साथ Google Workspace की सदस्यता ट्रांसफ़र करनी है, तो batch ऑपरेशन का इस्तेमाल करें. इससे ACTIVE स्टेटस वाली सभी सदस्यताओं को ट्रांसफ़र किया जा सकेगा. हर सदस्यता को एक-एक करके ट्रांसफ़र करने पर गड़बड़ी होती है.

निलंबित की गई सदस्यताओं को सिर्फ़ तब ट्रांसफ़र किया जा सकता है, जब निलंबन की वजह PENDING_TOS_ACCEPTANCE, TRIAL_ENDED या RENEWAL_WITH_TYPE_CANCEL हो.

लेगसी एसकेयू ट्रांसफ़र करते समय, subscriptions.list उस एसकेयू का skuId दिखाता है जिसे ट्रांसफ़र करना है. जिस एसकेयू का ग्राहक के पास असल में एनटाइटलमेंट है उसका skuId, transferInfo.currentLegacySkuId के तौर पर दिखाया जाता है. skuIds की पूरी सूची और इन प्लान में इस्तेमाल किए जाने वाले प्रॉडक्ट के बारे में जानने के लिए, प्रॉडक्ट और एसकेयू देखें.

ट्रांसफ़र की सुविधा, छूट वाले डील कोड के साथ काम नहीं करती.