सदस्यता वापस पाने के बाद, जवाब में मिली जानकारी का इस्तेमाल करके, सदस्यता का स्टेटस बदला जा सकता है या सदस्यता अपडेट की जा सकती है. इस पेज पर, सदस्यता वापस पाने और उसे अपडेट करने का तरीका बताया गया है.
सदस्यता वापस पाना
ऑर्डर की गई या ट्रांसफ़र की गई सदस्यता वापस पाने के लिए, एचटीटीपी का यह GET अनुरोध इस्तेमाल करें:
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताएं वापस पाएं तरीके का इस्तेमाल करके, यह वैल्यू वापस पाई जा सकती है.
इस कार्रवाई के लिए, अनुरोध के मुख्य हिस्से में कोई पैरामीटर नहीं होता.
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड और सदस्यता की सेटिंग मिलती हैं. जवाब के इस उदाहरण में, isInTrial प्रॉपर्टी की वैल्यू false है. हालांकि, इसमें trialEndTime प्रॉपर्टी नहीं है. इसका मतलब है कि इस ग्राहक ने इस प्लान के साथ, 30 दिनों का मुफ़्त ट्रायल कभी नहीं लिया.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"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": "RENEW_CURRENT_USERS_MONTHLY_PAY"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
}
किसी ग्राहक की सभी सदस्यताएं वापस पाना
किसी रीसेलर के ग्राहक की, ऑर्डर की गई या ट्रांसफ़र की गई सभी सदस्यताएं वापस पाने के लिए, एचटीटीपी का यह GET अनुरोध इस्तेमाल करें और इसमें अनुमति देने वाला टोकन शामिल करें:
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&pageToken=START_DATE&maxResults=MAX_NUMBER
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.START_DATE: शुरू होने की तारीख, जोYYYY-MM-DDफ़ॉर्मैट में होनी चाहिए.MAX_NUMBER: जवाब वाले पेज पर, नतीजों की ज़्यादा से ज़्यादा संख्या.
इस कार्रवाई के लिए, अनुरोध के मुख्य हिस्से में कोई पैरामीटर नहीं होता.
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड और ग्राहक की सदस्यताओं और सेटिंग की सूची मिलती है. सदस्यताओं की सूची में, ऐसे प्रॉडक्ट शामिल हो सकते हैं जिन्हें Reseller API के इस वर्शन में मैनेज नहीं किया जाता.
अगर ग्राहक को मैनेज नहीं किया जाता है, तो 403 Forbidden गड़बड़ी का मैसेज दिखता है.
किसी ग्राहक की, ट्रांसफ़र की जा सकने वाली सभी सदस्यताएं वापस पाना
किसी ग्राहक की, ट्रांसफ़र की जा सकने वाली सभी सदस्यताएं वापस पाने के लिए, एचटीटीपी का यह GET अनुरोध इस्तेमाल करें और इसमें अनुमति देने वाला टोकन शामिल करें. customerId ज़रूरी है
और यह ग्राहक का यूनीक आइडेंटिफ़ायर होता है, जो
रीसेल किए गए ग्राहक का खाता वापस पाने पर मिलता है.
customerAuthToken, ट्रांसफ़र टोकन होता है. यह टोकन, आपका ग्राहक देता है और यह आपके रीसेलर आईडी के लिए खास होता है. टोकन जनरेट करने के बाद, यह 30 दिनों तक मान्य रहता है. ग्राहक, टोकन कैसे जनरेट करते हैं, इस बारे101} में ज़्यादा जानने के लिए,101}अपना Google Workspace खाता किसी रीसेलर को ट्रांसफ़र करना लेख पढ़ें.
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.AUTH_TOKEN: ट्रांसफ़र टोकन, जो आपका ग्राहक देता है और यह आपके रीसेलर आईडी के लिए खास होता है. टोकन जनरेट करने के बाद, यह 30 दिनों तक मान्य रहता है. ग्राहक, टोकन कैसे जनरेट करते हैं, इस बारे में ज़्यादा जानने के लिए, अपना Google Workspace खाता किसी रीसेलर को ट्रांसफ़र करना लेख पढ़ें. अगर यह वैल्यू मान्य नहीं है या इसकी समयसीमा खत्म हो गई है, तो एपीआई के जवाब में403 Forbiddenगड़बड़ी का मैसेज दिखता है.START_DATE: शुरू होने की तारीख, जोYYYY-MM-DDफ़ॉर्मैट में होनी चाहिए.MAX_NUMBER: जवाब वाले पेज पर, नतीजों की ज़्यादा से ज़्यादा संख्या.
इस कार्रवाई के लिए, अनुरोध के मुख्य हिस्से में कोई पैरामीटर नहीं होता.
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड और ग्राहक की, ट्रांसफ़र की जा सकने वाली सदस्यताओं की सूची मिलती है. इसमें ट्रांसफ़र टोकन की समयसीमा खत्म होने की तारीख और ट्रांसफ़र ऑर्डर में ज़रूरी सीटों की कम से कम संख्या शामिल होती है. ऐसा हो सकता है कि ग्राहक के पास, ट्रांसफ़र नहीं की जा सकने वाली अन्य सदस्यताएं भी हों.
{
"kind": "reseller#subscriptions",
"subscriptions": [
{
"kind": "subscriptions#subscription",
"customerId": "custId-6543",
"subscriptionId": "432",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"maximumNumberOfSeats": 500,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"transferInfo": {
"transferabilityExpirationTime": "1333183980142",
"minimumTransferableSeats": "20"
},
"purchaseOrderId": "PO_890",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
{
"kind": "subscriptions#subscription",
"customerId": "custId-6543",
"subscriptionId": "140",
"skuId": "1010020028",
"creationTime": "1329389322728",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 50,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false,
"trialEndTime": "1331877480016"
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"transferInfo": {
"transferabilityExpirationTime": "1333183780159",
"minimumTransferableSeats": "10"
},
"purchaseOrderId": "",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
],
"nextPageToken": "token"
}
अगर आपको बैच ऑपरेशन का इस्तेमाल करके, इन सदस्यताओं को ट्रांसफ़र करना है, तो सभी सदस्यताएं ट्रांसफ़र करें. सदस्यताओं को एक-एक करके ट्रांसफ़र करने पर, गड़बड़ी होती है. इसके अलावा, बैच ऑपरेशन से सिर्फ़ वे सदस्यताएं ट्रांसफ़र होती हैं जिनका स्टेटस ACTIVE होता है. ज़्यादा जानकारी के लिए, सदस्यता ट्रांसफ़र करना लेख पढ़ें.
रीसेलर की सभी सदस्यताएं वापस पाना
किसी रीसेलर की, ऑर्डर की गई या ट्रांसफ़र की गई सभी सदस्यताएं वापस पाने के लिए, एचटीटीपी का यह GET अनुरोध इस्तेमाल करें और इसमें अनुमति देने वाला टोकन शामिल करें:
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX&pageToken=TOKEN&maxResults=MAX_NUMBER
इनकी जगह ये डालें:
PREFIX: ग्राहक के नाम की शुरुआत, जिसकी सदस्यताएं आपको ढूंढनी हैं.TOKEN: एक टोकन, जो नतीजों के किसी खास पेज की पहचान करता है. सर्वर को यह पेज दिखाना चाहिए.MAX_NUMBER: जवाब वाले पेज पर, नतीजों की ज़्यादा से ज़्यादा संख्या.
इस कार्रवाई के लिए, OAuth के रीड-ओनली ऐक्सेस स्कोप का इस्तेमाल किया जा सकता है. customerNamePrefix, pageToken, और maxResults क्वेरी स्ट्रिंग के तौर पर इस्तेमाल किए जा सकते हैं. हालांकि, ये ज़रूरी नहीं हैं.
इस उदाहरण में, किसी रीसेलर की वे सभी सदस्यताएं वापस पाई जाती हैं जिनके ग्राहक के नाम की शुरुआत 'exam' से होती है:
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam
{
"kind": "reseller#subscriptions",
"subscriptions": [
{
"kind": "subscriptions#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"billingMethod": "ONLINE",
"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": "PO_135",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
{
"kind": "subscriptions#subscription",
"customerId": "custId-5678",
"subscriptionId": "1404686",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"creationTime": "1329389322728",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 50,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false,
"trialEndTime": "1331877480016"
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "AUTO_RENEW"
},
"purchaseOrderId": "",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
],
"nextPageToken": "token"
}
सदस्यता प्लान अपडेट करना
Google Workspace के प्लान अपडेट करने का तरीका, प्लान के हिसाब से अलग-अलग होता है. प्लान अपडेट करने से पहले, इन बातों का ध्यान रखें:
सदस्यता बनाने पर, अगर ग्राहक ज़रूरी शर्तें पूरी करता है, तो सदस्यता का प्लान 30 दिनों का ट्रायल हो सकता है. महीने के हिसाब से बिलिंग वाले प्लान और सालाना प्लान, दोनों 30 दिनों के मुफ़्त ट्रायल हो सकते हैं. ट्रायल के दौरान, सदस्यता के पेमेंट प्लान को अपनी ज़रूरत के हिसाब से, महीने के हिसाब से बिलिंग वाले प्लान या सालाना प्लान में बदला जा सकता है. ट्रायल खत्म होने और प्लान के चालू होने के बाद, प्लान अपडेट करने के लिए वही नियम लागू होते हैं जो अन्य सदस्यताओं के चालू प्लान के लिए लागू होते हैं. ट्रायल वाली सदस्यता को तुरंत चालू प्लान में बदलने के लिए, 30 दिनों के मुफ़्त ट्रायल वाली सदस्यता से, पैसे चुकाकर सेवा लेना शुरू करें. 30 दिनों के ट्रायल और ग्राहक की ज़रूरी शर्तों के बारे में ज़्यादा जानने के लिए, the Admin सहायता केंद्र देखें.
महीने के हिसाब से बिलिंग वाले प्लान को, सालाना प्लान में अपडेट किया जा सकता है.
सालाना प्लान को अपडेट नहीं किया जा सकता.
यह ज़रूरी नहीं है कि सभी प्लान, सभी प्रॉडक्ट के साथ काम करें. इन प्लान के साथ इस्तेमाल किए जाने वाले प्रॉडक्ट के बारे में ज़्यादा जानने के लिए, प्रॉडक्ट और एसकेयू देखें.
30 दिनों के ट्रायल या महीने के हिसाब से बिलिंग वाले प्लान की सदस्यता को, सालाना प्लान में अपडेट करने के लिए, एचटीटीपी का यह POST अनुरोध इस्तेमाल करें:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताएं वापस पाएं तरीके का इस्तेमाल करके, यह वैल्यू वापस पाई जा सकती है.
इस उदाहरण में, subscriptionId की वैल्यू 123 वाली सदस्यता अपडेट की जाती है. customerId की वैल्यू C0123456 है.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan
अनुरोध के मुख्य हिस्से में यह जानकारी शामिल होती है:
{
"kind": "reseller#changePlanRequest",
"planName": "ANNUAL_MONTHLY_PAY",
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
"purchaseOrderId": "123_March2012"
}
अनुरोध पूरा होने पर, एचटीटीपी 201 स्टेटस कोड और अपडेट किए गए सदस्यता प्लान की सेटिंग मिलती हैं:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"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": "123_March2012",
"status": "ACTIVE",
"skuName": "Google Workspace Business Standard"
}
सदस्यता की सीटों की संख्या अपडेट करना
सालाना प्लान की सदस्यता अपडेट करने के लिए, सदस्यता की अलग-अलग प्रॉपर्टी इस्तेमाल की जाती हैं. वहीं, Google Workspace के महीने के हिसाब से बिलिंग वाले प्लान की सदस्यता अपडेट करने के लिए, सदस्यता की अलग-अलग प्रॉपर्टी इस्तेमाल की जाती हैं.
सालाना प्लान की सदस्यता के लिए सीटों की संख्या अपडेट करना
सालाना प्लान की सदस्यता के लिए, उपयोगकर्ता लाइसेंस की सेटिंग अपडेट करने के लिए, एचटीटीपी का यह POST अनुरोध इस्तेमाल करें:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताएं वापस पाएं तरीके का इस्तेमाल करके, यह वैल्यू वापस पाई जा सकती है.
इस उदाहरण में, subscriptionId की वैल्यू 123 वाली सदस्यता अपडेट की जाती है. customerId की वैल्यू C0123456 है. अनुरोध का मुख्य हिस्सा, प्लान के टाइप के हिसाब से अलग-अलग होता है:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats
Google Workspace के सालाना प्लान की सदस्यता के लिए, उपयोगकर्ता लाइसेंस की संख्या अपडेट करने के लिए, अनुरोध के इस मुख्य हिस्से का इस्तेमाल किया जाता है. numberOfSeats की वैल्यू, कुल संख्या होती है. उदाहरण के लिए, अगर आपके पास पहले 10 उपयोगकर्ता लाइसेंस थे और आपको ग्राहक से पांच नए लाइसेंस का ऑर्डर मिला है, तो अनुरोध के मुख्य हिस्से में numberOfSeats की वैल्यू 15 होगी. जैसा कि इस उदाहरण में दिखाया गया है:
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
महीने के हिसाब से बिलिंग वाले प्लान की सदस्यता के लिए सीटों की संख्या अपडेट करना
Google Workspace के महीने के हिसाब से बिलिंग वाले प्लान की सदस्यता के लिए, उपयोगकर्ता लाइसेंस अपडेट करने के लिए, अनुरोध के मुख्य हिस्से का इस्तेमाल किया जाता है. maximumNumberOfSeats की वैल्यू, मौजूदा लाइसेंस और नए लाइसेंस की कुल संख्या होती है. यह उपयोगकर्ता लाइसेंस की ज़्यादा से ज़्यादा संख्या होती है, जिसे खाते के लिए उपलब्ध कराया जा सकता है.
{
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15
}
अनुरोध पूरा होने पर, एचटीटीपी 201 स्टेटस कोड और अपडेट किए गए सदस्यता लाइसेंस की सेटिंग मिलती हैं:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"skuName": "Google Workspace Business Standard"
}
सदस्यता के रिन्यूअल की सेटिंग अपडेट करना
सालाना प्लान की सदस्यता के रिन्यूअल की सेटिंग अपडेट करने के लिए, एचटीटीपी का यह POST अनुरोध इस्तेमाल करें:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताएं वापस पाएं तरीके का इस्तेमाल करके, यह वैल्यू वापस पाई जा सकती है.
अनुरोध के मुख्य हिस्से का एक उदाहरण यहां दिया गया है:
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
renewalType प्रॉपर्टी की वैल्यू इनमें से कोई भी हो सकती है:
AUTO_RENEW_YEARLY_PAY: सालाना प्लान की अवधि खत्म होने पर, सदस्यता के प्लान कोANNUAL_YEARLY_PAYके तौर पर अपने-आप रिन्यू करें. इसमेंnumberOfSeatsकी वैल्यू वही रहेगी.AUTO_RENEW_MONTHLY_PAY: सालाना प्लान की अवधि खत्म होने पर, सदस्यता के प्लान कोANNUAL_MONTHLY_PAYके तौर पर अपने-आप रिन्यू करें. इसमेंnumberOfSeatsकी वैल्यू वही रहेगी.RENEW_CURRENT_USERS_YEARLY_PAY: सालाना प्लान की अवधि खत्म होने पर, सदस्यता के प्लान कोANNUAL_YEARLY_PAYके तौर पर रिन्यू करें. हालांकि, इसमें मौजूदा चालू उपयोगकर्ता लाइसेंस की कुल संख्या का इस्तेमाल करें. यह, सालाना प्लान (हर साल पैसे चुकाने वाले) के लिए डिफ़ॉल्ट सेटिंग है.RENEW_CURRENT_USERS_MONTHLY_PAY: सालाना प्लान की अवधि खत्म होने पर, सदस्यता के प्लान कोANNUAL_MONTHLY_PAYके तौर पर रिन्यू करें. हालांकि, इसमें मौजूदा चालू उपयोगकर्ता लाइसेंस की कुल संख्या का इस्तेमाल करें. यह, सालाना प्लान (हर महीने पैसे चुकाने वाले) के लिए डिफ़ॉल्ट सेटिंग है.RENEW_ON_PROPOSED_OFFER: मौजूदा प्लान की अवधि खत्म होने पर, रिन्यूअल के लिए मिले सबसे नए प्रपोज़ल के हिसाब से रिन्यू करें. इसमें numberOfSeats की वैल्यू, मौजूदा चालू उपयोगकर्ता लाइसेंस की संख्या या प्रपोज़ल में दी गई संख्या में से जो भी ज़्यादा हो, वह होगी.SWITCH_TO_PAY_AS_YOU_GO: सालाना प्लान की अवधि खत्म होने पर, सालाना प्लान को महीने के हिसाब से बिलिंग वाले प्लान में बदलें.CANCEL: सालाना प्लान की अवधि खत्म होने पर, सदस्यता निलंबित कर दी जाती है. निलंबन हटाने का तरीका जानने के लिए, देखें Admin सहायता केंद्र.
अनुरोध पूरा होने पर, एचटीटीपी 201 स्टेटस कोड और सदस्यता के रिन्यूअल की अपडेट की गई सेटिंग मिलती हैं:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 15,
"licensedNumberOfSeats": 15
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"skuName": "Google Workspace Business Standard"
}
मुफ़्त ट्रायल वाली सदस्यता से, पैसे चुकाकर सेवा लेना शुरू करना
अगर 30 दिनों के मुफ़्त ट्रायल वाली सदस्यता के लिए, पेमेंट प्लान पहले से सेट अप किया गया है, तो इस सदस्यता को तुरंत पैसे चुकाकर सेवा लेने वाली सदस्यता में बदलने के लिए, एचटीटीपी का यह POST अनुरोध इस्तेमाल करें:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.SUBSCRIPTION_ID: सदस्यता का आइडेंटिफ़ायर, जो हर ग्राहक के लिए यूनीक होता है. रीसेलर की सभी सदस्यताएं वापस पाएं तरीके का इस्तेमाल करके, यह वैल्यू वापस पाई जा सकती है.
इस उदाहरण में, customerId की वैल्यू C0123456 है और subscriptionId की वैल्यू 123 है:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService
इस कार्रवाई के लिए, अनुरोध के मुख्य हिस्से में कोई पैरामीटर नहीं होता.
अनुरोध पूरा होने पर, एचटीटीपी 201 स्टेटस कोड और सदस्यता की अपडेट की गई सेटिंग मिलती हैं:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 15,
"licensedNumberOfSeats": 15
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"skuName": "Google Workspace Business Standard"
}
सदस्यता को अपग्रेड या डाउनग्रेड करना
सालाना प्लान को उसकी अवधि के बीच में डाउनग्रेड नहीं किया जा सकता. साथ ही, रिन्यूअल की सेटिंग का इस्तेमाल करके, डाउनग्रेड करने का शेड्यूल नहीं किया जा सकता. हमारा सुझाव है कि रिन्यूअल की सेटिंग को FLEXIBLE पर सेट करें. इसके बाद, रिन्यूअल के समय डाउनग्रेड करें.
सदस्यता को अपग्रेड या डाउनग्रेड करने के लिए,
skuId के साथ नई सदस्यता बनाएं. यह , उस प्लान का होना चाहिए जिसे आपको अपग्रेड या डाउनग्रेड करना है.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
इनकी जगह ये डालें:
CUSTOMER_ID: ग्राहक का मुख्य डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर.
इस कॉल से, पिछली सदस्यता खत्म हो जाती है और नई सदस्यता बन जाती है.
अपग्रेड और डाउनग्रेड के बारे में ज़्यादा जानने के लिए, प्रॉडक्ट और एसकेयू पेज देखें.