এগিয়ে যাওয়ার জন্য, নিশ্চিত করুন যে আপনি পূর্বশর্তের ধাপগুলি সম্পূর্ণ করেছেন এবং আমরা ব্যবসায়িক প্রোফাইল API অ্যাক্সেসের জন্য আপনার প্রকল্প অনুমোদন করেছি।
APIs সক্রিয় করুন
ব্যবসায়িক প্রোফাইলের সাথে যুক্ত আটটি API আছে যেগুলিকে Google API কনসোলে সক্ষম করতে হবে:
- Google My Business API
- আমার ব্যবসা অ্যাকাউন্ট ম্যানেজমেন্ট API
- আমার ব্যবসা লজিং API
- My Business Place Actions API
- আমার ব্যবসা বিজ্ঞপ্তি API
- আমার ব্যবসা যাচাইকরণ API
- আমার ব্যবসা ব্যবসা তথ্য API
- আমার ব্যবসা প্রশ্নোত্তর API
একটি API সক্ষম করুন
আপনি যদি সমস্ত পূর্বশর্তগুলি সম্পূর্ণ করে থাকেন এবং API-তে অ্যাক্সেস মঞ্জুর করা হয়, কিন্তু এখনও প্রদত্ত শর্টকাট ব্যবহার করতে অক্ষম হন, তাহলে আপনি নিম্নলিখিত পদক্ষেপগুলি সহ ম্যানুয়ালি API সক্ষম করতে পারেন৷
আপনার প্রকল্পের জন্য একটি API সক্ষম করতে, নিম্নলিখিতগুলি করুন:
- Google API কনসোলে API লাইব্রেরি খুলুন । যদি অনুরোধ করা হয়, একটি প্রকল্প নির্বাচন করুন বা একটি নতুন তৈরি করুন৷ API লাইব্রেরি পণ্য পরিবার এবং জনপ্রিয়তা দ্বারা গোষ্ঠীবদ্ধ সমস্ত উপলব্ধ API তালিকাভুক্ত করে৷
- আপনি যে APIটি সক্ষম করতে চান তা তালিকায় দৃশ্যমান না হলে, এটি খুঁজতে অনুসন্ধান ব্যবহার করুন।
- আপনি যে APIটি সক্ষম করতে চান তা নির্বাচন করুন, তারপর সক্ষম বোতামটি ক্লিক করুন।
- অনুরোধ করা হলে, বিলিং সক্ষম করুন।
- অনুরোধ করা হলে, API-এর পরিষেবার শর্তাবলী স্বীকার করুন৷
আপনি যদি একজন Google ওয়ার্কস্পেস ব্যবহারকারী হন, তাহলে নিশ্চিত করুন যে আপনার Google ওয়ার্কস্পেস প্রতিষ্ঠানে আপনার অ্যাকাউন্টের জন্য Google ব্যবসায়িক প্রোফাইল চালু আছে । আপনার Google ওয়ার্কস্পেস প্রতিষ্ঠানে আপনার অ্যাকাউন্টের জন্য Google ব্যবসায়িক প্রোফাইল বন্ধ থাকলে GBP API ব্যবহার করার সময় আপনি `Error 403 - PERMISSION DENIED` পাবেন।
একটি OAuth 2.0 ক্লায়েন্ট আইডি অনুরোধ করুন
যেহেতু আপনার অ্যাপ সুরক্ষিত, অ-পাবলিক ডেটা অ্যাক্সেস করে, তাই আপনার একটি OAuth 2.0 ক্লায়েন্ট আইডি প্রয়োজন। এটি আপনার অ্যাপের ব্যবহারকারীদের পক্ষ থেকে আপনার প্রতিষ্ঠানের অবস্থানের ডেটা অ্যাক্সেস করার জন্য আপনার অ্যাপের অনুরোধ অনুমোদন করতে দেয়।
ব্যক্তিগত ব্যবহারকারীর ডেটা অ্যাক্সেস করে এমন যেকোনো ব্যবসায়িক প্রোফাইল API-এর অনুরোধের সাথে আপনার অ্যাপ্লিকেশনটিকে অবশ্যই একটি OAuth 2.0 টোকেন পাঠাতে হবে।
যদি আপনি ইতিমধ্যে এটি না করে থাকেন, তাহলে Google API কনসোলের "শংসাপত্র" বিভাগে যান এবং আপনার OAuth 2.0 শংসাপত্র তৈরি করতে ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডিতে ক্লিক করুন৷ আপনি শংসাপত্র তৈরি করার পরে, আপনি শংসাপত্র পৃষ্ঠায় আপনার ক্লায়েন্ট আইডি দেখতে পাবেন। বিশদ বিবরণের জন্য ক্লায়েন্ট আইডিতে ক্লিক করুন, যেমন ক্লায়েন্ট সিক্রেট, রিডাইরেক্ট ইউআরআই, জাভাস্ক্রিপ্ট অরিজিন ঠিকানা এবং ইমেল ঠিকানা।
REST বেসিক শিখুন
API গুলি আহ্বান করার দুটি উপায় রয়েছে:
- একটি HTTP অনুরোধ পাঠান এবং প্রতিক্রিয়াগুলি পার্স করুন৷
- ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন।
আপনি যদি ক্লায়েন্ট লাইব্রেরি ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে REST এর মূল বিষয়গুলি বুঝতে হবে।
REST হল সফ্টওয়্যার আর্কিটেকচারের একটি শৈলী যা তথ্যের অনুরোধ এবং পরিবর্তন করার জন্য একটি সুবিধাজনক এবং সামঞ্জস্যপূর্ণ পদ্ধতি প্রদান করে।
REST শব্দটি " রিপ্রেজেন্টেশনাল স্টেট ট্রান্সফার " এর জন্য সংক্ষিপ্ত। Google API-এর প্রসঙ্গে, এটি Google দ্বারা সংরক্ষিত ডেটার উপস্থাপনা পুনরুদ্ধার এবং সংশোধন করতে HTTP ক্রিয়াপদের ব্যবহারকে বোঝায়।
একটি আরামদায়ক সিস্টেম একটি ডেটা স্টোরে সম্পদ সঞ্চয় করে। একটি ক্লায়েন্ট সার্ভারের কাছে একটি নির্দিষ্ট ক্রিয়া সম্পাদনের জন্য একটি অনুরোধ পাঠায়, যেমন একটি সংস্থান তৈরি করা, পুনরুদ্ধার করা, আপডেট করা বা মুছে ফেলা, এবং সার্ভারটি ক্রিয়া সম্পাদন করে এবং একটি প্রতিক্রিয়া পাঠায়। এই প্রতিক্রিয়া প্রায়ই নির্দিষ্ট সম্পদের একটি উপস্থাপনা আকারে হয়.
Google এর RESTful API-এ, ক্লায়েন্ট একটি HTTP ক্রিয়া সহ একটি ক্রিয়া নির্দিষ্ট করে, যেমন GET
, POST
, PUT
, বা DELETE
৷ ক্লায়েন্ট নিম্নলিখিত ফর্মের একটি বিশ্বব্যাপী অনন্য ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (URI) দ্বারা একটি সংস্থান নির্দিষ্ট করে:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
যেহেতু সমস্ত API সংস্থানগুলিতে অনন্য HTTP- অ্যাক্সেসযোগ্য URI রয়েছে, REST ডেটা ক্যাশিং সক্ষম করে এবং ওয়েবের বিতরণ করা অবকাঠামোর সাথে কাজ করার জন্য অপ্টিমাইজ করা হয়৷
আপনি HTTP 1.1 স্ট্যান্ডার্ড ডকুমেন্টেশনে পদ্ধতির সংজ্ঞাগুলি দরকারী খুঁজে পেতে পারেন। তারা GET
, POST
, PUT
, এবং DELETE
এর স্পেসিফিকেশন অন্তর্ভুক্ত করে।
বিজনেস প্রোফাইল API-এ বিশ্রাম নিন
বিজনেস প্রোফাইল এপিআই অপারেশনগুলি সরাসরি REST HTTP ক্রিয়াতে ম্যাপ করে।
ব্যবসায়িক প্রোফাইল API-এর জন্য নির্দিষ্ট বিন্যাস নিম্নলিখিত URI-তে দেখানো হয়েছে:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
API-এ প্রতিটি সমর্থিত অপারেশনের জন্য ব্যবহৃত URI-এর সম্পূর্ণ সেট ব্যবসায়িক প্রোফাইল API-এর রেফারেন্স ডকুমেন্টেশনে প্রদর্শিত হয়।
রিসোর্স পাথ শেষ পয়েন্টের উপর ভিত্তি করে পরিবর্তিত হয়।
উদাহরণস্বরূপ, একটি অ্যাকাউন্টের রিসোর্স পাথ নিম্নলিখিত উদাহরণের মত প্রদর্শিত হয়:
accounts/accountId
একটি অবস্থানের জন্য সম্পদ পথ নিম্নলিখিত আকারে প্রদর্শিত হয়:
locations/locationId
JSON বেসিক শিখুন
ব্যবসার প্রোফাইল APIগুলি JSON ফর্ম্যাটে ডেটা ফেরত দেয়।
জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন ( JSON ) হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা বিন্যাস যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।
একটি সহজ HTTP অনুরোধ করতে Oauth প্লেগ্রাউন্ড ব্যবহার করুন
বিজনেস প্রোফাইল এপিআই নিয়ে পরীক্ষা করার জন্য আপনি OAuth 2.0 প্লেগ্রাউন্ড ব্যবহার করতে পারেন। যেহেতু বিজনেস প্রোফাইল APIগুলি সর্বজনীন API নয়, তাই খেলার মাঠে এটি ব্যবহার করার জন্য আপনাকে কিছু অতিরিক্ত পদক্ষেপ নিতে হবে৷ এগিয়ে যাওয়ার জন্য একটি ওয়েব অ্যাপ্লিকেশনের জন্য আপনার একটি ক্লায়েন্ট আইডি প্রয়োজন৷
- Google API কনসোলে যান এবং আপনার প্রকল্প খুলুন। ওয়েব অ্যাপ্লিকেশনের জন্য আপনার কাছে OAuth ক্লায়েন্ট আইডি না থাকলে, এখন একটি তৈরি করুন:
- শংসাপত্র তৈরি করুন ড্রপ-ডাউন তালিকা থেকে, OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।
- অ্যাপ্লিকেশন প্রকারের জন্য, ওয়েব অ্যাপ্লিকেশন ক্লিক করুন।
একটি বৈধ পুনঃনির্দেশ URI হিসাবে নিম্নলিখিত যোগ করুন:
https://developers.google.com/oauthplayground
- তৈরি করুন ক্লিক করুন।
- ক্লিপবোর্ডে ক্লায়েন্ট আইডি কপি করুন।
- OAuth 2.0 খেলার মাঠে যান।
- কনফিগারেশন বিকল্পগুলি খুলতে এবং নিম্নলিখিত পরিবর্তনগুলি করতে গিয়ার আইকনে ক্লিক করুন:
- ক্লায়েন্ট-সাইডে OAuth প্রবাহ সেট করুন।
- আপনার নিজস্ব OAuth শংসাপত্র ব্যবহার করুন নির্বাচন করুন।
- আপনার OAuth ক্লায়েন্ট আইডি পেস্ট করুন।
- কনফিগারেশন বিকল্পগুলি বন্ধ করুন।
"পদক্ষেপ 1 - API নির্বাচন করুন এবং অনুমোদন করুন" এর অধীনে, আপনার নিজস্ব স্কোপ ফিল্ড ইনপুট করুন ব্যবসায়িক প্রোফাইল API এর জন্য নিম্নলিখিত সুযোগ পেস্ট করুন:
https://www.googleapis.com/auth/business.manage
- এপিআই অনুমোদন করুন ক্লিক করুন।
- অনুরোধ করা হলে Accept ক্লিক করুন।
"ধাপ 2 - API-তে অনুরোধ কনফিগার করুন" এর অধীনে, অনুরোধ URI ক্ষেত্রে নিম্নলিখিত URI পেস্ট করুন:
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
- অনুরোধ পাঠান ক্লিক করুন. প্রতিক্রিয়া
200 OK
একটি স্ট্যাটাস দেখাতে হবে।
কিভাবে বিভিন্ন ধরনের অনুরোধ করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, ব্যবসার প্রোফাইল APIs রেফারেন্স দেখুন।
ক্লায়েন্ট লাইব্রেরি
বিজনেস প্রোফাইল API-এর ক্লায়েন্ট লাইব্রেরিগুলি ব্যবসায়িক প্রোফাইল API-এর কার্যকারিতা সমর্থন করে। তারা সমস্ত Google API-এর সাধারণ কার্যকারিতা প্রদান করে, যেমন HTTP পরিবহন, ত্রুটি পরিচালনা, প্রমাণীকরণ এবং JSON পার্সিং।
ক্লায়েন্ট লাইব্রেরি ডাউনলোড করতে, লাইব্রেরি দেখুন।