YouTube पर कस्टम वीडियो थंबनेल अपलोड करता है और उसे किसी वीडियो के लिए सेट करता है.
इस तरीके में मीडिया अपलोड किया जा सकता है. अपलोड की गई फ़ाइलें इन पाबंदियों के मुताबिक होनी चाहिए:
- फ़ाइल इससे बड़ी नहीं होनी चाहिए: 2 एमबी
- स्वीकार किए जाने वाले मीडिया MIME टाइप:
image/jpeg
,image/png
,application/octet-stream
कोटा असर: इस तरीके को कॉल करने का कोटा लागत करीब 50 है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set
अनुमति देना
इस अनुरोध को इनमें से कम से कम किसी एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें).
स्कोप |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर में
इस टेबल में उन पैरामीटर की सूची दी गई है जो इस क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर में | ||
---|---|---|
ज़रूरी पैरामीटर | ||
videoId |
string videoId पैरामीटर से उस YouTube वीडियो के आईडी की जानकारी मिलती है जिसके लिए कस्टम वीडियो थंबनेल दिया जा रहा है. |
|
ज़रूरी नहीं | ||
onBehalfOfContentOwner |
string ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए बनाया गया है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध के लिए अनुमति वाले क्रेडेंशियल, ऐसे YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इस सुविधा की मदद से, कॉन्टेंट के मालिक एक बार में पुष्टि कर सकते हैं. साथ ही, उन्हें अपने हर वीडियो और चैनल के डेटा का ऐक्सेस मिल सकता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होगी. उपयोगकर्ता जिस सीएमएस खाते की पुष्टि करता है उसे YouTube के किसी कॉन्टेंट के मालिक से लिंक करना होगा. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, वह थंबनेल इमेज होती है जिसे आपको अपलोड करना है. अनुरोध के मुख्य हिस्से में thumbnail
रिसॉर्स नहीं है.
जवाब
अगर इस तरीके का इस्तेमाल किया जाता है, तो रिस्पॉन्स देने वाला यह तरीका नीचे दिए गए स्ट्रक्चर के साथ दिखाता है:
{ "kind": "youtube#thumbnailSetResponse", "etag": etag, "items": [ thumbnail resource ] }
प्रॉपर्टी
इस टेबल में, उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में दिखती हैं:
प्रॉपर्टी | |
---|---|
kind |
string एपीआई संसाधन के टाइप की पहचान करता है. वैल्यू youtube#thumbnailSetResponse होगी. |
etag |
etag इस संसाधन का ऐटैग. |
items[] |
list थंबनेल की सूची. |
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो एपीआई को इस तरीके से कॉल करने पर मिल सकती हैं. कृपया ज़्यादा जानकारी के लिए गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | जानकारी |
---|---|---|
badRequest (400) |
invalidImage |
दिया गया इमेज कॉन्टेंट अमान्य है. |
badRequest (400) |
mediaBodyRequired |
अनुरोध में इमेज का कॉन्टेंट शामिल नहीं है. |
forbidden (403) |
forbidden |
थंबनेल को इस वीडियो के लिए सेट नहीं किया जा सकता. शायद अनुरोध को ठीक से अनुमति न दी गई हो. |
forbidden (403) |
forbidden |
पुष्टि पा चुके उपयोगकर्ता के पास कस्टम वीडियो थंबनेल अपलोड करने और सेट करने की अनुमतियां नहीं हैं. |
notFound (404) |
videoNotFound |
आपको जिस वीडियो के लिए थंबनेल इमेज डालने की कोशिश करनी है वह नहीं मिला. अनुरोध के videoId पैरामीटर की वैल्यू की जांच करके पक्का करें कि वह सही है. |
tooManyRequests (429) |
uploadRateLimitExceeded |
चैनल ने हाल ही में बहुत ज़्यादा थंबनेल अपलोड किए हैं. कृपया बाद में अनुरोध करें. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और रिस्पॉन्स देखने के लिए, APIs Explorer का इस्तेमाल करें.