הפעלת התראות

סוגי התראות

הוספת הודעה ושליחת התראה

רקע

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

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

שיקולים מסוימים בעת שליחת הודעות עם התראות למשתמשים

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

שלבי השילוב

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

דוגמה לבקשת 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 להוספת הודעה והתראה באובייקט 'כרטיסים'

  …
  "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" כפי שמתואר בשלבי השילוב.