MembershipsLevels: list

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

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

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

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 1 इकाई हो जाती है.

अनुरोध

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

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 जिस क्रिएटर चैनल ने अनुरोध भेजा है उस पर चैनल की पैसे चुकाकर ली जाने वाली सदस्यता की सुविधा चालू नहीं है.