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

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

  • सालाना प्लान की सदस्यता
  • इस्तेमाल के हिसाब से प्लान के विकल्प की सदस्यता
  • 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, छूट वाली कीमत पर सदस्यताएं बनाने के लिए, डील कोड दे सकता है. सदस्यता पर छूट देने के लिए, आपको सदस्यता 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 Workspace की सदस्यता के साथ-साथ, उससे जुड़ी Google Drive या Google Vault की सदस्यता ट्रांसफ़र करनी है, तो batch ऑपरेशन का इस्तेमाल करें. इससे ACTIVE स्टेटस वाली सभी सदस्यताएं ट्रांसफ़र हो जाएंगी. एक-एक करके सभी सदस्यताएं ट्रांसफ़र करने पर गड़बड़ी होती है.

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

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

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