API Reference

YouTube Data API की मदद से, YouTube की वेबसाइट पर आम तौर पर इस्तेमाल किए जाने वाले फ़ंक्शन को अपनी वेबसाइट या ऐप्लिकेशन में शामिल किया जा सकता है. यहां दिए गए सेक्शन में, अलग-अलग तरह के उन संसाधनों के बारे में बताया गया है जिन्हें एपीआई का इस्तेमाल करके वापस पाया जा सकता है. एपीआई, इन संसाधनों में से कई को डालने, अपडेट करने या मिटाने के तरीकों के साथ भी काम करता है.

इस रेफ़रंस गाइड में, इन सभी कार्रवाइयों को करने के लिए एपीआई का इस्तेमाल करने का तरीका बताया गया है. इस गाइड को संसाधन टाइप के हिसाब से व्यवस्थित किया गया है. संसाधन, एक तरह का आइटम होता है. यह YouTube के अनुभव का हिस्सा होता है. जैसे, वीडियो, प्लेलिस्ट या सदस्यता. हर संसाधन टाइप के लिए, गाइड में एक या उससे ज़्यादा डेटा प्रज़ेंटेशन दिए गए हैं. साथ ही, संसाधनों को JSON ऑब्जेक्ट के तौर पर दिखाया गया है. इस गाइड में, हर संसाधन टाइप के लिए एक या उससे ज़्यादा काम करने वाले तरीकों (LIST, POST, DELETE वगैरह) की सूची भी दी गई है. साथ ही, यह भी बताया गया है कि अपने ऐप्लिकेशन में इन तरीकों का इस्तेमाल कैसे करें.

एपीआई को कॉल करना

YouTube Data API के अनुरोधों पर ये शर्तें लागू होती हैं:

  1. हर अनुरोध में, एपीआई कुंजी (key पैरामीटर के साथ) या OAuth 2.0 टोकन देना ज़रूरी है. आपके प्रोजेक्ट के लिए, Developer Console के एपीआई ऐक्सेस पैनल में आपकी एपीआई पासकोड उपलब्ध है.

  2. आपको हर इंसर्ट, अपडेट, और मिटाने के अनुरोध के लिए, अनुमति वाला टोकन भेजना ज़रूरी है. आपको ऐसे हर अनुरोध के लिए अनुमति देने वाला टोकन भी भेजना होगा जो पुष्टि किए गए उपयोगकर्ता का निजी डेटा वापस पाता है.

    इसके अलावा, संसाधनों को वापस पाने के लिए कुछ एपीआई तरीके ऐसे पैरामीटर इस्तेमाल कर सकते हैं जिनके लिए अनुमति की ज़रूरत होती है. साथ ही, अनुरोधों को अनुमति मिलने पर उनमें अतिरिक्त मेटाडेटा भी शामिल हो सकता है. उदाहरण के लिए, अगर कोई उपयोगकर्ता अपने अपलोड किए गए वीडियो वापस पाने का अनुरोध करता है, तो उसमें निजी वीडियो भी शामिल हो सकते हैं. हालांकि, ऐसा तब ही होगा, जब उस उपयोगकर्ता ने अनुरोध की पुष्टि की हो.

  3. यह एपीआई, OAuth 2.0 पुष्टि करने वाले प्रोटोकॉल के साथ काम करता है. OAuth 2.0 टोकन को इनमें से किसी भी तरीके से उपलब्ध कराया जा सकता है:

    • access_token क्वेरी पैरामीटर का इस्तेमाल इस तरह करें: ?access_token=oauth2-token
    • एचटीटीपी Authorization हेडर का इस्तेमाल इस तरह करें: Authorization: Bearer oauth2-token

    अपने ऐप्लिकेशन में OAuth 2.0 पुष्टि करने की सुविधा लागू करने के बारे में पूरी जानकारी, पुष्टि करने की गाइड में देखी जा सकती है.

संसाधन के टाइप

गतिविधियां

