پیشینه
ویژگی «گذرنامههای خودکار پیوندیافته» به شما امکان میدهد گذرنامههای اضافی را برای کاربری که از قبل گذرنامه شما را در کیف پول گوگل خود دارد، ارسال کنید. همچنین میتوانید وقتی کاربری گذرنامه اصلی (اصلی) را ذخیره میکند، گذرنامههای اضافی را از قبل به گذرنامه اصلی پیوند دهید. گذرنامه خودکار پیوندیافته با گذرنامه اصلی گروهبندی میشود و بالای گذرنامه اصلی به کاربر اطلاع میدهد که گذرنامه جدید پیوند داده شده است. انواع گذرنامههای زیر به عنوان گذرنامههای اصلی یا پیونددادهشده پشتیبانی میشوند.
- بلیط رویداد
- کارت سوار شدن به هواپیما
- مجوز عبور و مرور
- پیشنهاد
- کارت هدیه
- کارت وفاداری
- گذر عمومی
 |  |
| گذر اصلی با این توضیح که گذر جدیدی اضافه شده است | مجوز جدید به مجوز اصلی متصل شده است |
موارد استفاده
ممکن است موارد استفاده مختلفی برای پیوند دادن گذرها به یک گذر موجود داشته باشید. برخی از مثالها عبارتند از:
- یک پیشنهاد را به یک کارت وفاداری موجود پیوند دهید.
- کوپن غذا را به کارت پرواز یا بلیط رویداد متصل کنید.
- کارت پارکینگ را به بلیط رویداد متصل کنید.
برخی ملاحظات هنگام استفاده از کارتهای اعتباری خودکار
- شیء اصلی و شیء پیوند داده شده باید از issuerId یکسانی استفاده کنند.
- برای هر شیء اصلی، محدودیت ۵۰ شیء مرتبط وجود دارد.
- ارسال خودکار لینکهای عبور تضمینشده نیست و بهترین تلاش محسوب میشود. کاربران میتوانند از دریافت لینکهای عبور خودکار انصراف دهند. اگر مورد استفاده حیاتی است و کاربر باید لینک عبور را دریافت کند، توصیه میکنیم از طریق کانال دیگری ارتباط برقرار کنید تا مطمئن شوید که کاربر لینک عبور را اضافه میکند.
- بهروزرسانیهای AUP گوگل والت شامل راهنماییهایی در مورد استفاده از مجوزهای خودکار مرتبط است که باید رعایت شوند.
مراحل ادغام
اگر قبلاً یک شیء اصلی ایجاد کردهاید، میتوانید از مرحله ۱ صرف نظر کنید.
- یک شیء از هر نوع گذر فهرستشده با پارامترهای مورد نیاز ایجاد کنید. این شیء اصلی است.
- یک شیء دیگر از هر نوع گذرگاه ذکر شده ایجاد کنید. این شیء، شیء لینک شده خواهد بود.
- قبل یا بعد از ذخیره شدن شیء اصلی، شیء اصلی را با شناسه شیء لینکشده در پارامتر linkedObjectIds بهروزرسانی کنید .
برای تنظیم linkedObjectIds در یک مسیر اصلی، حداقل payload مورد نیاز است. 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) پیوست کنید. |
| شیء مرتبط وجود ندارد. | شیء لینکشده باید از قبل در API کیف پول وارد شده باشد. |
| شیء پیوندی از قبل یک شیء پیوندی دیگر دارد. نمیتوان اشیاء پیوندی تو در تو اضافه کرد. | اشیاء پیوندی نمیتوانند شیء پیوندی دیگری داشته باشند. |
| شیء از قبل به شیء دیگری لینک شده است. نمیتوان اشیاء لینکشدهی تودرتو اضافه کرد. | شیء اصلی نمیتواند به خودی خود یک شیء پیوندی باشد. |
| نمیتوان اشیاء پیوندی بیشتری اضافه کرد، از حد مجاز فراتر رفته است. | محدودیت ۵۰ پاس مرتبط برای پاس اصلی تکمیل شده است. |