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

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

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

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

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

customerType = 'team' का इस्तेमाल करने वाले ग्राहक, Google Workspace के सिर्फ़ Google Workspace Essentials और Google Workspace 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, छूट वाली कीमत पर सदस्यताएं बनाने के लिए, डील कोड दे सकता है. सदस्यता पर छूट देने के लिए, आपको subscription 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 दिनों तक मान्य रहता है.

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

तय किए गए सालाना प्लान वाले ग्राहक की सदस्यता ट्रांसफ़र करने के लिए, यहां दिया गया 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 हो.

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

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