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