הפעלת התראות

סוגי התראות

הוספת הודעה והודעה

רקע

אחרי שמשתמש מוסיף כרטיס, כדאי לשלוח לו הודעה שקשורה לכרטיס כדי לוודא שהוא יקבל הודעה על כך. כשמשתמשים בבקשה של Add Message API עם message_type שווה ל-TEXT_AND_NOTIFY, מתרחשים האירועים הבאים:

1. המערכת מוסיפה את הפריט Message ל'גב הכרטיס' (שנקרא גם Details Template) ושולחת התראה ב-push למשתמשים ששמרו את הכרטיס.
2. כשהמשתמש מקיש על ההתראה, הוא פותח את Google Wallet בחלק הקדמי של הכרטיס (שנקרא גם תצוגת כרטיסים), ולמשתמש מוצג הסבר בחלק העליון של המסך עם הלחצן View Message.
3. לחיצה על ההסבר תעביר את המשתמשים לחלק האחורי של הכרטיס, שבו מודגשות הודעות חדשות שלא נקראו.

נקודות שכדאי להביא בחשבון כששולחים הודעות עם התראות למשתמשים

• כדי שהמשתמשים יקבלו התראות על הודעות, ההתראות צריכות להיות מופעלות בכרטיסים שלהם.
• ההודעות עשויות להכיל מזהי URI לאתר או לאפליקציה שלכם. היפר-קישורים חייבים להיות אתר או אפליקציה שקשורים לכרטיס. שליחת משתמשים לקישורים שלא קשורים לכרטיס היא הפרה של מדיניות השימוש המקובל.
• אתם יכולים לשלוח לכל היותר 3 הודעות שיפעילו התראת Push בפרק זמן של 24 שעות. Google עשויה להגביל את המכסה שלכם לשליחת הודעות Push אם היא תגיע למסקנה שאתם שולחים ספאם למשתמשים.
• ההתראה שהמשתמשים רואים במסך הנעילה נשלטת על ידי Google Wallet.
• אפשר להשתמש ב-methods UPDATE או PATCH כדי לערוך או להסיר את נתוני ההודעה באמצעות נקודת הקצה הרגילה של המחלקה או האובייקט.

שלבי ההטמעה

אם רוצים להודיע למשתמשים על הודעת מנפיק חדשה שנוספה באמצעות AddMessage API, צריך לעדכן את AddMessageRequest כך שMessage שמכיל את הטקסט החדש יהיה עם MessageType TEXT_AND_NOTIFY במקום TEXT.

דוגמה לבקשת JSON להוספת הודעה ושליחת התראה בכיתה של כרטיסים

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

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

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

דוגמה לתגובה להוספת הודעה ולעדכון על סיום בחינת מעבר

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

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

כל ניסיון לשלוח יותר מ-3 הודעות יוביל לתגובה QuotaExceededException. אפשר להגדיר עדכונים נוספים לכרטיס באמצעות TEXT במקום TEXT_AND_NOTIFY, כפי שמתואר בקטע שלבי השילוב.