इस पेज का अनुवाद Cloud Translation API से किया गया है.

Fitbit 3.0 के लिए YouTube डेटा एपीआई : पहला चरण

यह लेख किसी बाहरी डेवलपर ने लिखा और सबमिट किया है. YouTube API और टूल टीम अपने समय और विशेषज्ञता के लिए मार्टिन लेग्रिस को धन्यवाद देती हैं.

मार्टिन लेग्रिस
मार्च 2008

शुरुआती जानकारी
ज़रूरी संसाधन
खुद खोना
सोर्स कोड को पूरा करना
निष्कर्ष

सुविधा के बारे में जानकारी

इस ट्यूटोरियल में मैं आपको दिखा रहा हूं कि असल AS3 कोड की 10 से कम लाइनों में, आप पिछले day, week, month या all_time के लिए YouTube पर सबसे लोकप्रिय वीडियो कैसे पा सकते हैं. आपके पास इनमें से कोई भी स्टैंडर्ड फ़ीड पाने का विकल्प है:

सबसे ज़्यादा देखे गए वीडियाे
सर्वाधिक नया
सर्वाधिक चर्चित
सर्वाधिक लिंक किए गए
सर्वाधिक प्रतिक्रिया प्राप्त
हाल के चुनिंदा
सबसे अच्छी रेटिंग वाले
प्रमुख पसंदीदा
मोबाइल फ़ोन के लिए वीडियो

इस उदाहरण में इस्तेमाल की गई लाइब्रेरी हर टाइप पर हार्ड टाइप की गई है. इसका मतलब है कि आपको डेटा मिलने के बाद, FlashID, Flex IDE, Eclipse w/FDT, IntelliJ Idea वगैरह जैसे आईडीई में, अपने-आप पूरा होने वाली सुविधा का इस्तेमाल किया जा सकता है.

अहम जानकारी

शुरू करने से पहले, आपके लिए उपलब्ध संसाधनों की सूची यहां दी गई है - YouTube API के डेटा का इस्तेमाल करने में दिलचस्पी रखने वाले AS3 डेवलपर की.

खुदाई करने की सुविधा

अपना पहला अनुरोध करना

इसके बाद दिख रहा कोड अच्छी तरह से टिप्पणी करता है. हालांकि, इसके बारे में गहराई से जानने से पहले, मुझे इसके बारे में ज़्यादा जानकारी देनी होगी. सभी अनुरोधों के लिए शुरुआत, YouTubeClient नाम की क्लास होती है. यह क्लास सिंगलटन है. इसका ऐक्सेस आपको दिया जाता है:

// first you import it
import ca.newcommerce.youtube.webservice.YouTubeClient;

// then you get a reference to it
var client:YouTubeClient = YouTubeClient.getInstance();

अब अनुरोध किया जा सकता है:

client.getStandardFeed(YouTubeClient.STD_TOP_RATED, 
                                 YouTubeClient.TIME_MONTH,
                                 1, 
                                 10);

मैंने हाल ही में, सबसे ज़्यादा रेटिंग वाले वीडियो का अनुरोध किया है. इसमें पिछले एक से दस तक के वीडियो शामिल हैं. ध्यान दें कि हर कॉल पर ज़्यादा से ज़्यादा 50 वीडियो ही दिखाए जा सकते हैं. आसान!

नतीजों को मैनेज करना

अब, मैं इन परिणामों तक कैसे पहुंचूं? REST टाइप का वेबपेज पैरामेट्रिक मॉडल एसिंक्रोनस है. इसलिए, फ़ेच करने के दौरान कोड को रोकने के बजाय इवेंट को हैंडल करना आसान होता है. ऐसी स्थिति में, हमें StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED इवेंट के लिए इवेंट लिसनर के बारे में बताना होगा. हर बार किसी स्टैंडर्ड फ़ीड के लिए YouTubeClient को जवाब मिलने पर, हमारे फ़ंक्शन को कॉल किया जाएगा.

client.addEventListener(StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED, 
                        doVideosReceived);

कॉल किया जाने वाला फ़ंक्शन doVideosReceived होगा. इसमें एक पैरामीटर, StandardVideoFeedEvent टाइप का वैरिएबल होगा. यह AS3 के मानक का पालन करता है. हमें इसका एलान करने का मौका दें. साथ ही, हमें दिखाए गए वीडियो से जुड़ी कुछ समस्याओं के बारे में बताएं. हम स्टैंडर्ड आउटपुट पर नज़र रखेंगे:

वीडियो का शीर्षक
वीडियो एम्बेड करने के लिए SWF का URL,
देखे जाने की संख्या,
टिप्पणियों की संख्या,
वीडियो की अवधि,
और लेखक का नाम.

function doVideosReceived(evt:StandardVideoFeedEvent):void
{
	// get a reference to the feed containing the videos
	var feed:VideoFeed = evt.feed;
	
	// variable to hold each video retreived on the feed
	var video:VideoData;
	
	// iterate through the availabe results
	while(video = feed.next())
	{
		  // trace a newline followed by the video title
		  trace("\nvideo title:"+video.title);
		  
		  // trace the url to use to embed the flash player with this video playing in it..
		  trace("player url:"+video.swfUrl);
		  
		  // the view count
		  trace("viewCount:"+video.viewCount);
		  
		  // the comment count
		  trace("commentCount:"+video.commentCount);
		  
		  // the duration
		  trace("duration:"+video.duration);
		  
		  // the author
		  trace("author:"+video.authors.first().name);
	}
}

