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

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

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

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

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

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