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