এগিয়ে যাওয়ার জন্য, নিশ্চিত করুন যে আপনি পূর্বশর্তগুলিতে উল্লিখিত ধাপগুলি সম্পন্ন করেছেন এবং আমরা বিজনেস প্রোফাইল এপিআই অ্যাক্সেসের জন্য আপনার প্রকল্পটি অনুমোদন করেছি।
এপিআইগুলি সক্রিয় করুন
বিজনেস প্রোফাইলের সাথে যুক্ত সাতটি এপিআই (API) রয়েছে, যেগুলো গুগল ক্লাউড কনসোলে অবশ্যই সক্রিয় করতে হবে:
- গুগল মাই বিজনেস এপিআই
- আমার ব্যবসায়িক অ্যাকাউন্ট ম্যানেজমেন্ট এপিআই
- আমার ব্যবসায়িক আবাসন এপিআই
- আমার ব্যবসার স্থান কর্ম এপিআই
- আমার ব্যবসার বিজ্ঞপ্তি এপিআই
- আমার ব্যবসায়িক যাচাইকরণ এপিআই
- আমার ব্যবসা ব্যবসায়িক তথ্য এপিআই
একটি API সক্রিয় করুন
যদি আপনি সমস্ত পূর্বশর্ত পূরণ করে থাকেন এবং এপিআই (API)-তে অ্যাক্সেস পেয়ে থাকেন, কিন্তু তারপরেও প্রদত্ত শর্টকাটটি ব্যবহার করতে না পারেন, তাহলে আপনি নিম্নলিখিত ধাপগুলো অনুসরণ করে ম্যানুয়ালি এপিআই (API) সক্রিয় করতে পারেন।
আপনার প্রোজেক্টের জন্য একটি API সক্রিয় করতে, নিম্নলিখিতগুলি করুন:
- গুগল এপিআই কনসোলে এপিআই লাইব্রেরি খুলুন । অনুরোধ করা হলে, একটি প্রজেক্ট নির্বাচন করুন অথবা একটি নতুন প্রজেক্ট তৈরি করুন। এপিআই লাইব্রেরিতে প্রোডাক্ট ফ্যামিলি এবং জনপ্রিয়তা অনুসারে শ্রেণীবদ্ধ করে সমস্ত উপলব্ধ এপিআই-এর তালিকা দেওয়া থাকে।
- আপনি যে API-টি সক্রিয় করতে চান তা যদি তালিকায় না থাকে, তবে সেটি খুঁজে পেতে সার্চ ব্যবহার করুন।
- যে API-টি সক্রিয় করতে চান, সেটি নির্বাচন করুন, তারপর ' Enable' বোতামে ক্লিক করুন।
- অনুরোধ করা হলে, বিলিং চালু করুন।
- অনুরোধ করা হলে, এপিআই-এর পরিষেবার শর্তাবলী গ্রহণ করুন।
আপনি যদি একজন গুগল ওয়ার্কস্পেস ব্যবহারকারী হন, তাহলে আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনে আপনার অ্যাকাউন্টের জন্য গুগল বিজনেস প্রোফাইল চালু আছে কিনা তা নিশ্চিত করুন। আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনে আপনার অ্যাকাউন্টের জন্য গুগল বিজনেস প্রোফাইল বন্ধ থাকলে, জিবিপি এপিআই (GBP APIs) ব্যবহার করার সময় আপনি `error 403 - PERMISSION DENIED` পাবেন।
একটি OAuth 2.0 ক্লায়েন্ট আইডি অনুরোধ করুন
যেহেতু আপনার অ্যাপ সুরক্ষিত, অপ্রকাশ্য ডেটা অ্যাক্সেস করে, তাই আপনার একটি OAuth 2.0 ক্লায়েন্ট আইডি প্রয়োজন। এটি আপনার অ্যাপকে তার ব্যবহারকারীদের পক্ষ থেকে আপনার প্রতিষ্ঠানের লোকেশন ডেটা অ্যাক্সেস করার জন্য অনুমোদনের অনুরোধ করতে দেয়।
আপনার অ্যাপ্লিকেশনকে অবশ্যই এমন যেকোনো বিজনেস প্রোফাইল এপিআই অনুরোধের সাথে একটি OAuth 2.0 টোকেন পাঠাতে হবে, যা ব্যবহারকারীর ব্যক্তিগত তথ্য অ্যাক্সেস করে।
যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে Google Cloud কনসোলের "Credentials" বিভাগে যান এবং আপনার OAuth 2.0 ক্রেডেনশিয়াল তৈরি করতে Create credentials > OAuth client ID-তে ক্লিক করুন। ক্রেডেনশিয়াল তৈরি করার পরে, আপনি Credentials পৃষ্ঠায় আপনার ক্লায়েন্ট আইডি দেখতে পাবেন। ক্লায়েন্ট সিক্রেট, রিডাইরেক্ট ইউআরআই, জাভাস্ক্রিপ্ট অরিজিনস অ্যাড্রেস এবং ইমেল অ্যাড্রেসের মতো বিবরণ জানতে ক্লায়েন্ট আইডিতে ক্লিক করুন।
REST-এর প্রাথমিক বিষয়গুলো শিখুন
এপিআইগুলো কল করার দুটি উপায় আছে:
- একটি HTTP অনুরোধ পাঠান এবং প্রতিক্রিয়াগুলো পার্স করুন।
- ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন।
আপনি যদি ক্লায়েন্ট লাইব্রেরি ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে REST-এর মৌলিক বিষয়গুলো বুঝতে হবে।
REST হলো এক ধরনের সফটওয়্যার আর্কিটেকচার যা ডেটা অনুরোধ এবং পরিবর্তন করার জন্য একটি সুবিধাজনক ও সামঞ্জস্যপূর্ণ পদ্ধতি প্রদান করে।
REST শব্দটি " REST " (Representational State Transfer)-এর সংক্ষিপ্ত রূপ। গুগল এপিআই-এর প্রেক্ষাপটে, এটি গুগল দ্বারা সংরক্ষিত ডেটার উপস্থাপনা পুনরুদ্ধার এবং পরিবর্তন করার জন্য HTTP ভার্ব ব্যবহারের প্রক্রিয়াকে বোঝায়।
একটি RESTful সিস্টেম ডেটাস্টোরে রিসোর্স সংরক্ষণ করে। একজন ক্লায়েন্ট কোনো নির্দিষ্ট কাজ, যেমন কোনো রিসোর্স তৈরি, পুনরুদ্ধার, আপডেট বা মুছে ফেলার জন্য সার্ভারকে একটি অনুরোধ পাঠায় এবং সার্ভার সেই কাজটি সম্পাদন করে একটি প্রতিক্রিয়া পাঠায়। সেই প্রতিক্রিয়াটি প্রায়শই নির্দিষ্ট রিসোর্সটির একটি উপস্থাপনার আকারে থাকে।
গুগলের RESTful API-গুলোতে, ক্লায়েন্ট GET , POST , PUT বা DELETE এর মতো একটি HTTP ভার্ব ব্যবহার করে কোনো অ্যাকশন নির্দিষ্ট করে। ক্লায়েন্ট নিম্নলিখিত ফর্ম্যাটের একটি বিশ্বব্যাপী অনন্য ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (URI) দ্বারা একটি রিসোর্স নির্দিষ্ট করে:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
যেহেতু সমস্ত API রিসোর্সের অনন্য HTTP-অ্যাক্সেসযোগ্য URI থাকে, REST ডেটা ক্যাশিং সক্ষম করে এবং ওয়েবের ডিস্ট্রিবিউটেড ইনফ্রাস্ট্রাকচারের সাথে কাজ করার জন্য অপ্টিমাইজ করা থাকে।
HTTP 1.1 স্ট্যান্ডার্ড ডকুমেন্টেশনে থাকা মেথড ডেফিনিশনগুলো আপনার কাজে লাগতে পারে। সেগুলোতে GET , POST , PUT এবং DELETE এর স্পেসিফিকেশন অন্তর্ভুক্ত রয়েছে।
বিজনেস প্রোফাইল এপিআই-তে REST
বিজনেস প্রোফাইল এপিআই-এর অপারেশনগুলো সরাসরি REST HTTP ভার্বগুলোর সাথে ম্যাপ করা থাকে।
বিজনেস প্রোফাইল এপিআই-এর নির্দিষ্ট ফরম্যাটটি নিম্নলিখিত ইউআরআই-তে দেখানো হয়েছে:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
এপিআই-এর প্রতিটি সমর্থিত অপারেশনের জন্য ব্যবহৃত ইউআরআই-এর সম্পূর্ণ সেট বিজনেস প্রোফাইল এপিআই রেফারেন্স ডকুমেন্টেশনে পাওয়া যাবে।
এন্ডপয়েন্টের উপর ভিত্তি করে রিসোর্স পাথ ভিন্ন হয়।
উদাহরণস্বরূপ, একটি অ্যাকাউন্টের রিসোর্স পাথটি নিম্নলিখিত উদাহরণের মতো দেখায়:
accounts/accountId
কোনো অবস্থানের রিসোর্স পাথটি নিম্নলিখিত আকারে প্রদর্শিত হয়:
locations/locationId
JSON-এর প্রাথমিক বিষয়গুলো শিখুন
বিজনেস প্রোফাইল এপিআইগুলো JSON ফরম্যাটে ডেটা ফেরত দেয়।
জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন ( JSON ) হলো একটি প্রচলিত, ভাষা-নিরপেক্ষ ডেটা ফরম্যাট যা যেকোনো ডেটা কাঠামোর পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।
HTTP অনুরোধ করতে OAuth 2.0 প্লেগ্রাউন্ড ব্যবহার করুন।
আপনি বিজনেস প্রোফাইল এপিআইগুলো নিয়ে পরীক্ষা-নিরীক্ষা করার জন্য OAuth 2.0 প্লেগ্রাউন্ড ব্যবহার করতে পারেন। যেহেতু বিজনেস প্রোফাইল এপিআইগুলো পাবলিক এপিআই নয়, তাই প্লেগ্রাউন্ডে এটি ব্যবহার করার জন্য আপনাকে কয়েকটি অতিরিক্ত পদক্ষেপ নিতে হবে। প্রক্রিয়াটি এগিয়ে নিয়ে যাওয়ার জন্য আপনার একটি ওয়েব অ্যাপ্লিকেশনের ক্লায়েন্ট আইডি প্রয়োজন।
- Google API কনসোলে যান এবং আপনার প্রজেক্টটি খুলুন। যদি আপনার ওয়েব অ্যাপ্লিকেশনের জন্য কোনো OAuth ক্লায়েন্ট আইডি না থাকে, তাহলে এখনই একটি তৈরি করুন:
- Create credentials ড্রপ-ডাউন তালিকা থেকে OAuth client ID নির্বাচন করুন।
- অ্যাপ্লিকেশনের ধরন জানতে ওয়েব অ্যাপ্লিকেশন-এ ক্লিক করুন।
নিম্নলিখিতটি একটি বৈধ রিডাইরেক্ট ইউআরআই হিসাবে যুক্ত করুন:
https://developers.google.com/oauthplayground
- তৈরি করুন- এ ক্লিক করুন।
- ক্লায়েন্ট আইডিটি ক্লিপবোর্ডে কপি করুন।
- OAuth 2.0 প্লেগ্রাউন্ডে যান।
- কনফিগারেশন অপশনগুলো খুলতে গিয়ার আইকনে ক্লিক করুন এবং নিম্নলিখিত পরিবর্তনগুলো করুন:
- OAuth ফ্লো ক্লায়েন্ট-সাইডে সেট করুন।
- আপনার নিজের OAuth ক্রেডেনশিয়াল ব্যবহার করুন নির্বাচন করুন।
- আপনার OAuth ক্লায়েন্ট আইডি পেস্ট করুন।
- কনফিগারেশন বিকল্পগুলি বন্ধ করুন।
"ধাপ ১ - এপিআই নির্বাচন ও অনুমোদন" অংশের অধীনে, বিজনেস প্রোফাইল এপিআই-এর জন্য নিম্নলিখিত স্কোপটি "আপনার নিজস্ব স্কোপ ইনপুট করুন" ফিল্ডে পেস্ট করুন:
https://www.googleapis.com/auth/business.manage
- API অনুমোদন করুন- এ ক্লিক করুন।
- নির্দেশিত হলে Accept-এ ক্লিক করুন।
"ধাপ ২ - এপিআই-তে অনুরোধ কনফিগার করুন" এর অধীনে, নিম্নলিখিত URI-টি " অনুরোধ URI" ফিল্ডে পেস্ট করুন:
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
- 'Send the request'-এ ক্লিক করুন। জবাবে
200 OKস্ট্যাটাসটি দেখানো উচিত।
বিভিন্ন ধরণের অনুরোধ কীভাবে করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, বিজনেস প্রোফাইল এপিআই রেফারেন্স দেখুন।
ক্লায়েন্ট লাইব্রেরি
বিজনেস প্রোফাইল এপিআই ক্লায়েন্ট লাইব্রেরিগুলো বিজনেস প্রোফাইল এপিআই-এর কার্যকারিতা সমর্থন করে। এগুলো গুগলের সকল এপিআই-এর জন্য সাধারণ কার্যকারিতা প্রদান করে, যেমন এইচটিটিপি ট্রান্সপোর্ট, এরর হ্যান্ডলিং, অথেনটিকেশন এবং জেএসওএন পার্সিং।
ক্লায়েন্ট লাইব্রেরিগুলো ডাউনলোড করতে, লাইব্রেরিসমূহ দেখুন।