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

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

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

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

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

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

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

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

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

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

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

      वह JSON फ़ाइल डाउनलोड करें जिसमें आपके OAuth 2.0 क्रेडेंशियल हैं. फ़ाइल का नाम client_secret_CLIENTID.json जैसा होता है, जिसमें CLIENTID आपके प्रोजेक्ट का क्लाइंट आईडी होता है.

दूसरा चरण: प्रोजेक्ट तैयार करना

अपना Gradle प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं:

  1. अपनी चालू डायरेक्ट्री में, नया प्रोजेक्ट स्ट्रक्चर बनाने के लिए ये निर्देश चलाएं:

    $ gradle init --type basic
    $ mkdir -p src/main/java src/main/resources
    
  2. OAuth 2.0 क्लाइंट आईडी बनाने के बाद, डाउनलोड की गई JSON फ़ाइल को अपनी वर्किंग डायरेक्ट्री के नीचे src/main/resources डायरेक्ट्री में ले जाएं और फ़ाइल का नाम बदलकर client_secret.json करें.

  3. अपनी वर्किंग डायरेक्ट्री में build.gradle फ़ाइल खोलें और उसके कॉन्टेंट को इन चीज़ों से बदलें:

    apply plugin: 'java'
    apply plugin: 'application'
    
    mainClassName = 'ApiExample'
    sourceCompatibility = 1.7
    targetCompatibility = 1.7
    version = '1.0'
    
    repositories {
        mavenCentral()
    }
    
    dependencies {
        compile 'com.google.api-client:google-api-client:1.23.0'
        compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
        compile 'com.google.apis:google-api-services-youtube:v3-revREVISION-CL_VERSION'
    }
    
  4. build.gradle फ़ाइल में, आपको YouTube डेटा एपीआई के लिए, क्लाइंट लाइब्रेरी के दस्तावेज़ से REVISION और CL_VERSION वैरिएबल को दो वैल्यू से बदलना होगा. नीचे दिया गया स्क्रीनशॉट, YouTube Analytics API के दस्तावेज़ दिखाता है. यह दिखाता है कि पेज पर दो वैरिएबल कहां दिखाई देते हैं.

    JavaDoc संदर्भ का स्क्रीनशॉट, जिसमें 'REVISION' और 'CL_VERSION' वैरिएबल की वैल्यू खोजने का तरीका बताया गया है

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

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

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

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

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

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

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

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

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

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

  5. कोड का नमूना कॉपी करें और उसे src/main/java/ApiExample.java नाम वाली फ़ाइल में सेव करें. हर नमूने में एक ही क्लास का नाम (ApiExample) होता है, ताकि आपको अलग-अलग नमूने चलाने के लिए build.gradle फ़ाइल में बदलाव करने की ज़रूरत न पड़े.

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

  7. कमांड लाइन से सैंपल चलाएं. अपनी चालू डायरेक्ट्री में, यह काम करें:

    gradle -q run

  8. सैंपल में अनुरोध करना चाहिए. साथ ही, जवाब को STDOUT में प्रिंट करना है.

चौथा चरण: अनुमति वाला अनुरोध चलाना

इस चरण में, आपको अपने कोड का नमूना बदलना होगा. इससे, 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. पिछले उदाहरण की तरह, Java टैब चुनें, कोड का नमूना कॉपी करें और उसे src/main/java/ApiExample.java में सेव करें.

  5. कमांड लाइन से सैंपल चलाएं. अपनी चालू डायरेक्ट्री में, यह काम करें:

    gradle -q run

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

    अगर आपने पहले से ही अपने Google खाते में लॉग इन नहीं किया है, तो आपको लॉग इन करने के लिए कहा जाएगा. अगर आपने एक से ज़्यादा Google खातों में लॉग इन किया हुआ है, तो ऑथराइज़ेशन के लिए इस्तेमाल होने वाले खाते को चुनने के लिए कहा जाएगा.

  7. अपने ऐप्लिकेशन के कोड नमूने में दिए गए दायरों का ऐक्सेस देने के लिए, बटन पर क्लिक करें.

  8. नमूना अपने-आप आगे बढ़ जाएगा. साथ ही, आप पुष्टि करने के फ़्लो के लिए इस्तेमाल किए गए ब्राउज़र टैब को बंद कर सकते हैं.

    एपीआई रिस्पॉन्स को फिर से STDOUT पर प्रिंट किया जाना चाहिए.

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