অটো লিঙ্কড পাস

পটভূমি

স্বয়ংক্রিয় লিঙ্কযুক্ত পাস বৈশিষ্ট্য আপনাকে এমন একজন ব্যবহারকারীকে অতিরিক্ত পাস পাঠাতে দেয় যার ইতিমধ্যেই তাদের Google ওয়ালেটে আপনার বিদ্যমান পাস রয়েছে৷ একজন ব্যবহারকারী প্রাথমিক (প্রধান) পাস সংরক্ষণ করলে আপনি একটি প্রাথমিক পাসে প্রি-লিঙ্ক পাসও করতে পারেন। স্বয়ংক্রিয় লিঙ্কযুক্ত পাসটিকে প্রাথমিক পাসের সাথে গোষ্ঠীভুক্ত করা হয় প্রাথমিক পাসের উপরে একটি কলআউট সহ ব্যবহারকারীকে জানিয়ে দেয় যে একটি নতুন পাস লিঙ্ক করা হয়েছে। নিম্নলিখিত পাস প্রকারগুলি প্রাথমিক বা লিঙ্কযুক্ত পাস হিসাবে সমর্থিত;

• অনুষ্ঠানের টিকিট
• বোর্ডিং পাস
• ট্রানজিট পাস
• অফার
• উপহার কার্ড
• আনুগত্য পাস
• সাধারণ পাস

একটি নতুন পাস যোগ করা হয়েছে যে কলআউট সঙ্গে প্রাথমিক পাস	প্রাথমিক পাসের সাথে নতুন পাস লিঙ্ক করা হয়েছে

কেস ব্যবহার করুন

একটি বিদ্যমান পাসের সাথে পাস লিঙ্ক করার জন্য আপনার বিভিন্ন ব্যবহারের ক্ষেত্রে থাকতে পারে। কিছু উদাহরণ অন্তর্ভুক্ত:

• একটি বিদ্যমান আনুগত্য কার্ডের সাথে একটি অফার লিঙ্ক করুন।
• বোর্ডিং পাস বা ইভেন্ট টিকিটের সাথে খাবারের ভাউচার লিঙ্ক করুন।
• একটি ইভেন্ট টিকিটের সাথে একটি পার্কিং পাস লিঙ্ক করুন।

অটো লিঙ্কড পাস ব্যবহার করার সময় কিছু বিবেচনা

• প্রাথমিক অবজেক্ট এবং লিঙ্ক করা অবজেক্টকে অবশ্যই একই ইস্যুকারী আইডি ব্যবহার করতে হবে।
• প্রাথমিক বস্তুর প্রতি 50টি লিঙ্কযুক্ত বস্তুর সীমা রয়েছে।
• সংযুক্ত পাসগুলিকে স্বয়ংক্রিয়ভাবে ঠেলে দেওয়া নিশ্চিত নয় এবং সর্বোত্তম প্রচেষ্টা হিসাবে বিবেচিত হয়। ব্যবহারকারীরা স্বয়ংক্রিয় লিঙ্কযুক্ত পাসগুলি গ্রহণ করা থেকে অপ্ট আউট করতে পারেন৷ যদি ব্যবহারের কেসটি জটিল হয় এবং ব্যবহারকারীকে অবশ্যই লিঙ্কযুক্ত পাসটি গ্রহণ করতে হবে, তবে ব্যবহারকারী পাসটি যোগ করেছেন তা নিশ্চিত করতে আমরা অন্য চ্যানেলের মাধ্যমে যোগাযোগ করার পরামর্শ দিই।
• Google Wallet AUP- এর আপডেটগুলি অটো লিঙ্কড পাসগুলির ব্যবহার সংক্রান্ত নির্দেশিকা অন্তর্ভুক্ত করে যা অবশ্যই মেনে চলতে হবে৷

ইন্টিগ্রেশন পদক্ষেপ

আপনি যদি ইতিমধ্যে একটি প্রাথমিক বস্তু তৈরি করে থাকেন তাহলে আপনি ধাপ 1 এড়িয়ে যেতে পারেন।

1. প্রয়োজনীয় পরামিতিগুলির সাথে তালিকাভুক্ত যেকোনো পাস টাইপের একটি বস্তু তৈরি করুন। এটি প্রাথমিক বস্তু।
2. তালিকাভুক্ত যেকোনো পাস টাইপের আরেকটি অবজেক্ট তৈরি করুন। এই লিঙ্ক করা বস্তু হতে যাচ্ছে.
3. প্রাইমারি অবজেক্ট সেভ করার আগে বা পরে, লিঙ্কড অবজেক্ট আইডিস প্যারামিটারে লিঙ্ক করা অবজেক্টের আইডি সহ প্রাইমারি অবজেক্ট আপডেট করুন ।

একটি প্রাথমিক পাসে LinkedObjectIds সেট করার জন্য একটি ন্যূনতম পেলোড প্রয়োজন। 3টি প্রয়োজনীয় পরামিতি অন্তর্ভুক্ত;

1. ISSUERID।PRIMARY_OBJECT_ID
2. ISSUERID।PRIMARY_CLASS_ID
3. 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 এর ভুল ব্যবহারের সাথে ঘটতে পারে যা অন্তর্ভুক্ত করতে পারে;

বার্তা	কারণ
প্রাথমিক অবজেক্ট এবং লিঙ্ক করা অবজেক্ট একই ইস্যুকারী আইডি শেয়ার করে না।	আপনি অন্য ইস্যুকারীর বস্তুর সাথে একটি লিঙ্কযুক্ত বস্তু সংযুক্ত করতে পারবেন না।
প্রাইমারি অবজেক্ট এবং লিঙ্কড অবজেক্ট একই অবজেক্টকে বোঝায়।	আপনি লিঙ্কডঅবজেক্টের মতো একই বস্তু সংযুক্ত করতে পারবেন না।
লিঙ্কযুক্ত বস্তুর অস্তিত্ব নেই।	লিঙ্ক করা বস্তুটি ইতিমধ্যেই Wallet API-এ ঢোকানো উচিত।
লিঙ্ক করা অবজেক্ট ইতিমধ্যেই অন্য লিঙ্কযুক্ত বস্তু আছে। নেস্টেড লিঙ্ক করা অবজেক্ট যোগ করা যাবে না।	লিঙ্কযুক্ত বস্তুর অন্য লিঙ্কযুক্ত বস্তু থাকতে পারে না।
বস্তুটি ইতিমধ্যেই অন্য বস্তুর সাথে লিঙ্ক করা আছে। নেস্টেড লিঙ্ক করা অবজেক্ট যোগ করা যাবে না।	প্রাইমারি অবজেক্ট নিজেই একটি লিঙ্কড অবজেক্ট হতে পারে না।
আর কোনো লিঙ্ক করা অবজেক্ট যোগ করা যাবে না, সীমা ছাড়িয়ে গেছে।	প্রাথমিক পাসের জন্য 50টি সংযুক্ত পাসের সীমা পৌঁছে গেছে।