activity रिसॉर्स में, किसी चैनल या उपयोगकर्ता की YouTube पर की गई कार्रवाई के बारे में जानकारी होती है. गतिविधि फ़ीड में, वीडियो को रेटिंग देना, वीडियो शेयर करना, वीडियो को पसंदीदा के तौर पर मार्क करना, वीडियो अपलोड करना वगैरह जैसी कार्रवाइयों की जानकारी दी जाती है. हर activity संसाधन से, कार्रवाई के टाइप, कार्रवाई से जुड़े चैनल, और कार्रवाई से जुड़े संसाधनों की पहचान होती है. जैसे, जिस वीडियो को रेटिंग दी गई है या अपलोड किया गया है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /activities यह अनुरोध की शर्तों से मेल खाने वाले, चैनल की गतिविधि से जुड़े इवेंट की सूची दिखाता है. उदाहरण के लिए, किसी चैनल या उपयोगकर्ता के चैनल से जुड़े इवेंट वापस लाए जा सकते हैं.

कैप्शन

caption संसाधन, YouTube के कैप्शन ट्रैक को दिखाता है. एक कैप्शन ट्रैक, सिर्फ़ एक YouTube वीडियो से जुड़ा होता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /captions इससे चुने गए कैप्शन ट्रैक को मिटाया जाता है.
download GET /captions/id यह कुकी, कैप्शन ट्रैक को डाउनलोड करती है. कैप्शन ट्रैक को उसके मूल फ़ॉर्मैट में तब तक दिखाया जाता है, जब तक अनुरोध में tfmt पैरामीटर के लिए कोई वैल्यू न दी गई हो. इसी तरह, कैप्शन ट्रैक को उसकी मूल भाषा में तब तक दिखाया जाता है, जब तक अनुरोध में tlang पैरामीटर के लिए कोई वैल्यू न दी गई हो.
insert POST /captions यह कैप्शन ट्रैक अपलोड करता है.
list GET /captions यह फ़ंक्शन, किसी वीडियो से जुड़े कैप्शन ट्रैक की सूची दिखाता है. एपीआई के जवाब में असली कैप्शन मौजूद नहीं हैं. साथ ही, captions.download तरीके से कैप्शन ट्रैक को वापस पाने की सुविधा मिलती है.
update PUT /captions यह कैप्शन ट्रैक को अपडेट करता है. कैप्शन ट्रैक अपडेट करते समय, ट्रैक के ड्राफ़्ट स्टेटस में बदलाव किया जा सकता है. इसके अलावा, ट्रैक के लिए नई कैप्शन फ़ाइल अपलोड की जा सकती है या ये दोनों काम एक साथ किए जा सकते हैं.

ChannelBanners

channelBanner रिसॉर्स में वह यूआरएल होता है जिसका इस्तेमाल करके, नई अपलोड की गई इमेज को किसी चैनल की बैनर इमेज के तौर पर सेट किया जाता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
insert POST /channelBanners/insert यह कुकी, YouTube पर चैनल के बैनर की इमेज अपलोड करती है. इस तरीके में, चैनल के बैनर की इमेज अपडेट करने की तीन चरणों वाली प्रोसेस के पहले दो चरण शामिल हैं:
  1. YouTube पर बाइनरी इमेज डेटा अपलोड करने के लिए, channelBanners.insert तरीके का इस्तेमाल करें. इमेज की चौड़ाई-ऊंचाई का अनुपात 16:9 होना चाहिए. साथ ही, इमेज कम से कम 2048x1152 पिक्सल की होनी चाहिए. हमारा सुझाव है कि आप 2560 पिक्सल x 1440 पिक्सल की इमेज अपलोड करें.
  2. पहले चरण में एपीआई से मिले जवाब से, url प्रॉपर्टी की वैल्यू निकालें.
  3. चैनल की ब्रैंडिंग सेटिंग अपडेट करने के लिए, channels.update तरीके का इस्तेमाल करें. brandingSettings.image.bannerExternalUrl प्रॉपर्टी की वैल्यू को दूसरे चरण में मिले यूआरएल पर सेट करें.

