MembershipsLevels: list

ध्यान दें: इस एंडपॉइंट का इस्तेमाल सिर्फ़ अलग-अलग क्रिएटर्स ही कर सकते हैं. इससे वे अपने खुद के, चैनल की सदस्यता की सुविधा वाले YouTube चैनल के लिए अनुरोध कर सकते हैं. ऐक्सेस का अनुरोध करने के लिए, अपने Google या 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
इस संसाधन का ईटैग.
items[] list
एपीआई अनुरोध की अनुमति देने वाले चैनल के मालिकाना हक वाले membershipsLevel संसाधनों की सूची.

गड़बड़ियां

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

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