כרטיסים שמקושרים באופן אוטומטי

רקע

התכונה 'כרטיסים מקושרים אוטומטיים' מאפשרת לשלוח כרטיסים נוספים אל משתמש שהכרטיס הקיים שלך כבר שמור ב-Google Wallet שלו. אפשר גם קישור טרום-קישור (pre-link) מועבר לכרטיס ראשי כשמשתמש שומר את הכתובת הראשית (הציון הראשי). הכרטיס המקושר האוטומטי מקובץ עם הכרטיס הראשי עם הסבר מעל הכרטיס הראשי שמיידע את המשתמש שקיבל כרטיס חדש מקושר. סוגי הכרטיסים הבאים נתמכים ככרטיסים ראשיים או מקושרים:

  • כרטיס לאירוע
  • כרטיס עלייה למטוס
  • כרטיס לתחבורה ציבורית
  • ההצעה
  • כרטיס מתנה
  • כרטיס מועדון לקוחות
  • כרטיס גנרי
דוגמה ראשית לכרטיס שקושר אוטומטית דוגמה משנית של כרטיס שקושר אוטומטית
כרטיס ראשי עם נכס היתרונות המרכזיים שנוסף לו כרטיס חדש כרטיס חדש שמקושר לכרטיס הראשי

תרחישים לדוגמה

יכולים להיות תרחישים שונים לדוגמה לקישור כרטיסים לכרטיס קיים. במידה מסוימת לדוגמה:

  • אפשר לקשר מבצע לכרטיס מועדון לקוחות קיים.
  • קישור שובר ארוחה לכרטיס עלייה למטוס או לכרטיס לאירוע.
  • אפשר לקשר כרטיס חניה לכרטיס לאירוע.

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

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

שלבי שילוב

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

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

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

  1. ISSUERID.PRIMARY_OBJECT_ID
  2. ISSUERID.PRIMARY_CLASS_ID
  3. ISSUERID.LINKED_OBJECT_ID

דוגמה לבקשת JSON להוספת אובייקט מקושר לאובייקט Pass

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

דוגמה לתגובת JSON אחרי קישור אובייקט לאובייקט Pass

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

התנהגות צפויה

אחרי שמתקבלת תגובה מוצלחת, מכשירים עם הכרטיס שעדכנת לקבל את הכרטיס המקושר. הכרטיס המקושר הזה יקבץ יחד עם הכרטיס הראשי. המשתמשים יכולים לראות את הכרטיס המקושר בהחלקה ימינה.

טיפול בחריגים

שגיאות אפשריות עלולות להתרחש בגלל שימוש שגוי ב-API, כוללים;

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