Method: subscriptions.delete

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

किसी सदस्यता को सीधे तौर पर रद्द करने, निलंबित करने या ट्रांसफ़र करने के लिए.

एचटीटीपी अनुरोध

DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल होता है.

पाथ पैरामीटर

पैरामीटर
customerId

string

यह या तो ग्राहक का प्राइमरी डोमेन नेम हो सकता है या ग्राहक का यूनीक आइडेंटिफ़ायर हो सकता है. अगर किसी ग्राहक के लिए डोमेन नेम में बदलाव किया जाता है, तो पुराने डोमेन नेम का इस्तेमाल, ग्राहक को ऐक्सेस करने के लिए नहीं किया जा सकता. हालांकि, ग्राहक के यूनीक आइडेंटिफ़ायर (जैसे कि एपीआई से मिला डेटा) का इस्तेमाल हमेशा किया जा सकता है. हमारा सुझाव है कि जहां लागू हो वहां अपने सिस्टम में यूनीक आइडेंटिफ़ायर को स्टोर करें.

subscriptionId

string

यह एक ज़रूरी प्रॉपर्टी है. subscriptionId, सदस्यता आइडेंटिफ़ायर है और यह हर ग्राहक के लिए अलग होता है. सदस्यता अपडेट होने के बाद, subscriptionId बदल जाता है. इसलिए, हमारा सुझाव है कि आप इस डेटा को स्थायी डेटा की कुंजी के तौर पर इस्तेमाल न करें. साथ ही, subscriptionId को रीसेलर से जुड़ी सभी सदस्यताएं वापस पाने के तरीके का इस्तेमाल करके भी ढूंढा जा सकता है.

क्वेरी पैरामीटर

पैरामीटर
deletionType

enum (DeletionType)

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

string

एचटीटीपी कॉन्टेंट-टाइप हेडर की वैल्यू, बॉडी के कॉन्टेंट टाइप की जानकारी देती है.

data

string (bytes format)

एचटीटीपी अनुरोध/रिस्पॉन्स बॉडी, रॉ बाइनरी के तौर पर है.

Base64-एन्कोडेड स्ट्रिंग.

extensions[]

object

ऐप्लिकेशन के जवाब का खास मेटाडेटा. स्ट्रीमिंग एपीआई के लिए पहले जवाब में सेट किया जाना चाहिए.

ऐसा ऑब्जेक्ट जिसमें आर्बिट्ररी टाइप के फ़ील्ड होते हैं. एक और फ़ील्ड "@type" में एक यूआरआई होता है, जो टाइप की पहचान करता है. उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/apps.order

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

मिटाने का तरीका

Enums
deletion_type_undefined
cancel सदस्यता तुरंत रद्द कर देता है. यह G Suite सदस्यता पर लागू नहीं होता.
transfer_to_direct

सदस्यता को सीधे Google को ट्रांसफ़र करता है. ग्राहक को सीधे Google के साथ सीधे बिलिंग संबंध में ट्रांसफ़र कर दिया जाता है और उसे थोड़े समय में सेवा में कोई रुकावट नहीं आती है. इसके बाद, ग्राहक क्रेडिट कार्ड का इस्तेमाल करके, सीधे Google के साथ बिलिंग सेट अप कर सकते हैं या वे किसी दूसरे रीसेलर को ट्रांसफ़र कर सकते हैं.