ज़्यादा जानकारी के लिए, कृपया YouTube सहायता केंद्र पर जाएं.
किसी खास चैनल के लिए बुलेटिन पोस्ट करता है. (अनुरोध सबमिट करने वाले उपयोगकर्ता के पास चैनल की ओर से कार्रवाई करने की अनुमति होनी चाहिए.)
ध्यान दें: activity
संसाधन में उपयोगकर्ता की ओर से वीडियो को रेटिंग देने या वीडियो को 'पसंदीदा' के तौर पर मार्क करने जैसी कार्रवाइयों के बारे में जानकारी हो सकती है. हालांकि, activity
के उन संसाधनों को जनरेट करने के लिए आपको एपीआई के दूसरे तरीकों का इस्तेमाल करना होगा. उदाहरण के लिए, वीडियो को रेटिंग देने के लिए एपीआई के videos.rate()
तरीके और वीडियो को पसंदीदा के तौर पर मार्क करने के लिए playlistItems.insert()
तरीके का इस्तेमाल किया जाएगा.
कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/youtube/v3/activities
अनुमति
इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
स्कोप |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में शामिल सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string इस कार्रवाई में part पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करती है जिन्हें लिखने की कार्रवाई सेट की जाएगी. साथ ही, उन प्रॉपर्टी की भी पहचान करता है जिनमें एपीआई के रिस्पॉन्स में शामिल होगा.नीचे दी गई सूची में part के नाम दिए गए हैं, जिन्हें पैरामीटर की वैल्यू में शामिल किया जा सकता है:
|
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, गतिविधि संसाधन उपलब्ध कराएं. इस संसाधन के लिए:
-
आपको इन प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी:
snippet.description
-
इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:
snippet.description
contentDetails.bulletin.resourceId
जवाब
अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में गतिविधि संसाधन दिखता है.
गड़बड़ियां
नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
badRequest (400) |
bulletinTextRequired |
बुलेटिन पोस्ट के लिए टेक्स्ट देने के लिए, अनुरोध में snippet ऑब्जेक्ट की description प्रॉपर्टी का इस्तेमाल किया जाना चाहिए. |
badRequest (400) |
invalidMetadata |
kind प्रॉपर्टी, दिए गए आईडी के टाइप से मेल नहीं खाती. |
forbidden (403) |
forbidden |
अनुरोध सही तरीके से अनुमति नहीं दी गई है. |
notFound (404) |
playlistNotFound |
YouTube को वह वीडियो नहीं मिल सका जिसे आप बुलेटिन पोस्ट से जोड़ने की कोशिश कर रहे हैं. contentDetails.bulletinPosted.playlistId प्रॉपर्टी की वैल्यू देखें. |
notFound (404) |
videoNotFound |
YouTube को वह वीडियो नहीं मिल सका जिसे आप बुलेटिन पोस्ट से जोड़ने की कोशिश कर रहे हैं. contentDetails.bulletinPosted.videoId प्रॉपर्टी की वैल्यू देखें. |
userRateLimitExceeded (403) |
rateLimitExceeded |
अनुरोध पूरा नहीं किया जा सकता, क्योंकि आपने अपना कोटा पार कर लिया है. |