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