JavaScript क्विकस्टार्ट

इस क्विकस्टार्ट गाइड में एक आसान पेज सेट अप करने का तरीका बताया गया है. यह पेज, YouTube Data API के लिए अनुरोध करता है. यह क्विकस्टार्ट दो एपीआई अनुरोध करने का तरीका बताता है:

  1. Google डेवलपर YouTube चैनल के बारे में जानकारी पाने के लिए आपको एपीआई कुंजी का इस्तेमाल करना होगा. यह कुंजी आपके ऐप्लिकेशन की पहचान करती है.
  2. आपको OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करके, आपका अनुरोध सबमिट करना होगा. यह अनुरोध आपके YouTube चैनल के बारे में जानकारी इकट्ठा करेगा.

ज़रूरी शर्तें

इस क्विकस्टार्ट को चलाने के लिए, आपको इनकी ज़रूरत होगी:

  • Python 2.4 या इसके बाद का वर्शन (वेब सर्वर देने के लिए)
  • इंटरनेट और वेब ब्राउज़र का ऐक्सेस.
  • एक Google खाता.

पहला चरण: अपना प्रोजेक्ट और क्रेडेंशियल सेट अप करना

एपीआई कंसोल में कोई प्रोजेक्ट बनाएं या चुनें. अपने प्रोजेक्ट के लिए, API (एपीआई) कंसोल में ये टास्क पूरे करें:

  1. लाइब्रेरी पैनल में, YouTube Data API v3 खोजें. उस एपीआई की लिस्टिंग पर क्लिक करें और पक्का करें कि आपके प्रोजेक्ट के लिए एपीआई चालू है.

  2. क्रेडेंशियल पैनल में, दो क्रेडेंशियल बनाएं:

    1. एपीआई कुंजी बनाएं आप एपीआई कुंजी का इस्तेमाल ऐसे एपीआई अनुरोध करने के लिए करेंगे जिनके लिए उपयोगकर्ता की अनुमति की ज़रूरत नहीं होती है. उदाहरण के लिए, आपको सार्वजनिक YouTube चैनल के बारे में जानकारी पाने के लिए उपयोगकर्ता की अनुमति की ज़रूरत नहीं है.

    2. OAuth 2.0 क्लाइंट आईडी बनाना ऐप्लिकेशन टाइप को वेब ऐप्लिकेशन पर सेट करें. आपको उन अनुरोधों के लिए OAuth 2.0 क्रेडेंशियल का इस्तेमाल करना होगा जिनके लिए उपयोगकर्ता की अनुमति की ज़रूरत होती है. उदाहरण के लिए, आपको उपयोगकर्ता के मौजूदा YouTube चैनल की जानकारी फिर से पाने के लिए, उपयोगकर्ता की अनुमति लेनी होगी.

      अनुमति वाले JavaScript ऑरिजिन फ़ील्ड में, यूआरएल डालें http://localhost:8000. अनुमति वाले रीडायरेक्ट यूआरआई फ़ील्ड को खाली छोड़ा जा सकता है.

दूसरा चरण: सैंपल सेट अप करना और उसे चलाना

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

  1. एपीआई के channels.list तरीके के लिए दस्तावेज़ खोलें.

  2. उस पेज पर, "इस्तेमाल के सामान्य उदाहरण" सेक्शन में एक टेबल होती है, जिसमें इस तरीके के कई सामान्य तरीके बताए गए हैं. टेबल में पहली लिस्टिंग नतीजों को चैनल आईडी से दिखाया जाता है.

    फ़ुल स्क्रीन एपीआई एक्सप्लोरर को खोलने और पॉप्युलेट करने के लिए, पहली लिस्टिंग पर दिखने वाले कोड के निशान पर क्लिक करें.

    ऐसी इमेज जिसमें टेबल में कोड सिंबल वाले लिंक की जगह की पहचान की गई है. इस लिंक में, channel.list दस्तावेज़ के इस्तेमाल के उदाहरण शामिल हैं. उस इमेज के लिए वैकल्पिक टेक्स्ट, इमेज को एक कोड सिंबल के तौर पर बताता है और उस लिंक से जुड़े 'इस्तेमाल के उदाहरण' के बारे में बताता है.

  3. फ़ुलस्क्रीन API एक्सप्लोरर की बाईं ओर, यह जानकारी दिखती है:

    1. पैरामीटर का अनुरोध करें हेडर के नीचे, ऐसे पैरामीटर की सूची दी गई है जो इस तरीके पर काम करती है. part और id पैरामीटर वैल्यू सेट की जानी चाहिए. id पैरामीटर की वैल्यू UC_x5XG1OV2P6uZZ5FSM9Ttw, Google Developers YouTube चैनल का आईडी है.

    2. पैरामीटर के नीचे, क्रेडेंशियल नाम का एक सेक्शन होता है. उस सेक्शन के पुलडाउन मेन्यू में, एपीआई बटन की वैल्यू दिखनी चाहिए. API एक्सप्लोरर, डेमो को डिफ़ॉल्ट रूप से इस्तेमाल करता है, ताकि शुरुआत करना आसान हो सके. हालांकि, सैंपल को स्थानीय रूप से चलाने के लिए, आपको अपनी एपीआई कुंजी का इस्तेमाल करना होगा.

      वह इमेज जो फ़ुलस्क्रीन एपीआई एक्सप्लोरर में 'क्रेडेंशियल' दिखाती है और पुलडाउन मेन्यू में 'एपीआई कुंजी' विकल्प चुना हुआ है.

  4. फ़ुलस्क्रीन API एक्सप्लोरर की दाईं ओर, अलग-अलग भाषाओं में कोड के सैंपल वाले टैब दिखते हैं. JavaScript टैब चुनें.

  5. कोड का नमूना कॉपी करें और उसे example.html नाम वाली फ़ाइल में सेव करें.

  6. डाउनलोड किए गए सैंपल में, YOUR_API_KEY स्ट्रिंग ढूंढें और उसे उस एपीआई कुंजी से बदलें जिसे आपने इस क्विकस्टार्ट के पहले चरण में बनाया था.

  7. अपनी काम करने वाली डायरेक्ट्री से नीचे दिए गए निर्देश का इस्तेमाल करके, वेब सर्वर शुरू करें:

    Python 2.x

    python -m SimpleHTTPServer 8000

    Python 3.x

    python -m http.server 8000

  8. अपने ब्राउज़र में example.html फ़ाइल खोलें. साथ ही, ब्राउज़र के डेवलपर टूल, जैसे कि Chrome ब्राउज़र के "डेवलपर टूल" भी खोलें.

    1. JavaScript के लिए, Google API क्लाइंट लाइब्रेरी लोड करने के लिए, पेज पर मौजूद लोड करें बटन पर क्लिक करें. बटन पर क्लिक करने के बाद, डेवलपर कंसोल को एक नोट दिखाएगा, जो बताएगा कि GAPI क्लाइंट लोड हुआ है.

    2. एपीआई अनुरोध भेजने के लिए, लागू करें बटन पर क्लिक करें. इसके बाद, डेवलपर के कंसोल को एपीआई का रिस्पॉन्स दिखाना चाहिए.

