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