इस क्विकस्टार्ट गाइड में एक आसान Java Java कमांड लाइन सेट अप करने का तरीका बताया गया है जो YouTube Data API के लिए अनुरोध करता है. यह क्विकस्टार्ट दो एपीआई अनुरोध करने का तरीका बताता है:
- Google डेवलपर YouTube चैनल के बारे में जानकारी पाने के लिए आपको एपीआई कुंजी का इस्तेमाल करना होगा. यह कुंजी आपके ऐप्लिकेशन की पहचान करती है.
- आपको OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करके, आपका अनुरोध सबमिट करना होगा. यह अनुरोध आपके YouTube चैनल के बारे में जानकारी इकट्ठा करेगा.
ज़रूरी शर्तें
इस क्विकस्टार्ट को चलाने के लिए, आपको इनकी ज़रूरत होगी:
- Java 1.7 या उसके बाद का वर्शन.
- ग्रेडल 2.3 या इसके बाद का वर्शन.
- इंटरनेट और वेब ब्राउज़र का ऐक्सेस.
- एक Google खाता.
पहला चरण: अपना प्रोजेक्ट और क्रेडेंशियल सेट अप करना
एपीआई कंसोल में कोई प्रोजेक्ट बनाएं या चुनें. अपने प्रोजेक्ट के लिए, API (एपीआई) कंसोल में ये टास्क पूरे करें:
लाइब्रेरी पैनल में, YouTube Data API v3 खोजें. उस एपीआई की लिस्टिंग पर क्लिक करें और पक्का करें कि आपके प्रोजेक्ट के लिए एपीआई चालू है.
क्रेडेंशियल पैनल में, दो क्रेडेंशियल बनाएं:
एपीआई कुंजी बनाएं आप एपीआई कुंजी का इस्तेमाल ऐसे एपीआई अनुरोध करने के लिए करेंगे जिनके लिए उपयोगकर्ता की अनुमति की ज़रूरत नहीं होती है. उदाहरण के लिए, आपको सार्वजनिक YouTube चैनल के बारे में जानकारी पाने के लिए उपयोगकर्ता की अनुमति की ज़रूरत नहीं है.
OAuth 2.0 क्लाइंट आईडी बनाना ऐप्लिकेशन टाइप को अन्य पर सेट करें. उन अनुरोधों के लिए आपको OAuth 2.0 क्रेडेंशियल का इस्तेमाल करना होगा जिनके लिए उपयोगकर्ता की अनुमति की ज़रूरत होती है. उदाहरण के लिए, आपको उपयोगकर्ता के हाल ही में पुष्टि किए गए YouTube चैनल के बारे में जानकारी पाने के लिए, उपयोगकर्ता की अनुमति लेनी होगी.
वह JSON फ़ाइल डाउनलोड करें जिसमें आपके OAuth 2.0 क्रेडेंशियल हैं. फ़ाइल का नाम
client_secret_CLIENTID.json
जैसा होता है, जिसमेंCLIENTID
आपके प्रोजेक्ट का क्लाइंट आईडी होता है.
दूसरा चरण: प्रोजेक्ट तैयार करना
अपना Gradle प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं:
अपनी चालू डायरेक्ट्री में, नया प्रोजेक्ट स्ट्रक्चर बनाने के लिए ये निर्देश चलाएं:
$ gradle init --type basic $ mkdir -p src/main/java src/main/resources
OAuth 2.0 क्लाइंट आईडी बनाने के बाद, डाउनलोड की गई JSON फ़ाइल को अपनी वर्किंग डायरेक्ट्री के नीचे
src/main/resources
डायरेक्ट्री में ले जाएं और फ़ाइल का नाम बदलकरclient_secret.json
करें.अपनी वर्किंग डायरेक्ट्री में
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' }
build.gradle
फ़ाइल में, आपको YouTube डेटा एपीआई के लिए, क्लाइंट लाइब्रेरी के दस्तावेज़ से REVISION और CL_VERSION वैरिएबल को दो वैल्यू से बदलना होगा. नीचे दिया गया स्क्रीनशॉट, YouTube Analytics API के दस्तावेज़ दिखाता है. यह दिखाता है कि पेज पर दो वैरिएबल कहां दिखाई देते हैं.
तीसरा चरण: सैंपल सेट अप करना और उसे चलाना
Google Developers के YouTube चैनल के बारे में जानकारी पाने के लिए, साइड पैनल में मौजूद एपीआई एक्सप्लोरर विजेट का इस्तेमाल करें. यह अनुरोध आपके ऐप्लिकेशन की पहचान करने के लिए एपीआई कुंजी का इस्तेमाल करता है. इसके लिए, उपयोगकर्ता की अनुमति की ज़रूरत नहीं होती है. इसके अलावा, सैंपल चलाने वाले उपयोगकर्ता से खास अनुमति की भी ज़रूरत नहीं होती है.
- एपीआई के channels.list तरीके के लिए दस्तावेज़ खोलें.
उस पेज पर, "इस्तेमाल के सामान्य उदाहरण" सेक्शन में एक टेबल होती है, जिसमें इस तरीके के कई सामान्य तरीके बताए गए हैं. टेबल में पहली लिस्टिंग नतीजों को चैनल आईडी से दिखाया जाता है.
फ़ुल स्क्रीन एपीआई एक्सप्लोरर को खोलने और पॉप्युलेट करने के लिए, पहली लिस्टिंग पर दिखने वाले कोड के निशान पर क्लिक करें.
फ़ुलस्क्रीन API एक्सप्लोरर की बाईं ओर, यह जानकारी दिखती है:
पैरामीटर का अनुरोध करें हेडर के नीचे, ऐसे पैरामीटर की सूची दी गई है जो इस तरीके पर काम करती है.
part
औरid
पैरामीटर वैल्यू सेट की जानी चाहिए.id
पैरामीटर की वैल्यूUC_x5XG1OV2P6uZZ5FSM9Ttw
, Google Developers YouTube चैनल का आईडी है.पैरामीटर के नीचे, क्रेडेंशियल नाम का एक सेक्शन होता है. उस सेक्शन के पुलडाउन मेन्यू में, एपीआई बटन की वैल्यू दिखनी चाहिए. API एक्सप्लोरर, डेमो को डिफ़ॉल्ट रूप से इस्तेमाल करता है, ताकि शुरुआत करना आसान हो सके. हालांकि, सैंपल को स्थानीय रूप से चलाने के लिए, आपको अपनी एपीआई कुंजी का इस्तेमाल करना होगा.
फ़ुलस्क्रीन API एक्सप्लोरर की दाईं ओर, अलग-अलग भाषाओं में कोड के सैंपल वाले टैब दिखते हैं. Java टैब चुनें.
कोड का नमूना कॉपी करें और उसे
src/main/java/ApiExample.java
नाम वाली फ़ाइल में सेव करें. हर नमूने में एक ही क्लास का नाम (ApiExample
) होता है, ताकि आपको अलग-अलग नमूने चलाने के लिएbuild.gradle
फ़ाइल में बदलाव करने की ज़रूरत न पड़े.डाउनलोड किए गए सैंपल में,
YOUR_API_KEY
स्ट्रिंग ढूंढें और उसे उस एपीआई कुंजी से बदलें जिसे आपने इस क्विकस्टार्ट के पहले चरण में बनाया था.कमांड लाइन से सैंपल चलाएं. अपनी चालू डायरेक्ट्री में, यह काम करें:
gradle -q run
सैंपल में अनुरोध करना चाहिए. साथ ही, जवाब को
STDOUT
में प्रिंट करना है.
चौथा चरण: अनुमति वाला अनुरोध चलाना
इस चरण में, आपको अपने कोड का नमूना बदलना होगा. इससे, Google Developers YouTube चैनल के बारे में जानकारी पाने के बजाय, आपके YouTube चैनल के बारे में जानकारी मिलेगी. इस अनुरोध के लिए उपयोगकर्ता की अनुमति की ज़रूरत है.
एपीआई के channels.list तरीके के दस्तावेज़ पर वापस जाएं.
"सामान्य इस्तेमाल के उदाहरण" सेक्शन में, टेबल में तीसरी लिस्टिंग के लिए कोड के चिह्न पर क्लिक करें. इसे "मेरे चैनल" के लिए
list
तरीके का इस्तेमाल करना है.दोबारा, फ़ुलस्क्रीन API एक्सप्लोरर के बाईं ओर, आपको क्रेडेंशियल सेक्शन के बाद पैरामीटर की एक सूची दिखेगी. हालांकि, हमने उदाहरण के लिए यहां दो बदलाव किए हैं, जिनमें आपको Googleडेवलपर चैनल के बारे में जानकारी मिली थी:
पैरामीटर सेक्शन में,
id
पैरामीटर की वैल्यू को सेट करने के बजाय,mine
पैरामीटर की वैल्यू कोtrue
पर सेट किया जाना चाहिए. इससे एपीआई सर्वर को मौजूदा उपयोगकर्ता की चैनल के बारे में जानकारी मिलती है.क्रेडेंशियल सेक्शन में, पुलडाउन मेन्यू में Google OAuth 2.0 का विकल्प चुनना चाहिए.
इसके अलावा, अगर दायरे दिखाएं लिंक पर क्लिक किया जाता है, तो https://www.googleapis.com/auth/youtube.readonly दायरे की जांच की जानी चाहिए.
पिछले उदाहरण की तरह, Java टैब चुनें, कोड का नमूना कॉपी करें और उसे
src/main/java/ApiExample.java
में सेव करें.कमांड लाइन से सैंपल चलाएं. अपनी चालू डायरेक्ट्री में, यह काम करें:
gradle -q run
नमूने को आपके डिफ़ॉल्ट ब्राउज़र में एक नई विंडो या टैब खोलने की कोशिश करनी चाहिए. अगर ऐसा नहीं होता है, तो टर्मिनल से यूआरएल कॉपी करें और उसे मैन्युअल रूप से अपने ब्राउज़र में खोलें.
अगर आपने पहले से ही अपने Google खाते में लॉग इन नहीं किया है, तो आपको लॉग इन करने के लिए कहा जाएगा. अगर आपने एक से ज़्यादा Google खातों में लॉग इन किया हुआ है, तो ऑथराइज़ेशन के लिए इस्तेमाल होने वाले खाते को चुनने के लिए कहा जाएगा.
अपने ऐप्लिकेशन के कोड नमूने में दिए गए दायरों का ऐक्सेस देने के लिए, बटन पर क्लिक करें.
नमूना अपने-आप आगे बढ़ जाएगा. साथ ही, आप पुष्टि करने के फ़्लो के लिए इस्तेमाल किए गए ब्राउज़र टैब को बंद कर सकते हैं.
एपीआई रिस्पॉन्स को फिर से
STDOUT
पर प्रिंट किया जाना चाहिए.