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

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

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

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

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

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

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

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

      

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

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

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

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

   php example.php

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

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

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

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

2. "Common use cases" सेक्शन में, टेबल में मौजूद तीसरी लिस्टिंग के लिए कोड सिंबल पर क्लिक करें. इस तरीके का इस्तेमाल, "मेरे चैनल" के लिए 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 की क्लाइंट लाइब्रेरी का दस्तावेज़
• GitHub पर PHP के लिए Google APIs क्लाइंट लाइब्रेरी और YouTube API के लिए अपने-आप जनरेट होने वाली क्लास. (पेज पर, YouTube फ़ोल्डर और YouTube.php फ़ाइल ढूंढें.
• YouTube Data API के रेफ़रंस दस्तावेज़