Google Maps Platform প্রোডাক্টের অননুমোদিত ব্যবহার আটকাতে Google, API কলকে শুধুমাত্র সেইসব কলের মধ্যে সীমাবদ্ধ রাখে যেগুলি সঠিক যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান করে। এই ক্রেডেনশিয়াল API কী-এর ফর্ম নেয়, যা হল একটি অনন্য আলফানিউমেরিক স্ট্রিং যা আপনার Google বিলিং অ্যাকাউন্টকে আপনার প্রোজেক্ট এবং নির্দিষ্ট API বা SDK-এর সাথে যুক্ত করে।
এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে Google Maps Platform-এর জন্য API কী তৈরি, সীমাবদ্ধ ও ব্যবহার করতে হয়।
API key তৈরি করুন
API কী হল একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিংয়ের উদ্দেশ্যে আপনার প্রোজেক্টের সাথে সম্পর্কিত অনুরোধগুলি যাচাই করে। আপনার প্রোজেক্টের সাথে অন্তত একটি API কী যুক্ত থাকতে হবে। নতুন 'কী' তৈরি করতে অথবা আগে থেকে থাকা 'কী'-তে API বা SDK যোগ করতে, এইসব নির্দেশাবলী অনুসরণ করুন।
কনসোল
-
Google Maps Platform > কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান।
- প্রম্পট করা হলে, আপনার প্রোজেক্ট বেছে নিন।
-
নিম্নলিখিতগুলির মধ্যে থেকে যেকোনও একটি করুন:
-
নতুন 'কী' তৈরি করুন:
- ক্রেডেনশিয়াল তৈরি করুন > API key বিকল্পে ক্লিক করুন।
- API key তৈরি করুন প্যানেলে, API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা খুলুন।
- এই 'কী'-এর প্রয়োজন নেই এমন যেকোনও API মুছে দিন এবং নিশ্চিত করুন যে লোকেশন বেছে নেওয়ার API বেছে নেওয়া আছে।
- তৈরি করুন বিকল্পে ক্লিক করুন। প্যানেলে আপনার নতুন API কী দেখা যাবে।
-
আগে থেকে থাকা 'কী' ব্যবহার করুন:
- 'কী'-এর নামে ক্লিক করুন।
- API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা থেকে, লোকেশন বেছে নেওয়ার API বেছে নিন।
- সেভ করুন বিকল্পে ক্লিক করুন।
এখানে API বেছে নিলে তা চালু হয় না। নিশ্চিত করুন যে Location Selection API এর API লাইব্রেরি পৃষ্ঠায় চালু করা আছে।
-
- পরে কী স্ট্রিং দেখতে, কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান এবং কী-এর জন্য কী দেখুন বিকল্পে ক্লিক করুন।
কনসোলটি যদি এই ধাপগুলির থেকে আলাদা দেখায়, তাহলে Google Cloud ডকুমেন্টেশনে একটি API কী তৈরি করুন এবং API বিধিনিষেধ যোগ করুন দেখুন।
gcloud
নিচের কমান্ডে PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন।
-
নতুন 'কী' তৈরি করুন: নিম্নলিখিত কমান্ড রান করুন এবং DISPLAY_NAME-এর জায়গায় 'কী'-এর নাম লিখুন।
gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=locationselection.googleapis.com
Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:
-
আগে থেকে থাকা 'কী' ব্যবহার করুন: নিম্নলিখিত কমান্ড রান করুন এবং KEY_ID-এর জায়গায় 'কী'-এর আইডি লিখুন।
--appendফ্ল্যাগ সেইসব API রাখে যেগুলি 'কী' আগে থেকেই অনুমোদন করে। এটি না থাকলে, কমান্ডটি সেগুলি পরিবর্তন করে।gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=locationselection.googleapis.com
Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:
'কী' আইডি হল 'কী' স্ট্রিং বা ডিসপ্লে নাম নয়। এটি খুঁজতে,
gcloud services api-keys list --project="PROJECT_ID"রান করুন। আইডি হলnameফিল্ডের শেষ অংশ:projects/PROJECT_NUMBER/locations/global/keys/KEY_ID।
কী স্ট্রিং দেখতে,
gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID" রান করুন।
API কী-তে বিধিনিষেধ আরোপ করা
Google আপনাকে API কী-এর ব্যবহার সীমিত করার জন্য জোরালোভাবে সাজেস্ট করে। আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় API-এর ক্ষেত্রেই শুধু API কী-এর ব্যবহার সীমিত করুন। API কী সীমাবদ্ধ করলে, আপনার অ্যাপ্লিকেশনকে অযাচিত অনুরোধ থেকে রক্ষা করে সুরক্ষা প্রদান করে। সীমাবদ্ধতা নেই এমন API কী অপব্যবহারের কারণে হওয়া চার্জের জন্য আপনি আর্থিকভাবে দায়বদ্ধ। আরও তথ্যের জন্য, API নিরাপত্তা সংক্রান্ত পেশাদার পদ্ধতি দেখুন।
API key-তে বিধিনিষেধ আরোপ করতে:
কনসোল
-
Google Maps Platform > কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান।
- আপনি যে API কী-তে বিধিনিষেধ আরোপ করতে চান সেটি বেছে নিন। API key প্রপার্টি পৃষ্ঠা দেখতে পাবেন।
- মূল বিধিনিষেধ বিকল্পের অধীনে, নিম্নলিখিত বিধিনিষেধ সেট করুন:
- অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধ:
- আপনার দেওয়া ওয়েব সার্ভার IP অ্যাড্রেসের তালিকা থেকে অনুরোধ গ্রহণ করতে, অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধ বিকল্পের মধ্যে থেকে IP অ্যাড্রেস বেছে নিন। এক বা একাধিক IPv4 বা IPv6 অ্যাড্রেস, অথবা CIDR নোটেশন ব্যবহার করে সাবনেট উল্লেখ করুন। IP অ্যাড্রেস অবশ্যই Google Maps Platform সার্ভার যে সোর্স অ্যাড্রেস পর্যবেক্ষণ করে তার সাথে মিলতে হবে। আপনি যদি নেটওয়ার্ক অ্যাড্রেস ট্রান্সলেশন (NAT) ব্যবহার করেন, তাহলে এটি সাধারণত আপনার মেশিনের পাবলিক IP অ্যাড্রেসের সাথে মিলে যাবে।
- API সংক্রান্ত বিধিনিষেধ:
- API সংক্রান্ত বিধিনিষেধ বেছে নিন বিকল্পে, লোকেশন বেছে নেওয়ার API বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন। এটি তালিকাভুক্ত না থাকলে, আপনাকে এটি চালু করতে হবে।
- আপনার করা পরিবর্তন চূড়ান্ত করতে, সেভ করুন বিকল্পে ক্লিক করুন।
gcloud
নিম্নলিখিত কমান্ড রান করুন। KEY_ID-এর জায়গায় 'কী'-এর আইডি এবং
PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন। কী আইডি খুঁজতে,
gcloud services api-keys list --project="PROJECT_ID" রান করুন। আইডি হল
name ফিল্ডের
শেষ অংশ।
gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=locationselection.googleapis.com \ --allowed-ips="IP_ADDRESS"
Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:
আপনার অনুরোধে API key যোগ করুন
প্রতিটি লোকেশন সিলেকশন API অনুরোধের সাথে আপনাকে অবশ্যই একটি API কী অন্তর্ভুক্ত করতে হবে। নিচের উদাহরণে,
YOUR_API_KEY-এর জায়গায় আপনার API key লিখুন:
https://locationselection.googleapis.com/v1beta:findNearbyPlaces?&key=YOUR_API_KEY
API কী ব্যবহার করে এমন অনুরোধের জন্য আপনাকে অবশ্যই HTTPS ব্যবহার করতে হবে।