পটভূমি
অটো লিঙ্কড পাসেস ফিচারটি আপনাকে এমন একজন ব্যবহারকারীকে অতিরিক্ত পাস পাঠাতে দেয়, যার গুগল ওয়ালেটে আপনার বিদ্যমান পাসটি আগে থেকেই রয়েছে। ব্যবহারকারী যখন প্রাইমারি (প্রধান) পাসটি সেভ করেন, তখন আপনি সেই প্রাইমারি পাসের সাথে অন্যান্য পাস আগে থেকেই লিঙ্ক করে রাখতে পারেন। অটো লিঙ্কড পাসটি প্রাইমারি পাসের সাথে গ্রুপ করা থাকে এবং প্রাইমারি পাসের উপরে একটি কলআউট ব্যবহারকারীকে জানিয়ে দেয় যে একটি নতুন পাস লিঙ্ক করা হয়েছে। প্রাইমারি বা লিঙ্কড পাস হিসেবে নিম্নলিখিত ধরনের পাসগুলো সমর্থিত;
- ইভেন্টের টিকিট
- বোর্ডিং পাস
- ট্রানজিট পাস
- অফার
- উপহার কার্ড
- লয়ালটি পাস
- জেনেরিক পাস
 |  |
| প্রাথমিক পাসের সাথে এই ঘোষণা যে একটি নতুন পাস যোগ করা হয়েছে। | প্রাথমিক পাসের সাথে সংযুক্ত নতুন পাস |
ব্যবহারের ক্ষেত্র
বিদ্যমান পাসের সাথে নতুন পাস লিঙ্ক করার ক্ষেত্রে আপনার বিভিন্ন ব্যবহারের ক্ষেত্র থাকতে পারে। কিছু উদাহরণ হলো:
- বিদ্যমান লয়ালটি কার্ডের সাথে একটি অফার লিঙ্ক করুন।
- একটি খাবারের ভাউচারকে বোর্ডিং পাস বা ইভেন্টের টিকিটের সাথে লিঙ্ক করুন।
- ইভেন্টের টিকিটের সাথে পার্কিং পাস লিঙ্ক করুন।
অটো লিঙ্কড পাস ব্যবহার করার সময় কিছু বিবেচ্য বিষয়
- প্রাথমিক অবজেক্ট এবং লিঙ্ক করা অবজেক্টে অবশ্যই একই issuerId ব্যবহার করতে হবে।
- প্রতিটি প্রাথমিক অবজেক্টের জন্য ৫০টি লিঙ্ক করা অবজেক্টের সীমা রয়েছে।
- স্বয়ংক্রিয়ভাবে লিঙ্ক করা পাস পাঠানো নিশ্চিত নয় এবং এটিকে একটি সর্বোত্তম প্রচেষ্টা হিসেবে বিবেচনা করা হয়। ব্যবহারকারীরা স্বয়ংক্রিয়ভাবে লিঙ্ক করা পাস গ্রহণ করা থেকে বিরত থাকতে পারেন। যদি ব্যবহারের ক্ষেত্রটি অত্যন্ত গুরুত্বপূর্ণ হয় এবং ব্যবহারকারীকে অবশ্যই লিঙ্ক করা পাসটি পেতে হয়, তবে ব্যবহারকারী যাতে পাসটি যোগ করেন তা নিশ্চিত করার জন্য আমরা অন্য কোনো মাধ্যমে যোগাযোগ করার পরামর্শ দিই।
- গুগল ওয়ালেট AUP- এর আপডেটে অটো লিঙ্কড পাস ব্যবহারের নির্দেশিকা অন্তর্ভুক্ত করা হয়েছে, যা অবশ্যই মেনে চলতে হবে।
একীকরণ পদক্ষেপ
যদি আপনি আগে থেকেই একটি প্রাথমিক অবজেক্ট তৈরি করে থাকেন, তাহলে আপনি ধাপ ১ বাদ দিতে পারেন।
- প্রয়োজনীয় প্যারামিটারসহ তালিকাভুক্ত যেকোনো পাস টাইপের একটি অবজেক্ট তৈরি করুন। এটিই হলো প্রাথমিক অবজেক্ট।
- তালিকাভুক্ত যেকোনো পাস টাইপের আরেকটি অবজেক্ট তৈরি করুন। এটিই লিঙ্ক করা অবজেক্ট হবে।
- প্রাথমিক অবজেক্টটি সংরক্ষণ করার আগে বা পরে, linkedObjectIds প্যারামিটারে লিঙ্ক করা অবজেক্টের আইডি দিয়ে প্রাথমিক অবজেক্টটি আপডেট করুন ।
প্রাথমিক পাসে linkedObjectIds সেট করার জন্য একটি ন্যূনতম পেলোড প্রয়োজন। প্রয়োজনীয় ৩টি প্যারামিটার হলো:
- ইস্যুকারী আইডি.প্রাথমিক_বস্তু আইডি
- ইস্যুকারী আইডি.প্রাথমিক_শ্রেণী_আইডি
- ইস্যুকারী আইডি.লিঙ্কড_অবজেক্ট_আইডি
একটি পাস অবজেক্টে লিঙ্ক করা অবজেক্ট যোগ করার জন্য 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"
}
…প্রত্যাশিত আচরণ
সফলভাবে সাড়া পাওয়ার পর, আপনার আপডেট করা পাস থাকা ডিভাইসগুলোতে লিঙ্ক করা পাসটি পৌঁছে যাবে। এই লিঙ্ক করা পাসটি মূল পাসের সাথে একত্রিত থাকবে। ব্যবহারকারীরা ডানদিকে সোয়াইপ করে লিঙ্ক করা পাসটি দেখতে পারবেন।
ব্যতিক্রম পরিচালনা
এপিআই-এর ভুল ব্যবহারের ফলে সম্ভাব্য ত্রুটি ঘটতে পারে, যার মধ্যে অন্তর্ভুক্ত থাকতে পারে;
| বার্তা | কারণ |
|---|---|
| প্রাথমিক অবজেক্ট এবং লিঙ্ক করা অবজেক্টের ইস্যুকারী আইডি একই হয় না। | আপনি একটি লিঙ্ক করা অবজেক্টকে অন্য কোনো ইস্যুকারীর অবজেক্টের সাথে সংযুক্ত করতে পারবেন না। |
| প্রাথমিক অবজেক্ট এবং লিঙ্কড অবজেক্ট একই অবজেক্টকে নির্দেশ করে। | আপনি লিঙ্ক করা অবজেক্ট হিসেবে একই অবজেক্ট সংযুক্ত করতে পারবেন না। |
| লিঙ্ক করা অবজেক্টটির অস্তিত্ব নেই। | লিঙ্ক করা অবজেক্টটি ইতিমধ্যেই ওয়ালেট এপিআই-তে অন্তর্ভুক্ত থাকা উচিত। |
| লিঙ্ক করা অবজেক্টের ইতিমধ্যেই আরেকটি লিঙ্ক করা অবজেক্ট রয়েছে। নেস্টেড লিঙ্ক করা অবজেক্ট যোগ করা যাবে না। | লিঙ্ক করা অবজেক্টের অন্য কোনো লিঙ্ক করা অবজেক্ট থাকতে পারে না। |
| একটি অবজেক্ট ইতিমধ্যেই অন্য একটি অবজেক্টের সাথে লিঙ্ক করা আছে। নেস্টেড লিঙ্কড অবজেক্ট যোগ করা যাবে না। | প্রাথমিক অবজেক্ট নিজে একটি লিঙ্কড অবজেক্ট হতে পারে না। |
| আর কোনো সংযুক্ত বস্তু যোগ করা যাবে না, সীমা অতিক্রম করা হয়েছে। | প্রাথমিক পাসের জন্য ৫০টি সংযুক্ত পাসের সীমা পূরণ হয়ে গেছে। |