ChannelSections

channelSection संसाधन में, उन वीडियो के बारे में जानकारी होती है जिन्हें किसी चैनल ने दिखाने के लिए चुना है. उदाहरण के लिए, किसी सेक्शन में किसी चैनल के हाल ही में अपलोड किए गए वीडियो, सबसे लोकप्रिय वीडियो या एक या उससे ज़्यादा प्लेलिस्ट के वीडियो दिखाए जा सकते हैं.

किसी चैनल के सेक्शन सिर्फ़ तब दिखते हैं, जब चैनल पर कॉन्टेंट को फ़ीड व्यू के बजाय ब्राउज़ व्यू में दिखाया जाता है. किसी चैनल को ब्राउज़ व्यू में कॉन्टेंट दिखाने की अनुमति देने के लिए, उस चैनल के लिए brandingSettings.channel.showBrowseView प्रॉपर्टी को true पर सेट करें.

कोई चैनल ज़्यादा से ज़्यादा 10 शेल्फ़ बना सकता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /channelSections यह कुकी, चैनल के सेक्शन को मिटाती है.
insert POST /channelSections इस तरीके का इस्तेमाल करके, भरोसेमंद व्यक्ति के चैनल में कोई चैनल सेक्शन जोड़ा जा सकता है. कोई चैनल ज़्यादा से ज़्यादा 10 शेल्फ़ बना सकता है.
list GET /channelSections यह एपीआई अनुरोध की शर्तों से मेल खाने वाले channelSection संसाधनों की सूची दिखाता है.
update PUT /channelSections चैनल के किसी सेक्शन को अपडेट करता है.

चैनल

channel संसाधन में, किसी YouTube चैनल के बारे में जानकारी होती है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /channels यह अनुरोध की शर्तों से मेल खाने वाले, शून्य या उससे ज़्यादा channel संसाधनों का कलेक्शन दिखाता है.
update PUT /channels चैनल का मेटाडेटा अपडेट करता है. इस तरीके से, सिर्फ़ channel संसाधन के brandingSettings और invideoPromotion ऑब्जेक्ट और उनकी चाइल्ड प्रॉपर्टी को अपडेट किया जा सकता है.

CommentThreads

commentThread संसाधन में, YouTube पर की गई टिप्पणी की थ्रेड के बारे में जानकारी होती है. इसमें टॉप-लेवल की टिप्पणी और उस टिप्पणी के जवाब शामिल होते हैं. commentThread रिसॉर्स, किसी वीडियो या चैनल के बारे में की गई टिप्पणियों को दिखाता है.

टॉप-लेवल की टिप्पणी और उसके जवाब, commentThread रिसॉर्स में नेस्ट किए गए comment रिसॉर्स होते हैं. यह ज़रूरी नहीं है कि commentThread संसाधन में, किसी टिप्पणी के सभी जवाब शामिल हों. अगर आपको किसी टिप्पणी के सभी जवाब वापस पाने हैं, तो आपको comments.list तरीके का इस्तेमाल करना होगा. इसके अलावा, कुछ टिप्पणियों के जवाब नहीं होते.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /commentThreads यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाले कमेंट थ्रेड की सूची दिखाता है.
insert POST /commentThreads यह टॉप-लेवल की नई टिप्पणी बनाता है. किसी मौजूदा टिप्पणी का जवाब देने के लिए, comments.insert तरीके का इस्तेमाल करें.

टिप्पणियां

