YouTube डेटा एपीआई की मदद से, YouTube वेबसाइट पर आम तौर पर, अपनी वेबसाइट या ऐप्लिकेशन में इस्तेमाल किए जाने वाले फ़ंक्शन शामिल किए जा सकते हैं. नीचे दी गई सूचियां अलग-अलग तरह के संसाधनों की पहचान करती हैं, जिन्हें आप एपीआई का इस्तेमाल करके फिर से पा सकते हैं. एपीआई, इनमें से कई रिसॉर्स को डालने, अपडेट करने या मिटाने के तरीके भी काम करता है.
इस रेफ़रंस गाइड में, इन सभी कामों को करने के लिए एपीआई इस्तेमाल करने का तरीका बताया गया है. गाइड को रिसॉर्स के टाइप के हिसाब से व्यवस्थित किया जाता है. संसाधन, उस तरह के आइटम के बारे में बताता है जिसमें YouTube के कुछ अनुभव शामिल होते हैं. जैसे, वीडियो, प्लेलिस्ट या सदस्यता. हर तरह के संसाधन के लिए, गाइड में एक या एक से ज़्यादा डेटा के बारे में जानकारी दी गई होती है. साथ ही, संसाधनों को JSON ऑब्जेक्ट के तौर पर दिखाया जाता है. इस गाइड में हर तरह के संसाधन के लिए एक या उससे ज़्यादा तरीकों (LIST, POST, DELETE वगैरह) के बारे में बताया गया है. साथ ही, अपने ऐप्लिकेशन में उन तरीकों का इस्तेमाल करने के बारे में भी बताया गया है.
एपीआई को कॉल किया जा रहा है
YouTube के डेटा एपीआई के अनुरोधों पर ये शर्तें लागू होती हैं:
-
हर अनुरोध को एपीआई कुंजी (
keyपैरामीटर के साथ) के बारे में बताना होगा या OAuth 2.0 टोकन देना होगा. आपकी एपीआई कुंजी, आपके प्रोजेक्ट के लिए डेवलपर कंसोल के एपीआई ऐक्सेस पैनल में उपलब्ध है. -
आपको हर अनुरोध को डालने, अपडेट करने, और मिटाने के लिए अनुमति वाला टोकन भेजना होगा. आपको ऐसे किसी भी अनुरोध के लिए ऑथराइज़ेशन टोकन भी भेजना होगा जिससे पुष्टि किए गए उपयोगकर्ता के निजी डेटा को हासिल किया जाता है.
इसके अलावा, संसाधनों को पाने के लिए कुछ एपीआई तरीकों में ऐसे पैरामीटर काम कर सकते हैं जिनके लिए अनुमति की ज़रूरत होती है या अनुरोधों की अनुमति होने पर उनमें और मेटाडेटा हो सकता है. उदाहरण के लिए, उपयोगकर्ता के अपलोड किए गए वीडियो वापस पाने के अनुरोध में निजी वीडियो भी हो सकते हैं, अगर अनुरोध उस खास उपयोगकर्ता ने अनुमति दी हो.
-
एपीआई पर, OAuth 2.0 के लिए पुष्टि करने वाला प्रोटोकॉल काम करता है. इनमें से किसी एक तरीके से OAuth 2.0 टोकन दिया जा सकता है:
- इस तरह के
access_tokenक्वेरी पैरामीटर का इस्तेमाल करें:?access_token=oauth2-token - एचटीटीपी
Authorizationहेडर का इस्तेमाल इस तरह करें:Authorization: Beareroauth2-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 पर चैनल के बैनर की इमेज अपलोड करता है. यह तरीका, चैनल के लिए बैनर इमेज को अपडेट करने के तीन चरणों में तीन चरणों को दिखाता है:
|
चैनल-सेक्शन
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 की वेबसाइट काम करती है. |
I18nक्षेत्र
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, किसी चैनल के खास वीडियो के संग्रह की पहचान करने के लिए प्लेलिस्ट का भी इस्तेमाल करता है. जैसे:
- अपलोड किए गए वीडियो
- अच्छी रेटिंग वाले (पसंद किए गए) वीडियो
- देखने का इतिहास
- बाद में देखूँगा
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थंबनेल इमेज आम तौर पर 120px x 90px होती है औरchannelसंसाधन कीdefaultथंबनेल इमेज आम तौर पर 88px x 88px होती है. - 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 |
चैनल की वॉटरमार्क इमेज मिटा देता है. |