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

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

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

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

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

customerType = 'team' वाले ग्राहक सिर्फ़ Essentials और Google Workspace के Enterprise Essentials वर्शन. अगर आपको खरीदारी करनी है, तो सदस्यता लेने के बाद, आपको गड़बड़ी—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: छूट का कोड उपलब्ध है देखें.

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

{
  "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 सदस्यता है, तो batch कार्रवाई ACTIVE स्टेटस वाली सभी सदस्यताओं को ट्रांसफ़र करने के लिए. हर एक को ट्रांसफ़र किया जा रहा है एक-एक करके सदस्यता का इस्तेमाल करने में गड़बड़ी होती है.

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

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

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