वीडियो से जुड़े फ़ंक्शन करने के लिए, YouTube Data API (v3) का इस्तेमाल करने का तरीका यहां बताया गया है.
चैनल के अपलोड किए गए वीडियो वापस पाना
इस उदाहरण में, किसी खास चैनल पर अपलोड किए गए वीडियो वापस मिलते हैं. इस उदाहरण में दो चरण दिए गए हैं:
-
पहला चरण: चैनल के अपलोड किए गए वीडियो की प्लेलिस्ट आईडी फिर से पाना
चैनल के अपलोड किए गए वीडियो की प्लेलिस्ट का आईडी वापस पाने के लिए,
channels.list
तरीके को कॉल करें. अनुरोध केpart
पैरामीटर की वैल्यू में,contentDetails
को शामिल किया जाना चाहिए. यहchannel
वाले रिसॉर्स पार्ट में से किसी एक के तौर पर मिलता है. एपीआई से मिले रिस्पॉन्स में,contentDetails.relatedPlaylists.uploads
प्रॉपर्टी में प्लेलिस्ट आईडी शामिल है.चैनल की पहचान करने के कई तरीके हैं:
-
हाल ही में पुष्टि किए गए उपयोगकर्ता के YouTube चैनल की जानकारी पाने के लिए,
mine
पैरामीटर की वैल्यूtrue
पर सेट करें. आपके अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति देनी होगी.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=contentDetails &mine=true
-
किसी उपयोगकर्ता नाम से जुड़े चैनल की जानकारी पाने के लिए,
forUsername
पैरामीटर को YouTube उपयोगकर्ता नाम पर सेट करें. इस उदाहरण में,forUsername
पैरामीटर की वैल्यूGoogle
को सेट करके, Google के आधिकारिक YouTube चैनल की जानकारी ली गई है.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=contentDetails &forUsername=Google
-
id
पैरामीटर को उस YouTube चैनल आईडी पर सेट करें जो उस चैनल की खास तौर पर पहचान करता है जिसके लिए आप जानकारी हासिल कर रहे हैं. इस उदाहरण में,id
पैरामीटर कोUCK8sQmJBp8GCxrOtXWBpyEA
पर सेट किया गया है. यह Google के आधिकारिक YouTube चैनल की भी पहचान करता है.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=contentDetails &id=UCK8sQmJBp8GCxrOtXWBpyEA
-
-
दूसरा चरण: अपलोड किए गए वीडियो की सूची वापस पाना
अपलोड किए गए वीडियो की सूची पाने के लिए,
playlistItems.list
तरीके को कॉल करें. पहले चरण में मिली वैल्यू पर,playlistId
पैरामीटर की वैल्यू सेट करें. इस उदाहरण में, पैरामीटर वैल्यूUUK8sQmJBp8GCxrOtXWBpyEA
पर सेट है, जो Google के आधिकारिक YouTube चैनल पर अपलोड किए गए वीडियो की सूची है.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.list? part=snippet,contentDetails,status &playlistId=UUK8sQmJBp8GCxrOtXWBpyEA
सबसे लोकप्रिय वीडियो फिर से पाएं
इस उदाहरण में YouTube के सबसे लोकप्रिय वीडियो की सूची वापस पाने का तरीका बताया गया है. इन्हें चुनने के लिए, एक एल्गोरिदम का इस्तेमाल किया जाता है. इस एल्गोरिदम में अलग-अलग तरह के सिग्नल को मिलाकर, लोकप्रियता तय की जाती है.
सबसे लोकप्रिय वीडियो की सूची वापस पाने के लिए, videos.list
तरीके पर कॉल करें और chart
पैरामीटर की वैल्यू mostPopular
पर सेट करें. इस सूची को वापस लाते समय, आप इनमें से किसी एक या दोनों पैरामीटर को सेट कर सकते हैं:
regionCode
यह एपीआई किसी खास इलाके के लिए, वीडियो की सूची लौटाने का निर्देश देता है.videoCategoryId
, उस वीडियो की कैटगरी के बारे में बताता है जिसके लिए सबसे लोकप्रिय वीडियो वापस लाए जाने हैं.
नीचे दिया गया अनुरोध स्पेन के सबसे लोकप्रिय खेल वीडियो को दिखाता है:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &chart=mostPopular ®ionCode=es &videoCategoryId=17
वीडियो अपलोड करना
एपीआई एक्सप्लोरर, फ़ाइलें अपलोड करने की सुविधा नहीं देता है. इसलिए, इस जानकारी को एक्ज़ीक्यूटेबल उदाहरण से नहीं जोड़ा जा सकता. v3 एपीआई का इस्तेमाल करके वीडियो अपलोड करने के लिए, यहां दिए गए रिसॉर्स की मदद से अपने ऐप्लिकेशन में बदलाव करें:
-
एपीआई के videos.insert तरीके के दस्तावेज़ में कोड के कई नमूने शामिल हैं. इनमें वीडियो की प्रोग्रामिंग के लिए अलग-अलग भाषाओं में वीडियो अपलोड करने का तरीका बताया गया है.
-
फिर से शुरू किए जा सकने वाले अपलोड गाइड में, एचटीटीपी अनुरोधों के क्रम के बारे में बताया जाता है. इन अनुरोधों का इस्तेमाल करके ऐप्लिकेशन, फिर से अपलोड करने की प्रोसेस का इस्तेमाल करके वीडियो अपलोड करता है. यह गाइड मुख्य तौर पर उन डेवलपर के लिए है जो Google API क्लाइंट लाइब्रेरी का इस्तेमाल नहीं कर सकते. इनमें से कुछ गाइड में, ऐसे वीडियो के लिए नेटिव सहायता मिलती है जिन्हें फिर से शुरू किया जा सकता है.
-
वीडियो अपलोड करने के लिए JavaScript का उदाहरण, सीओआरएस (क्रॉस-ऑरिजिन रिसॉर्स शेयरिंग) का इस्तेमाल करके दिखाता है कि वेब पेज से वीडियो फ़ाइल कैसे अपलोड की जाती है. सीओआरएस अपलोड लाइब्रेरी, जिसमें v3 एपीआई सामान्य तौर पर दोबारा अपलोड करने की सुविधा देता है. इसके अलावा, इस उदाहरण में
video
संसाधन केprocessingDetails
हिस्से को फिर से पाने के साथ-साथ, अपलोड किए गए वीडियो के लिए स्थिति में बदलावों को हैंडल करने के तरीके के बारे में भी बताया गया है.
अपलोड किए गए वीडियो की स्थिति देखना
इस उदाहरण में, अपलोड किए गए वीडियो की स्थिति देखने का तरीका बताया गया है. अपलोड किया गया वीडियो, पुष्टि किए गए उपयोगकर्ता के अपलोड किए गए वीडियो फ़ीड में तुरंत दिखेगा. हालांकि, वीडियो YouTube पर तब तक नहीं दिखेगा, जब तक उसे प्रोसेस नहीं किया जाता.
-
पहला चरण: वीडियो अपलोड करना
वीडियो अपलोड करने के लिए,
videos.insert
तरीके को कॉल करें. अगर अनुरोध पूरा हो जाता है, तो एपीआई की जांच के नतीजे मेंvideo
रिसॉर्स शामिल होगा. यह रिसॉर्स, अपलोड किए गए वीडियो के यूनीक वीडियो आईडी की पहचान करता है. -
दूसरा चरण: वीडियो की स्थिति देखना
वीडियो की स्थिति देखने के लिए,
videos.list
तरीके को कॉल करें. पहले चरण में मिले वीडियो आईडी के लिए,id
पैरामीटर की वैल्यू सेट करें.part
पैरामीटर की वैल्यूprocessingDetails
पर सेट करें.अगर अनुरोध को सही तरीके से हैंडल किया जाता है, तो एपीआई से मिले रिस्पॉन्स में
video
रिसॉर्स शामिल होगा.processingDetails.processingStatus
प्रॉपर्टी की वैल्यू की जांच करके पता लगाएं कि YouTube अब भी वीडियो को प्रोसेस कर रहा है या नहीं. प्रॉपर्टी के लिए,processing
के बजाय कोई और वैल्यू इस्तेमाल की जा सकती है. जैसे,succeeded
याfailed
.अनुरोध का मुख्य हिस्सा एक
video
रिसॉर्स है. जिसेid
प्रॉपर्टी, उस वीडियो के वीडियो आईडी के बारे में बताती है जिसे मिटाया जा रहा है. इस उदाहरण में, संसाधन में एकrecordingDetails
ऑब्जेक्ट भी है.नीचे दिया गया अनुरोध, वीडियो की स्थिति की जांच करता है. एपीआई एक्सप्लोरर में अनुरोध पूरा करने के लिए, आपको
id
प्रॉपर्टी की वैल्यू सेट करनी होगी.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet,processingDetails &id=VIDEO_ID
ध्यान दें: हाल ही में अपलोड किए गए किसी वीडियो की स्थिति देखने के लिए, आपका ऐप्लिकेशन इस एपीआई का इस्तेमाल कर सकता है. वीडियो प्रोसेस हो जाने के बाद, आपका ऐप्लिकेशन बुलेटिन बना सकता है या वीडियो की स्थिति के आधार पर दूसरी कार्रवाई कर सकता है.
वीडियो अपडेट करना
इस उदाहरण में वीडियो को अपडेट करने का तरीका बताया गया है, ताकि वीडियो को रिकॉर्ड करने के समय और जगह की जानकारी जोड़ी जा सके. उदाहरण में नीचे दिए गए चरण शामिल हैं:
-
पहला चरण: वीडियो आईडी वापस पाना
पुष्टि किए गए मौजूदा उपयोगकर्ता के चैनल के लिए, अपलोड किए गए वीडियो वापस पाने के लिए, ऊपर दिया गया तरीका अपनाएं. इस सूची का इस्तेमाल, वीडियो की सूची दिखाने के लिए किया जा सकता है. इसके लिए, हर वीडियो के आईडी को कुंजी के तौर पर इस्तेमाल किया जाता है.
ध्यान दें: वीडियो आईडी पाने के कई और तरीके हैं, जैसे कि खोज नतीजों को फिर से पाना या किसी प्लेलिस्ट में आइटम की सूची बनाना. हालांकि, वीडियो को सिर्फ़ उसका मालिक अपडेट कर सकता है, लेकिन एपीआई अनुरोध को अनुमति देने वाले उपयोगकर्ता के मालिकाना हक वाले वीडियो की सूची हासिल करना, इस प्रोसेस का पहला कदम हो सकता है.
-
दूसरा चरण: वीडियो अपडेट करना
किसी खास वीडियो को अपडेट करने के लिए,
videos.update
तरीके को कॉल करें.part
पैरामीटर की वैल्यूrecordingDetails
पर सेट करें. (पैरामीटर वैल्यू इस बात पर निर्भर करती है कि वीडियो के मेटाडेटा फ़ील्ड अपडेट किए जा रहे हैं या नहीं.)अनुरोध का मुख्य हिस्सा एक
video
रिसॉर्स है.id
प्रॉपर्टी में उस वीडियो के वीडियो आईडी की जानकारी होती है जिसे अपडेट किया जा रहा है. इस उदाहरण में, संसाधन में एकrecordingDetails
ऑब्जेक्ट भी है.नीचे दिए गए सैंपल संसाधन से पता चलता है कि वीडियो को 30 अक्टूबर, 2013 को बॉस्टन में रिकॉर्ड किया गया था:
{ "id": "VIDEO_ID", "recordingDetails": { "location": { "latitude": "42.3464", "longitude": "-71.0975" } "recordingDate": "2013-10-30T23:15:00.000Z" } }
एपीआई एक्सप्लोरर में अनुरोध पूरा करने के लिए, आपको
id
प्रॉपर्टी की वैल्यू सेट करनी होगी.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update? part=snippet
कस्टम थंबनेल इमेज अपलोड करें और उसे किसी वीडियो के लिए सेट करें
v3 एपीआई का thumbnails.set
इस्तेमाल करके, कस्टम थंबनेल इमेज अपलोड की जा सकती है. साथ ही, इसे किसी वीडियो के लिए सेट किया जा सकता है. आपके अनुरोध में, videoId
पैरामीटर की वैल्यू उस वीडियो की पहचान करती है जिसके लिए थंबनेल का इस्तेमाल किया जाएगा.
इस क्वेरी की जांच एपीआई एक्सप्लोरर का इस्तेमाल करके नहीं की जा सकती, क्योंकि एपीआई एक्सप्लोरर मीडिया फ़ाइलों को अपलोड करने की सुविधा नहीं देता है, जो इस तरीके के लिए ज़रूरी है.
वीडियो मिटाना
इस उदाहरण में, वीडियो को मिटाने का तरीका बताया गया है. उदाहरण में नीचे दिए गए चरण शामिल हैं:
-
पहला चरण: वीडियो आईडी वापस पाना
पुष्टि किए गए मौजूदा उपयोगकर्ता के चैनल के लिए, अपलोड किए गए वीडियो वापस पाने के लिए, ऊपर दिया गया तरीका अपनाएं. इस सूची का इस्तेमाल, वीडियो की सूची दिखाने के लिए किया जा सकता है. इसके लिए, हर वीडियो के आईडी को कुंजी के तौर पर इस्तेमाल किया जाता है.
ध्यान दें: वीडियो आईडी पाने के कई और तरीके हैं, जैसे कि खोज नतीजों को फिर से पाना या किसी प्लेलिस्ट में आइटम की सूची बनाना. हालांकि, वीडियो को सिर्फ़ उसका मालिक ही मिटा सकता है, लेकिन वीडियो हटाने के लिए अनुरोध करने वाले व्यक्ति के मालिकाना हक वाले वीडियो की सूची हासिल करना, इस प्रोसेस का पहला कदम हो सकता है.
-
दूसरा चरण: वीडियो मिटाना
किसी खास वीडियो को मिटाने के लिए,
videos.delete
तरीके को कॉल करें. अनुरोध में,id
पैरामीटर उस वीडियो का वीडियो आईडी बताता है जिसे आप मिटा रहे हैं. इस अनुरोध को अनुमति देने के लिए, OAuth 2.0 का इस्तेमाल किया जाना चाहिए. अगर आप इस क्वेरी की जांच एपीआई एक्सप्लोरर में कर रहे हैं, तो आपकोid
पैरामीटर वैल्यू के लिए कोई मान्य वीडियो आईडी डालना होगा.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.delete? id=VIDEO_ID
गलत इस्तेमाल वाले वीडियो की शिकायत करना
इस उदाहरण में, बुरे बर्ताव वाले वीडियो की शिकायत करने का तरीका बताया गया है. उदाहरण में नीचे दिए गए चरण शामिल हैं:
-
पहला चरण: वीडियो की शिकायत करने की वजह बताना.
वीडियो को फ़्लैग करने की मान्य वजहों की सूची पाने के लिए,
videoAbuseReportReasons.list
तरीके का अनुरोध किया गया हो. नीचे दिए गए सैंपलvideoAbuseReportReason
संसाधन में, ऐसे वीडियो को फ़्लैग करने से जुड़ी जानकारी दी गई है जिसमें स्पैम या गुमराह करने वाला कॉन्टेंट है.{ "kind": "youtube#videoAbuseReportReason", "etag": "\"tbWC5XrSXxe1WOAx6MK9z4hHSU8/Or2VqBIilpHU7j__oPzUFCvGVBw\"", "id": "S", "snippet": { "label": "Spam or misleading", "secondaryReasons": [ { "id": "27", "label": "Spam or mass advertising" }, { "id": "28", "label": "Misleading thumbnail" }, { "id": "29", "label": "Malware or phishing" }, { "id": "30", "label": "Pharmaceutical drugs for sale" }, { "id": "31", "label": "Other misleading info" } ] } }
जैसा कि संसाधन में दिखाया गया है, यह वजह, दूसरी वजहों की सूची से जुड़ी है. स्पैम वाले किसी वीडियो को फ़्लैग करते समय, आपको वजह के साथ आईडी देना होगा. साथ ही, हम आपको इसकी दूसरी वजह भी बताना चाहते हैं.
-
दूसरा चरण: यौन शोषण वाले कॉन्टेंट के लिए वीडियो को फ़्लैग करना
वीडियो की शिकायत करने के लिए,
JSON ऑब्जेक्ट कीvideos.reportAbuse
तरीके का इस्तेमाल करके अनुमति वाला अनुरोध भेजें. अनुरोध का मुख्य हिस्सा एक JSON ऑब्जेक्ट है. यह वीडियो फ़्लैग किए जाने और उसकी वजह, दोनों की पहचान करता है. जैसा कि पहले चरण में बताया गया है, कुछ वजहों से दूसरी वजहों को भी शामिल किया जा सकता है और उन्हें बढ़ावा दिया जाएगा.videoId
प्रॉपर्टी, फ़्लैग किए गए वीडियो की पहचान करती है.नीचे दिए गए JSON ऑब्जेक्ट, स्पैम या गुमराह करने वाले कॉन्टेंट के बारे में बताने वाले वीडियो को फ़्लैग करते हैं. इसमें खास तौर पर, गुमराह करने वाले थंबनेल की इमेज का इस्तेमाल करने के बारे में बताया गया है. जैसा कि ऊपर JSON ऑब्जेक्ट में दिखाया गया है, स्पैम या गुमराह करने वाले कॉन्टेंट का आईडी S है. गुमराह करने वाले थंबनेल का आईडी 28 है.
{ "videoId": "VIDEO_ID", "reasonId": "S", "secondaryReasonId": "28", "comments": "Testing the video flagging feature.", "language": "en" }
videos.reportAbuse
अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति देनी होगी. नीचे दिया गया लिंक, एपीआई एक्सप्लोरर में ऊपर दिए गए JSON ऑब्जेक्ट को लोड करता है. क्वेरी की जांच करने के लिए, आपकोvideoId
प्रॉपर्टी की वैल्यू का एक मान्य वीडियो आईडी डालना होगा. कृपया याद रखें कि इस अनुरोध को सबमिट करने से वीडियो फ़्लैग कर दिया जाएगा.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.reportAbuse