পিএইচপি কুইকস্টার্ট

এই কুইকস্টার্ট গাইডটি ব্যাখ্যা করে যে কীভাবে একটি সাধারণ, পিএইচপি কমান্ড-লাইন অ্যাপ্লিকেশন সেট আপ করতে হয় যা YouTube ডেটা API-তে অনুরোধ করে। এই কুইকস্টার্ট আসলে ব্যাখ্যা করে কিভাবে দুটি API অনুরোধ করতে হয়:

  1. GoogleDevelopers YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করতে আপনি একটি API কী ব্যবহার করবেন, যা আপনার অ্যাপ্লিকেশন সনাক্ত করে।
  2. আপনি একটি অনুমোদিত অনুরোধ জমা দেওয়ার জন্য একটি OAuth 2.0 ক্লায়েন্ট আইডি ব্যবহার করবেন যা আপনার নিজের YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করে৷

পূর্বশর্ত

এই কুইকস্টার্ট চালানোর জন্য আপনার প্রয়োজন হবে:

  • কমান্ড-লাইন ইন্টারফেস (CLI) এবং JSON এক্সটেনশন ইনস্টল সহ PHP 5.4 বা তার বেশি।
  • কম্পোজার নির্ভরতা ব্যবস্থাপনা টুল বিশ্বব্যাপী ইনস্টল করা হয়েছে {: target="_blank"}
  • PHP-এর জন্য Google APIs ক্লায়েন্ট লাইব্রেরি:
    • আপনি যদি আগে ক্লায়েন্ট লাইব্রেরি ইনস্টল না করে থাকেন:
      composer require google/apiclient:^2.0
    • আপনি যদি পূর্বে ক্লায়েন্ট লাইব্রেরি ইনস্টল করে থাকেন, তাহলে আপনি যে লাইব্রেরির পরীক্ষা করছেন তার জন্য আপনার কাছে সবচেয়ে আপ-টু-ডেট ক্লাস আছে তা নিশ্চিত করতে আমরা এটিকে আপডেট করার পরামর্শ দিই:
      composer update google/apiclient --with-dependencies

ধাপ 1: আপনার প্রকল্প এবং শংসাপত্র সেট আপ করুন

API কনসোলে একটি প্রকল্প তৈরি করুন বা নির্বাচন করুন। আপনার প্রকল্পের জন্য API কনসোলে নিম্নলিখিত কাজগুলি সম্পূর্ণ করুন:

  1. লাইব্রেরি প্যানেলে , YouTube ডেটা API v3 অনুসন্ধান করুন৷ সেই API-এর তালিকায় ক্লিক করুন এবং নিশ্চিত করুন যে API আপনার প্রকল্পের জন্য সক্ষম হয়েছে।

  2. শংসাপত্র প্যানেলে , দুটি শংসাপত্র তৈরি করুন:

    1. একটি API কী তৈরি করুন আপনি API কী ব্যবহার করবেন এমন API অনুরোধগুলি তৈরি করতে যা ব্যবহারকারীর অনুমোদনের প্রয়োজন নেই৷ উদাহরণস্বরূপ, একটি সর্বজনীন YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করতে আপনার ব্যবহারকারীর অনুমোদনের প্রয়োজন নেই৷

    2. একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন অ্যাপ্লিকেশনের ধরনটি অন্যে সেট করুন। ব্যবহারকারীর অনুমোদন প্রয়োজন এমন অনুরোধের জন্য আপনাকে OAuth 2.0 শংসাপত্র ব্যবহার করতে হবে। উদাহরণস্বরূপ, বর্তমানে প্রমাণীকৃত ব্যবহারকারীর YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করতে আপনার ব্যবহারকারীর অনুমোদন প্রয়োজন৷

      JSON ফাইলটি ডাউনলোড করুন যাতে আপনার OAuth 2.0 শংসাপত্র রয়েছে৷ ফাইলটিতে client_secret_CLIENTID.json এর মতো একটি নাম রয়েছে, যেখানে CLIENTID হল আপনার প্রকল্পের ক্লায়েন্ট আইডি।

ধাপ 2: সেট আপ করুন এবং নমুনা চালান

