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

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

  • तय की गई सालाना सदस्यता
  • ज़रूरत के हिसाब से सदस्यता
  • 30-दिन का मुफ़्त परीक्षण
  • छूट पर सदस्यता

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

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

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

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

तय किए गए सालाना प्लान वाली सदस्यताओं के लिए, सभी SKU के लिए रिन्यूअल की डिफ़ॉल्ट सेटिंग एक जैसी नहीं होती हैं. हमारा सुझाव है कि आप हमेशा 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: यूनीक स्टॉक कीपिंग यूनिट (SKU) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और SKU आईडी देखें.
  • 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: यूनीक स्टॉक कीपिंग यूनिट (SKU) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और SKU आईडी देखें.
  • 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: यूनीक स्टॉक कीपिंग यूनिट (SKU) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और SKU आईडी देखें.
  • 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 कॉल में डील कोड देना होगा. अगर ग्राहक अपनी मूल SKU से बदलाव करता है, तो यह छूट हटा दी जाती है.

नए बनाए गए ग्राहक के खाते के लिए, तय की गई छूट वाली सालाना सदस्यता बनाने के लिए, यहां दिया गया 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: यूनीक स्टॉक कीपिंग यूनिट (SKU) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और SKU आईडी देखें.
  • 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: यूनीक स्टॉक कीपिंग यूनिट (SKU) आइडेंटिफ़ायर. ज़्यादा जानकारी के लिए, प्रॉडक्ट और SKU आईडी देखें.
  • 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 की सदस्यता ट्रांसफ़र की जा रही है, तो ACTIVE स्टेटस वाली सभी सदस्यताओं को ट्रांसफ़र करने के लिए, batch कार्रवाई का इस्तेमाल करें. हर सदस्यता को एक-एक करके ट्रांसफ़र करने में गड़बड़ी होती है.

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

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

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