הפעלת התראות

סוגי התראות

הוספת הודעה והתראה

רקע

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

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

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

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

שלבי שילוב

כשרוצים להודיע למשתמשים על הודעת מנפיק חדשה שנוספה באמצעות AddMessage API, תצטרכו לעדכן את AddMessageRequest. כך שההודעה שמכיל את הטקסט החדש, כולל 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 להוספת הודעה ולהתראה באובייקט כרטיסים

  …
  "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"
    },
  …

דוגמה לתשובה להוספת הודעה ולקבלת התראה לגבי כיתה ב-Pass

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