GoogleDevelopers YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধারের জন্য নমুনা কোড পেতে পাশের প্যানেলে APIs এক্সপ্লোরার উইজেট ব্যবহার করুন। এই অনুরোধটি আপনার অ্যাপ্লিকেশন সনাক্ত করতে একটি API কী ব্যবহার করে এবং এটির জন্য ব্যবহারকারীর অনুমোদন বা নমুনা চালানো ব্যবহারকারীর কাছ থেকে কোনো বিশেষ অনুমতির প্রয়োজন হয় না।

  1. API এর channels.list পদ্ধতির জন্য ডকুমেন্টেশন খুলুন।
  2. সেই পৃষ্ঠায়, "সাধারণ ব্যবহারের ক্ষেত্রে" বিভাগে একটি টেবিল রয়েছে যা পদ্ধতিটি ব্যবহার করার জন্য বেশ কয়েকটি সাধারণ উপায় ব্যাখ্যা করে। সারণীতে প্রথম তালিকাটি হল চ্যানেল আইডি দ্বারা ফলাফল তালিকাভুক্ত করার জন্য৷

    পূর্ণস্ক্রীন APIs এক্সপ্লোরার খুলতে এবং পপুলেট করতে প্রথম তালিকার কোড চিহ্নে ক্লিক করুন।

    যে চিত্রটি সারণিতে কোড প্রতীক লিঙ্কের অবস্থান শনাক্ত করে যেটি channels.list ডকুমেন্টেশনের ক্ষেত্রে ব্যবহার করার তালিকা দেয়। সেই ছবির জন্য Alt টেক্সট ইমেজটিকে একটি কোড প্রতীক হিসেবে চিহ্নিত করে এবং সেই লিঙ্কের সাথে যুক্ত ব্যবহারের ক্ষেত্রে উল্লেখ করে।

  3. ফুলস্ক্রিন এপিআই এক্সপ্লোরারের বাম দিকে নিম্নলিখিতগুলি দেখায়:

    1. অনুরোধের পরামিতি শিরোনামের নীচে, পদ্ধতিটি সমর্থন করে এমন প্যারামিটারগুলির একটি তালিকা রয়েছে। part এবং id প্যারামিটার মান সেট করা উচিত। id প্যারামিটার মান, UC_x5XG1OV2P6uZZ5FSM9Ttw , হল GoogleDevelopers YouTube চ্যানেলের ID।

    2. পরামিতিগুলির নীচে, শংসাপত্র নামে একটি বিভাগ রয়েছে। সেই বিভাগে পুলডাউন মেনুতে মান API কী প্রদর্শন করা উচিত। শুরু করা সহজ করতে APIs এক্সপ্লোরার ডিফল্টরূপে ডেমো শংসাপত্র ব্যবহার করে। কিন্তু আপনি স্থানীয়ভাবে নমুনা চালানোর জন্য আপনার নিজস্ব API কী ব্যবহার করবেন।

      পূর্ণস্ক্রীন APIs এক্সপ্লোরার এবং নির্বাচিত 'API কী' বিকল্প সহ পুলডাউন মেনুতে 'শংসাপত্র' দেখায় এমন চিত্র৷

  4. ফুলস্ক্রিন APIs এক্সপ্লোরারের ডানদিকে বিভিন্ন ভাষায় কোড নমুনা সহ ট্যাব দেখায়। পিএইচপি ট্যাব নির্বাচন করুন।

  5. কোডের নমুনাটি কপি করে example.php নামের একটি ফাইলে সংরক্ষণ করুন।

  6. আপনি যে নমুনাটি ডাউনলোড করেছেন তাতে, YOUR_API_KEY স্ট্রিংটি খুঁজুন এবং এই কুইকস্টার্টের ধাপ 1 এ তৈরি করা API কী দিয়ে সেটিকে প্রতিস্থাপন করুন।

  7. কমান্ড লাইন থেকে নমুনা চালান। আপনার কাজের ডিরেক্টরিতে, চালান:

    php example.php

  8. নমুনাটি অনুরোধটি চালাতে হবে এবং STDOUT এ প্রতিক্রিয়া প্রিন্ট করতে হবে।

ধাপ 3: একটি অনুমোদিত অনুরোধ চালান

