Google Wallet API ব্যবহার করার সময় আপনাকে যেসব সাধারণ পরিভাষা ও ধারণা সম্পর্কে জানতে হবে, এই ডকুমেন্টে সেগুলি তালিকাভুক্ত করা হয়েছে।
পাস
পাস
পাস হল Passes Object-এর একটি ইনস্ট্যান্স যা কোনও ব্যবহারকারীকে তার Google Wallet-এ সেভ করার জন্য ইস্যু করা হয়। Google Wallet API, বোর্ডিং পাস, ইভেন্টের টিকিট, আইডি কার্ড এবং আরও অনেক কিছু সহ বিভিন্ন ধরনের সাধারণ পাসের জন্য সহায়তা প্রদান করে। এছাড়াও, Google Wallet API একটি জেনেরিক পাসের ধরন প্রদান করে যা অন্যথায় বিশেষভাবে সমর্থিত নয় এমন পাস তৈরি করতে ব্যবহার করা যেতে পারে।
বেশিরভাগ ক্ষেত্রে, পাস ক্লাস ও পাস অবজেক্ট, এই দুটিই ব্যবহার করে পাস তৈরি করা হয়।
পাস ইস্যুকারী
পাস ইস্যুকারী হল এমন একটি এন্টিটি যা পাস তৈরি করে এবং ব্যবহারকারীদের তাদের Google Wallet-এ সেভ করার জন্য ইস্যু করে। পাস ইস্যুকারী পাসের মালিক এবং তিনি সেগুলি তৈরি, ইস্যু ও আপডেট করতে পারেন। পাস ইস্যুকারী ব্যক্তি, কোম্পানি ও সংস্থা হতে পারে, এছাড়াও এগ্রিগেটররা অন্যদের হয়ে পাস তৈরি ও ইস্যু করে, যেমন, কোনও কোম্পানি ইভেন্টের টিকিট বা রিটেলারদের জন্য কুপন তৈরি করে।
পাস ক্লাস
পাস ক্লাসকে একটি শেয়ার করা টেমপ্লেট হিসেবে বিবেচনা করা যেতে পারে যেখান থেকে পাস তৈরি করা হয়। পাস ক্লাস নির্দিষ্ট কিছু প্রপার্টিকে সংজ্ঞায়িত করে যা এটি ব্যবহার করে এমন সব পাসে অন্তর্ভুক্ত করা হবে। পাস ইস্যুকারী একাধিক ক্লাস তৈরি করতে পারেন, প্রতিটি ক্লাসের নিজস্ব স্বতন্ত্র প্রপার্টির সেট থাকে যা স্টাইল ও চেহারার মতো অ্যাট্রিবিউট এবং Smart Tap, এনরোলমেন্ট ও সাইন-ইন করার মতো অতিরিক্ত ফিচারকে সংজ্ঞায়িত করে।
বেশিরভাগ ক্ষেত্রে, পাসের টেমপ্লেট নির্ধারণ করার জন্য Passes Class এবং ইস্যু করা স্বতন্ত্র পাসের নির্দিষ্ট বিবরণ নির্ধারণ করার জন্য Passes Object প্রদান করে পাস তৈরি করা হয়।
পাস অবজেক্ট
পাস অবজেক্ট হল একটি স্বতন্ত্র পাস যা কোনও ব্যবহারকারীকে তার Google Wallet-এ সেভ করার জন্য ইস্যু করা হয়। পাস অবজেক্টে প্রায়ই ব্যবহারকারী-নির্দিষ্ট তথ্য থাকে। যেমন, পাস ক্লাস নির্দিষ্ট কোনও দোকানের গিফ্ট কার্ড পাস কেমন হবে তা নির্ধারণ করতে পারে, তবে পাস অবজেক্ট ব্যালেন্স বা মেয়াদ শেষ হওয়ার তারিখের মতো নির্দিষ্ট বিবরণ প্রদান করবে।
ইস্যু করা প্রতিটি পাসের জন্য একটি করে পাস অবজেক্ট তৈরি করতে হবে, কারণ পাস ক্লাস একাধিক পাস ইনস্ট্যান্স জুড়ে শেয়ার করা যায়।
ব্যক্তিগত পাস
Google Wallet API-এর মাধ্যমে তৈরি করা কিছু পাসে ব্যবহারকারীর সংবেদনশীল ডেটা থাকতে পারে। আপনার ব্যবহারকারীর ডেটা সুরক্ষিত রাখতে এইসব পাসের জন্য অতিরিক্ত সুরক্ষার প্রয়োজন হয় এবং জেনেরিক ব্যক্তিগত পাস টাইপ ব্যবহার করে Google Wallet API-তে এগুলি আলাদাভাবে ম্যানেজ করা হয়। আপনার পাসে সংবেদনশীল ডেটা (Google Wallet API-এর গ্রহণযোগ্য ব্যবহার সংক্রান্ত নীতিতে সংজ্ঞায়িত করা হয়েছে) অন্তর্ভুক্ত থাকলে, জেনেরিক ব্যক্তিগত পাস ব্যবহার করা উচিত এবং অনবোর্ডিংয়ের সময় অতিরিক্ত গোপনীয়তা নিয়ন্ত্রণ ও পর্যালোচনার বিষয় হতে পারে।
'স্মার্ট ট্যাপ' ফিচার
স্মার্ট ট্যাপ হল Google-এর মালিকানাধীন নিয়ার-ফিল্ড কমিউনিকেশন প্রোটোকল যা মোবাইল ডিভাইস এবং NFC টার্মিনালের মধ্যে ডেটা আদান-প্রদান করে। 'স্মার্ট ট্যাপ' প্রযুক্তির মাধ্যমে ব্যবহারকারীরা তাদের Google Wallet-এ সেভ করা পাস রিডিম করতে পারবেন, এর জন্য তাদের ফোন যেকোনও মানানসই NFC টার্মিনালের কাছাকাছি ধরতে হবে।
আপনার পাসের সাথে Smart Tap প্রোটোকল ব্যবহার করতে, আপনাকে অবশ্যই Smart Tap কাজ করে এমন টার্মিনাল প্রদানকারীর সাথে সম্পর্ক স্থাপন করতে হবে।
API এবং SDK
Google Wallet API
Google Wallet API হল Google-এর প্রদান করা একটি পরিষেবা যা আপনাকে ব্যবহারকারীদের জন্য পাস তৈরি ও ইস্যু করার অনুমতি দেয় যাতে তারা সেগুলি নিজেদের Google Wallet-এ সেভ করতে পারেন। 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 Cloud অ্যাকাউন্টও ব্যবহার করতে হবে যাতে আপনি একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে পারেন। এই অ্যাকাউন্টটি 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 Wallet-এ যোগ করুন' বোতামটি ব্যবহার করুন, কারণ এটি একটি পরিচিত UI এলিমেন্ট যার সাথে আপনার ব্যবহারকারীরা ইতিমধ্যেই ইন্টার্যাক্ট করতে জানেন।
বোতাম ব্যবহার করার জন্য অ্যাসেট ও নির্দেশিকা Google Wallet API ব্র্যান্ড নির্দেশিকায় উপলভ্য।
'Google Wallet-এ যোগ করুন' লিঙ্ক
'Google Wallet-এ যোগ করুন' লিঙ্ক ব্যবহার করে, আপনি সাধারণ হাইপারলিঙ্কের মাধ্যমে কোনও ব্যবহারকারীকে পাস ইস্যু করতে পারবেন। ইমেল, এসএমএস, ওয়েবসাইট ও মোবাইল অ্যাপের মতো যেসব জায়গায় হাইপারলিঙ্ক ব্যবহার করা যায়, সেখানে এটি ব্যবহার করা যেতে পারে।
URL-এ সই করা JWT যোগ করে https://pay.google.com/gp/v/save/ 'Google Wallet-এ যোগ করুন' লিঙ্ক তৈরি করা হয়।
ইস্যুকারীর অ্যাকাউন্ট
ডেমো মোড
আপনি ইস্যুকারী অ্যাকাউন্ট তৈরি করলে, প্রকাশনার অ্যাক্সেসের জন্য অনুমোদিত না হওয়া পর্যন্ত এটি 'ডেমো মোডে' থাকবে। ডেমো মোডে আপনি পাস তৈরি করতে পারবেন, তবে আপনি শুধুমাত্র আপনার ইস্যুকারী অ্যাকাউন্টের 'অ্যাডমিন' বা 'ডেভেলপার' ভূমিকায় থাকা ব্যবহারকারীদের বা Google Wallet কনসোলে টেস্ট অ্যাকাউন্ট হিসেবে যোগ করা ব্যবহারকারীদের পাস ইস্যু করতে পারবেন।
'ডেমো মোড'-এ থাকাকালীন, আপনার ইস্যু করা যেকোনও পাসের শীর্ষক অটোমেটিক '[TEST ONLY]' শব্দ দিয়ে শুরু হবে, যাতে বোঝা যায় যে পাসটি শুধুমাত্র পরীক্ষার উদ্দেশ্যে ইস্যু করা হয়েছে।
টেস্ট অ্যাকাউন্ট
আপনার ইস্যুকারী অ্যাকাউন্ট 'ডেমো মোডে' থাকলে, আপনার অ্যাকাউন্টের জন্য 'অ্যাডমিন' বা 'ডেভেলপার' ভূমিকা নেই এমন কোনও ব্যবহারকারীকে পাস ইস্যু করতে চাইলে, আপনাকে অবশ্যই 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 (উচ্চারণ "জট") ফর্ম্যাটে এনকোড করেন, তারপর সেই JWT, Google Wallet API-তে একটি অনুরোধের মাধ্যমে পাঠান।
Google Wallet API-তে পাঠানোর আগে JWT-কে শেয়ার্ড সিক্রেট দিয়ে সাইন করে সুরক্ষিত রাখা হয়। আপনি Google Wallet REST API ব্যবহার করলে, সাইনিং সিক্রেট হল আপনার Google Cloud পরিষেবা অ্যাকাউন্টের কী। আপনি Google Wallet Android SDK ব্যবহার করলে, সাইনিং সিক্রেট হল আপনার Android অ্যাপের SHA-1 ফিঙ্গারপ্রিন্ট।
সার্ভিস অ্যাকাউন্ট
Google Cloud পরিষেবা অ্যাকাউন্ট হল এক বিশেষ ধরনের অ্যাকাউন্ট যা সাধারণত কোনও ব্যক্তি ব্যবহার করেন না, বরং কোনও অ্যাপ্লিকেশন বা কম্পিউট ওয়ার্কলোড ব্যবহার করে। Google Wallet API-এর ক্ষেত্রে, Google Wallet REST API-তে পাঠানো অনুরোধগুলি প্রমাণীকরণের জন্য আপনি পরিষেবা অ্যাকাউন্ট ব্যবহার করবেন।
Google Cloud কনসোল থেকে পরিষেবা অ্যাকাউন্ট তৈরি করা হয়। পরিষেবা অ্যাকাউন্ট ব্যবহার করতে, আপনাকে Cloud Console-এ Google Wallet API চালু করতে হবে যাতে পরিষেবা অ্যাকাউন্ট Google Wallet REST API-তে অনুরোধ করতে পারে।
সার্ভিস অ্যাকাউন্ট কী
পরিষেবা অ্যাকাউন্ট কী হল সেই ক্রেডেনশিয়াল যা আপনি Google Wallet REST API-তে কল যাচাই করার জন্য ব্যবহার করবেন। পরিষেবা অ্যাকাউন্ট কী অত্যন্ত সংবেদনশীল হিসেবে বিবেচিত হয় এবং এটি অবশ্যই ব্যক্তিগত রাখতে হবে, কারণ এটি Google Wallet REST API ব্যবহার করে আপনার অ্যাকাউন্টের অনেক পাস ইস্যুকারী ফিচারে অ্যাক্সেস প্রদান করে, যার মধ্যে পাস ক্লাস ও পাস অবজেক্ট তৈরি করাও অন্তর্ভুক্ত।
SHA-1 ফিঙ্গারপ্রিন্ট
Google Wallet Android SDK ব্যবহার করার সময় Google Wallet API-তে কল অথেণ্টিকেট করতে, আপনার Android অ্যাপ সাইনিং সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট হল ক্রেডেনশিয়াল যা আপনি ব্যবহার করবেন। আপনার সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট Gradle বা keytool ব্যবহার করে তৈরি করা হয়। আপনার অনুরোধ প্রমাণীকরণের জন্য ফিঙ্গারপ্রিন্ট ব্যবহার করতে, আপনাকে অবশ্যই Google Wallet কনসোলে এটি রেজিস্টার করতে হবে।