PHP কুইকস্টার্ট

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

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

মনে রাখবেন: আরও সাধারণভাবে, আপনি API key ব্যবহার করে এমন যেকোনও ব্যবহারের ক্ষেত্রে প্রথম উদাহরণের নির্দেশাবলী অনুসরণ করতে পারেন অথবা OAuth 2.0 ব্যবহার করে অনুমোদনের প্রয়োজন হয় এমন যেকোনও ব্যবহারের ক্ষেত্রে দ্বিতীয় উদাহরণের নির্দেশাবলী অনুসরণ করতে পারেন। আরও উদাহরণ পেতে ব্যবহারের ক্ষেত্র ও কোড স্যাম্পেল টুল দেখুন।

পূর্বশর্ত

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

• কমান্ড-লাইন ইন্টারফেস (CLI) এবং JSON এক্সটেনশন ইনস্টল করা সহ PHP 5.4 বা তার পরবর্তী ভার্সন।
• Composer ডিপেন্ডেন্সি ম্যানেজমেন্ট টুল বিশ্বব্যাপী ইনস্টল করা
• PHP-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি:
  • আপনি যদি আগে ক্লায়েন্ট লাইব্রেরি ইনস্টল না করে থাকেন:

    composer require google/apiclient:^2.0

  • আপনি আগে ক্লায়েন্ট লাইব্রেরি ইনস্টল করে থাকলে, আপনি যে লাইব্রেরি পরীক্ষা করছেন সেটির জন্য সবচেয়ে আপ-টু-ডেট ক্লাস আপনার কাছে আছে কিনা তা নিশ্চিত করতে আমরা এটি আপডেট করার সাজেশন দিই:

    composer update google/apiclient --with-dependencies

ধাপ ১: আপনার প্রোজেক্ট ও ক্রেডেনশিয়াল সেট-আপ করুন

Cloud console-এ কোনও প্রোজেক্ট তৈরি করুন বা বেছে নিন। আপনার প্রোজেক্টের জন্য Cloud কনসোলে নিম্নলিখিত টাস্কগুলি সম্পূর্ণ করুন:

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

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

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

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

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

ধাপ ২: স্যাম্পেল সেট-আপ ও রান করা

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

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

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

   ফুলস্ক্রিন APIs Explorer খুলতে ও পপুলেট করতে প্রথম তালিকার জন্য কোড চিহ্নে ক্লিক করুন।

   

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

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

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

      

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

5. কোডের নমুনা কপি করে example.php নামের ফাইলে সেভ করুন।

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

7. কমান্ড লাইন থেকে স্যাম্পেল রান করুন। আপনার ওয়ার্কিং ডিরেক্টরিতে, এগুলি রান করান:

   php example.php

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

ধাপ ৩: অনুমোদিত অনুরোধ রান করা

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

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

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

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

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

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

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

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

8. ব্রাউজার থেকে যাচাইকরণ কোড কপি করে আপনার টার্মিনালে পেস্ট করুন। তারপর আপনি অথ ফ্লোয়ের জন্য ব্যবহার করা ব্রাউজার ট্যাব বন্ধ করতে পারবেন।

   API রেসপন্স আবার STDOUT-এ প্রিন্ট করতে হবে।

আরও পড়ুন

• Google Developers Console সহায়তা ডকুমেন্টেশন
• PHP ডকুমেন্টেশনের জন্য Google APIs ক্লায়েন্ট লাইব্রেরি
• GitHub-এ PHP-এর জন্য Google APIs ক্লায়েন্ট লাইব্রেরি এবং YouTube API-এর জন্য অটোজেনারেট করা ক্লাস। (পৃষ্ঠায়, YouTube ফোল্ডার এবং YouTube.php ফাইল খুঁজুন।
• YouTube Data API রেফারেন্স ডকুমেন্টেশন