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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.