এই ধাপে, আপনি আপনার কোড নমুনা পরিবর্তন করবেন যাতে GoogleDevelopers YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করার পরিবর্তে, এটি আপনার YouTube চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করে। এই অনুরোধ ব্যবহারকারী অনুমোদন প্রয়োজন.

  1. API এর channels.list পদ্ধতির জন্য ডকুমেন্টেশনে ফিরে যান।

  2. "সাধারণ ব্যবহারের ক্ষেত্রে" বিভাগে, টেবিলের তৃতীয় তালিকার কোড চিহ্নে ক্লিক করুন। এই ব্যবহারের ক্ষেত্রে "আমার চ্যানেল" এর জন্য list পদ্ধতি কল করা হয়।

  3. আবার, ফুলস্ক্রিন APIs এক্সপ্লোরারের বাম দিকে, আপনি শংসাপত্র বিভাগ দ্বারা অনুসরণ করা পরামিতিগুলির একটি তালিকা দেখতে পাবেন। যাইহোক, উদাহরণ থেকে দুটি পরিবর্তন আছে যেখানে আপনি GoogleDevelopers চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করেছেন:

    1. পরামিতি বিভাগে, id প্যারামিটার মান সেট করার পরিবর্তে, mine প্যারামিটার মান true সেট করা উচিত। এটি এপিআই সার্ভারকে বর্তমানে প্রমাণীকৃত ব্যবহারকারীর চ্যানেল সম্পর্কে তথ্য পুনরুদ্ধার করার নির্দেশ দেয়।

    2. শংসাপত্র বিভাগে, পুলডাউন মেনুতে Google OAuth 2.0- এর বিকল্পটি নির্বাচন করা উচিত।

      উপরন্তু, যদি আপনি স্কোপ দেখান লিঙ্কে ক্লিক করেন, https://www.googleapis.com/auth/youtube.readonly স্কোপটি চেক করা উচিত।

      পূর্ণস্ক্রীন APIs এক্সপ্লোরার এবং নির্বাচিত 'Google OAuth 2.0' শংসাপত্র ব্যবহার করার বিকল্পে স্কোপ দেখায় এমন চিত্র৷

  4. আগের উদাহরণের মতো, পিএইচপি ট্যাবটি নির্বাচন করুন, কোড নমুনাটি অনুলিপি করুন এবং এটি example.php এ সংরক্ষণ করুন।

    কোডটিতে, YOUR_CLIENT_SECRET_FILE.json স্ট্রিংটি খুঁজুন এবং এই দ্রুতস্টার্টের ধাপ 1 এ ডাউনলোড করা ক্লায়েন্ট গোপন ফাইলের অবস্থানের সাথে এটিকে প্রতিস্থাপন করুন।

  5. কমান্ড লাইন থেকে নমুনা চালান। আপনার কাজের ডিরেক্টরিতে, চালান:

    php example.php

  6. কনসোল থেকে URLটি অনুলিপি করুন এবং এটি আপনার ব্রাউজারে খুলুন।

    আপনি যদি ইতিমধ্যে আপনার Google অ্যাকাউন্টে লগ ইন না করে থাকেন, তাহলে আপনাকে লগ ইন করতে বলা হবে৷ আপনি যদি একাধিক Google অ্যাকাউন্টে লগ ইন করে থাকেন, তাহলে অনুমোদনের জন্য ব্যবহার করার জন্য আপনাকে একটি অ্যাকাউন্ট নির্বাচন করতে বলা হবে৷

  7. আপনার কোড নমুনায় নির্দিষ্ট স্কোপে আপনার অ্যাপ্লিকেশন অ্যাক্সেস মঞ্জুর করার জন্য বোতামটি ক্লিক করুন।

  8. ব্রাউজার থেকে প্রমাণীকরণ কোডটি কপি করুন এবং আপনার টার্মিনালে পেস্ট করুন। তারপরে আপনি অনুমোদন প্রবাহের জন্য ব্যবহৃত ব্রাউজার ট্যাবটি বন্ধ করতে পারেন।

    API প্রতিক্রিয়া আবার STDOUT এ প্রিন্ট করা উচিত।

আরও পড়া