ঠিকানা যাচাইকরণ API প্রমাণীকরণের জন্য OAuth 2.0 ব্যবহার সমর্থন করে। Google সাধারণ OAuth 2.0 পরিস্থিতি সমর্থন করে যেমন একটি ওয়েব সার্ভারের জন্য।
আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে অ্যাড্রেস ভ্যালিডেশন এপিআই কলে কীভাবে একটি OAuth টোকেন পাস করবেন তা এই ডকুমেন্টটি বর্ণনা করে। উৎপাদন পরিবেশে OAuth ব্যবহার করার নির্দেশাবলীর জন্য, Google-এ প্রমাণীকরণ দেখুন।
তুমি শুরু করার আগে
আপনি ঠিকানা যাচাইকরণ API ব্যবহার শুরু করার আগে, আপনার একটি বিলিং অ্যাকাউন্ট এবং ঠিকানা যাচাইকরণ API সক্ষম সহ একটি প্রকল্প প্রয়োজন৷ আমরা একাধিক প্রকল্পের মালিক এবং বিলিং অ্যাডমিনিস্ট্রেটর তৈরি করার পরামর্শ দিই, যাতে আপনার দলের কাছে এই ভূমিকাগুলির সাথে আপনার কাছে সর্বদা উপলব্ধ কেউ থাকে। আরও জানতে, ক্লাউড কনসোলে সেট আপ দেখুন।
OAuth সম্পর্কে
আপনার স্থাপনার পরিবেশের উপর ভিত্তি করে OAuth এর সাথে অ্যাক্সেস টোকেন তৈরি এবং পরিচালনা করার অনেক উপায় রয়েছে।
উদাহরণস্বরূপ, Google OAuth 2.0 সিস্টেম সার্ভার-টু-সার্ভার ইন্টারঅ্যাকশন সমর্থন করে, যেমন আপনার অ্যাপ্লিকেশন এবং একটি Google পরিষেবার মধ্যে। এই দৃশ্যের জন্য আপনার একটি পরিষেবা অ্যাকাউন্টের প্রয়োজন, যা একটি অ্যাকাউন্ট যা আপনার অ্যাপ্লিকেশনের অন্তর্গত একটি স্বতন্ত্র ব্যবহারকারীর পরিবর্তে। আপনার অ্যাপ্লিকেশন পরিষেবা অ্যাকাউন্টের হয়ে Google API-কে কল করে, তাই ব্যবহারকারীরা সরাসরি জড়িত নয়৷ প্রমাণীকরণ পদ্ধতি সম্পর্কে আরও তথ্যের জন্য, Google-এ প্রমাণীকরণ দেখুন।
বিকল্পভাবে, আপনি Android বা iOS মোবাইল অ্যাপের অংশ হিসেবে ঠিকানা যাচাইকরণ API ব্যবহার করতে পারেন। বিভিন্ন স্থাপনার পরিবেশের জন্য অ্যাক্সেস টোকেন পরিচালনার তথ্য সহ ঠিকানা যাচাইকরণ API এর সাথে OAuth ব্যবহার করার বিষয়ে সাধারণ তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
OAuth স্কোপ সম্পর্কে
ঠিকানা যাচাইকরণ API এর সাথে OAuth ব্যবহার করতে, OAuth টোকেনকে অবশ্যই সুযোগ বরাদ্দ করতে হবে:
-
https://www.googleapis.com/auth/cloud-platform
উদাহরণ: আপনার স্থানীয় উন্নয়ন পরিবেশে REST API কলগুলি ব্যবহার করে দেখুন
আপনি যদি একটি OAuth টোকেন ব্যবহার করে ঠিকানা যাচাইকরণ API ব্যবহার করে দেখতে চান, কিন্তু টোকেন তৈরি করার জন্য একটি পরিবেশ সেটআপ না থাকলে, আপনি কল করার জন্য এই বিভাগে পদ্ধতিটি ব্যবহার করতে পারেন।
এই উদাহরণটি বর্ণনা করে কিভাবে কল করার জন্য অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) দ্বারা প্রদত্ত OAuth টোকেন ব্যবহার করতে হয়। ক্লায়েন্ট লাইব্রেরি ব্যবহার করে Google API কল করার জন্য ADC ব্যবহার সম্পর্কে তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে প্রমাণীকরণ দেখুন।
পূর্বশর্ত
আপনি ADC ব্যবহার করে একটি REST অনুরোধ করার আগে, ADC-কে শংসাপত্র প্রদান করতে Google Cloud CLI ব্যবহার করুন:
- যদি আপনি ইতিমধ্যেই না করে থাকেন, একটি প্রকল্প তৈরি করুন এবং Google ক্লাউড কনসোলে সেট আপ করার ধাপগুলি অনুসরণ করে বিলিং সক্ষম করুন৷
- 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.- আপনার Google ক্লাউড প্রকল্পের আইডি বা নাম পাস করুন যেটিতে
X-Goog-User-Projectহেডারে বিলিং সক্ষম করা আছে। আরও জানতে, ক্লাউড কনসোলে সেট আপ দেখুন।
নিম্নলিখিত উদাহরণটি একটি OAuth টোকেন ব্যবহার করে ঠিকানা যাচাইকরণ API এ একটি কল করে:
curl -X POST -d '{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"addressLines": ["1600 Amphitheatre Pkwy"]
}
}' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://addressvalidation.googleapis.com/v1:validateAddress"
সমস্যা সমাধান
যদি আপনার অনুরোধটি শেষ-ব্যবহারকারীর শংসাপত্রগুলি এই API দ্বারা সমর্থিত না হওয়ার বিষয়ে একটি ত্রুটি বার্তা ফেরত দেয়, তাহলে ব্যবহারকারীর শংসাপত্রগুলি কাজ করছে না দেখুন।