যাচাইকরণের জন্য Map Management API, OAuth 2.0 ব্যবহার করা যায়। Google সাধারণ OAuth 2.0 দৃশ্যপট যেমন ওয়েব সার্ভারের জন্য দৃশ্যপট সমর্থন করে৷
আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে Map Management API কলে কীভাবে OAuth টোকেন পাস করতে হয় তা এই ডকুমেন্টে বর্ণনা করা হয়েছে। প্রোডাকশন এনভায়রনমেন্টে OAuth ব্যবহার করার নির্দেশাবলীর জন্য, Google-এ যাচাইকরণ দেখুন।
শুরু করার আগে
Map Management API ব্যবহার শুরু করার আগে, আপনার বিলিং অ্যাকাউন্ট সহ একটি প্রজেক্ট এবং Map Management API চালু থাকতে হবে। আমরা একাধিক প্রোজেক্ট মালিক ও বিলিং অ্যাডমিনিস্ট্রেটর তৈরি করার সাজেশন দিই, যাতে আপনার টিমের কাছে সবসময় এই রোল উপলভ্য থাকে। আরও জানতে, Cloud Console-এ সেট-আপ করুন দেখুন।
OAuth সম্পর্কে
আপনার ডিপ্লয়মেন্ট এনভায়রনমেন্টের উপর ভিত্তি করে OAuth-এর মাধ্যমে অ্যাক্সেস টোকেন তৈরি ও ম্যানেজ করার অনেক উপায় আছে।
যেমন, Google OAuth 2.0 সিস্টেম, আপনার অ্যাপ্লিকেশন ও Google পরিষেবার মধ্যেকার ইন্টার্যাকশনের মতো সার্ভার-টু-সার্ভার ইন্টার্যাকশন কাজ করে। এই পরিস্থিতির জন্য আপনার একটি পরিষেবা অ্যাকাউন্ট প্রয়োজন, যা কোনও ব্যক্তিগত ব্যবহারকারীর পরিবর্তে আপনার অ্যাপ্লিকেশনের সাথে সম্পর্কিত অ্যাকাউন্ট। আপনার অ্যাপ্লিকেশন পরিষেবা অ্যাকাউন্টের হয়ে Google API কল করে, তাই ব্যবহারকারীরা সরাসরি এতে যুক্ত থাকেন না। যাচাইকরণ পদ্ধতি সম্পর্কে আরও জানতে, Google-এ যাচাইকরণ দেখুন।
বিকল্প হিসেবে, আপনি Android বা iOS মোবাইল অ্যাপের অংশ হিসেবে Map Management API ব্যবহার করতে পারেন। বিভিন্ন ডেপ্লয়মেন্ট এনভায়রনমেন্টের জন্য অ্যাক্সেস টোকেন ম্যানেজ করা সহ Map Management API-এর সাথে OAuth ব্যবহার করার ব্যাপারে সাধারণ তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
OAuth স্কোপ সম্পর্কে
Map Management API-এর সাথে OAuth ব্যবহার করতে, OAuth টোকেনকে এই স্কোপ অ্যাসাইন করতে হবে:
https://www.googleapis.com/auth/cloud-platform
যেমন: আপনার লোকাল ডেভেলপমেন্ট এনভায়রনমেন্টে REST API কল করে দেখুন
আপনি যদি OAuth টোকেন ব্যবহার করে Map Management API ব্যবহার করে দেখতে চান, কিন্তু টোকেন জেনারেট করার জন্য কোনও এনভায়রনমেন্ট সেট-আপ না থাকে, তাহলে কল করার জন্য এই বিভাগে দেওয়া পদ্ধতি ব্যবহার করতে পারেন।
এই উদাহরণে কল করার জন্য অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) থেকে পাওয়া OAuth টোকেন কীভাবে ব্যবহার করতে হয় তা বর্ণনা করা হয়েছে। ক্লায়েন্ট লাইব্রেরি ব্যবহার করে Google API কল করার জন্য ADC ব্যবহার করা সম্পর্কে তথ্য পেতে, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে যাচাইকরণ করা দেখুন।
পূর্বশর্ত
ADC ব্যবহার করে REST অনুরোধ করার আগে, ADC-কে ক্রেডেনশিয়াল প্রদান করতে Google Cloud CLI ব্যবহার করুন:
- আপনি আগে থেকে না করে থাকলে, Google Cloud Console-এ সেট-আপ করুন লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করে একটি প্রোজেক্ট তৈরি করুন এবং বিলিং চালু করুন।
- gcloud CLI ইনস্টল ও ইনিশিয়ালাইজ করুন।
আপনার ক্রেডেনশিয়াল ফাইল তৈরি করতে লোকাল মেশিনে নিম্নলিখিত
gcloudকমান্ড রান করুন:gcloud auth application-default login
- লগ-ইন স্ক্রিন দেখানো হয়। আপনি লগ-ইন করার পরে, আপনার ক্রেডেনশিয়াল ADC-এর ব্যবহার করা লোকাল ক্রেডেনশিয়াল ফাইলে স্টোর করা হয়।
আরও তথ্যের জন্য, অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়ালের জন্য ক্রেডেনশিয়াল প্রদান করুন ডকুমেন্টেশনের লোকাল ডেভেলপমেন্ট এনভায়রনমেন্ট বিভাগ দেখুন।
REST অনুরোধ করা
এই উদাহরণে, আপনি দুটি অনুরোধ হেডার পাস করেছেন:
টোকেন জেনারেট করতে নিম্নলিখিত কমান্ড ব্যবহার করে
Authorizationহেডারে OAuth টোকেন পাস করুন:gcloud auth application-default print-access-tokenফেরত পাঠানো টোকেনের স্কোপ হল
https://www.googleapis.com/auth/cloud-platform.X-Goog-User-Projectহেডার -এ বিলিং চালু আছে এমন Google Cloud প্রোজেক্টের আইডি বা নাম পাস করুন। আরও জানতে, Cloud Console-এ সেট-আপ করুন বিকল্প দেখুন।
নিচের উদাহরণে OAuth টোকেন ব্যবহার করে Map Management API-তে কল করা হয়েছে:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ https://mapmanagement.googleapis.com/v2beta/projects/PROJECT_NUMBER_OR_ID/mapConfigs/
সমস্যার সমাধান
আপনার অনুরোধের উত্তরে যদি এই API-তে গ্রাহকের ক্রেডেনশিয়াল কাজ করছে না বলে কোনও সমস্যার মেসেজ দেখানো হয়, তাহলে ব্যবহারকারীর ক্রেডেনশিয়াল কাজ করছে না দেখুন।