OAuth ব্যবহার করুন

রোড ম্যানেজমেন্ট ইনসাইটস রোডস সিলেকশন এপিআইকে মূল উপাদান হিসেবে ব্যবহার করে যা বিগকুয়েরি এবং পাব/সাব-কে রোড ডেটা সরবরাহ করে।

রোডস সিলেকশন এপিআই প্রমাণীকরণের জন্য OAuth 2.0 ব্যবহার সমর্থন করে। গুগল ওয়েব সার্ভারের মতো সাধারণ OAuth 2.0 পরিস্থিতি সমর্থন করে।

এই ডকুমেন্টে আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে Roads Selection API কলে OAuth টোকেন কীভাবে পাস করবেন তা বর্ণনা করা হয়েছে। প্রোডাকশন এনভায়রনমেন্টে OAuth ব্যবহারের নির্দেশাবলীর জন্য, Google-এ Authentication দেখুন।

শুরু করার আগে

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

OAuth সম্পর্কে

আপনার স্থাপনার পরিবেশের উপর ভিত্তি করে OAuth ব্যবহার করে অ্যাক্সেস টোকেন তৈরি এবং পরিচালনা করার অনেক উপায় রয়েছে।

উদাহরণস্বরূপ, Google OAuth 2.0 সিস্টেম সার্ভার-টু-সার্ভার ইন্টারঅ্যাকশন সমর্থন করে, যেমন আপনার অ্যাপ্লিকেশন এবং একটি Google পরিষেবার মধ্যে। এই পরিস্থিতিতে আপনার একটি পরিষেবা অ্যাকাউন্ট প্রয়োজন, যা একটি অ্যাকাউন্ট যা কোনও পৃথক শেষ ব্যবহারকারীর পরিবর্তে আপনার অ্যাপ্লিকেশনের অন্তর্গত। আপনার অ্যাপ্লিকেশন পরিষেবা অ্যাকাউন্টের পক্ষে Google API গুলিকে কল করে, তাই ব্যবহারকারীরা সরাসরি জড়িত থাকে না। প্রমাণীকরণ পদ্ধতি সম্পর্কে আরও তথ্যের জন্য, Google-এ প্রমাণীকরণ দেখুন।

বিকল্পভাবে, আপনি একটি Android বা iOS মোবাইল অ্যাপের অংশ হিসেবে Roads Selection API ব্যবহার করতে পারেন। Roads Selection API-এর সাথে OAuth ব্যবহার সম্পর্কে সাধারণ তথ্যের জন্য, বিভিন্ন স্থাপনার পরিবেশের জন্য অ্যাক্সেস টোকেন পরিচালনার তথ্য সহ, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।

OAuth স্কোপ সম্পর্কে

Roads Selection API-এর সাথে OAuth ব্যবহার করতে, OAuth টোকেনটিকে অবশ্যই স্কোপ বরাদ্দ করতে হবে:

• https://www.googleapis.com/auth/cloud-platform

উদাহরণ: আপনার স্থানীয় ডেভেলপমেন্ট পরিবেশে REST API কল চেষ্টা করুন

যদি আপনি OAuth টোকেন ব্যবহার করে Roads Selection API ব্যবহার করে দেখতে চান, কিন্তু টোকেন তৈরি করার জন্য কোনও পরিবেশ সেটআপ না থাকে, তাহলে আপনি কল করার জন্য এই বিভাগের পদ্ধতিটি ব্যবহার করতে পারেন।

এই উদাহরণে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়ালস (ADC) দ্বারা প্রদত্ত OAuth টোকেনটি কীভাবে কল করতে হয় তা বর্ণনা করা হয়েছে। ক্লায়েন্ট লাইব্রেরি ব্যবহার করে Google API গুলিতে কল করার জন্য ADC ব্যবহার সম্পর্কে তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে প্রমাণীকরণ দেখুন।

পূর্বশর্ত

ADC ব্যবহার করে REST অনুরোধ করার আগে, ADC-কে শংসাপত্র প্রদান করতে Google Cloud CLI ব্যবহার করুন:

1. যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে একটি প্রকল্প তৈরি করুন এবং Google Cloud Console-এর "Set Up"- এর ধাপগুলি অনুসরণ করে বিলিং সক্ষম করুন।
2. gcloud CLI ইনস্টল এবং আরম্ভ করুন ।

3. আপনার ক্রেডেনশিয়াল ফাইল তৈরি করতে আপনার স্থানীয় মেশিনে নিম্নলিখিত gcloud কমান্ডটি চালান:

   gcloud auth application-default login

4. একটি লগইন স্ক্রিন প্রদর্শিত হবে। লগ ইন করার পরে, আপনার শংসাপত্রগুলি ADC দ্বারা ব্যবহৃত স্থানীয় শংসাপত্র ফাইলে সংরক্ষণ করা হবে।

আরও তথ্যের জন্য, অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রের জন্য শংসাপত্র প্রদান করুন ডকুমেন্টেশনের স্থানীয় উন্নয়ন পরিবেশ বিভাগটি দেখুন।

একটি REST অনুরোধ করুন

এই উদাহরণে, আপনি দুটি অনুরোধ শিরোনাম পাস করেছেন:

• টোকেন তৈরি করতে নিম্নলিখিত কমান্ড ব্যবহার করে Authorization হেডারে OAuth টোকেনটি পাস করুন:

  gcloud auth application-default print-access-token

  ফেরত দেওয়া টোকেনের একটি সুযোগ রয়েছে https://www.googleapis.com/auth/cloud-platform.

• X-Goog-User-Project হেডারে আপনার Google Cloud Project এর আইডি বা নাম লিখুন যেখানে বিলিং সক্ষম করা আছে। আরও জানতে, "Cloud Console এ সেট আপ করুন" দেখুন।

নিম্নলিখিত উদাহরণটি OAuth টোকেন ব্যবহার করে Roads Selection API-তে কল করে:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID

সমস্যা সমাধান

যদি আপনার অনুরোধটি এই API দ্বারা সমর্থিত নয় এমন শেষ-ব্যবহারকারী শংসাপত্র সম্পর্কে একটি ত্রুটি বার্তা ফেরত দেয়, তাহলে ব্যবহারকারী শংসাপত্র কাজ করছে না দেখুন।