পটভূমি
এখন আপনি ভ্যালু অ্যাডেড অপরচুনিটি মডিউল অন্তর্ভুক্ত করতে অবজেক্ট এবং ক্লাস আপডেট করতে পারেন। মডিউলগুলো পাসের নিচের অংশে প্রদর্শিত হবে এবং ইস্যুকারী কন্টেন্টের সাথে লিঙ্ক করা যাবে। এই ডকুমেন্টটিতে গুগল ওয়ালেট এপিআই ব্যবহার করে মডিউল সক্রিয় ও ব্যবহার করার জন্য প্রয়োজনীয় মূল ধাপগুলো বর্ণনা করা হয়েছে।
বৈশিষ্ট্যের উদাহরণ
 |  |
| একক দৃশ্য | তালিকা দৃশ্য |
এই নির্দেশিকাটি ধরে নেয় যে আপনি গুগল ওয়ালেটের প্রাথমিক ধারণাগুলির সাথে পরিচিত এবং প্রস্তাবিত পূর্বশর্তগুলি ইতিমধ্যেই সম্পন্ন করেছেন। যেকোনো প্রশ্ন বা মতামত আপনার গুগল ওয়ালেট পিওসি-কে (POC) পাঠান।
একীকরণ পদক্ষেপ
একটি নতুন মডিউল যোগ করতে হলে আপনাকে অবজেক্ট এবং/অথবা ক্লাসটি আপডেট করে তাতে ValueAddedModuleData অন্তর্ভুক্ত করতে হবে। ValueAddedModuleData-এর নিম্নলিখিত ফিল্ডগুলো রয়েছে:
[প্রয়োজনীয়] LocalizedString হেডার
মডিউলে হেডারটি প্রদর্শিত হয়। এর অক্ষর সংখ্যা ৬০ এবং এর চেয়ে দীর্ঘ স্ট্রিং সংক্ষিপ্ত করে দেওয়া হবে।
স্থানীয় স্ট্রিং বডি
মডিউলে মূল অংশটি প্রদর্শিত হবে। অক্ষর সীমা ৫০ এবং এর চেয়ে দীর্ঘ স্ট্রিং সংক্ষিপ্ত করা হবে।
ছবি ছবি
মডিউলে ছবিটি প্রদর্শিত হয়। প্রস্তাবিত ছবির অনুপাত হলো ১:১ এবং ছবিগুলোকে এই অনুপাত অনুযায়ী রিসাইজ করা হবে।
[প্রয়োজনীয়] স্ট্রিং ইউআরআই
মডিউলটিতে ক্লিক করলে যে URI-তে নিয়ে যায়। এটি একটি ওয়েব লিঙ্ক বা ডিপ লিঙ্ক হতে পারে।ModuleViewConstraints viewConstraints
মডিউলটি প্রদর্শিত হওয়ার জন্য যে শর্তগুলো অবশ্যই পূরণ করতে হবে। ModuleViewConstraints-এ নিম্নলিখিত ফিল্ডটি রয়েছে:সময় ব্যবধান প্রদর্শন ব্যবধান
যে সময়কাল ধরে মডিউলটি ব্যবহারকারীদের কাছে প্রদর্শিত হবে। একটি `startTime` এবং একটি `endTime` উভয়ই নির্ধারণ করা যেতে পারে। `startTime` সেট করা না থাকলে, মডিউলটি প্রবেশ করানোর সাথে সাথেই প্রদর্শিত হয়। `endTime` সেট করা না থাকলে মডিউলটি অনির্দিষ্টকালের জন্য প্রদর্শিত হয়।int32 sortIndex
মডিউলগুলো সাজানোর জন্য সূচক। কম সর্ট ইনডেক্সযুক্ত মডিউলগুলো বেশি সর্ট ইনডেক্সযুক্ত মডিউলগুলোর আগে দেখানো হয়। যদি নির্দিষ্ট না করা হয়, তবে সর্ট ইনডেক্সটি INT_MAX হিসেবে ধরে নেওয়া হয়। একই ইনডেক্সযুক্ত দুটি মডিউলের ক্ষেত্রে, সাজানোর আচরণ অনির্ধারিত থাকে।উদাহরণ ValueAddedModuleData:
{
"valueAddedModuleData": [
{
"header": {
"defaultValue": {
"language": "en-US",
"value": "10% off merch"
}
},
"body": {
"defaultValue": {
"language": "en-US",
"value": "Shirts, caps, mugs, and more"
}
},
"image": {
"sourceUri": {
"uri": "http://www.images.google.com/opportunity"
}
},
"uri": "http://www.google.com/opportunity",
"viewConstraints": {
"displayInterval": {
"start": {
"date": "2024-08-01T18:30:00"
},
"end": {
"date": "2025-08-01T18:30:00"
}
}
},
"sortIndex": 0
},
{
"header": {
"defaultValue": {
"language": "en-US",
"value": "10% off concessions"
}
},
"uri": "http://www.google.com/new_opportunity"
}
]
}প্রত্যাশিত আচরণ
অবজেক্ট এবং/অথবা ক্লাস সফলভাবে আপডেট করার পর আপনি এখন সংশ্লিষ্ট পাসে মডিউলগুলো দেখতে পাবেন। যদি আপনি কেবল একটি মডিউল যোগ করে থাকেন, তবে আপনি সেটি পাসের শুরুতে দেখতে পাবেন।
মূল্য সংযোজন সুযোগ মডিউল সম্পর্কিত নির্দেশিকা
মডিউলগুলো হলো অতিরিক্ত কার্যক্রমের মাধ্যমে আপনার ব্যবহারকারীর পাস অভিজ্ঞতাকে আরও সমৃদ্ধ করার সুযোগ। মডিউল তৈরি ও পরিচালনা করার সময় আপনার নিম্নলিখিত বিষয়গুলো বিবেচনা করা উচিত:
- মডিউলগুলোকে এমন উপযুক্ত ভাষায় সংজ্ঞায়িত করা উচিত, যা থেকে বোঝা যায় যে এগুলো কার্যকর এবং ব্যবহারকারীরা বুঝতে পারেন যে এই মডিউলগুলো ক্লিকযোগ্য।
- মডিউলগুলোতে নির্দিষ্ট মডিউলের সাথে সম্পর্কিত যথাযথ চিত্রাবলী সংজ্ঞায়িত থাকা উচিত।
- মডিউলগুলো আপনার নিয়ন্ত্রণে রয়েছে এবং গুরুত্ব ও প্রাসঙ্গিকতার ওপর নির্ভর করে আপনাকে সক্রিয়ভাবে মডিউলের অগ্রাধিকার নির্ধারণ করতে হবে।
- ব্যবহারকারীদের শুধু সক্রিয় মডিউলগুলোই দেখানো উচিত। আপনি মডিউলে displayInterval সেট করে অথবা ক্লাস বা অবজেক্ট থেকে সক্রিয়ভাবে মডিউলটি যোগ বা অপসারণ করে এটি নিয়ন্ত্রণ করতে পারেন।
ব্যতিক্রম পরিচালনা
| বার্তা | কারণ |
|---|---|
| ValueAddedModuleData-তে অবশ্যই একটি হেডার থাকতে হবে। | ValueAddedModuleData-এর কোনো হেডার নেই। |
| ValueAddedModuleData-তে অবশ্যই একটি অ-খালি URI থাকতে হবে। | ValueAddedModuleData-এর কোনো অ-খালি URI নেই। |
| প্রতি ক্লাসে সর্বাধিক ১৫টি ভ্যালু অ্যাডেড মডিউল অনুমোদিত। | ক্লাসে ভ্যালু অ্যাডেড মডিউলগুলো কমানো প্রয়োজন। |
| প্রতিটি অবজেক্টে সর্বাধিক ১৫টি ভ্যালু অ্যাডেড মডিউল অনুমোদিত। | অবজেক্টটিতে ভ্যালু অ্যাডেড মডিউলের সংখ্যা কমাতে হবে। |