জাভা কুইকস্টার্ট

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

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

পূর্বশর্ত

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

  • Java 1.7 বা তার বেশি।
  • গ্রেডেল 2.3 বা তার বেশি
  • ইন্টারনেট এবং একটি ওয়েব ব্রাউজারে অ্যাক্সেস।
  • একটি Google অ্যাকাউন্ট।

ধাপ 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: প্রকল্প প্রস্তুত করুন

আপনার গ্রেডল প্রকল্প প্রস্তুত করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

  1. আপনার কাজের ডিরেক্টরিতে, একটি নতুন প্রকল্প কাঠামো তৈরি করতে নিম্নলিখিত কমান্ডগুলি চালান:

    $ gradle init --type basic
    $ mkdir -p src/main/java src/main/resources
    
  2. আপনার OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করার পরে আপনি যে JSON ফাইলটি ডাউনলোড করেছেন তা আপনার কার্যকারী ডিরেক্টরির নীচে src/main/resources ডিরেক্টরিতে সরান এবং ফাইলটির নাম পরিবর্তন করুন client_secret.json

  3. আপনার ওয়ার্কিং ডাইরেক্টরিতে build.gradle ফাইলটি খুলুন এবং এর বিষয়বস্তুগুলি নিম্নলিখিতগুলির সাথে প্রতিস্থাপন করুন:

    apply plugin: 'java'
    apply plugin: 'application'
    
    mainClassName = 'ApiExample'
    sourceCompatibility = 1.7
    targetCompatibility = 1.7
    version = '1.0'
    
    repositories {
        mavenCentral()
    }
    
    dependencies {
        compile 'com.google.api-client:google-api-client:1.23.0'
        compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
        compile 'com.google.apis:google-api-services-youtube:v3-revREVISION-CL_VERSION'
    }
    
  4. build.gradle ফাইলে, আপনাকে YouTube ডেটা API-এর জন্য ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন থেকে দুটি মান দিয়ে REVISION এবং CL_VERSION ভেরিয়েবল প্রতিস্থাপন করতে হবে। নীচের স্ক্রিনশট, যা YouTube Analytics API-এর ডকুমেন্টেশন দেখায়, দেখায় যে দুটি ভেরিয়েবল পৃষ্ঠায় কোথায় উপস্থিত হয়।

    JavaDoc রেফারেন্সের স্ক্রিনশট দেখানো হচ্ছে কিভাবে 'REVISION' এবং 'CL_VERSION' ভেরিয়েবলের মান খুঁজে পাওয়া যায়

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

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 এক্সপ্লোরারের ডানদিকে বিভিন্ন ভাষায় কোড নমুনা সহ ট্যাব দেখায়। Java ট্যাব নির্বাচন করুন।

  5. কোড নমুনাটি অনুলিপি করুন এবং src/main/java/ApiExample.java নামে একটি ফাইলে সংরক্ষণ করুন। প্রতিটি নমুনা একই শ্রেণীর নাম ( ApiExample ) ব্যবহার করে যাতে বিভিন্ন নমুনা চালানোর জন্য আপনাকে build.gradle ফাইলটি পরিবর্তন করতে হবে না।

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

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

    gradle -q run

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

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

এই ধাপে, আপনি আপনার কোড নমুনা পরিবর্তন করবেন যাতে 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. আগের উদাহরণের মতো, Java ট্যাব নির্বাচন করুন, কোড নমুনাটি অনুলিপি করুন এবং src/main/java/ApiExample.java এ সংরক্ষণ করুন।

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

    gradle -q run

  6. নমুনাটি আপনার ডিফল্ট ব্রাউজারে একটি নতুন উইন্ডো বা ট্যাব খোলার চেষ্টা করা উচিত। এটি ব্যর্থ হলে, টার্মিনাল থেকে URLটি অনুলিপি করুন এবং ম্যানুয়ালি এটি আপনার ব্রাউজারে খুলুন৷

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

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

  8. নমুনা স্বয়ংক্রিয়ভাবে এগিয়ে যাবে, এবং আপনি অনুমোদন প্রবাহের জন্য ব্যবহৃত ব্রাউজার ট্যাবটি বন্ধ করতে পারেন।

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

আরও পড়া