Google Wallet API ব্যবহার করার সময় এই নথিতে সাধারণ পরিভাষা এবং ধারণাগুলির সাথে আপনার পরিচিত হওয়া উচিত।
পাস করে
পাস
একটি পাস হল একটি পাস অবজেক্টের একটি উদাহরণ যা ব্যবহারকারীকে তাদের Google ওয়ালেটে সংরক্ষণ করার জন্য জারি করা হয়। Google Wallet API বোর্ডিং পাস, ইভেন্ট টিকিট, আইডি কার্ড এবং আরও অনেক কিছু সহ সাধারণ পাস প্রকারের জন্য সমর্থন প্রদান করে৷ Google Wallet API একটি জেনেরিক পাস টাইপও প্রদান করে যা পাস তৈরি করতে ব্যবহার করা যেতে পারে যা অন্যথায় বিশেষভাবে সমর্থিত নয়।
বেশিরভাগ ক্ষেত্রে, একটি পাস ক্লাস এবং একটি পাস অবজেক্ট উভয় ব্যবহার করে একটি পাস তৈরি করা হয়।
পাস ইস্যুকারী
একটি পাস ইস্যুকারী এমন একটি সত্তা যা পাস তৈরি করে এবং ব্যবহারকারীদের তাদের Google Wallet এ সংরক্ষণ করার জন্য সেগুলি ইস্যু করে৷ পাস ইস্যুকারী পাসগুলির মালিক, এবং সেগুলি তৈরি করতে, ইস্যু করতে এবং আপডেট করতে পারে। পাস ইস্যুকারীরা স্বতন্ত্র বিকাশকারী, কোম্পানি এবং সংস্থার পাশাপাশি এগ্রিগেটর হতে পারে যারা অন্যদের পক্ষে পাস তৈরি করে এবং ইস্যু করে, যেমন একটি কোম্পানি যা খুচরা বিক্রেতাদের জন্য ইভেন্ট বা কুপনের জন্য টিকিট বাস্তবায়নে বিশেষজ্ঞ।
ক্লাস পাশ করে
একটি পাস ক্লাসকে একটি ভাগ করা টেমপ্লেট হিসাবে ভাবা যেতে পারে যা থেকে পাসগুলি তৈরি করা হয়। একটি পাস ক্লাস নির্দিষ্ট বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে যা এটি ব্যবহার করে এমন সমস্ত পাসগুলিতে অন্তর্ভুক্ত করা হবে। একজন পাস ইস্যুকারী একাধিক ক্লাস তৈরি করতে পারে, প্রত্যেকের নিজস্ব স্বতন্ত্র বৈশিষ্ট্যের সেট রয়েছে যা শৈলী এবং চেহারার মতো বৈশিষ্ট্যের পাশাপাশি স্মার্ট ট্যাপ, এবং তালিকাভুক্তি এবং সাইন ইনের মতো অতিরিক্ত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে।
বেশিরভাগ ক্ষেত্রে, পাসের টেমপ্লেটটি সংজ্ঞায়িত করার জন্য একটি পাস ক্লাস প্রদান করে একটি পাস তৈরি করা হয় এবং ইস্যু করা পৃথক পাসের সুনির্দিষ্ট বিষয়গুলি সংজ্ঞায়িত করার জন্য একটি পাস অবজেক্ট প্রদান করা হয়।
অবজেক্ট পাস করে
একটি পাস অবজেক্ট একটি পৃথক পাসকে সংজ্ঞায়িত করে যা ব্যবহারকারীকে তাদের Google ওয়ালেটে সংরক্ষণ করার জন্য জারি করা হয়। পাস অবজেক্টে প্রায়ই ব্যবহারকারী-নির্দিষ্ট তথ্য থাকে। উদাহরণস্বরূপ, যখন একটি পাস ক্লাস একটি নির্দিষ্ট দোকানের জন্য একটি উপহার কার্ড পাস কেমন হবে তা নির্ধারণ করতে পারে, পাস অবজেক্ট ব্যালেন্স বা মেয়াদ শেষ হওয়ার তারিখের মতো নির্দিষ্ট বিবরণ প্রদান করবে।
ইস্যু করা প্রতিটি পাসের জন্য একটি পাস অবজেক্ট তৈরি করতে হবে, পাস ক্লাসের বিপরীতে যা অনেক পাসের উদাহরণ জুড়ে ভাগ করা যেতে পারে।
প্রাইভেট পাস
Google Wallet API দিয়ে আপনার তৈরি করা কিছু পাসে সংবেদনশীল ব্যবহারকারীর ডেটা থাকতে পারে। আপনার ব্যবহারকারীদের ডেটা সুরক্ষিত রাখতে এই পাসগুলির অতিরিক্ত সুরক্ষা প্রয়োজন এবং জেনেরিক প্রাইভেট পাস টাইপ ব্যবহার করে Google Wallet API-এ ভিন্নভাবে পরিচালিত হয়৷ জেনেরিক প্রাইভেট পাসটি এমন ক্ষেত্রে ব্যবহার করা উচিত যেখানে সংবেদনশীল ডেটা ( Google Wallet API গ্রহণযোগ্য ব্যবহারের নীতিতে সংজ্ঞায়িত করা হয়েছে) আপনার পাসে অন্তর্ভুক্ত করা হয়েছে এবং অনবোর্ডিংয়ের সময় অতিরিক্ত গোপনীয়তা নিয়ন্ত্রণ এবং পর্যালোচনার অধীন হতে পারে৷
স্মার্ট ট্যাপ
স্মার্ট ট্যাপ হল একটি মোবাইল ডিভাইস এবং একটি NFC টার্মিনালের মধ্যে ডেটা পৌঁছে দেওয়ার জন্য একটি Google মালিকানাধীন কাছাকাছি-ক্ষেত্র যোগাযোগ প্রোটোকল। স্মার্ট ট্যাপ প্রযুক্তি ব্যবহারকারীদের যেকোনো সামঞ্জস্যপূর্ণ NFC টার্মিনালের কাছে তাদের ফোন ধরে রেখে তাদের Google Wallet-এ সংরক্ষিত পাসগুলি রিডিম করতে দেয়৷
আপনার পাসের সাথে স্মার্ট ট্যাপ প্রোটোকল ব্যবহার করতে, আপনাকে অবশ্যই একটি স্মার্ট ট্যাপ সক্ষম টার্মিনাল প্রদানকারীর সাথে সম্পর্ক স্থাপন করতে হবে।
API এবং SDK
Google Wallet API
Google Wallet API হল Google দ্বারা প্রদত্ত একটি পরিষেবা যা আপনাকে ব্যবহারকারীদের তাদের Google Wallets-এ সংরক্ষণ করার জন্য পাস তৈরি এবং ইস্যু করার অনুমতি দেয়৷ API Google Wallet REST API, Google Wallet Android SDK, এবং Google Wallet কনসোল সহ বিভিন্ন উপায়ে ব্যবহার করা যেতে পারে৷
Google Wallet REST API
Google Wallet REST API হল একটি ইন্টারফেস যা Google Wallet API-এ HTTP অনুরোধ পাঠিয়ে প্রোগ্রামগতভাবে পাসগুলি তৈরি এবং পরিচালনা করার জন্য৷
Google Wallet REST API ব্যবহার করার জন্য, একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে আপনার একটি Google ক্লাউড অ্যাকাউন্টেরও প্রয়োজন হবে, যা Google Wallet REST API-তে অনুরোধগুলি প্রমাণীকরণ করতে ব্যবহৃত হয়।
Google Wallet Android SDK
Google Wallet Android SDK আপনার Android অ্যাপ্লিকেশানগুলিতে Google Wallet API এর সাথে কাজ করার জন্য সুবিধার পদ্ধতির একটি সেট প্রদান করে, যেমন পাস তৈরি করা এবং ইস্যু করা৷
Google Wallet এ যোগ করুন
'Google Wallet এ যোগ করুন' বোতাম
'Google Wallet এ যোগ করুন' বোতামটি একজন ব্যবহারকারীর কাছে একটি পাস উপস্থাপনের জন্য একটি Google-অনুমোদিত সম্পদ। যখন একজন ব্যবহারকারী বোতামটি ক্লিক করেন বা আলতো চাপেন, তখন ব্যবহারকারীর Google Wallet-এ জারি করা পাস যোগ করার প্রবাহ শুরু করতে একটি 'Google Wallet-এ যোগ করুন' লিঙ্কটি ট্রিগার করা উচিত।
এটি সুপারিশ করা হয় যে আপনি যখনই সম্ভব 'Google ওয়ালেটে যোগ করুন' বোতামটি ব্যবহার করুন, যেহেতু এটি একটি পরিচিত UI উপাদান যার সাথে কীভাবে ইন্টারঅ্যাক্ট করতে হয় তা আপনার ব্যবহারকারীরা ইতিমধ্যেই জানেন৷
বোতামটি ব্যবহার করার জন্য সম্পদ এবং নির্দেশিকা Google Wallet API ব্র্যান্ড নির্দেশিকাগুলিতে উপলব্ধ৷
'Google Wallet এ যোগ করুন' লিঙ্ক
একটি 'Google Wallet এ যোগ করুন' লিঙ্কের মাধ্যমে, আপনি একটি সাধারণ হাইপারলিঙ্ক সহ ব্যবহারকারীকে একটি পাস ইস্যু করতে পারেন৷ আপনি হাইপারলিঙ্ক যেমন ইমেল, এসএমএস, ওয়েবসাইট এবং মোবাইল অ্যাপ ব্যবহার করতে সক্ষম হন সেখানে এটি ব্যবহার করা যেতে পারে।
URL https://pay.google.com/gp/v/save/ এ একটি স্বাক্ষরিত JWT যুক্ত করে 'Google Wallet-এ যোগ করুন' লিঙ্কগুলি তৈরি করা হয়।
ইস্যুকারী অ্যাকাউন্ট
ডেমো মোড
আপনি যখন আপনার ইস্যুকারী অ্যাকাউন্ট তৈরি করেন, তখন এটি 'ডেমো মোডে' থাকবে যতক্ষণ না আপনি প্রকাশের অ্যাক্সেসের জন্য অনুমোদিত হন। ডেমো মোডে আপনি পাসগুলি তৈরি করতে পারেন, কিন্তু আপনি শুধুমাত্র আপনার ইস্যুকারী অ্যাকাউন্টের 'প্রশাসক' বা 'ডেভেলপার' ভূমিকা সহ ব্যবহারকারীদের বা Google Wallet কনসোলে পরীক্ষার অ্যাকাউন্ট হিসাবে যোগ করা ব্যবহারকারীদের জন্য ইস্যু করতে পারেন৷
'ডেমো মোড'-এ থাকাকালীন, আপনার ইস্যু করা যেকোনো পাসের শিরোনামটি স্বয়ংক্রিয়ভাবে '[শুধুমাত্র পরীক্ষা]' শব্দ দিয়ে শুরু হবে যে পাসটি শুধুমাত্র পরীক্ষার উদ্দেশ্যে।
পরীক্ষার খাতা
যখন আপনার ইস্যুকারী অ্যাকাউন্ট 'ডেমো মোডে' থাকে, আপনি যদি এমন কোনও ব্যবহারকারীকে পাস ইস্যু করতে চান যার কাছে আপনার অ্যাকাউন্টের জন্য 'প্রশাসক' বা 'ডেভেলপার' ভূমিকা নেই, তাহলে আপনাকে অবশ্যই সেগুলিকে Google Wallet কনসোলে পরীক্ষা অ্যাকাউন্ট হিসাবে যুক্ত করতে হবে . পরীক্ষার অ্যাকাউন্ট হিসাবে নথিভুক্ত ব্যবহারকারীরা তাদের Google Wallet এ আপনার দ্বারা জারি করা পাসগুলি যোগ করতে সক্ষম হবে৷ এটি 'ডেমো মোডে' থাকাকালীন আরও বৃহত্তর দর্শকদের সাথে আপনার পাসগুলি পরীক্ষা করার জন্য দরকারী।
ব্যবসায়িক তথ্যাদি
Google Wallet API-এর জন্য একটি ইস্যুকারী অ্যাকাউন্ট তৈরি করতে, আপনি যখন Google Pay এবং Wallet কনসোলের জন্য নিবন্ধন করবেন তখন আপনাকে অবশ্যই একটি ব্যবসায়িক প্রোফাইল সেট আপ করতে হবে। একটি ব্যবসায়িক প্রোফাইল Google-কে আপনার কোম্পানি বা প্রতিষ্ঠান সম্পর্কে প্রাথমিক তথ্য প্রদান করে এবং প্রকাশনা অ্যাক্সেসের জন্য অনুমোদিত হতে হবে।
প্রকাশনা অ্যাক্সেস
আপনি পাস ইস্যু করার আগে যে কোনো ব্যবহারকারী তাদের Google Wallet এ সংরক্ষণ করতে পারেন, আপনাকে প্রকাশের অ্যাক্সেসের জন্য অনুমোদিত হতে হবে। প্রকাশনা অ্যাক্সেসের জন্য অনুমোদিত হওয়ার জন্য, আপনাকে অবশ্যই কমপক্ষে একটি পাস ক্লাস তৈরি করতে হবে এবং একটি সম্পূর্ণ ব্যবসায়িক প্রোফাইল থাকতে হবে। ইস্যুকারীরা যারা Google Wallet Android SDK ব্যবহার করে পাস ইস্যু করতে চান তাদেরও তাদের অ্যাপের জন্য SHA-1 ফিঙ্গারপ্রিন্ট জমা দিতে হবে।
প্রকাশনার অ্যাক্সেসের অনুরোধ করতে, Google Wallet কনসোলে যান এবং 'প্রকাশনার অ্যাক্সেসের অনুরোধ করুন' বোতামে ক্লিক করুন৷ Google Wallet টিম আপনার অনুরোধ পর্যালোচনা করবে এবং আপনাকে প্রকাশের অ্যাক্সেস দেওয়া হলে আপনাকে অবহিত করবে৷
প্রমাণীকরণ
JSON ওয়েব টোকেন (JWT)
JSON ওয়েব টোকেনগুলি একটি JSON অবজেক্ট হিসাবে নিরাপদে তথ্য স্থানান্তর করার জন্য একটি সাধারণভাবে ব্যবহৃত শিল্প মান। Google Wallet API ব্যবহার করার সময়, আপনি JWT (উচ্চারিত "jot") ফর্ম্যাটে একটি পাস ইন্সট্যান্স তৈরি করতে যে পাসস অবজেক্ট ব্যবহার করতে চান তার বিবরণ এনকোড করেন, তারপর সেই JWTটিকে Google Wallet API-কে অনুরোধ করে পাঠান।
JWT গুলিকে Google Wallet API-এ পাঠানোর আগে একটি শেয়ার করা গোপনীয়তার সাথে স্বাক্ষর করে সুরক্ষিত রাখা হয়। আপনি যদি Google Wallet REST API ব্যবহার করেন, তাহলে স্বাক্ষর করার গোপনীয়তা হল আপনার Google ক্লাউড পরিষেবা অ্যাকাউন্ট কী৷ আপনি যদি Google Wallet Android SDK ব্যবহার করেন, তাহলে সাইনিং সিক্রেট হল আপনার Android অ্যাপের জন্য SHA-1 ফিঙ্গারপ্রিন্ট৷
পরিষেবা অ্যাকাউন্ট
একটি Google ক্লাউড পরিষেবা অ্যাকাউন্ট হল একটি বিশেষ ধরনের অ্যাকাউন্ট যা সাধারণত একজন ব্যক্তির পরিবর্তে একটি অ্যাপ্লিকেশন বা গণনা কাজের চাপ দ্বারা ব্যবহৃত হয়। Google Wallet API-এর ক্ষেত্রে, একটি পরিষেবা অ্যাকাউন্ট হল যা আপনি Google Wallet REST API-তে পাঠানো অনুরোধগুলিকে প্রমাণীকরণ করতে ব্যবহার করবেন৷
পরিষেবা অ্যাকাউন্টগুলি Google ক্লাউড কনসোলে তৈরি করা হয়। একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করার জন্য, আপনাকে ক্লাউড কনসোলে Google Wallet API সক্ষম করতে হবে যাতে পরিষেবা অ্যাকাউন্টটিকে Google Wallet REST API-তে অনুরোধ করার অনুমতি দেয়৷
পরিষেবা অ্যাকাউন্ট কী
একটি পরিষেবা অ্যাকাউন্ট কী হল শংসাপত্র যা আপনি Google Wallet REST API-তে কলগুলিকে প্রমাণীকরণ করতে ব্যবহার করবেন৷ পরিষেবা অ্যাকাউন্ট কীটি অত্যন্ত সংবেদনশীল বলে বিবেচিত হয় এবং এটিকে অবশ্যই ব্যক্তিগত রাখতে হবে, কারণ এটি Google Wallet REST API ব্যবহার করে আপনার অ্যাকাউন্টের পাস ইস্যুকারী বৈশিষ্ট্যগুলির অনেকগুলি অ্যাক্সেস দেয়, যার মধ্যে পাস ক্লাস এবং পাস অবজেক্ট তৈরি করা হয়৷
SHA-1 ফিঙ্গারপ্রিন্ট
আপনার অ্যান্ড্রয়েড অ্যাপ সাইনিং সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট হল সেই শংসাপত্র যা আপনি Google Wallet API এ কলগুলি প্রমাণীকরণ করতে ব্যবহার করবেন যখন আপনি Google Wallet Android SDK ব্যবহার করবেন৷ আপনার শংসাপত্রের SHA-1 ফিঙ্গারপ্রিন্ট গ্রেডল বা কীটুল ব্যবহার করে তৈরি করা হয়েছে। আপনার অনুরোধগুলি প্রমাণীকরণের জন্য আঙ্গুলের ছাপ ব্যবহার করতে, আপনাকে অবশ্যই এটি Google Wallet কনসোলে নিবন্ধন করতে হবে৷