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

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. পূর্ণস্ক্রিন APIs Explorer এর বাম দিকে নিম্নলিখিতগুলি দেখানো হয়েছে:

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

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

      পূর্ণস্ক্রিন API এক্সপ্লোরারে 'শংসাপত্র' এবং 'API কী' বিকল্পটি নির্বাচিত পুলডাউন মেনু দেখানো ছবিটি।

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

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

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

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

    php example.php

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

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

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

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

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

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

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

    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. কনসোল থেকে URL টি কপি করুন এবং আপনার ব্রাউজারে এটি খুলুন।

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

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

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

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

আরও পড়া