comment संसाधन में, YouTube पर की गई किसी एक टिप्पणी के बारे में जानकारी होती है. comment संसाधन, किसी वीडियो या चैनल के बारे में की गई टिप्पणी को दिखाता है. इसके अलावा, टिप्पणी टॉप-लेवल की टिप्पणी या टॉप-लेवल की टिप्पणी का जवाब हो सकती है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /comments यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाली टिप्पणियों की सूची दिखाता है.
setModerationStatus POST /comments/setModerationStatus यह कुकी, एक या उससे ज़्यादा टिप्पणियों के मॉडरेशन की स्थिति सेट करती है. एपीआई अनुरोध को उस चैनल या वीडियो के मालिक की अनुमति मिलनी चाहिए जिस पर टिप्पणियां की गई हैं.
insert POST /comments इस फ़ंक्शन का इस्तेमाल, किसी मौजूदा टिप्पणी का जवाब देने के लिए किया जाता है. ध्यान दें: सबसे ऊपर दिखने वाली टिप्पणी बनाने के लिए, commentThreads.insert तरीके का इस्तेमाल करें.
delete DELETE /comments किसी टिप्पणी को मिटाता है.
update PUT /comments किसी टिप्पणी में बदलाव करता है.

I18nLanguages

i18nLanguage संसाधन, ऐप्लिकेशन की उस भाषा की पहचान करता है जिसे YouTube की वेबसाइट पर इस्तेमाल किया जा सकता है. ऐप्लिकेशन की भाषा को यूज़र इंटरफ़ेस (यूआई) की भाषा भी कहा जा सकता है. YouTube की वेबसाइट के लिए, ऐप्लिकेशन की भाषा अपने-आप चुनी जा सकती है. यह Google खाते की सेटिंग, ब्राउज़र की भाषा या आईपी पते की जगह के हिसाब से चुनी जाती है. कोई उपयोगकर्ता, YouTube साइट के फ़ुटर से भी यूज़र इंटरफ़ेस (यूआई) की भाषा को मैन्युअल तरीके से चुन सकता है.

हर i18nLanguage रिसॉर्स, भाषा कोड और नाम की पहचान करता है. भाषा कोड का इस्तेमाल, hl जैसे एपीआई तरीकों को कॉल करते समय, hl पैरामीटर की वैल्यू के तौर पर किया जा सकता है.videoCategories.list

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /i18nLanguages इससे YouTube वेबसाइट पर इस्तेमाल की जा सकने वाली भाषाओं की सूची मिलती है.

I18nRegions

i18nRegion संसाधन, किसी भौगोलिक इलाके की पहचान करता है. YouTube उपयोगकर्ता इस इलाके को, कॉन्टेंट देखने के लिए अपनी पसंदीदा जगह के तौर पर चुन सकता है. कॉन्टेंट क्षेत्र को कॉन्टेंट की स्थान-भाषा भी कहा जा सकता है. YouTube की वेबसाइट के लिए, कॉन्टेंट क्षेत्र को अपने-आप चुना जा सकता है. इसके लिए, YouTube डोमेन या उपयोगकर्ता की आईपी लोकेशन जैसे अनुमानित तरीकों का इस्तेमाल किया जाता है. उपयोगकर्ता, YouTube साइट के फ़ुटर से भी कॉन्टेंट का क्षेत्र मैन्युअल तरीके से चुन सकता है.

हर i18nRegion संसाधन, क्षेत्र के कोड और नाम की पहचान करता है. एपीआई के search.list, videos.list, activities.list, और videoCategories.list जैसे तरीकों को कॉल करते समय, क्षेत्र के कोड का इस्तेमाल regionCode पैरामीटर की वैल्यू के तौर पर किया जा सकता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /i18nRegions इससे उन देशों/इलाकों की सूची मिलती है जहां YouTube की वेबसाइट काम करती है.

सदस्य

member संसाधन, YouTube चैनल के लिए पैसे चुकाकर बने सदस्य को दिखाता है. पैसे चुकाकर बने सदस्य, किसी क्रिएटर को बार-बार पैसे देकर सपोर्ट करते हैं. इसके बदले, उन्हें खास फ़ायदे मिलते हैं. उदाहरण के लिए, जब कोई क्रिएटर चैट के लिए सिर्फ़ सदस्यों के लिए उपलब्ध मोड चालू करता है, तब सदस्य चैट कर सकते हैं.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /members किसी चैनल के सदस्यों (जिन्हें पहले "प्रायोजक" कहा जाता था) की सूची दिखाता है. एपीआई अनुरोध को चैनल के मालिक की अनुमति मिली होनी चाहिए.

