মার্চেন্ট এপিআই কার্যকরভাবে ব্যবহার করার জন্য রেজিস্ট্রেশন, অথেন্টিকেশন এবং অথরাইজেশন -এর ধারণাগুলো বোঝা জরুরি। মার্চেন্ট সেন্টারের ডেটাতে নিরাপদ ও সঠিক অ্যাক্সেস নিশ্চিত করতে এগুলোর স্বতন্ত্র উদ্দেশ্য রয়েছে।
পরিভাষা
নিবন্ধন, প্রমাণীকরণ এবং অনুমোদন পরস্পর সম্পর্কিত হলেও, প্রত্যেকটির স্বতন্ত্র অর্থ ও উদ্দেশ্য রয়েছে।
- প্রমাণীকরণ : এই প্রক্রিয়ায় পরিষেবাটি এপিআই অনুরোধকারী ব্যবহারকারী বা অ্যাপ্লিকেশনের পরিচয় যাচাই করে। মার্চেন্ট এপিআই OAuth 2.0- এর মতো গুগলের প্রচলিত পদ্ধতি ব্যবহার করে। আরও তথ্যের জন্য, ‘অনুরোধ প্রমাণীকরণ’ এবং ‘আপনার নিজের অ্যাকাউন্ট হিসাবে প্রমাণীকরণ’ দেখুন।
- অনুমোদন : এই প্রক্রিয়াটি নির্ধারণ করে যে, প্রমাণীকৃত ব্যবহারকারী বা অ্যাপ্লিকেশন একটি মার্চেন্ট সেন্টার অ্যাকাউন্ট ব্যবহার করে কী কী কাজ করার অনুমতি পাবে। মার্চেন্ট সেন্টার অ্যাকাউন্টের মধ্যে প্রমাণীকৃত ব্যবহারকারীকে প্রদত্ত ভূমিকা এবং অনুমতির উপর ভিত্তি করে এটি "আপনি কী করতে পারেন?"—এই প্রশ্নের উত্তর দেয়। উদাহরণস্বরূপ, একজন ব্যবহারকারী পণ্যের ডেটা পড়ার জন্য অনুমোদিত হতে পারেন, কিন্তু অ্যাকাউন্টের সেটিংস পরিবর্তন করার জন্য নাও হতে পারেন।
- রেজিস্ট্রেশন : মার্চেন্ট এপিআই (Merchant API)-এর ক্ষেত্রে, এটি একটি এককালীন সেটআপ প্রক্রিয়া যা গুগলকে আপনার পরিচালিত মার্চেন্ট অ্যাকাউন্টগুলোর জন্য গুরুত্বপূর্ণ পরিষেবা সংক্রান্ত ঘোষণা পাঠাতে দেয়। রেজিস্ট্রেশন আপনার ডেভেলপার ইমেল অ্যাড্রেসগুলোকে আপনার মূল মার্চেন্ট সেন্টার অ্যাকাউন্টে যুক্ত করে এবং এটিকে আপনার অথেনটিকেশনের জন্য ব্যবহৃত গুগল ক্লাউড প্রজেক্ট আইডি(গুলো)-র সাথে লিঙ্ক করে। এই সংযোগটি আপনার অ্যাপ্লিকেশনকে আপনার পরিচালিত সমস্ত মার্চেন্ট অ্যাকাউন্টের জন্য পরিষেবা সংক্রান্ত ঘোষণা গ্রহণ করতে দেয়। আরও তথ্যের জন্য, একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন (Create a Google Cloud Project ) দেখুন।
নিবন্ধন
আপনার অ্যাপ্লিকেশনকে মার্চেন্ট এপিআই ব্যবহার করতে সক্ষম করার জন্য নিবন্ধন প্রক্রিয়াটি অত্যন্ত গুরুত্বপূর্ণ। নিচে যা যা জানা প্রয়োজন:
পূর্বশর্ত
মার্চেন্ট এপিআই ব্যবহার করার জন্য নিবন্ধন করতে নিম্নলিখিত বিষয়গুলো প্রয়োজন:
- মার্চেন্ট সেন্টার অ্যাকাউন্ট : আপনার একটি বিদ্যমান মার্চেন্ট সেন্টার অ্যাকাউন্ট থাকতে হবে।
- অ্যাডমিন অ্যাক্সেস: রেজিস্ট্রেশন প্রক্রিয়া শুরু করার জন্য আপনি যে গুগল ইউজার অ্যাকাউন্টটি ব্যবহার করছেন, আপনি যে মার্চেন্ট সেন্টার অ্যাকাউন্টটি রেজিস্টার করছেন সেটিতে সেই অ্যাকাউন্টের অ্যাডমিন প্রিভিলেজ থাকতে হবে।
- গুগল ক্লাউড প্রজেক্ট : আপনার অ্যাপ্লিকেশনটি অবশ্যই একটি গুগল ক্লাউড প্রজেক্টের সাথে যুক্ত থাকতে হবে। এই প্রজেক্টটি আপনার অ্যাপ্লিকেশনের প্রমাণীকরণের জন্য প্রয়োজনীয় ক্রেডেনশিয়াল (যেমন OAuth 2.0 ক্লায়েন্ট আইডি) সরবরাহ করে।
কেন আপনি একটি শেয়ার করা গুগল ক্লাউড প্রজেক্ট নিবন্ধন করতে পারবেন না
Google OAuth Playground এবং APIs Explorer-এর মতো টুলগুলো Google-এর মালিকানাধীন ও শেয়ার করা Google Cloud প্রজেক্ট ব্যবহার করে। আপনি শেয়ার করা প্রজেক্টগুলোতে রেজিস্টার করতে পারবেন না, কারণ:
- এগুলো পরীক্ষা ও অনুসন্ধানের জন্য তৈরি, প্রোডাকশন অ্যাপ্লিকেশনের পরিচয় নির্ধারণের জন্য নয়।
- এগুলো নিবন্ধন করলে শেয়ার করা টুলটির সাথে আপনার নির্দিষ্ট মার্চেন্ট সেন্টার ডেটার একটি সংযোগ স্থাপিত হবে এবং এর ফলে অনাকাঙ্ক্ষিত যোগাযোগ ঘটতে পারে।
আপনার অ্যাপ্লিকেশনের জন্য একটি নিজস্ব ডেডিকেটেড গুগল ক্লাউড প্রজেক্ট প্রয়োজন, যাতে গুগল থেকে পাঠানো মার্চেন্ট এপিআই কমিউনিকেশনগুলো আপনার প্রকৃত ব্যবহারের জন্য প্রাসঙ্গিক থাকে।
তথাপি, আপনি পরীক্ষা-নিরীক্ষা এবং নন-প্রোডাকশন ব্যবহারের জন্য মার্চেন্ট এপিআই ব্যবহার করতে OAuth Playground এবং API Explorer ওয়েবঅ্যাপগুলো ব্যবহার করতে পারেন।
আপনার গুগল ক্লাউড প্রজেক্ট আইডি খুঁজুন
আপনি আপনার প্রজেক্ট আইডি এবং প্রজেক্ট নম্বর গুগল ক্লাউড কনসোলে খুঁজে পাবেন। বিস্তারিত জানতে, ‘প্রজেক্টের নাম, নম্বর এবং আইডি খুঁজুন’ দেখুন।
নিবন্ধনের জন্য কল করুন
Accounts সাব-এপিআই-এর মধ্যে থাকা registerGcp মেথডটি ব্যবহার করে নিবন্ধন করুন। এই কলটি আপনার Google Cloud প্রজেক্ট নম্বরকে মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে যুক্ত করে।
প্রক্রিয়া চলাকালীন, আপনাকে এমন একজন স্বতন্ত্র ব্যবহারকারীর ইমেল ঠিকানা প্রদান করতে হবে, যা আপনি এপিআই (API) কল করার জন্য ব্যবহার করেন। এই ইমেলটি অবশ্যই এমন একজন ব্যবহারকারীর হতে হবে, যার মার্চেন্ট সেন্টার অ্যাকাউন্টে অ্যাডমিন অ্যাক্সেস রয়েছে।
ইমেল ক্ষেত্র সম্পর্কে
কার্যকরী যোগাযোগই মূল চাবিকাঠি। গুগল গুরুত্বপূর্ণ আপডেট, বাধ্যতামূলক পরিষেবা ঘোষণা (এমএসএ), ডেভেলপার সমীক্ষা এবং মার্চেন্ট এপিআই সম্পর্কিত অন্যান্য সুযোগ-সুবিধা পাঠায়। সঠিক যোগাযোগ ব্যবস্থাপনা নিশ্চিত করে যে এই বার্তাগুলো সঠিক ব্যক্তিদের কাছে পৌঁছায়।
- উদ্দেশ্য : গুগল এপিআই-সম্পর্কিত যোগাযোগের জন্য এই ইমেল ঠিকানাটিকে প্রাথমিক মাধ্যম হিসেবে ব্যবহার করে।
- কার ইমেল : এটি এমন একজন স্বতন্ত্র ডেভেলপার বা প্রধান কারিগরি যোগাযোগের ইমেল ঠিকানা হতে হবে, যিনি এপিআই ইন্টিগ্রেশনের জন্য দায়িত্বে আছেন।
- সর্বোত্তম অনুশীলন :
- করণীয় : কোনো ব্যক্তির প্রাতিষ্ঠানিক ইমেল ঠিকানা ব্যবহার করুন।
- করবেন না : সাধারণ গ্রুপ অ্যালিয়াস বা সার্ভিস অ্যাকাউন্টের ইমেল ব্যবহার করুন। আমাদের যোগাযোগগুলো মানুষের উদ্দেশ্যে করা হয়।
যোগাযোগ ব্যবস্থাপনার জন্য users রিসোর্স
রেজিস্ট্রেশন কলের ইমেল ঠিকানাটি প্রাথমিক যোগাযোগ স্থাপন করলেও, যোগাযোগ এবং অনুমতিগুলি পরিচালনা করার আরও নির্ভরযোগ্য উপায় হলো মার্চেন্ট এপিআই-এর accounts.users রিসোর্স অথবা মার্চেন্ট সেন্টার ইউআই-এর ব্যবহারকারী ব্যবস্থাপনা সেটিংস ব্যবহার করা। মার্চেন্ট সেন্টার ব্যবহার সম্পর্কে আরও তথ্যের জন্য, আপনার অ্যাকাউন্টে লোকজনকে পরিচালনা দেখুন।
নিম্নলিখিতভাবে এই বৈশিষ্ট্যগুলির সুবিধা নিন:
- সকল ডেভেলপার যুক্ত করুন : এপিআই ইন্টিগ্রেশনে কর্মরত ডেভেলপারদের মার্চেন্ট সেন্টার অ্যাকাউন্টের ব্যবহারকারী হিসেবে যুক্ত করুন।
-
API_DEVELOPERরোলটি অ্যাসাইন করুন : সাধারণ রোল ( অ্যাডমিন , স্ট্যান্ডার্ড ) ছাড়াও, আপনি ব্যবহারকারীদেরAPI_DEVELOPERরোলটি অ্যাসাইন করতে পারেন। বিশেষ করে, যে ব্যবহারকারীরা API-সম্পর্কিত যোগাযোগ গ্রহণ করবেন, তাদের এই রোলটি অ্যাসাইন করুন। আপনি এটিকে অন্যান্য রোলের সাথেও যুক্ত করতে পারেন। - সুবিধাসমূহ :
- সুস্পষ্ট পৃথকীকরণ : এককালীন নিবন্ধন থেকে এপিআই যোগাযোগ ব্যবস্থাপনাকে পৃথক করে।
- নমনীয়তা : দলের সদস্য পরিবর্তন হলে যোগাযোগের তথ্য হালনাগাদ করুন।
- সুনির্দিষ্ট যোগাযোগ : এপিআই-সম্পর্কিত খবর প্রাসঙ্গিক ব্যক্তিদের কাছে পৌঁছানো নিশ্চিত করে।
নিবন্ধনের সময় আপনি ইমেল ঠিকানা দিয়ে থাকলেও, আমরা API_DEVELOPER রোল সহ ব্যবহারকারীদের যুক্ত করে API যোগাযোগগুলি পরিচালনা করার জন্য দৃঢ়ভাবে সুপারিশ করি।
তথ্যসূত্র
আরও তথ্যের জন্য, নিম্নলিখিতগুলি দেখুন: