Method: subscriptions.list

उन सदस्यताओं की सूचियां जिन्हें रीसेलर मैनेज करता है. सूची में सभी सदस्यताएं, किसी ग्राहक की सभी सदस्यताएं या ग्राहक की ट्रांसफ़र की जा सकने वाली सभी सदस्यताएं हो सकती हैं.

इसके अलावा, इस तरीके से रिस्पॉन्स को customerNamePrefix की मदद से फ़िल्टर किया जा सकता है. ज़्यादा जानकारी के लिए, सदस्यताएं मैनेज करना देखें.

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

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

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

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

पैरामीटर
customerAuthToken

string

रीसेलर से खरीदा गया खाता बनाते समय, customerAuthToken क्वेरी स्ट्रिंग की ज़रूरत होती है. यह स्ट्रिंग, किसी ग्राहक की सदस्यता को सीधे तौर पर ट्रांसफ़र करती है या किसी दूसरे रीसेलर ग्राहक की सदस्यता को आपके रीसेलर मैनेजमेंट में ट्रांसफ़र करती है. यह हेक्साडेसिमल ऑथेंटिकेशन टोकन है. इसकी ज़रूरत सदस्यता ट्रांसफ़र करने के लिए होती है. ज़्यादा जानकारी के लिए, एडमिन सहायता केंद्र पर जाएं.
customerId

string

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

string

अपनी सभी सदस्यताएं वापस पाने और खास ग्राहकों के लिए फ़िल्टर लगाते समय, किसी ग्राहक के नाम के आगे एक प्रीफ़िक्स डाला जा सकता है. उदाहरण के तौर पर दिए गए ऐसे ग्राहक ग्रुप का इस्तेमाल करना जिसमें exam.com, example20.com, और example.com शामिल हों:

  • exa -- 'exa' से शुरू होने वाले सभी ग्राहकों के नाम दिखाता है, जिनमें exam.com, example20.com, और example.com शामिल हो सकते हैं. नाम का प्रारंभिक भाग रेगुलर एक्सप्रेशन के तारे का निशान, exa* इस्तेमाल करने जैसा ही है.
  • example -- example20.com और example.com दिखाता है.
maxResults

integer (uint32 format)

बड़ी सूची लोड करते समय, हर पेज पर नतीजों की ज़्यादा से ज़्यादा संख्या maxResults होती है. nextPageToken वैल्यू आपको अगले पेज पर ले जाती है. डिफ़ॉल्ट संख्या 20 है.
pageToken

string

सूची में अगला पेज जोड़ने के लिए टोकन

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

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

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

यह संसाधन को सदस्यताओं के कलेक्शन के तौर पर बताता है. मान: रीसेलर#subscriptions
subscriptions[]

object (Subscription)

नतीजों के इस पेज पर मौजूद सदस्यताएं.
nextPageToken

string

कंटिन्यूशन टोकन, जिसका इस्तेमाल नतीजों के बड़े सेट में मौजूद पेजों के लिए किया जाता है. यह वैल्यू, नतीजों का अगला पेज दिखाने के लिए, बाद के अनुरोध में डालें.

अनुमति देने के दायरे

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.