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

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

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

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

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

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

• Python 2.7 या Python 3.5 या इसके बाद का वर्शन

• pip पैकेज मैनेजमेंट टूल

• Python के लिए Google APIs की क्लाइंट लाइब्रेरी:

  pip install --upgrade google-api-python-client
  

• उपयोगकर्ता की अनुमति के लिए, google-auth-oauthlib और google-auth-httplib2 लाइब्रेरी.

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

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

Cloud Console में कोई प्रोजेक्ट बनाएं या चुनें. अपने प्रोजेक्ट के लिए, Cloud Console में ये टास्क पूरे करें:

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

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

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

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

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

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

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

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

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

   पहली सूची के लिए, कोड के सिंबल पर क्लिक करके, फ़ुलस्क्रीन APIs Explorer खोलें और उसमें जानकारी भरें.

   

3. फ़ुलस्क्रीन APIs Explorer के बाईं ओर, यह जानकारी दिखती है:

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

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

      

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

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

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

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

   python example.py

8. सैंपल को अनुरोध पूरा करना चाहिए और जवाब को STDOUT पर प्रिंट करना चाहिए.

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

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

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

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

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

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

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

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

      

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

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

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

   python example.py

6. कंसोल से यूआरएल कॉपी करें और उसे अपने ब्राउज़र में खोलें.

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

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

8. ब्राउज़र से अनुमति का कोड कॉपी करें और उसे अपने टर्मिनल में चिपकाएं. इसके बाद, अनुमति के फ़्लो के लिए इस्तेमाल किए गए ब्राउज़र टैब को बंद किया जा सकता है.

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

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

• Google Developers Console की मदद से जुड़ा दस्तावेज़
• Python के लिए Google APIs की क्लाइंट लाइब्रेरी का दस्तावेज़
• YouTube Data API PyDoc का दस्तावेज़
• YouTube Data API के रेफ़रंस का दस्तावेज़