- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- DeletionType
- इसे आज़माएं!
सदस्यता रद्द करता है, निलंबित करता है या डायरेक्ट करने के लिए ट्रांसफ़र करता है.
एचटीटीपी अनुरोध
DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
यह ग्राहक का प्राइमरी डोमेन नेम या ग्राहक का यूनीक आइडेंटिफ़ायर हो सकता है. अगर किसी ग्राहक का डोमेन नेम बदलता है, तो ग्राहक को ऐक्सेस करने के लिए पुराने डोमेन नेम का इस्तेमाल नहीं किया जा सकता. हालांकि, ग्राहक के यूनीक आइडेंटिफ़ायर (जो एपीआई से मिला है) का हमेशा इस्तेमाल किया जा सकता है. हमारा सुझाव है कि जहां भी लागू हो, वहां अपने सिस्टम में यूनीक आइडेंटिफ़ायर को सेव करें. |
subscriptionId |
यह एक ज़रूरी प्रॉपर्टी है. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
deletionType |
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
यह मैसेज एक आर्बिट्ररी एचटीटीपी काेड दिखाता है. इसका इस्तेमाल सिर्फ़ पेलोड फ़ॉर्मैट के लिए किया जाना चाहिए, जिसे मूल बाइनरी या एचटीएमएल पेज जैसे जेएसओएन के रूप में नहीं दिखाया जा सकता.
इस मैसेज का इस्तेमाल अनुरोध और जवाब में एपीआई के स्ट्रीमिंग और बिना स्ट्रीमिंग वाले दाेनाें तरीकों में किया जा सकता है.
इसका इस्तेमाल टॉप-लेवल के अनुरोध फ़ील्ड के रूप में किया जा सकता है. अगर कोई व्यक्ति यूआरएल या एचटीटीपी टेम्प्लेट से पैरामीटर को अनुरोध फ़ील्ड में लाना और मूल एचटीटीपी के मुख्य भाग का इस्तेमाल करना चाहता है, ताे इसके लिए भी यह अच्छा विकल्प है.
उदाहरण:
message GetResourceRequest {
// A unique request id.
string requestId = 1;
// The raw HTTP body is bound to this field.
google.api.HttpBody http_body = 2;
}
service ResourceService {
rpc GetResource(GetResourceRequest)
returns (google.api.HttpBody);
rpc UpdateResource(google.api.HttpBody)
returns (google.protobuf.Empty);
}
स्ट्रीमिंग के तरीकाें के साथ उदाहरण:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
स्ट्रीमिंग के इस प्रकार का इस्तेमाल सिर्फ़ तब बदलता है जब अनुरोध और जवाब के मुख्य में बदलाव हाेता है. बाकी सभी सुविधाएं वैसे ही काम करती हैं.
अगर सफलता मिलती है, तो रिस्पॉन्स एक सामान्य एचटीटीपी रिस्पॉन्स है, जिसका फ़ॉर्मैट इस तरीके से तय होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
फ़ील्ड | |
---|---|
contentType |
एचटीटीपी Content-Type हेडर वैल्यू, जिससे यह पता चलता है कि कॉन्टेंट किस तरह का है. |
data |
एचटीटीपी अनुरोध/रिस्पॉन्स का मुख्य हिस्सा, रॉ बाइनरी के तौर पर. Base64 कोड में बदली गई स्ट्रिंग. |
extensions[] |
ऐप्लिकेशन के जवाब का खास मेटाडेटा. स्ट्रीमिंग एपीआई के लिए पहले जवाब में सेट किया जाना चाहिए. एक ऑब्जेक्ट, जिसमें आर्बिट्रेरी टाइप के फ़ील्ड शामिल हैं. एक और फ़ील्ड |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/apps.order
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
DeletionType
Enums | |
---|---|
deletion_type_undefined |
|
cancel |
सदस्यता को तुरंत रद्द कर देता है. यह G Suite की सदस्यता पर लागू नहीं होता. |
transfer_to_direct |
सदस्यता को सीधे Google को ट्रांसफ़र करता है. ग्राहक को तुरंत Google के साथ सीधे तौर पर बिलिंग करने वाले संबंध में ट्रांसफ़र कर दिया जाता है और सेवा में बिना किसी रुकावट के कुछ समय दिया जाता है. इसके बाद, ग्राहक अपने क्रेडिट कार्ड का इस्तेमाल करके, सीधे Google के साथ बिलिंग सेट अप कर सकते हैं. इसके अलावा, वह इसे किसी दूसरे रीसेलर को ट्रांसफ़र कर सकते हैं. |