MembershipsLevels

membershipsLevel संसाधन, क्रिएटर के लिए कीमत के लेवल की पहचान करता है. यह क्रिएटर, एपीआई अनुरोध को अनुमति देता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /membershipsLevels यह एपीआई अनुरोध को अनुमति देने वाले चैनल के मालिकाना हक वाले, शून्य या उससे ज़्यादा membershipsLevel संसाधनों का कलेक्शन दिखाता है. लेवल, डिसप्ले के डिफ़ॉल्ट क्रम में दिखाए जाते हैं.

PlaylistItems

playlistItem संसाधन, किसी अन्य संसाधन की पहचान करता है. जैसे, प्लेलिस्ट में शामिल किया गया वीडियो. इसके अलावा, playlistItem रिसॉर्स में, शामिल किए गए रिसॉर्स के बारे में जानकारी होती है. यह जानकारी खास तौर पर इस बारे में होती है कि उस रिसॉर्स का इस्तेमाल उस प्लेलिस्ट में कैसे किया जाता है.

YouTube, अपलोड किए गए वीडियो की सूची वाले चैनल की पहचान करने के लिए भी प्लेलिस्ट का इस्तेमाल करता है. इस सूची में मौजूद हर playlistItem, अपलोड किए गए एक वीडियो को दिखाता है. किसी चैनल के लिए, उस सूची का प्लेलिस्ट आईडी channel resource से वापस पाया जा सकता है. इसके बाद, सूची में playlistItems.list तरीका इस्तेमाल किया जा सकता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /playlistItems यह अनुरोध, प्लेलिस्ट आइटम को मिटाता है.
insert POST /playlistItems यह किसी संसाधन को प्लेलिस्ट में जोड़ता है.
list GET /playlistItems यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाले प्लेलिस्ट आइटम का कलेक्शन दिखाता है. किसी प्लेलिस्ट में मौजूद सभी आइटम को वापस लाया जा सकता है. इसके अलावा, एक या उससे ज़्यादा आइटम को उनके यूनीक आईडी के हिसाब से भी वापस लाया जा सकता है.
update PUT /playlistItems यह प्लेलिस्ट आइटम में बदलाव करता है. उदाहरण के लिए, प्लेलिस्ट में आइटम की जगह अपडेट की जा सकती है.

प्लेलिस्ट

playlist संसाधन, YouTube प्लेलिस्ट को दिखाता है. प्लेलिस्ट, वीडियो का एक कलेक्शन होता है. इसे क्रम से देखा जा सकता है और अन्य लोगों के साथ शेयर किया जा सकता है. डिफ़ॉल्ट रूप से, प्लेलिस्ट अन्य उपयोगकर्ताओं को सार्वजनिक तौर पर दिखती हैं. हालांकि, प्लेलिस्ट को सार्वजनिक या निजी के तौर पर सेट किया जा सकता है.

YouTube, किसी चैनल के लिए वीडियो के खास कलेक्शन की पहचान करने के लिए भी प्लेलिस्ट का इस्तेमाल करता है. जैसे:

  • अपलोड किए गए वीडियो
  • पसंद किए गए वीडियो
  • देखने का इतिहास
  • बाद में देखूँगा

ज़्यादा जानकारी के लिए बता दें कि ये सूचियां किसी चैनल से जुड़ी होती हैं. चैनल, किसी व्यक्ति, ग्रुप या कंपनी के वीडियो, प्लेलिस्ट, और YouTube पर मौजूद अन्य जानकारी का कलेक्शन होता है. किसी चैनल के लिए, इन सूचियों में से हर सूची के प्लेलिस्ट आईडी, channel resource से वापस पाए जा सकते हैं.

