শুরু করা হচ্ছে
গুগল ওয়ালেট এপিআই (API) কী?
গুগল ওয়ালেট এপিআই ডেভেলপারদের গুগল ওয়ালেটে ডিজিটাল পাস তৈরি করার সুযোগ দেয়। গুগল ওয়ালেট এপিআই বর্তমানে বোর্ডিং পাস, ইভেন্ট টিকিট, লয়ালটি কার্ড, অফার এবং ট্রানজিট পাস সমর্থন করে। সম্প্রতি, অতিরিক্ত ব্যবহারের ক্ষেত্রগুলোকে সমর্থন করার জন্য একটি জেনেরিক পাস টাইপ যুক্ত করা হয়েছে।
আমার ব্যবসায়িক প্রয়োজনীয়তা এবং জটিলতার উপর ভিত্তি করে আমি কীভাবে আমার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করতে পারি?
বিভিন্ন স্তরের ব্যবসায়িক জটিলতা এবং নিরাপত্তা অনুযায়ী একটি ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করার জন্য নিচে কিছু নির্দেশিকা দেওয়া হলো। একাধিক সার্ভিস অ্যাকাউন্ট ব্যবহার করে ডেভেলপাররা তাদের প্রোডাকশন (PROD) এনভায়রনমেন্ট থেকে আলাদা একটি টেস্ট (TEST) এনভায়রনমেন্ট তৈরি করতে পারেন।
মৌলিক সেটআপের জটিলতা
১টি বিজনেস কনসোল অ্যাকাউন্ট অথবা ১টি বিজনেস কনসোল প্যারেন্ট অ্যাকাউন্ট থেকে একাধিক ইস্যুয়ার অ্যাকাউন্ট।
- এই বিকল্পটি ১টি প্রধান অ্যাকাউন্ট এবং তার অধীনে শূন্য থেকে একাধিক উপ-ব্যবসা/ইস্যুকারী ব্যবহার করে একটি কেন্দ্রীয়ভাবে পরিচালিত পদ্ধতির সুযোগ দেয়।
- ১. গুগল ক্লাউড প্রজেক্ট।
- ১টি পরিষেবা অ্যাকাউন্টের পরিচয়পত্র।
- একক ব্যবহারকারী গোষ্ঠী।
গড় সেটআপ জটিলতা
একটি প্যারেন্ট অ্যাকাউন্টের অধীনে একাধিক ইস্যুকারী অ্যাকাউন্ট।
- এই বিকল্পটি একটি প্রধান অ্যাকাউন্টের মাধ্যমে অনেকগুলো উপ-ব্যবসা পরিচালনার জন্য একটি কেন্দ্রীয়ভাবে পরিচালিত পদ্ধতি সক্ষম করে।
- ১. গুগল ক্লাউড প্রজেক্ট।
- প্রতিটি ইস্যুকারীর জন্য স্বতন্ত্র ব্যবসায়িক কনসোল ব্যবহারকারী।
- এক থেকে একাধিক পরিষেবা অ্যাকাউন্টের পরিচয়পত্র।
- প্রতিটি ব্যবসা/ইস্যুকারীর জন্য ১টি ক্রেডেনশিয়াল।
- প্রতিটি ব্যবসার জন্য আলাদা পরিচয়পত্রের মাধ্যমে প্রবেশাধিকার।
জটিল সেটআপের জটিলতা
একটি প্যারেন্ট অ্যাকাউন্টের অধীনে একাধিক ইস্যুকারী অ্যাকাউন্ট।
- এই বিকল্পটি একটি প্রধান অ্যাকাউন্টের মাধ্যমে অনেকগুলো উপ-ব্যবসা পরিচালনার জন্য একটি কেন্দ্রীয়ভাবে পরিচালিত পদ্ধতি সক্ষম করে।
- এক থেকে একাধিক গুগল ক্লাউড প্রজেক্ট।
- প্রতিটি ইস্যুকারীর জন্য স্বতন্ত্র ব্যবসায়িক কনসোল ব্যবহারকারী।
- এক থেকে একাধিক পরিষেবা অ্যাকাউন্টের পরিচয়পত্র।
- প্রতিটি ব্যবসা/ইস্যুকারীর জন্য ১টি PROD ক্রেডেনশিয়াল।
- প্রতিটি ব্যবসা/ইস্যুকারীর জন্য ১টি DEV ক্রেডেনশিয়াল।
পাস নিয়ে কাজ করা
আমি কীভাবে ক্লাস বা অবজেক্ট ডিলিট করব?
বর্তমানে, আপনি গুগল ওয়ালেট থেকে ক্লাস বা অবজেক্ট ডিলিট করতে পারবেন না। তবে ব্যবহারকারীরা তাদের গুগল ওয়ালেট থেকে অবজেক্ট ডি-লিঙ্ক করতে পারেন।
আমি কীভাবে একাধিক পাস একসাথে গ্রুপ করব?
GroupingID ব্যবহার করে পাসগুলোকে একসাথে গ্রুপ করা সহজ হয়।
আমি কীভাবে পাসের শুধু একটি অংশ আপডেট করব?
PATCH অনুরোধ ব্যবহার করে কীভাবে আংশিক আপডেট করতে হয়, তা বুঝতে আমাদের পারফরম্যান্স গাইডটি অনুসরণ করুন।
আমি কি একসাথে অনেকগুলো পাস তৈরি করতে পারি?
এপিআই ব্যবহার করে কীভাবে ব্যাচ রিকোয়েস্ট সম্পাদন করতে হয়, তা বুঝতে আমাদের পারফরম্যান্স গাইডটি অনুসরণ করুন।
সাধারণ প্রশ্নাবলী
গুগল ওয়ালেট এপিআই-তে পাঠানো অনুরোধের রেট লিমিট কত?
গুগল ওয়ালেট এপিআই-তে কলের সংখ্যা প্রতি সেকেন্ডে ২০টি অনুরোধে সীমিত করা হয়েছে।
গুগল ওয়ালেট এপিআই-তে পাঠানো অনুরোধের জন্য প্রস্তাবিত টাইমআউট কত?
গুগল ওয়ালেট এপিআই-এর কোনো আনুষ্ঠানিক এসএলএ (SLA) নেই, কিন্তু প্রায় ৫ সেকেন্ডের ৯৯তম পার্সেন্টাইল ল্যাটেন্সির উপর ভিত্তি করে আমরা ১০ সেকেন্ডের একটি টাইমআউটের সুপারিশ করি। এও মনে রাখবেন যে, ল্যাটেন্সি প্রায়শই বাহ্যিক কারণগুলোর উপর নির্ভর করে; যেমন, কোনো ছবিসহ অবজেক্ট যুক্ত করার সময় বাহ্যিক সার্ভারে হোস্ট করা একটি ছবি আনতে যে সময় লাগে, তা সেই সার্ভারের ল্যাটেন্সির উপর নির্ভরশীল।
গুগল ওয়ালেটের পাসে ব্যক্তিগত ছবি রাখা কেন নিষিদ্ধ?
গুগল ওয়ালেট পাসে ব্যক্তিগত ছবি সমর্থন করে না, কারণ বর্তমান নিয়ম অনুযায়ী সকল গ্রাহকের সংবেদনশীল তথ্য সংগ্রহ বা প্রক্রিয়াকরণ থেকে বিরত থাকার অধিকার রয়েছে। মূল্যবান বস্তুর (একটি JWT-তে) অংশ হিসেবে সংবেদনশীল তথ্য (ব্যক্তিগত ছবি) থাকলে হোস্টিং সংক্রান্ত উদ্বেগ দেখা দিতে পারে, যেখানে ডেটা সর্বজনীন হয়ে যেতে পারে, যা মূল সম্মতি চুক্তির বাইরে। তথ্যের গোপনীয়তা নিশ্চিত করার জন্য, ব্যক্তিগত ছবির অনুমতি নেই। আমরা ভবিষ্যতে ব্যক্তিগত ছবি সমর্থন করার জন্য কাজ করছি।
গুগল ওয়ালেট এপিআই কী কী এরর কোড ফেরত দেয়?
গুগল ওয়ালেট এপিআই দ্বারা ফেরত আসা ত্রুটি কোড এবং ব্যতিক্রমগুলির তালিকার জন্য, ত্রুটি কোডসমূহ দেখুন।আমি কীভাবে পুশ নোটিফিকেশন চালু করব?
ডেভেলপারদের পাঠানো পুশ নোটিফিকেশন বর্তমানে গুগল ওয়ালেট দ্বারা সমর্থিত নয়। তবে গুগল ওয়ালেট নিম্নলিখিত পাসগুলোর জন্য সময়মতো নোটিফিকেশন প্রদান করে। ডেভেলপারদের পাঠানো পুশ নোটিফিকেশন বর্তমানে গুগল ওয়ালেট দ্বারা সমর্থিত নয়।
| উল্লম্ব | বিজ্ঞপ্তি | ট্রিগার করা হয়েছে | ডকুমেন্টেশন |
|---|---|---|---|
| অনুষ্ঠান | আসন্ন অনুস্মারক | অনুষ্ঠানের ৩ ঘন্টা আগে | ডক্স |
| বোর্ডিং পাস | আসন্ন অনুস্মারক | ফ্লাইট ছাড়ার ৩ ঘন্টা আগে | ডক্স |
| বোর্ডিং পাস | পাস আপডেট | যাত্রার শুরুর টার্মিনাল, গেট, বোর্ডিং বা প্রস্থানের সময় পরিবর্তন | ডক্স |
| অফার কার্ড | মেয়াদ শেষ হওয়ার অনুস্মারক | অফার কার্ডের মেয়াদ শেষ হওয়ার ৪৮ ঘন্টা আগে | ডক্স |
| জেনেরিক | আসন্ন অনুস্মারক | “সময়সীমা” শুরু হওয়ার ২৪ ঘন্টা আগে | ডক্স |
| জেনেরিক | মেয়াদ শেষ হওয়ার অনুস্মারক | “অভ্যন্তরীণ সময়” শেষ হওয়ার ৪৮ ঘন্টা আগে | ডক্স |
মার্চেন্ট আইডিগুলো কি মুছে ফেলা যায়?
বর্তমানে, গুগল পে ও ওয়ালেট কনসোল থেকে মার্চেন্ট আইডি মুছে ফেলা বা আর্কাইভ করা যায় না।
আমি অ্যাপলিংকিং ফিচারটি কীভাবে ব্যবহার করব?
অ্যাপলিংকিংয়ের জন্য অ্যালাওলিস্টিং প্রয়োজন, যার জন্য এখানে অনুরোধ করা যেতে পারে।
গুগল ওয়ালেট কি জিওফেন্সিং সমর্থন করে?
হ্যাঁ, এটি সমর্থিত। আরও তথ্যের জন্য, সংশ্লিষ্ট পাস টাইপের অধীনে ‘পুশ নোটিফিকেশন ট্রিগার করা’ দেখুন।
আমি কীভাবে একটি লয়ালটি প্রোগ্রাম সেট আপ করব?
এই নির্দেশিকা অনুসরণ করে আপনি একটি তালিকাভুক্তি ও আনুগত্য কর্মসূচি চালু করতে পারেন।
ট্রানজিট পাসের জন্য আমি গুগলকে আমার লোগো কীভাবে পাঠাবো?
অনুমোদনের জন্য গুগলকে লোগো পাঠাতে অনুগ্রহ করে এই ফর্মটি ব্যবহার করুন।
Base64 এনকোড করা userProfile ডেটা কীভাবে সঠিকভাবে পরিচালনা করা যায়?
আপনার পুরো প্রক্রিয়া জুড়ে UTF-8 এনকোডিং ব্যবহার নিশ্চিত করুন। JSON স্ট্রিংটি প্রথমে UTF-8 এনকোড করা হয় এবং পরবর্তীতে android.util.Base64 ব্যবহার করে NO_WRAP এবং URL_SAFE অপশনগুলোর সাহায্যে এনকোড করা হয়। এটি RFC 3548-এর ৪ নং সেকশনের সাথে সামঞ্জস্যপূর্ণ।
প্রোগ্রাম্যাটিকভাবে কীভাবে ইস্যুয়ার অ্যাকাউন্ট তৈরি করব?
এপিআই (API) এর মাধ্যমে ইস্যুকারী অ্যাকাউন্ট তৈরি করতে এই নির্দেশিকাটি দেখুন।
স্মার্ট ট্যাপ
গুগল স্মার্টট্যাপ পাসের জন্য আমার কি কোনো বিশেষ এনএফসি রিডার প্রয়োজন?
এটি অবশ্যই একটি স্মার্টট্যাপ সক্ষম টার্মিনাল হতে হবে। অনুমোদিত সরবরাহকারীদের একটি তালিকা এখানে পাওয়া যাবে।
আমি কীভাবে আমার পাসগুলো NFC-এর সাথে কাজ করাবো?
আপনার পাসটি স্মার্ট ট্যাপের মাধ্যমে রিডিমযোগ্য করতে অনুগ্রহ করে এই কনফিগারেশনটি অনুসরণ করুন।
JSON ওয়েব টোকেন (JWTs)
এমন কোনো টুল আছে কি যা JWT-এর বাস্তবায়ন এবং ডিবাগিং সহজ করে?
হ্যাঁ, www.jwt.io- এর মতো প্ল্যাটফর্মগুলো আপনাকে আপনার ডেভেলপমেন্ট প্রক্রিয়ার সময় টোকেন ডিকোড ও ডিবাগ করার সুযোগ দেয়, যার ফলে আপনি আপনার জমা দেওয়া কন্টেন্ট যাচাই করতে পারেন। উল্লেখ্য যে, গুগলের এর সাথে কোনো সম্পর্ক নেই এবং গুগল বিশেষভাবে এই ধরনের কোনো তৃতীয় পক্ষকে সুপারিশ করে না।
আমার JWT লিঙ্কের URL-টি ব্রাউজারের ১৮০০ অক্ষরের সীমাবদ্ধতা অতিক্রম করেছে। আমার কী করা উচিত?
সেভ পাস লিঙ্ক (JWT) তৈরি করার আগেই আপনি API ব্যবহার করে ক্লাস ও অবজেক্ট তৈরি করে রাখতে পারেন।
সমস্যা সমাধান
আমার সময় সেটিংসে ইভেন্টটির জন্য ভুল সময় দেখাচ্ছে কেন?
পাসে প্রদর্শিত সময়টি হলো ইভেন্টের স্থানীয় সময়, সাথে ইভেন্টস্থলের সময়ের অফসেট যুক্ত থাকে।
আমার তৈরি করা পাসগুলোতে লোগোটি দেখা যাচ্ছে না। সমস্যাটা কী হতে পারে?
- প্রথমত, নিশ্চিত করুন যে আপনার লোগোটি নির্দেশিকা অনুসরণ করে এবং PNG ফরম্যাটে সংরক্ষিত আছে।
- লোগোটি যেন উচ্চ নির্ভরযোগ্যতার সাথে সহজেই উপলব্ধ থাকে তা নিশ্চিত করুন। এমন কোনো ইমেজ ফাইলে রিডাইরেক্ট করবেন না যা 404 এরর ঘটাতে পারে। আপনার ইমেজগুলো অবশ্যই HTTPS লোকেশনে হোস্ট করতে হবে, অন্যথায় সেগুলো গুগল ওয়ালেটে দেখা যাবে না।
- নিশ্চিত করুন যে API-তে আবশ্যক হিসেবে চিহ্নিত সমস্ত প্রয়োজনীয় ফিল্ড পাস-এ সেট করা আছে।
গুগল ওয়ালেট কলব্যাকের জন্য কোন ইউজার-এজেন্ট হেডারগুলো ব্যবহার করে?
গুগল ওয়ালেট সার্ভার কলব্যাক অনুরোধ করার সময় Googlebot এবং Google-Valuables ইউজার-এজেন্ট হেডার ব্যবহার করে। অনুরোধগুলো যাতে বট হিসেবে ব্লক না হয়, তা নিশ্চিত করার জন্য পার্টনারদের উচিত তাদের সিডিএন বা ফায়ারওয়ালে এই প্যাটার্নগুলোকে অনুমতি তালিকায় অন্তর্ভুক্ত করা।
সমর্থন ও মতামত
আমি টেকনিক্যাল সাপোর্টের সাথে কীভাবে যোগাযোগ করব?
অতিরিক্ত সাহায্যের জন্য, Google Pay এবং Wallet কনসোলের বাম সাইডবারে থাকা 'Contact Support' বোতামে ক্লিক করে সাপোর্ট টিমের সাথে যোগাযোগ করুন।
আমি কীভাবে পণ্যের বিষয়ে মতামত জানাবো?
পণ্যের মতামত জানাতে, ডেভেলপার সাইট পেজের উপরের ডানদিকের অংশে থাকা 'Send Feedback' বোতামে ক্লিক করুন এবং 'Product feedback' নির্বাচন করুন। এরপর, টেক্সট এরিয়াতে আপনার মতামত বর্ণনা করুন এবং 'Send' বোতামে ক্লিক করুন।
আমি কীভাবে ডকুমেন্টেশন সম্পর্কে মতামত জানাব?
ডকুমেন্টেশন সম্পর্কে মতামত জানাতে, ডেভেলপার সাইট পেজের উপরের ডানদিকের অংশে থাকা 'Send Feedback' বোতামে ক্লিক করুন এবং 'Documentation feedback' নির্বাচন করুন। এরপর, টেক্সট এরিয়াতে আপনার মতামত বর্ণনা করুন এবং 'Send' বোতামে ক্লিক করুন।