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 यह फ़ंक्शन, अनुरोध की शर्तों के मुताबिक चैनल की गतिविधि के इवेंट की सूची दिखाता है. उदाहरण के लिए, किसी खास चैनल या उपयोगकर्ता के चैनल से जुड़े इवेंट की जानकारी वापस पाई जा सकती है.
insert POST /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 कैप्शन ट्रैक को अपडेट करता है. कैप्शन ट्रैक को अपडेट करते समय, ट्रैक के लिए ड्राफ़्ट का स्टेटस बदला जा सकता है, ट्रैक के लिए नई कैप्शन फ़ाइल अपलोड की जा सकती है या दोनों काम किए जा सकते हैं.

चैनल बैनर

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 प्रॉपर्टी की वैल्यू को दूसरे चरण में मिले यूआरएल पर सेट करें.

चैनल सेक्शन

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 ऑब्जेक्ट और उनकी चाइल्ड प्रॉपर्टी के अपडेट पर काम करता है.

कमेंट थ्रेड

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 तरीके का इस्तेमाल करें.
markAsSpam POST /comments/markAsSpam ध्यान दें: यह तरीका अब काम नहीं करता.
delete DELETE /comments किसी टिप्पणी को मिटाता है.
update PUT /comments किसी टिप्पणी में बदलाव करता है.

गाइड की कैटगरी

guideCategory संसाधन एक ऐसी कैटगरी की पहचान करता है जिसे YouTube, एल्गोरिदम के आधार पर किसी चैनल के कॉन्टेंट या दूसरे संकेतों, जैसे कि चैनल की लोकप्रियता के आधार पर असाइन करता है. यह सूची वीडियो कैटगरी की तरह होती है. इसमें बस इतना अंतर होता है कि वीडियो अपलोड करने वाला व्यक्ति, वीडियो कैटगरी असाइन कर सकता है, लेकिन चैनल की कैटगरी सिर्फ़ YouTube तय कर सकता है.

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

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

I18nभाषाएं

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

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

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

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

I18nregion

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

सदस्यता के लेवल

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

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

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

प्लेलिस्ट आइटम

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 प्लेलिस्ट के बारे में बताता है. प्लेलिस्ट उन वीडियो का एक संग्रह है जिन्हें एक के बाद एक देखा जा सकता है और दूसरे उपयोगकर्ताओं के साथ शेयर किया जा सकता है. किसी प्लेलिस्ट में 200 वीडियो तक हो सकते हैं. साथ ही, 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 पर कस्टम वीडियो का थंबनेल अपलोड करता है और उसे वीडियो के लिए सेट करता है.

वीडियो के गलत इस्तेमाल की शिकायत करने की वजहें

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

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

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

वीडियो की कैटगरी

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 चैनल की वॉटरमार्क इमेज मिटाता है.