इसके बाद, इनमें से किसी भी सूची को वापस पाने के लिए, playlistItems.list तरीके का इस्तेमाल किया जा सकता है. playlistItems.insert और playlistItems.delete तरीकों का इस्तेमाल करके, उन सूचियों में आइटम जोड़े या हटाए भी जा सकते हैं.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /playlists यह किसी प्लेलिस्ट को मिटाता है.
list GET /playlists यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाली प्लेलिस्ट का कलेक्शन दिखाता है. उदाहरण के लिए, पुष्टि किए गए उपयोगकर्ता के मालिकाना हक वाली सभी प्लेलिस्ट वापस पाई जा सकती हैं. इसके अलावा, यूनीक आईडी के हिसाब से एक या उससे ज़्यादा प्लेलिस्ट वापस पाई जा सकती हैं.
insert POST /playlists यह कुकी, प्लेलिस्ट बनाती है.
update PUT /playlists यह कुकी, प्लेलिस्ट में बदलाव करती है. उदाहरण के लिए, प्लेलिस्ट का टाइटल, ब्यौरा या निजता की स्थिति बदली जा सकती है.

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

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /search यह एपीआई अनुरोध में बताए गए क्वेरी पैरामीटर से मेल खाने वाले खोज नतीजों का कलेक्शन दिखाता है. डिफ़ॉल्ट रूप से, खोज के नतीजों का सेट, मिलते-जुलते video, channel, और playlist रिसॉर्स की पहचान करता है. हालांकि, क्वेरी को सिर्फ़ किसी खास तरह के रिसॉर्स को वापस पाने के लिए भी कॉन्फ़िगर किया जा सकता है.

सदस्यताएं

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

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /subscriptions यह सदस्यता मिटाता है.
insert POST /subscriptions इस कुकी का इस्तेमाल, पुष्टि किए गए उपयोगकर्ता के चैनल के लिए सदस्यता जोड़ने के लिए किया जाता है.
list GET /subscriptions यह एपीआई अनुरोध की शर्तों से मेल खाने वाले सदस्यता संसाधन दिखाता है.

थंबनेल

thumbnail संसाधन, किसी संसाधन से जुड़ी थंबनेल इमेज के अलग-अलग साइज़ की पहचान करता है. थंबनेल इमेज की ये विशेषताएं:

  • किसी संसाधन की snippet.thumbnails प्रॉपर्टी एक ऑब्जेक्ट होती है. यह उस संसाधन के लिए उपलब्ध थंबनेल इमेज की पहचान करती है.
  • thumbnail रिसॉर्स में ऑब्जेक्ट की एक सीरीज़ होती है. हर ऑब्जेक्ट (default, medium, high वगैरह) का नाम, थंबनेल इमेज के साइज़ के बारे में बताता है.
  • अलग-अलग तरह के संसाधनों के लिए, थंबनेल इमेज के साइज़ अलग-अलग हो सकते हैं.
  • अलग-अलग तरह के संसाधनों के लिए, एक ही नाम वाली थंबनेल इमेज के अलग-अलग साइज़ तय किए जा सकते हैं. उदाहरण के लिए, video संसाधन के लिए default थंबनेल इमेज आम तौर पर 120 पिक्सल x 90 पिक्सल होती है. वहीं, channel संसाधन के लिए default थंबनेल इमेज आम तौर पर 88 पिक्सल x 88 पिक्सल होती है.
  • एक ही तरह के संसाधनों की कुछ इमेज के थंबनेल का साइज़ अलग-अलग हो सकता है. ऐसा ओरिजनल इमेज के रिज़ॉल्यूशन या YouTube पर अपलोड किए गए कॉन्टेंट के आधार पर होता है. उदाहरण के लिए, एचडी वीडियो के लिए, नॉन-एचडी वीडियो के मुकाबले ज़्यादा रिज़ॉल्यूशन वाले थंबनेल इस्तेमाल किए जा सकते हैं.
  • थंबनेल इमेज के साइज़ की जानकारी देने वाले हर ऑब्जेक्ट में, width प्रॉपर्टी और height प्रॉपर्टी होती है. हालांकि, हो सकता है कि उस इमेज के लिए चौड़ाई और ऊंचाई की प्रॉपर्टी न दिखाई जाएं.
  • अगर अपलोड की गई थंबनेल इमेज, ज़रूरी डाइमेंशन से मेल नहीं खाती है, तो इमेज का आसपेक्ट रेशियो बदले बिना, उसके साइज़ को सही साइज़ के हिसाब से बदल दिया जाता है. इमेज को काटा नहीं गया है, लेकिन इसमें ब्लैक बार शामिल हो सकते हैं, ताकि साइज़ सही हो.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
