১. শুরু করার আগে
এই কোডল্যাবটি আপনাকে দেখায় কিভাবে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করতে হয় এবং তারপর সেই প্রজেক্ট থেকে গুগল ক্লাউড এপিআই কল করতে হয়।
পূর্বশর্ত
- গুগল ক্লাউড কনসোল নেভিগেট করার ক্ষমতা।
তুমি কি শিখবে
- কিভাবে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করবেন।
- কিভাবে একটি বিলিং অ্যাকাউন্ট সেট আপ করবেন।
- ক্লাউড শেল কিভাবে সেট আপ করবেন।
- কিভাবে একটি API সক্রিয় করবেন।
- API কী ব্যবহার করে কীভাবে একটি API অনুমোদন করবেন।
- একটি পরিষেবা অ্যাকাউন্টের মাধ্যমে একটি API কীভাবে অনুমোদন করবেন।
তোমার যা লাগবে
- একটি গুগল অ্যাকাউন্ট, যেমন একটি জিমেইল অ্যাকাউন্ট বা একটি গুগল ওয়ার্কস্পেস অ্যাকাউন্ট ।
- ফ্রি ট্রায়াল প্রোগ্রামে সাইন আপ করার জন্য একটি ক্লাউড বিলিং অ্যাকাউন্ট বা ক্রেডিট কার্ড অ্যাক্সেস করুন।
2. সেট আপ করুন
এই বিভাগটি আপনাকে দেখায় কিভাবে একটি Google ক্লাউড প্রকল্প তৈরি করতে হয়, একটি বিলিং অ্যাকাউন্ট সেট আপ করতে হয় এবং ক্লাউড শেল সেট আপ করতে হয়।
একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন এবং একটি বিলিং অ্যাকাউন্ট সেট আপ করুন
- ক্লাউড কনসোলে সাইন ইন করুন এবং একটি প্রকল্প নির্বাচন করুন বা তৈরি করুন।
প্রজেক্ট আইডি মনে রাখবেন, যা প্রজেক্টের নাম ক্ষেত্রের অধীনে দেখানো হয়েছে। আইডিটি সমস্ত গুগল ক্লাউড প্রকল্পের জন্য একটি অনন্য নাম (উপরের নামটি ইতিমধ্যেই নেওয়া হয়েছে), এবং এই কোডল্যাবে পরে PROJECT_ID হিসাবে উল্লেখ করা হয়েছে।
- এরপর, গুগল ক্লাউড রিসোর্স ব্যবহার করার জন্য ক্লাউড কনসোলে বিলিং সক্ষম করুন ।
যদিও এই কোডল্যাবের দাম বেশি নাও হতে পারে, তবুও রিসোর্স বন্ধ করতে এবং এই কোডল্যাবের বাইরে খরচ এড়াতে ক্লিন আপ বিভাগে দেওয়া নির্দেশাবলী অনুসরণ করুন। মনে রাখবেন যে গুগল ক্লাউডের নতুন ব্যবহারকারীরা US$300 বিনামূল্যে ট্রায়ালের জন্য যোগ্য।
ক্লাউড শেল সেট আপ করুন
এই কোডল্যাবে, আপনি ক্লাউড শেল ব্যবহার করেন, একটি কমান্ড-লাইন পরিবেশ যা গুগল ক্লাউডে চলে। ক্লাউড শেল হল একটি ডেবিয়ান-ভিত্তিক ভার্চুয়াল মেশিন যা আপনার প্রয়োজনীয় সমস্ত ডেভেলপমেন্ট টুল দিয়ে সজ্জিত। এটি একটি স্থায়ী 5GB হোম ডিরেক্টরি অফার করে, যা নেটওয়ার্ক কর্মক্ষমতা এবং প্রমাণীকরণকে ব্যাপকভাবে উন্নত করে। এর অর্থ হল এই কোডল্যাবের জন্য আপনার যা প্রয়োজন তা হল একটি ব্রাউজার।
ক্লাউড কনসোল থেকে ক্লাউড শেল সক্রিয় করতে:
- ক্লিক করুন
ক্লাউড শেল সক্রিয় করুন ।
পরিবেশের সাথে সংযোগ স্থাপন এবং সংযোগ স্থাপন করতে কয়েক মুহূর্ত সময় লাগতে পারে।
একবার ক্লাউড শেলের সাথে সংযুক্ত হয়ে গেলে, আপনি দেখতে পাবেন যে আপনি ইতিমধ্যেই প্রমাণিত এবং প্রকল্পটি ইতিমধ্যেই আপনার PROJECT_ID এ সেট করা আছে।
- শংসাপত্রপ্রাপ্ত অ্যাকাউন্টগুলির একটি তালিকা তৈরি করুন:
gcloud auth list
আপনার এই আউটপুটটি দেখা উচিত:
Credentialed accounts:
- <MY_ACCOUNT>@<MY_DOMAIN>.com (active)
- আপনার প্রকল্পের তালিকা দেখতে, এই কমান্ডটি প্রবেশ করান।
gcloud config list project
আপনার এই আউটপুটটি দেখা উচিত:
[core]
project = <PROJECT_ID>
যদি, কোন কারণে, প্রকল্পটি সেট না করা থাকে, তাহলে প্রকল্পটি সেট আপ করতে এই কমান্ডটি চালান।
gcloud config set project <PROJECT_ID>
PROJECT_ID হল সেই আইডি যা আপনি সেটআপ ধাপগুলিতে ব্যবহার করেছিলেন। আপনি এটি ক্লাউড কনসোল ড্যাশবোর্ডেও দেখতে পারেন:
ক্লাউড শেল ডিফল্টরূপে কিছু পরিবেশ ভেরিয়েবল সেট করে, যা ভবিষ্যতের কমান্ড চালানোর সময় কার্যকর হতে পারে।
- আপনার প্রকল্প আইডি দেখতে, নিম্নলিখিত কমান্ডটি প্রবেশ করান।
echo $GOOGLE_CLOUD_PROJECT
আপনার নিম্নলিখিত আউটপুটটি দেখতে হবে:
<PROJECT_ID>
- অবশেষে, ডিফল্ট জোন এবং প্রকল্প কনফিগারেশন সেট করুন।
gcloud config set compute/zone us-central1-f
আপনি বিভিন্ন ধরণের অঞ্চল বেছে নিতে পারেন। আরও তথ্যের জন্য, অঞ্চল এবং অঞ্চল দেখুন।
৩. একটি প্রকল্প থেকে একটি API কল করুন
এই কোডল্যাবটি আপনাকে দেখায় কিভাবে একটি উদাহরণ API ( প্রাকৃতিক ভাষা API ) ব্যবহার করে টেক্সটে সত্তা (যেমন মানুষ, স্থান এবং ইভেন্ট) খুঁজে বের করতে হয় এবং কীভাবে সেই টেক্সটের অনুভূতি (অনুকূলতার স্তর) আনুমানিক করতে হয়। আপনি শিখবেন কিভাবে:
- গুগল ক্লাউড এপিআই সক্ষম করুন।
- API কী এবং পরিষেবা অ্যাকাউন্টের মাধ্যমে API এর জন্য অনুমোদন পান।
-
curlএবং ক্লায়েন্ট লাইব্রেরি সহ API কল করুন।
একটি API সক্ষম করুন
- ক্লাউড কনসোলের প্রধান মেনু থেকে API এবং পরিষেবা নির্বাচন করুন।
- স্ক্রিনের উপর থেকে + ENABLE APIS AND SERVICES নির্বাচন করুন।
- এই মুহুর্তে, আপনি API গুলি ফিল্টার এবং ব্রাউজ করতে পারেন, অথবা অনুসন্ধান বাক্সের মাধ্যমে সরাসরি একটি API-তে যেতে পারেন।
Natural Languageঅনুসন্ধান করুন এবং ক্লাউড প্রাকৃতিক ভাষা API নির্বাচন করুন।
- এই API ব্যবহার করে দেখুন ক্লিক করুন।
যদি "এই API ব্যবহার করে দেখুন" বোতামটি না দেখা যায়, তাহলে তালিকাভুক্ত পদ্ধতিগুলির মধ্যে একটিতে ক্লিক করে সেই পদ্ধতিটি চেষ্টা করুন।
একটি API কী তৈরি করুন
যেহেতু আপনি ন্যাচারাল ল্যাঙ্গুয়েজ এপিআই-তে একটি অনুরোধ পাঠাতে curl ব্যবহার করেন, তাই আপনার অনুরোধের URL পাস করার জন্য আপনাকে একটি API কী তৈরি করতে হবে।
- ক্লাউড কনসোলে, নেভিগেশন মেনু > API এবং পরিষেবা > শংসাপত্র নির্বাচন করুন।
- CREATE CREDENTIALS এ ক্লিক করুন এবং তারপর API কী নির্বাচন করুন:
- জেনারেট করা API কীটি কপি করুন এবং তারপর Close এ ক্লিক করুন।
API কল করতে API কী ব্যবহার করুন
- ক্লাউড শেল কমান্ড লাইনে, আপনার API কী এক্সপোর্ট করুন।
export API_KEY=<YOUR_API_KEY>
<YOUR_API_KEY> পরিবর্তে আপনি পূর্বে তৈরি করা কীটি ব্যবহার করুন।
- ক্লাউড শেল এডিটরে অথবা ভিম বা ইম্যাকসের মতো লিনাক্স এডিটর দিয়ে API-এর জন্য একটি অনুরোধ তৈরি করুন। প্যারামিটারের বিস্তারিত তথ্য আপনি Method: documents.analyzeEntities -এ পাবেন।
request.jsonনামক একটি ফাইলে আউটপুট সংরক্ষণ করুন:
{
"document":{
"type":"PLAIN_TEXT",
"content":"Google, headquartered in Mountain View (1600 Amphitheatre Pkwy, Mountain View, CA 940430), unveiled the new Android phone for $799 at the Consumer Electronic Show. Sundar Pichai said in his keynote that users love their new Android phones."
},
"encodingType":"UTF8"
}
- অনুরোধের তথ্য সহ API-তে কল করুন।
curl "https://language.googleapis.com/v1/documents:analyzeEntities?key=${API_KEY}" \
-s -X POST -H "Content-Type: application/json" --data-binary @request.json
- কমান্ডটি পুনরায় চালান এবং আউটপুটটিকে একটি ফাইলে পুনঃনির্দেশিত করুন এবং ফলাফল পরীক্ষা করুন। JSON ফাইলের আউটপুটের বিশদ বিবরণ Method: documents.analyzeEntities তেও রয়েছে।
-
request.jsonফাইলে বিশ্লেষণের জন্য টেক্সট পরিবর্তন করতে,contentমানটি আপনার পছন্দের টেক্সট দিয়ে প্রতিস্থাপন করুন।
৪. একটি পরিষেবা অ্যাকাউন্ট দিয়ে অনুমোদন করুন
API কী-এর চেয়ে পরিষেবা অ্যাকাউন্টগুলিকে প্রায়শই পছন্দ করা হয় কারণ এগুলি প্রমাণীকরণ এবং অনুমোদন উভয়ই প্রদান করে। আপনি আপনার অ্যাপের জন্য পরিষেবা অ্যাকাউন্টগুলিকে ইমেল ঠিকানা হিসেবে ভাবতে পারেন।
- APIs & Services মেনুর Credentials বিভাগে ফিরে যান।
- Create Credentials নির্বাচন করুন, কিন্তু এবার, Service Account নির্বাচন করুন।
- "
Natural Language Service Account" এর মতো একটি পরিষেবা অ্যাকাউন্টের নাম দিন যা এর উদ্দেশ্য বর্ণনা করে। সিস্টেমটি একটি আইডি প্রস্তাব করে। আপনি একটি বিবরণও যোগ করতে পারেন। পরিষেবা অ্যাকাউন্ট সম্পর্কে আরও জানার সাথে সাথে, আপনি পরিষেবা অ্যাকাউন্টকে প্রকল্পগুলিতে অ্যাক্সেস প্রদান করেন এবং ব্যবহারকারীদের পরিষেবা অ্যাকাউন্টে অ্যাক্সেস প্রদান করেন, তবে আপাতত, পরিষেবা অ্যাকাউন্ট তৈরি করতে কেবল সম্পন্ন ক্লিক করুন। - পরিষেবা অ্যাকাউন্ট ব্যবহারের জন্য একটি কী পেয়ার তৈরি করতে, ক্লিক করুন
পরিষেবা অ্যাকাউন্ট সম্পাদনা করতে।
আপনার পরিষেবা অ্যাকাউন্টের বিবরণ প্রদর্শিত হবে।
- পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানাটি অনুলিপি করুন এবং ক্লাউড শেলে ফিরে যান।
- ক্লাউড শেলে, আপনার পরিষেবা অ্যাকাউন্টের জন্য একটি কী জোড়া তৈরি করুন এবং এটি নির্দেশ করার জন্য একটি পরিবেশ ভেরিয়েবল সেট করুন:
gcloud iam service-accounts keys create ~/key.json \
--iam-account <your service account email>
export GOOGLE_APPLICATION_CREDENTIALS="/home/$USER/key.json"
গুগল ক্লাউড এই পরিবেশ পরিবর্তনশীল ব্যবহার করে শংসাপত্রগুলি খুঁজে বের করে, তাই তাদের API কলে অন্তর্ভুক্ত করার প্রয়োজন হয় না।
- আপনি এখন এই কমান্ড দিয়ে API কল করতে পারেন:
gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."
ফলাফল আগের মতোই হওয়া উচিত।
অনেক API-তে বিস্তৃত ক্লায়েন্ট লাইব্রেরি থাকে যেখান থেকে এই বিবরণগুলি বের করা যায়। ক্লায়েন্ট লাইব্রেরি সম্পর্কে আরও জানতে, ক্লাউড ক্লায়েন্ট লাইব্রেরি দেখুন। আপনি যে API গুলি ব্যবহার করেন তার ডকুমেন্টেশনগুলি পড়ে দেখতে পারেন যে তাদের জন্য কোন ক্লায়েন্ট লাইব্রেরিগুলি উপলব্ধ।
৫. পরিষ্কার করা
প্রকল্পের জন্য একটি অবাধ API কী থাকা খারাপ অভ্যাস । যদি কেউ এটিতে অ্যাক্সেস পায়, তাহলে সেই ব্যক্তি আর কোনও প্রমাণীকরণের প্রয়োজন ছাড়াই এটি ব্যবহার করতে পারবেন।
এই API কীটি মুছে ফেলার জন্য:
- ক্লিক করুন
নেভিগেশন মেনু > API এবং পরিষেবা > শংসাপত্র । - API Keys এর অধীনে, মুছে ফেলার জন্য কীটি নির্বাচন করুন এবং তারপরে ক্লিক করুন
মুছে ফেলুন । - একইভাবে, আপনার পরিষেবা অ্যাকাউন্টের ব্যক্তিগত কী অরক্ষিত থাকার বিষয়ে চিন্তা করার পরিবর্তে, পরিষেবা অ্যাকাউন্টগুলির অধীনে, মুছে ফেলার জন্য পরিষেবা অ্যাকাউন্টটি নির্বাচন করুন এবং তারপরে ক্লিক করুন মুছে ফেলুন ।
৬. অভিনন্দন
অভিনন্দন! আপনি শিখেছেন কিভাবে একটি Google ক্লাউড প্রকল্প তৈরি করতে হয় এবং প্রকল্পের মধ্যে থেকে একটি API কল করতে হয়।