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