MembershipsLevels: list

ध्यान दें: इस एंडपॉइंट का इस्तेमाल, सिर्फ़ वे क्रिएटर कर सकते हैं जिन्होंने अपने YouTube चैनल पर पैसे चुकाकर ली जाने वाली सदस्यता की सुविधा चालू की है. साथ ही, वे अपने चैनल के लिए ही अनुरोध कर सकते हैं.

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

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

कोटे पर असर: इस तरीके के लिए किए गए कॉल पर, कोटे की एक यूनिट का खर्च आता है.

अनुरोध

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

GET https://www.googleapis.com/youtube/v3/membershipsLevels

इस अनुरोध के लिए, इस दायरे के साथ अनुमति ज़रूरी है:

दायरा
https://www.googleapis.com/auth/youtube.channel-memberships.creator

पैरामीटर

यहां दी गई टेबल में, वे पैरामीटर दिए गए हैं जिन्हें इस क्वेरी में इस्तेमाल किया जा सकता है. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर से पता चलता है कि एपीआई के जवाब में, membershipsLevel संसाधन की कौनसी प्रॉपर्टी शामिल होंगी. इस पैरामीटर की वैल्यू, संसाधन के हिस्सों की कॉमा से अलग की गई सूची होती है. यहां उन हिस्सों की सूची दी गई है जिन्हें वापस पाया जा सकता है:
  • id
  • snippet

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

इस तरीके को कॉल करते समय, अनुरोध का मुख्य भाग न दें.

जवाब

अगर यह तरीका सही से काम करता है, तो इसके जवाब के मुख्य भाग में यह स्ट्रक्चर शामिल होता है:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे, एपीआई संसाधन के टाइप की पहचान होती है. इसकी वैल्यू youtube#membershipsLevelListResponse होगी.
etag etag
यह इस संसाधन का Etag है.
items[] list
यह membershipsLevel संसाधनों की सूची है. इनका मालिकाना हक उस चैनल के पास है जिसने एपीआई के अनुरोध को अनुमति दी है.

गड़बड़ियां

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

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