ব্যাকগ্রাউন্ড
অটোমেটিক লিঙ্ক করা পাস ফিচারের মাধ্যমে আপনি এমন ব্যবহারকারীকে অতিরিক্ত পাস পাঠাতে পারবেন যার Google Wallet-এ আগে থেকেই আপনার পাস আছে। এছাড়াও, ব্যবহারকারী প্রাইমারি (প্রধান) পাস সেভ করার সময় আপনি প্রাইমারি পাসের সাথে আগে থেকে লিঙ্ক করা পাস সেট করতে পারবেন। অটোমেটিক লিঙ্ক করা পাসটি প্রাইমারি পাসের সাথে গ্রুপ করা হয় এবং প্রাইমারি পাসের উপরে একটি কলআউট থাকে যা ব্যবহারকারীকে জানায় যে একটি নতুন পাস লিঙ্ক করা হয়েছে। নিম্নলিখিত ধরনের পাস প্রাইমারি বা লিঙ্ক করা পাস হিসেবে কাজ করে;
- ইভেন্টের টিকেট
- বোর্ডিং পাস
- ট্রানজিট পাস
- অফার
- গিফ্ট কার্ড
- লয়ালটি পাস
- জেনেরিক পাস
|
|
| নতুন পাস যোগ করা হয়েছে বলে কলআউট সহ প্রাথমিক পাস | প্রাইমারি পাসের সাথে নতুন পাস লিঙ্ক করা হয়েছে |
ব্যবহারিক ক্ষেত্র
আগে থেকে থাকা পাসের সাথে পাস লিঙ্ক করার জন্য আপনার কাছে বিভিন্ন ব্যবহারের কেস থাকতে পারে। কিছু উদাহরণ হল:
- আগে থেকে থাকা লয়ালটি কার্ডের সাথে অফার লিঙ্ক করুন।
- বোর্ডিং পাস বা ইভেন্টের টিকিটের সাথে মিল ভাউচার লিঙ্ক করুন।
- ইভেন্ট টিকিটের সাথে পার্কিং পাস লিঙ্ক করুন।
অটো-লিঙ্ক করা পাস ব্যবহার করার সময় কিছু বিষয় বিবেচনা করতে হবে
- প্রাইমারি অবজেক্ট ও লিঙ্ক করা অবজেক্টে একই issuerId ব্যবহার করতে হবে।
- প্রতিটি প্রাথমিক অবজেক্টের জন্য সর্বাধিক ৫০টি লিঙ্ক করা অবজেক্ট থাকতে পারে।
- লিঙ্ক করা পাস অটোমেটিক পুশ করার কোনও গ্যারান্টি নেই এবং এটি সর্বোচ্চ চেষ্টা হিসেবে বিবেচনা করা হয়। ব্যবহারকারীরা অটোমেটিক লিঙ্ক করা পাস পাওয়ার সুবিধা থেকে অপ্ট-আউট করতে পারবেন। ব্যবহারের কেসটি যদি গুরুত্বপূর্ণ হয় এবং ব্যবহারকারীকে অবশ্যই লিঙ্ক করা পাস পেতে হয়, তাহলে ব্যবহারকারী যাতে পাস যোগ করেন তা নিশ্চিত করতে আমরা অন্য চ্যানেলের মাধ্যমে যোগাযোগ করার সাজেশন দিই।
- Google Wallet AUP-এ করা আপডেটে অটোমেটিক লিঙ্ক করা পাসের ব্যবহার সংক্রান্ত নির্দেশিকা অন্তর্ভুক্ত রয়েছে যা অবশ্যই মেনে চলতে হবে।
ইন্টিগ্রেশনের ধাপ
আপনি আগে থেকেই প্রাইমারি অবজেক্ট তৈরি করে থাকলে, ১ নম্বর ধাপটি এড়িয়ে যেতে পারেন।
- প্রয়োজনীয় প্যারামিটার সহ তালিকাভুক্ত যেকোনও ধরনের পাসের অবজেক্ট তৈরি করুন। এটি হল প্রাথমিক অবজেক্ট।
- তালিকায় উল্লেখ করা যেকোনও ধরনের পাসের আরেকটি অবজেক্ট তৈরি করুন। এটি লিঙ্ক করা অবজেক্ট হতে চলেছে।
- প্রাইমারি অবজেক্ট সেভ করার আগে বা পরে, linkedObjectIds প্যারামিটারে লিঙ্ক করা অবজেক্টের আইডি দিয়ে প্রাইমারি অবজেক্ট আপডেট করুন।
প্রাইমারি পাসে linkedObjectIds সেট করার জন্য ন্যূনতম পেলোড প্রয়োজন। ৩টি প্রয়োজনীয় প্যারামিটারের মধ্যে এগুলি অন্তর্ভুক্ত;
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- ISSUERID.LINKED_OBJECT_ID
পাস অবজেক্টে লিঙ্ক করা অবজেক্ট যোগ করার জন্য JSON অনুরোধের উদাহরণ
… { "id": "ISSUERID.PASS_OBJECTID", "classId": "ISSUERID.PASS_CLASSID", "barcode": { "type": "qrCode", "value": "QR code" }, "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"] } …
কোনও অবজেক্টকে পাস অবজেক্টের সাথে লিঙ্ক করার পরে JSON রেসপন্সের উদাহরণ
…
"state": "active",
"linkedObjectIds": {
"ISSUERID.LINKED_PASS_OBJECTID"
}
…প্রত্যাশিত আচরণ
সফলভাবে উত্তর পাওয়ার পরে, আপনার আপডেট করা পাস সহ ডিভাইসগুলি লিঙ্ক করা পাস পাবে। এই লিঙ্ক করা পাসটি প্রাইমারি পাসের সাথে গ্রুপ করা হবে। ব্যবহারকারীরা ডানদিকে সোয়াইপ করে লিঙ্ক করা পাস দেখতে পারবেন।
ব্যতিক্রম ম্যানেজ করা
API-এর ভুল ব্যবহারের ফলে সম্ভাব্য সমস্যা হতে পারে, যার মধ্যে রয়েছে;
| মেসেজ | কারণ |
|---|---|
| প্রাইমারি অবজেক্ট ও লিঙ্ক করা অবজেক্ট একই ইস্যুকারী আইডি শেয়ার করে না। | আপনি অন্য ইস্যুকারীর অবজেক্টের সাথে লিঙ্ক করা অবজেক্ট অ্যাটাচ করতে পারবেন না। |
| প্রাইমারি অবজেক্ট ও লিঙ্ক করা অবজেক্ট একই অবজেক্টকে রেফার করে। | আপনি linkedObject হিসেবে একই অবজেক্ট অ্যাটাচ করতে পারবেন না। |
| লিঙ্ক করা অবজেক্টের কোনও অস্তিত্ব নেই। | লিঙ্ক করা অবজেক্টটি আগে থেকেই Wallet API-তে যোগ করা থাকতে হবে। |
| লিঙ্ক করা অবজেক্টে আগে থেকেই অন্য একটি লিঙ্ক করা অবজেক্ট আছে। নেস্ট করা লিঙ্ক করা অবজেক্ট যোগ করা যাবে না। | লিঙ্ক করা অবজেক্টের সাথে অন্য কোনও লিঙ্ক করা অবজেক্ট থাকতে পারবে না। |
| অবজেক্টটি আগে থেকেই অন্য অবজেক্টের সাথে লিঙ্ক করা আছে। নেস্টেড লিঙ্ক করা অবজেক্ট যোগ করা যাবে না। | প্রাথমিক অবজেক্ট নিজে থেকে লিঙ্ক করা অবজেক্ট হতে পারে না। |
| আর কোনও লিঙ্ক করা অবজেক্ট যোগ করা যাবে না, সীমা পেরিয়ে গেছে। | প্রাইমারি পাসের জন্য ৫০টি লিঙ্ক করা পাসের সীমায় পৌঁছে গেছেন। |