1. আপনি শুরু করার আগে
এই কোডল্যাব আপনাকে দেখায় কিভাবে একটি Google ক্লাউড প্রজেক্ট তৈরি করতে হয় এবং তারপর সেই প্রোজেক্ট থেকে Google ক্লাউড এপিআই কল করতে হয়।
পূর্বশর্ত
- Google ক্লাউড কনসোল নেভিগেট করার ক্ষমতা।
আপনি কি শিখবেন
- কিভাবে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করবেন।
- কিভাবে একটি বিলিং অ্যাকাউন্ট সেট আপ করবেন।
- কিভাবে ক্লাউড শেল সেট আপ করবেন।
- কিভাবে একটি API সক্ষম করবেন।
- কিভাবে একটি API কী দিয়ে একটি API অনুমোদন করবেন।
- কীভাবে একটি পরিষেবা অ্যাকাউন্টের সাথে একটি API অনুমোদন করবেন।
আপনি কি প্রয়োজন হবে
- একটি Google অ্যাকাউন্ট, যেমন একটি Gmail অ্যাকাউন্ট বা একটি Google Workspace অ্যাকাউন্ট ।
- বিনামূল্যে ট্রায়াল প্রোগ্রামের জন্য সাইন আপ করতে ব্যবহার করার জন্য একটি ক্লাউড বিলিং অ্যাকাউন্ট বা একটি ক্রেডিট কার্ড অ্যাক্সেস করুন৷
2. সেট আপ করুন
এই বিভাগটি আপনাকে দেখায় কিভাবে একটি Google ক্লাউড প্রকল্প তৈরি করতে হয়, একটি বিলিং অ্যাকাউন্ট সেট আপ করতে হয় এবং ক্লাউড শেল সেট আপ করতে হয়।
একটি Google ক্লাউড প্রকল্প তৈরি করুন এবং একটি বিলিং অ্যাকাউন্ট সেট আপ করুন৷
- ক্লাউড কনসোলে সাইন ইন করুন এবং একটি প্রকল্প নির্বাচন করুন বা তৈরি করুন৷
প্রজেক্ট আইডি মনে রাখবেন, যা প্রজেক্ট নাম ফিল্ডের অধীনে দেখানো হয়েছে। আইডিটি সমস্ত Google ক্লাউড প্রকল্পে একটি অনন্য নাম (উপরের নামটি ইতিমধ্যে নেওয়া হয়েছে), এবং পরে এই কোডল্যাবে PROJECT_ID হিসাবে উল্লেখ করা হয়েছে।
- এর পরে, Google ক্লাউড সংস্থানগুলি ব্যবহার করার জন্য ক্লাউড কনসোলে বিলিং সক্ষম করুন ৷
যদিও এই কোডল্যাবটির জন্য খুব বেশি খরচ করা উচিত নয়, যদি কিছু থাকে তবে সংস্থানগুলি বন্ধ করতে এবং এই কোডল্যাবের বাইরে খরচ এড়াতে ক্লিন আপ বিভাগে নির্দেশাবলী অনুসরণ করুন৷ মনে রাখবেন যে Google ক্লাউডের নতুন ব্যবহারকারীরা US$300 বিনামূল্যে ট্রায়ালের জন্য যোগ্য৷
ক্লাউড শেল সেট আপ করুন
এই কোডল্যাবে, আপনি ক্লাউড শেল ব্যবহার করেন, একটি কমান্ড-লাইন পরিবেশ যা Google ক্লাউডে চলে। ক্লাউড শেল হল একটি ডেবিয়ান-ভিত্তিক ভার্চুয়াল মেশিন যা আপনার প্রয়োজনীয় সমস্ত ডেভেলপমেন্ট টুল দিয়ে লোড করা হয়েছে। এটি একটি ক্রমাগত 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 হল সেই ID যা আপনি সেটআপ ধাপে ব্যবহার করেছেন৷ আপনি ক্লাউড কনসোল ড্যাশবোর্ডেও এটি দেখতে পারেন:
ক্লাউড শেল ডিফল্টভাবে কিছু এনভায়রনমেন্ট ভেরিয়েবলও সেট করে, যা আপনি ভবিষ্যতে কমান্ড চালানোর সময় কার্যকর হতে পারে।
- আপনার প্রকল্প আইডি দেখতে, নিম্নলিখিত কমান্ড লিখুন।
echo $GOOGLE_CLOUD_PROJECT
আপনি নিম্নলিখিত আউটপুট দেখতে হবে:
<PROJECT_ID>
- অবশেষে, ডিফল্ট জোন এবং প্রকল্প কনফিগারেশন সেট করুন।
gcloud config set compute/zone us-central1-f
আপনি বিভিন্ন জোন বিভিন্ন চয়ন করতে পারেন. আরও তথ্যের জন্য, অঞ্চল এবং অঞ্চল দেখুন।
3. একটি প্রকল্প থেকে একটি API কল করুন
এই কোডল্যাবটি আপনাকে দেখায় কিভাবে একটি উদাহরণ API ( প্রাকৃতিক ভাষা API ) ব্যবহার করে টেক্সটে সত্তা (যেমন মানুষ, স্থান এবং ইভেন্ট) খুঁজে বের করতে হয় এবং কীভাবে সেই পাঠ্যের অনুভূতি (অনুকুলতার স্তর) আনুমানিক করা যায়। আপনি শিখবেন কিভাবে:
- Google ক্লাউড API সক্ষম করুন৷
- API কী এবং পরিষেবা অ্যাকাউন্ট সহ API-এর জন্য অনুমোদন পান।
-
curlএবং ক্লায়েন্ট লাইব্রেরি সহ API কল করুন।
একটি API সক্ষম করুন
- ক্লাউড কনসোলের প্রধান মেনু থেকে APIs এবং পরিষেবাগুলি নির্বাচন করুন৷
- পর্দার শীর্ষ থেকে APIS এবং পরিষেবাগুলি সক্রিয় করুন + নির্বাচন করুন৷
- এই মুহুর্তে, আপনি APIs ফিল্টার এবং ব্রাউজ করতে পারেন, অথবা অনুসন্ধান বাক্সের সাথে সরাসরি একটি API-তে যেতে পারেন।
Natural Languageজন্য অনুসন্ধান করুন এবং ক্লাউড ন্যাচারাল ল্যাঙ্গুয়েজ API নির্বাচন করুন।
- এই API ব্যবহার করে দেখুন ক্লিক করুন।
যদি দেখানো এই API বোতামটি চেষ্টা না করে থাকে, তবে সেই পদ্ধতিটি চেষ্টা করার জন্য তালিকাভুক্ত পদ্ধতিগুলির একটিতে ক্লিক করুন।
একটি API কী তৈরি করুন
যেহেতু আপনি ন্যাচারাল ল্যাঙ্গুয়েজ এপিআইতে একটি অনুরোধ পাঠাতে curl ব্যবহার করেন, তাই আপনার অনুরোধের URL পাস করার জন্য আপনাকে অবশ্যই একটি API কী তৈরি করতে হবে।
- ক্লাউড কনসোলে, নেভিগেশন মেনু > APIs এবং পরিষেবাগুলি > শংসাপত্র নির্বাচন করুন।
- ক্রিয়েট ক্রেডেনশিয়াল ক্লিক করুন এবং তারপরে API কী নির্বাচন করুন:
- উত্পন্ন API কী অনুলিপি করুন এবং তারপর বন্ধ করুন ক্লিক করুন।
API কল করতে API কী ব্যবহার করুন
- ক্লাউড শেল কমান্ড লাইনে, আপনার API কী রপ্তানি করুন।
export API_KEY=<YOUR_API_KEY>
<YOUR_API_KEY> আপনার পূর্বে তৈরি করা কী দিয়ে প্রতিস্থাপন করুন।
- ক্লাউড শেল এডিটরে বা লিনাক্স এডিটরের সাথে এপিআই-এর জন্য একটি অনুরোধ তৈরি করুন, যেমন Vim বা Emacs। আপনি পদ্ধতিতে প্যারামিটারের বিশদ বিবরণ পেতে পারেন: 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 ফাইলের আউটপুটের বিশদ বিবরণও পদ্ধতিতে রয়েছে: documents.analyzeEntities .
-
request.jsonফাইলে বিশ্লেষণ করার জন্য পাঠ্য পরিবর্তন করতে, আপনার পছন্দের পাঠ্যের সাথেcontentমান প্রতিস্থাপন করুন।
4. একটি পরিষেবা অ্যাকাউন্ট দিয়ে অনুমোদন করুন
পরিষেবা অ্যাকাউন্টগুলি প্রায়শই API কীগুলির চেয়ে পছন্দ করা হয় কারণ তারা প্রমাণীকরণ এবং অনুমোদন উভয়ই সরবরাহ করে। আপনি আপনার অ্যাপের ইমেল ঠিকানা হিসাবে পরিষেবা অ্যাকাউন্টগুলিকে ভাবতে পারেন৷
- APIs এবং পরিষেবা মেনুর শংসাপত্র বিভাগে ফিরে যান।
- শংসাপত্র তৈরি করুন নির্বাচন করুন, কিন্তু এই সময়, পরিষেবা অ্যাকাউন্ট নির্বাচন করুন।
- একটি পরিষেবা অ্যাকাউন্টের নাম প্রদান করুন যা এর উদ্দেশ্য বর্ণনা করে, যেমন "
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"
Google ক্লাউড শংসাপত্রগুলি খুঁজে পেতে এই পরিবেশ পরিবর্তনশীল ব্যবহার করে, তাই তাদের API কলে অন্তর্ভুক্ত করার প্রয়োজন নেই।
- আপনি এখন কমান্ড সহ API কল করতে পারেন:
gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."
ফলাফল আগের মতই হওয়া উচিত।
অনেক এপিআই-এর বিস্তৃত ক্লায়েন্ট লাইব্রেরি রয়েছে যা থেকে এই বিবরণগুলি বের করা যায়। ক্লায়েন্ট লাইব্রেরি সম্পর্কে আরও জানতে, ক্লাউড ক্লায়েন্ট লাইব্রেরি দেখুন। ক্লায়েন্ট লাইব্রেরিগুলি তাদের জন্য উপলব্ধ রয়েছে তা দেখতে আপনি যে APIগুলি ব্যবহার করেন তার ডকুমেন্টেশনগুলিও পড়তে পারেন৷
5. পরিষ্কার করুন
প্রকল্পের জন্য একটি সীমাবদ্ধ API কী থাকা খারাপ অভ্যাস । যদি কেউ এটিতে অ্যাক্সেস পায়, তবে সেই ব্যক্তি এটি ব্যবহার করতে পারবেন আর প্রমাণীকরণের প্রয়োজন নেই৷
এই API কী মুছে ফেলতে:
- ক্লিক করুন
নেভিগেশন মেনু > APIs এবং পরিষেবা > শংসাপত্র । - API কী এর অধীনে, মুছে ফেলার জন্য কী নির্বাচন করুন এবং তারপরে ক্লিক করুন
মুছুন । - একইভাবে, আপনার পরিষেবা অ্যাকাউন্টের ব্যক্তিগত কী অরক্ষিত হওয়ার বিষয়ে চিন্তা না করে, পরিষেবা অ্যাকাউন্টের অধীনে, মুছে ফেলার জন্য পরিষেবা অ্যাকাউন্টটি নির্বাচন করুন এবং তারপরে ক্লিক করুন মুছুন ।
6. অভিনন্দন
অভিনন্দন! আপনি শিখেছেন কিভাবে একটি Google ক্লাউড প্রকল্প তৈরি করতে হয় এবং কিভাবে প্রকল্পের মধ্যে থেকে একটি API কল করতে হয়।