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

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

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

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

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

  • कमांड-लाइन इंटरफ़ेस (सीएलआई) और JSON एक्सटेंशन इंस्टॉल करने वाले PHP 5.4 या इसके बाद के वर्शन.
  • कंपोज़र डिपेंडेंसी मैनेजमेंट टूल दुनिया भर में इंस्टॉल किया गया {: target="_blank"}
  • PHP के लिए Google API क्लाइंट लाइब्रेरी:
    • अगर आपने पहले क्लाइंट लाइब्रेरी इंस्टॉल नहीं की है, तो:
      composer require google/apiclient:^2.0
    • अगर आपने पहले क्लाइंट लाइब्रेरी इंस्टॉल की थी, तो हमारा सुझाव है कि आप यह पक्का करें कि आपके पास उस लाइब्रेरी की सबसे अप-टू-डेट क्लास हों जिसकी आप जांच कर रहे हैं:
      composer update google/apiclient --with-dependencies

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

एपीआई कंसोल में कोई प्रोजेक्ट बनाएं या चुनें. अपने प्रोजेक्ट के लिए, 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 आपके प्रोजेक्ट का क्लाइंट आईडी होता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

    php example.php

  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. पिछले उदाहरण की तरह, PHP टैब चुनें, कोड का नमूना कॉपी करें और उसे example.php में सेव करें.

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

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

    php example.php

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

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

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

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

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

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