পরাগ API এর সাথে API কী ব্যবহার করুন

Google মানচিত্র প্ল্যাটফর্ম পণ্যগুলি যথাযথ প্রমাণীকরণ শংসাপত্র প্রদান করে এমন API কলগুলিকে সীমাবদ্ধ করে অননুমোদিত ব্যবহার থেকে সুরক্ষিত। এই শংসাপত্রগুলি একটি API কী আকারে রয়েছে - একটি অনন্য আলফানিউমেরিক স্ট্রিং যা আপনার প্রকল্পের সাথে এবং নির্দিষ্ট API বা SDK এর সাথে আপনার Google বিলিং অ্যাকাউন্টকে সংযুক্ত করে৷

এই গাইডটি দেখায় কিভাবে Google Maps প্ল্যাটফর্মের জন্য আপনার API কী তৈরি, সীমাবদ্ধ এবং ব্যবহার করতে হয়।

আপনি শুরু করার আগে: আপনি পরাগ API ব্যবহার শুরু করার আগে, আপনার একটি বিলিং অ্যাকাউন্ট সহ একটি প্রকল্প প্রয়োজন এবং পরাগ API সক্রিয় আমরা একাধিক প্রকল্পের মালিক এবং বিলিং অ্যাডমিনিস্ট্রেটর তৈরি করার পরামর্শ দিই, যাতে আপনার দলের কাছে এই ভূমিকাগুলির সাথে আপনার কাছে সর্বদা উপলব্ধ কেউ থাকে। আরও জানতে, ক্লাউড কনসোলে সেট আপ দেখুন।

API কী তৈরি করা হচ্ছে

API কী একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিং উদ্দেশ্যে আপনার প্রকল্পের সাথে যুক্ত অনুরোধগুলিকে প্রমাণীকরণ করে৷ আপনার প্রোজেক্টের সাথে যুক্ত অন্তত একটি API কী থাকতে হবে।

একটি API কী তৈরি করতে:

কনসোল

1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

   শংসাপত্র পৃষ্ঠায় যান

2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
   API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
3. Close এ ক্লিক করুন।
   নতুন API কী API কী-এর অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
   (এটি উত্পাদনে ব্যবহার করার আগে API কী সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

• gcloud alpha services api-keys create

API কী সীমাবদ্ধ করা হচ্ছে

Google দৃঢ়ভাবে সুপারিশ করে যে আপনি আপনার এপিআই কীগুলির ব্যবহার সীমিত করে শুধুমাত্র আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় API গুলিকে সীমাবদ্ধ করুন৷ এপিআই কীগুলিকে সীমাবদ্ধ করা আপনার অ্যাপ্লিকেশানটিকে অনাকাঙ্ক্ষিত অনুরোধ থেকে রক্ষা করে নিরাপত্তা যোগ করে। আরও তথ্যের জন্য, API নিরাপত্তার সর্বোত্তম অনুশীলন দেখুন।

ক্লাউড কনসোলে একটি API কী সীমাবদ্ধ করার সময়, অ্যাপ্লিকেশন বিধিনিষেধগুলি API বিধিনিষেধের অধীনে সক্ষম করা যেকোনো APIকে ওভাররাইড করে। প্রতিটি অ্যাপের জন্য এবং সেই অ্যাপটি উপলব্ধ প্রতিটি প্ল্যাটফর্মের জন্য একটি পৃথক API কী তৈরি করে সর্বোত্তম অনুশীলনগুলি অনুসরণ করুন।

একটি API কী সীমাবদ্ধ করতে:

কনসোল

1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

   শংসাপত্র পৃষ্ঠায় যান

2. আপনি একটি সীমাবদ্ধতা সেট করতে চান এমন API কী নির্বাচন করুন। API কী প্রপার্টি পৃষ্ঠাটি প্রদর্শিত হবে।
3. কী সীমাবদ্ধতার অধীনে, নিম্নলিখিত সীমাবদ্ধতাগুলি সেট করুন:
• আবেদন বিধিনিষেধ:
1. আপনার সরবরাহ করা ওয়েব সার্ভারের আইপি ঠিকানাগুলির তালিকা থেকে অনুরোধগুলি গ্রহণ করতে, অ্যাপ্লিকেশন বিধিনিষেধের তালিকা থেকে আইপি ঠিকানাগুলি (ওয়েব সার্ভার, ক্রোন কাজ, ইত্যাদি) নির্বাচন করুন। CIDR স্বরলিপি ব্যবহার করে এক বা একাধিক IPv4 বা IPv6 ঠিকানা, বা সাবনেট নির্দিষ্ট করুন৷ আইপি ঠিকানাগুলি অবশ্যই Google মানচিত্র প্ল্যাটফর্ম সার্ভারগুলি পর্যবেক্ষণ করে উৎস ঠিকানার সাথে মেলে। আপনি নেটওয়ার্ক ঠিকানা অনুবাদ (NAT) ব্যবহার করলে, এটি সাধারণত আপনার মেশিনের সর্বজনীন IP ঠিকানার সাথে মিলিত হবে।
• API সীমাবদ্ধতা:
1. সীমাবদ্ধ কী ক্লিক করুন।
2. Select APIs ড্রপডাউন থেকে Pollen API নির্বাচন করুন। যদি পরাগ API তালিকাভুক্ত না হয়, তাহলে আপনাকে এটি সক্ষম করতে হবে।
4. আপনার পরিবর্তনগুলি চূড়ান্ত করতে, সংরক্ষণ করুন ক্লিক করুন।
   

ক্লাউড SDK

বিদ্যমান কী তালিকাভুক্ত করুন।

gcloud services api-keys list --project="PROJECT"

বিদ্যমান কী-তে বিদ্যমান বিধিনিষেধ সাফ করুন।

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

বিদ্যমান কীতে নতুন সীমাবদ্ধতা সেট করুন।

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="pollen.googleapis.com"
    --allowed-ips="IP_ADDRESS"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

আপনার অনুরোধে API কী যোগ করা হচ্ছে

প্রতিটি পরাগ API অনুরোধের সাথে আপনাকে অবশ্যই একটি API কী অন্তর্ভুক্ত করতে হবে। নিম্নলিখিত উদাহরণে, আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন।

https://pollen.googleapis.com/v1/forecast:lookup?key= YOUR_API_KEY

একটি API কী ব্যবহার করে এমন অনুরোধের জন্য HTTPS প্রয়োজন।

দ্রষ্টব্য: ওয়েব পরিষেবাগুলি ব্যবহার করার সময়, প্যারামিটারের ভিতরে সমস্ত বিশেষ অক্ষর অবশ্যই URL এনকোড করা উচিত। ইউআরএলগুলিকে বৈধ হওয়ার জন্য সঠিকভাবে এনকোড করা আবশ্যক এবং সমস্ত ওয়েব পরিষেবার জন্য 2048 অক্ষরের মধ্যে সীমাবদ্ধ। আপনার URL গুলি তৈরি করার সময় এই সীমা সম্পর্কে সচেতন থাকুন৷ বিভিন্ন ব্রাউজার, প্রক্সি এবং সার্ভারের আলাদা আলাদা ইউআরএল অক্ষর সীমাও থাকতে পারে।