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

רקע

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

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

כרטיס ראשי עם הערה על כך שנוסף כרטיס חדש	כרטיס חדש מקושר לכרטיס הראשי

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

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

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

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

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

שלבי ההטמעה

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

1. יוצרים אובייקט מכל סוג כרטיס שמופיע ברשימה עם הפרמטרים הנדרשים. זהו אובייקט primary.
2. יצירת אובייקט נוסף מכל סוג כרטיס שמופיע ברשימה. זה יהיה האובייקט המקושר.
3. לפני או אחרי ששומרים את האובייקט הראשי, מעדכנים את האובייקט הראשי עם המזהה של האובייקט המקושר בפרמטר 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.
לאובייקט המקושר כבר יש אובייקט מקושר אחר. אי אפשר להוסיף אובייקטים מקושרים מוטמעים.	אי אפשר לקשר אובייקט מקושר לאובייקט מקושר אחר.
האובייקט כבר מקושר לאובייקט אחר. אי אפשר להוסיף אובייקטים מקושרים מוטמעים.	האובייקט הראשי לא יכול להיות אובייקט מקושר בפני עצמו.
אי אפשר להוסיף עוד אובייקטים מקושרים, חרגת מהמגבלה.	הגעתם למגבלה של 50 כרטיסים מקושרים לכרטיס הראשי.