Subscriptions: insert

इससे, पुष्टि किए गए उपयोगकर्ता के चैनल के लिए सदस्यता जुड़ जाती है.

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

इस्तेमाल के सामान्य उदाहरण

अनुरोध

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

POST https://www.googleapis.com/youtube/v3/subscriptions

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत होती है. (अनुमति और पुष्टि के बारे में ज़्यादा जानें).

दायरा
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
इस कार्रवाई में, part पैरामीटर दो मकसद पूरे करता है. इससे उन प्रॉपर्टी की पहचान होती है जिन्हें राइट ऑपरेशन सेट करेगा. साथ ही, उन प्रॉपर्टी की पहचान होती है जिन्हें एपीआई से मिली जानकारी में शामिल किया जाएगा.

यहां दी गई सूची में, part के उन नामों के बारे में बताया गया है जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

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

अनुरोध के मुख्य भाग में, सदस्यता का संसाधन उपलब्ध कराएं. उस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए वैल्यू तय करनी होगी:

    • snippet.resourceId

  • आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प होता है:

    • snippet.resourceId

जवाब

यह तरीका पूरा होने पर, जवाब के मुख्य भाग में सदस्यता का संसाधन दिखता है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) subscriptionDuplicate जिस सदस्यता को बनाने की कोशिश की जा रही है वह पहले से मौजूद है.
badRequest (400) subscriptionForbidden आपने सदस्यता की ज़्यादा से ज़्यादा संख्या पूरी कर ली है.
badRequest (400) subscriptionForbidden अपने चैनल की सदस्यता लेने की सुविधा उपलब्ध नहीं है.
badRequest (400) subscriptionForbidden हाल ही में बहुत ज़्यादा सदस्यताएं ली गई हैं. कृपया कुछ घंटों बाद फिर से कोशिश करें.
forbidden (403) subscriptionForbidden अनुरोध की पुष्टि सही तरीके से नहीं की गई है या यह इस चैनल के लिए उपलब्ध नहीं है.
notFound (404) publisherNotFound अनुरोध की snippet.resourceId प्रॉपर्टी से तय किया गया संसाधन नहीं मिला.
notFound (404) subscriberNotFound अनुरोध में तय किया गया सदस्य नहीं मिला.
required (400) publisherRequired अनुरोध में तय किए गए सदस्यता संसाधन के लिए, उस चैनल की पहचान करने के लिए snippet.resourceId प्रॉपर्टी का इस्तेमाल करना ज़रूरी है जिसकी सदस्यता ली जा रही है.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई अनुरोध और जवाब को देखने के लिए, APIs Explorer का इस्तेमाल करें.