הוספה אוטומטית של כרטיסי עלייה למטוס

רקע

התכונה מאפשרת לחברות תעופה לשלוח באופן אוטומטי כרטיסי עלייה למטוס ל-Google Wallet של המשתמש. האפשרות הזו תועיל במיוחד לנוסעים מתמידים, כי היא תאפשר להם להוסיף את כרטיסי העלייה למטוס ל-Wallet בצורה פשוטה יותר ועם פחות חיכוך, בהתחשב בתדירות הנסיעות הגבוהה שלהם.

הפעולה הזו מתבצעת באופן אוטומטי, ללא קשר לערוץ הצ'ק-אין (למשל, אתר, אפליקציה או עמדת צ'ק-אין בשדה התעופה). שותפות תעופה יכולות להשתמש במספר חשבון המועדון של המשתמש כדי ליצור קורלציה ולדחוף את הכרטיס ל-Wallet שלו.

איך התכונה הזו פועלת

שלב 1: מאפשרים לנוסע המתמיד להוסיף ל-Wallet את כרטיס המועדון של הנוסע המתמיד.

שלב 2: מוסיפים אוטומטית כרטיסי עלייה למטוס חדשים לנוסע המתמיד על ידי קישור שלהם לכרטיס המועדון ב-Wallet.

שיטות מומלצות

• כדי לאפשר הרשמה חלקה למועדון לקוחות לנוסעים מתמידים, כדאי להפעיל תהליך הרשמה או כניסה באמצעות חשבון Google. לאחר מכן, המשתמשים יוכלו לגלות את תהליך ההרשמה למועדון הלקוחות של חברת התעופה בנקודות כניסה שונות ב-Google Wallet, כולל כרטיסי עלייה למטוס.
• כדאי להפעיל הרשמה בלחיצה אחת לחברי מועדון קיימים באפליקציית Android ובאתר.

הערה: התכונה הזו היא יישום ספציפי של היכולת 'כרטיסים מקושרים אוטומטית'. בהקשר הזה, הכרטיס הראשי הוא כרטיס מועדון לקוחות והכרטיס המקושר הוא כרטיס עלייה למטוס. בהמשך המסמך הזה נשתמש במינוח הכללי יותר – כרטיסים שמקושרים אוטומטית, כרטיס ראשי וכרטיס מקושר – כדי לתאר את הפונקציונליות הזו.

שיקולים לשימוש בכרטיסים שמקושרים אוטומטית

• האובייקט הראשי והאובייקט המקושר חייבים להשתמש באותו issuerId.
• אין ערובה לכך שהכרטיסים המקושרים יועברו אוטומטית, וההעברה מתבצעת כמיטב היכולת. המשתמשים יכולים לבטל את ההסכמה לקבלת כרטיסים שמקושרים אוטומטית. אם התרחיש לדוגמה הוא קריטי והמשתמש חייב לקבל את הכרטיס המקושר, מומלץ לתקשר איתו בערוץ אחר כדי לוודא שהוא יוסיף את הכרטיס.
• העדכונים במדיניות השימוש המקובל של Google Wallet כוללים הנחיות לשימוש בכרטיסים שמקושרים אוטומטית, וחובה לפעול בהתאם להנחיות האלה.

שלבי ההטמעה

אם כבר יצרתם אובייקט ראשי, אתם יכולים לדלג על שלב 1.

1. יוצרים אובייקט מכל סוג כרטיס שמופיע ברשימה עם הפרמטרים הנדרשים. זהו אובייקט primary.
2. יוצרים אובייקט נוסף מכל סוג כרטיס שמופיע ברשימה. זה יהיה האובייקט המקושר.
3. לפני או אחרי ששומרים את האובייקט הראשי, מעדכנים את האובייקט הראשי עם המזהה של האובייקט המקושר בפרמטר linkedObjectIds.

יש מטען ייעודי (payload) מינימלי שנדרש כדי להגדיר את המאפיין linkedObjectIds בכרטיס מעבר ראשי. שלושת הפרמטרים הנדרשים כוללים:

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, כולל:

Message	סיבה
לאובייקט הראשי ולאובייקט המקושר אין אותו מזהה מנפיק.	אי אפשר לצרף אובייקט מקושר לאובייקט של מנפיק אחר.
האובייקט הראשי והאובייקט המקושר מתייחסים לאותו אובייקט.	אי אפשר לצרף את אותו אובייקט בתור linkedObject.
האובייקט המקושר לא קיים.	האובייקט המקושר צריך כבר להיות מוכנס ל-Wallet API.
לאובייקט המקושר כבר יש אובייקט מקושר אחר. אי אפשר להוסיף אובייקטים מקושרים מוטמעים.	אי אפשר לקשר אובייקטים מקושרים לאובייקטים מקושרים אחרים.
האובייקט כבר מקושר לאובייקט אחר. אי אפשר להוסיף אובייקטים מקושרים מוטמעים.	האובייקט הראשי לא יכול להיות אובייקט מקושר בפני עצמו.