اعلان‌های فشاری را فعال کنید

انواع اطلاع رسانی

پیام اضافه کنید و اطلاع دهید

پس زمینه

پس از اینکه کاربر یک گذرنامه اضافه کرد، ممکن است بخواهید برای او پیامی مربوط به گذرنامه ارسال کنید و مطمئن شوید که در مورد آن مطلع شده است. با استفاده از درخواست Add Message API با message_type برابر با TEXT_AND_NOTIFY موارد زیر رخ می دهد:

1. یک مورد " پیام " به "پشت پاس" (معروف به الگوی جزئیات ) اضافه می شود و یک اعلان فشار برای کاربران با ذخیره پاس ارسال می شود.
2. هنگامی که کاربر بر روی اعلان ضربه می زند، Google Wallet را در جلوی پاس باز می کند (معروف به نمای کارت) و کاربر یک فراخوانی را در بالای صفحه با دکمه "مشاهده پیام" می بیند.
3. با کلیک کردن بر روی فراخوانی، کاربران به پشت گذرنامه می‌برند، جایی که پیام‌های خوانده نشده جدید برجسته می‌شوند.

برخی از ملاحظات هنگام ارسال پیام همراه با اعلان به کاربران

• برای دریافت اعلان‌های فشار مربوط به پیام‌ها، کاربران باید اعلان‌ها را برای پاس خود فعال کنند.
• پیام ها ممکن است حاوی URI به وب سایت یا برنامه شما باشند. هایپرلینک ها باید یک وب سایت یا برنامه مرتبط با پاس باشد. ارسال کاربران به پیوندهایی که به گذرنامه مرتبط نیستند، نقض خط مشی استفاده قابل قبول است.
• شما می توانید حداکثر 3 پیام ارسال کنید که باعث ایجاد یک اعلان فشار در یک دوره 24 ساعته شود. اگر فکر کند که شما در حال ارسال هرزنامه به کاربران خود هستید، ممکن است Google سهمیه ارسال اعلان فشار شما را کاهش دهد.
• Push notification که کاربران روی صفحه قفل خود می بینند توسط Google Wallet کنترل می شود.
• می‌توانید از روش‌های UPDATE یا PATCH برای ویرایش یا حذف داده‌های پیام با استفاده از نقطه پایانی کلاس یا شی معمولی استفاده کنید.

مراحل ادغام

هنگامی که می خواهید کاربران را در مورد پیام صادرکننده جدیدی که با استفاده از AddMessage API اضافه شده است مطلع کنید، باید AddMessageRequest را به روز کنید تا پیام حاوی متن جدید شما به جای TEXT، MessageType 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 برای افزودن پیام و اطلاع رسانی در یک Object 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 " همانطور که در مراحل ادغام مورد بحث قرار گرفت، تنظیم کرد.