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