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 के ग्राहक की सदस्यताएं मैनेज करना है.

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

JSON के काेड में दिखाना 
{
  "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

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