तीसरा चरण: अनुमति वाला अनुरोध चलाना

इस चरण में, आपको अपने कोड का नमूना बदलना होगा. इससे, Google Developers YouTube चैनल के बारे में जानकारी पाने के बजाय, आपके YouTube चैनल के बारे में जानकारी मिलेगी. इस अनुरोध के लिए उपयोगकर्ता की अनुमति की ज़रूरत है.

  1. एपीआई के channels.list तरीके के दस्तावेज़ पर वापस जाएं.

  2. "सामान्य इस्तेमाल के उदाहरण" सेक्शन में, टेबल में तीसरी लिस्टिंग के लिए कोड के चिह्न पर क्लिक करें. इसे "मेरे चैनल" के लिए list तरीके का इस्तेमाल करना है.

  3. दोबारा, फ़ुलस्क्रीन API एक्सप्लोरर के बाईं ओर, आपको क्रेडेंशियल सेक्शन के बाद पैरामीटर की एक सूची दिखेगी. हालांकि, हमने उदाहरण के लिए यहां दो बदलाव किए हैं, जिनमें आपको Googleडेवलपर चैनल के बारे में जानकारी मिली थी:

    1. पैरामीटर सेक्शन में, id पैरामीटर की वैल्यू को सेट करने के बजाय, mine पैरामीटर की वैल्यू को true पर सेट किया जाना चाहिए. इससे एपीआई सर्वर को मौजूदा उपयोगकर्ता की चैनल के बारे में जानकारी मिलती है.

    2. क्रेडेंशियल सेक्शन में, पुलडाउन मेन्यू में Google OAuth 2.0 का विकल्प चुनना चाहिए.

      इसके अलावा, अगर दायरे दिखाएं लिंक पर क्लिक किया जाता है, तो https://www.googleapis.com/auth/youtube.readonly दायरे की जांच की जानी चाहिए.

      वह इमेज जो फ़ुलस्क्रीन API एक्सप्लोरर में दायरे दिखाती है और चुने गए 'Google OAuth 2.0' क्रेडेंशियल को इस्तेमाल करने का विकल्प दिखाती है.

  4. पिछले उदाहरण की तरह, JavaScript टैब चुनें, कोड का नमूना कॉपी करें और उसे example.html में सेव करें.

    कोड में, YOUR_CLIENT_ID स्ट्रिंग ढूंढें और उसे उस क्लाइंट आईडी से बदलें जिसे आपने इस क्विकस्टार्ट के पहले चरण में बनाया था.

  5. अपनी काम करने वाली डायरेक्ट्री से नीचे दिए गए निर्देश का इस्तेमाल करके, वेब सर्वर शुरू करें:

    Python 2.x

    python -m SimpleHTTPServer 8000

    Python 3.x

    python -m http.server 8000

  6. अपने ब्राउज़र में http://localhost:8000/example.html फ़ाइल पर जाएं. ब्राउज़र के डेवलपर टूल, जैसे Chrome ब्राउज़र में "डेवलपर टूल" खोलें.

  7. JavaScript के लिए Google API क्लाइंट लाइब्रेरी लोड करने और अनुमति देने की प्रक्रिया शुरू करने के लिए, पेज पर अनुमति दें और लोड करें बटन पर क्लिक करें. ऐप्लिकेशन के लिए, आपको अपने YouTube खाते से डेटा पढ़ने की अनुमति देने के लिए कहा जाना चाहिए.

    अनुमति देने पर, डेवलपर के कंसोल को ऐसे मैसेज दिखाने चाहिए जिनसे पता चलता हो कि साइन इन हो गया है और एपीआई क्लाइंट लोड हो गया है.

  8. एपीआई अनुरोध भेजने के लिए, लागू करें बटन पर क्लिक करें. इसके बाद, डेवलपर के कंसोल को एपीआई का रिस्पॉन्स दिखाना चाहिए.

इसके बारे में और पढ़ें