लाइब्रेरी और फ़ीड के बारे में कुछ नोट

करीब सभी इवेंट में एक .feed प्रॉपर्टी होती है. ProfileEvent एक अपवाद है, इसकी जगह .profile प्रॉपर्टी है, क्योंकि इस कॉल में सिर्फ़ एक रिकॉर्ड मिला है.

फ़ीड कई तरह के होते हैं - उन सभी में यह तरीका लागू होता है:

first() -- पहला रिकॉर्ड फिर से पाएं और उसे पॉइंट करें
next() -- अगला उपलब्ध रिकॉर्ड फिर से पाएं
last() -- पिछला रिकॉर्ड फिर से पाएं और इस पर कर्सर ले जाएं
previous() -- फ़ीड पर पिछला रिकॉर्ड फिर से पाएं
getAt() -- किसी खास जगह पर नतीजा पाएं
count() -- इस फ़ीड के लिए उपलब्ध परिणामों की संख्या, totalResults के समान नहीं

नतीजे खत्म होने पर, next() शून्य दिखता है. पिछले फ़ोन पर भी जब आप पहले नतीजे पर पहुंच जाते हैं, तो previous() पर अगला कॉल null दिखेगा.

ध्यान दें कि फ़ीड में कैटगरी डेटा (जैसे, कैटगरी) Iterators के अंदर रैप किए जाते हैं, ताकि आप उपलब्ध कैटगरी पर जाने के लिए उन फ़ंक्शन का इस्तेमाल कर सकें.

सोर्स कोड को पूरा करें

इस उदाहरण के लिए पूरा सोर्स कोड नीचे दिया गया है. एक ज़िप डाउनलोड किया जा सकता है, जिसमें फ़्लैश सीएस3 के अंदर उदाहरण चलाने के लिए ज़रूरी सभी चीज़ें शामिल हों. हालांकि, अगर हम गड़बड़ियां ठीक कर देते हैं या सुविधाओं को अपडेट करते हैं, तो लाइब्रेरी को अपडेट करना सबसे अच्छा होता है. यहां क्लिक करके, लाइब्रेरी डाउनलोड की जा सकती है.

package
{
    // first import dependencies (You can be more specific than this if you want)
    import ca.newcommerce.youtube.data.*;
    import ca.newcommerce.youtube.events.*;
    import ca.newcommerce.youtube.feeds.*;
    import ca.newcommerce.youtube.iterators.*;
    import ca.newcommerce.youtube.webservice.YouTubeClient;

    public class ytTest()
    {
        // some class variables
        protected var _ws:YouTubeClient;
        protected var _requestId:Number;

        public function ytTest()
        {
            // now inside of an init function
            _ws = YouTubeClient.getInstance();

            // register to list to the events you are interested in
            _ws.addEventListener(StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED, doVideosReceived);

            // do your call.. get the Top Rated videos for the last month
            // results 1 to 10; it returns a requestId
            _requestId = _ws.getStandardFeed(YouTubeClient.STD_TOP_RATED,
                                                YouTubeClient.TIME_MONTH, 
                                                1,
                                                10);
        }

        protected function doVideosReceived(evt:StandardVideoFeedEvent):void
        {

            // get a reference to the feed containing the videos
            var feed:VideoFeed = evt.feed;

            // variable to hold each video retrieved on the feed
            var video:VideoData;

            while(video = feed.next())
            {
                // trace a newline followed by the video title
                trace("\nvideo title:"+video.title);

                // trace the swf URL (used for embedding)
                trace("player url:"+video.swfUrl);

                // the view count
                trace("viewCount:"+video.viewCount);

                // the comment count
                trace("commentCount:"+video.commentCount);

                // the duration
                trace("duration:"+video.duration);

                // the author
                trace("author:"+video.authors.first().name);
             }

        }

    }

}

नतीजा

हालांकि, यह लेख बर्फ़ीले पहाड़ की चोटी का सिरा है. हालांकि, इससे आपको यह अंदाज़ा हो जाएगा कि इस लाइब्रेरी का इस्तेमाल करके, YouTube Data API को कितनी आसानी से खोजा जा सकता है. मैंने हर चीज़ को अच्छी तरह टाइप करने में बहुत समय लगाया है. इसलिए, यह जानना आसान है कि हर फ़ीड के हिसाब से कौनसा डेटा उपलब्ध है. यह अभी तक लिखने और अपलोड करने की नई सुविधा नहीं देता है, लेकिन अगर आप लाइब्रेरी में योगदान देना चाहते हैं, तो प्रोजेक्ट पेज पर जाएं.

लेखक की जानकारी

मार्टिन लेग्रिस के पास सॉफ़्टवेयर के 12 साल तक चलने का दावा है. आज के समय में, उनका मुख्य काम यूज़र इंटरफ़ेस पर रिसर्च करना है और उनका पसंदीदा टूल Flash w/ Action है. blog.martinlegris.com और www.newcommerce.ca पर वेबसाइट (पुराना हो सकता है) पर उनका ब्लॉग देखें.

इस काम को क्रिएटिव कॉमंस एट्रिब्यूशन 3.0 अमेरिका के लाइसेंस के तहत लाइसेंस मिला है.