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

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

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

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

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

• PHP 5.4 या इसके बाद का वर्शन. साथ ही, कमांड-लाइन इंटरफ़ेस (सीएलआई) और JSON एक्सटेंशन इंस्टॉल होना चाहिए.
• Composer डिपेंडेंसी मैनेजमेंट टूल ग्लोबल स्तर पर इंस्टॉल किया गया हो
• PHP के लिए Google APIs Client Library:
  • अगर आपने पहले क्लाइंट लाइब्रेरी इंस्टॉल नहीं की है, तो:

    composer require google/apiclient:^2.0

  • अगर आपने पहले से ही क्लाइंट लाइब्रेरी इंस्टॉल की है, तो हमारा सुझाव है कि आप उसे अपडेट करें. इससे यह पक्का किया जा सकेगा कि आपके पास उस लाइब्रेरी के सबसे नए क्लास मौजूद हैं जिसकी जांच की जा रही है:

    composer update google/apiclient --with-dependencies

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

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. पैरामीटर के नीचे, क्रेडेंशियल नाम का सेक्शन होता है. उस सेक्शन में मौजूद पुलडाउन मेन्यू में, एपीआई पासकोड वैल्यू दिखनी चाहिए. एपीआई एक्सप्लोरर, डिफ़ॉल्ट रूप से डेमो क्रेडेंशियल का इस्तेमाल करता है, ताकि आपको इसे इस्तेमाल करने में आसानी हो. हालांकि, सैंपल को स्थानीय तौर पर चलाने के लिए, आपको अपनी एपीआई कुंजी का इस्तेमाल करना होगा.

      

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

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

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

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

   php example.php

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

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

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

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

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

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

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

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

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

      

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

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

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

   php example.php

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

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

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

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

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

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

• Google Developers Console के सहायता दस्तावेज़
• PHP के लिए Google APIs Client Library का दस्तावेज़
• YouTube API के लिए, GitHub पर PHP के लिए Google APIs Client Library और अपने-आप जनरेट होने वाली क्लास. (पेज पर, YouTube फ़ोल्डर और YouTube.php फ़ाइल ढूंढें.
• YouTube Data API के बारे में जानकारी देने वाला दस्तावेज़