set POST /thumbnails/set यह कुकी, YouTube पर वीडियो का कस्टम थंबनेल अपलोड करती है और उसे वीडियो के लिए सेट करती है.

VideoAbuseReportReasons

videoAbuseReportReason संसाधन में, उस वजह के बारे में जानकारी होती है जिसकी वजह से किसी वीडियो को अपमानजनक कॉन्टेंट के लिए फ़्लैग किया जाता है. जब आपका ऐप्लिकेशन, आपत्तिजनक वीडियो की शिकायत करने के लिए videos.reportAbuse तरीके का इस्तेमाल करता है, तो अनुरोध में videoAbuseReportReason संसाधन से मिली जानकारी का इस्तेमाल किया जाता है. इससे यह पता चलता है कि वीडियो की शिकायत क्यों की जा रही है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /videoAbuseReportReasons अपमानजनक वीडियो की शिकायत करने के लिए इस्तेमाल की जा सकने वाली वजहों की सूची पाएं.

VideoCategories

videoCategory संसाधन, ऐसी कैटगरी की पहचान करता है जिसे अपलोड किए गए वीडियो से जोड़ा गया है या जोड़ा जा सकता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /videoCategories यह उन कैटगरी की सूची दिखाता है जिन्हें YouTube वीडियो से जोड़ा जा सकता है.

वीडियो

video संसाधन, YouTube वीडियो को दिखाता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
insert POST /videos YouTube पर वीडियो अपलोड करता है. साथ ही, वीडियो का मेटाडेटा सेट करने का विकल्प भी देता है.
list GET /videos इससे एपीआई अनुरोध के पैरामीटर से मेल खाने वाले वीडियो की सूची मिलती है.
delete DELETE /videos यह YouTube वीडियो मिटाता है.
update PUT /videos इस तरीके का इस्तेमाल करके, वीडियो के मेटाडेटा को अपडेट किया जा सकता है.
rate POST /videos/rate किसी वीडियो को पसंद या नापसंद करने की रेटिंग जोड़ना या हटाना.
getRating GET /videos/getRating यह फ़ंक्शन, उन रेटिंग को वापस पाता है जो अनुमति वाले उपयोगकर्ता ने वीडियो की सूची में मौजूद वीडियो को दी हैं.
reportAbuse POST /videos/reportAbuse अपमानजनक कॉन्टेंट वाले वीडियो की शिकायत करें.

वॉटरमार्क

watermark रिसॉर्स, किसी इमेज की पहचान करता है. यह इमेज, किसी चैनल के वीडियो के प्लेबैक के दौरान दिखती है. आपके पास यह तय करने का विकल्प भी होता है कि इमेज किस टारगेट चैनल से लिंक होगी. साथ ही, आपके पास यह तय करने का विकल्प भी होता है कि वीडियो चलाने के दौरान वॉटरमार्क कब दिखेगा और कितने समय तक दिखेगा.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
set POST /watermarks/set यह कुकी, YouTube पर वॉटरमार्क वाली इमेज अपलोड करती है और उसे किसी चैनल के लिए सेट करती है.
unset POST /watermarks/unset यह चैनल की वॉटरमार्क इमेज को मिटाता है.