YouTube Data API से, YouTube की वेबसाइट पर आम तौर पर इस्तेमाल किए जाने वाले फ़ंक्शन को अपनी वेबसाइट या ऐप्लिकेशन में शामिल किया जा सकता है. नीचे दी गई सूचियां अलग-अलग तरह के संसाधनों की पहचान करती हैं, जिन्हें एपीआई का इस्तेमाल करके वापस लाया जा सकता है. इस एपीआई में, इनमें से कई संसाधनों को शामिल करने, अपडेट करने या मिटाने के तरीके भी मौजूद हैं.
इस रेफ़रंस गाइड में बताया गया है कि इन सभी कामों के लिए, एपीआई का इस्तेमाल कैसे किया जाता है. गाइड, रिसॉर्स टाइप के हिसाब से व्यवस्थित होती है. संसाधन, एक तरह का आइटम होता है जो YouTube का हिस्सा होता है. जैसे, वीडियो, प्लेलिस्ट या सदस्यता. हर तरह के संसाधन के लिए, गाइड एक या उससे ज़्यादा डेटा को दिखाती है. साथ ही, संसाधन JSON ऑब्जेक्ट के तौर पर दिखाए जाते हैं. इस गाइड में, संसाधन के हर टाइप के लिए इस्तेमाल किए जा सकने वाले एक या उससे ज़्यादा तरीकों (LIST
, POST
, DELETE
वगैरह) की सूची दी गई है. साथ ही, यह भी बताया गया है कि अपने ऐप्लिकेशन में उन तरीकों का इस्तेमाल कैसे किया जाए.
एपीआई को कॉल करना
YouTube Data API के अनुरोधों पर ये शर्तें लागू होती हैं:
-
हर अनुरोध में,
key
पैरामीटर के साथ एपीआई पासकोड तय करना ज़रूरी है या OAuth 2.0 टोकन उपलब्ध कराना होगा. आपकी एपीआई कुंजी, आपके प्रोजेक्ट के लिए Developer Console के एपीआई ऐक्सेस पैनल में उपलब्ध होती है. -
आपको हर बार डेटा डालने, अपडेट करने, और मिटाने के अनुरोध के लिए, ऑथराइज़ेशन टोकन भेजना ज़रूरी है. आपको पुष्टि किए गए उपयोगकर्ता का निजी डेटा पाने वाले किसी भी अनुरोध के लिए, ऑथराइज़ेशन टोकन भी भेजना होगा.
इसके अलावा, संसाधन वापस पाने के लिए एपीआई के कुछ तरीके, ऐसे पैरामीटर के साथ काम कर सकते हैं जिनके लिए अनुमति की ज़रूरत होती है या जिनमें अतिरिक्त मेटाडेटा शामिल हो सकता है. ऐसा तब किया जाता है, जब अनुरोधों को अनुमति दी जाती है. उदाहरण के लिए, किसी उपयोगकर्ता के अपलोड किए गए वीडियो को वापस पाने के अनुरोध में निजी वीडियो भी शामिल हो सकते हैं. ऐसा तब होगा, जब अनुरोध करने वाले उपयोगकर्ता ने इसकी अनुमति दी हो.
-
यह एपीआई, 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 |
कैप्शन ट्रैक को अपडेट करता है. कैप्शन ट्रैक को अपडेट करते समय, ट्रैक का ड्राफ़्ट का स्टेटस बदला जा सकता है, ट्रैक के लिए नई कैप्शन फ़ाइल अपलोड की जा सकती है या ये दोनों काम किए जा सकते हैं. |
ChannelBanners
channelBanner
संसाधन में ऐसा यूआरएल होता है जिसका इस्तेमाल, किसी चैनल के लिए अपलोड की गई नई इमेज को बैनर इमेज के तौर पर सेट करने के लिए किया जा सकता है.
इस संसाधन के बारे में ज़्यादा जानकारी के लिए, इसके संसाधन और प्रॉपर्टी की सूची देखें.
तरीका | एचटीटीपी अनुरोध | ब्यौरा |
---|---|---|
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई |
||
insert |
POST /channelBanners/insert |
YouTube पर चैनल की बैनर इमेज अपलोड करता है. यह तरीका, किसी चैनल की बैनर इमेज को अपडेट करने के तीन चरणों की प्रोसेस के पहले दो चरणों को दिखाता है:
|
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
संसाधन किसी वीडियो या चैनल के बारे में की गई टिप्पणियों को दिखा सकता है.
बेहतरीन टिप्पणी और जवाब, दोनों असल में comment
संसाधन होते हैं, जो commentThread
संसाधन में नेस्ट किए गए हैं. यह ज़रूरी नहीं है कि 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 |
किसी टिप्पणी में बदलाव करता है. |
GuideCategories
guideCategory
संसाधन, किसी चैनल के कॉन्टेंट या दूसरे संकेतों के आधार पर उस कैटगरी की पहचान करता है जिसे YouTube, एल्गोरिदम की मदद से असाइन करता है. जैसे, चैनल की लोकप्रियता. सूची, वीडियो की कैटगरी जैसी होती है. इसमें अंतर यह होता है कि वीडियो अपलोड करने वाला व्यक्ति, वीडियो कैटगरी असाइन कर सकता है, लेकिन YouTube ही चैनल की कैटगरी असाइन कर सकता है.
इस संसाधन के बारे में ज़्यादा जानकारी के लिए, इसके संसाधन और प्रॉपर्टी की सूची देखें.
तरीका | एचटीटीपी अनुरोध | ब्यौरा |
---|---|---|
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई |
||
list |
GET /guideCategories |
उन कैटगरी की सूची दिखाता है जिन्हें YouTube चैनल से जोड़ा जा सकता है. |
I18nLanguages
i18nLanguage
संसाधन, ऐप्लिकेशन के लिए इस्तेमाल की गई ऐसी भाषा की पहचान करता है जो YouTube वेबसाइट पर काम करती है. ऐप्लिकेशन भाषा को यूज़र इंटरफ़ेस (यूआई) भाषा के रूप में भी रेफ़र किया जा सकता है. YouTube वेबसाइट के लिए, Google खाते की सेटिंग, ब्राउज़र की भाषा या आईपी लोकेशन के आधार पर ऐप्लिकेशन की भाषा अपने-आप चुनी जा सकती है. उपयोगकर्ता, YouTube साइट के फ़ुटर से भी, यूज़र इंटरफ़ेस (यूआई) के लिए अपनी पसंद की भाषा चुन सकता है.
हर i18nLanguage
रिसॉर्स, भाषा कोड और नाम की पहचान करता है. videoCategories.list
और guideCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय, भाषा के कोड का इस्तेमाल hl
पैरामीटर की वैल्यू के तौर पर किया जा सकता है.
इस संसाधन के बारे में ज़्यादा जानकारी के लिए, इसके संसाधन और प्रॉपर्टी की सूची देखें.
तरीका | एचटीटीपी अनुरोध | ब्यौरा |
---|---|---|
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 प्लेलिस्ट के बारे में बताता है. प्लेलिस्ट, उन वीडियो का एक कलेक्शन है जिन्हें एक क्रम में देखा जा सकता है और अन्य लोगों के साथ शेयर किया जा सकता है. किसी प्लेलिस्ट में 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
की थंबनेल इमेज का साइज़ आम तौर पर 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 |
इससे चैनल की वॉटरमार्क इमेज मिट जाती है. |