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

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

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

پس زمینه

پس از اینکه کاربر یک گذرنامه اضافه کرد، ممکن است بخواهید برای او پیامی مربوط به گذرنامه ارسال کنید و مطمئن شوید که در مورد آن مطلع شده است. با استفاده از درخواست 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 " همانطور که در مراحل ادغام مورد بحث قرار گرفت، تنظیم کرد.

فیلد را به روز کنید و اطلاع دهید

پس زمینه

پس از اینکه کاربر یک پاس را اضافه کرد، ممکن است بخواهید هنگام به روز رسانی فیلدهای خاص، یک اعلان فشاری راه اندازی کنید. این اعلان در صفحه قفل کاربر ظاهر می شود و به آنها اطلاع می دهد که یک به روز رسانی در گذرنامه او وجود دارد. این اعلان فقط برای زیرمجموعه خاصی از فیلدهای تعریف شده در زیر با استفاده از روش های UPDATE و PATCH API فعال می شود. هنگامی که یک تماس API برای به روز رسانی پاس انجام می شود، موارد زیر رخ می دهد:

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

برخی از ملاحظات هنگام ارسال اعلان های به روز رسانی فیلد

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

مراحل ادغام

برای فعال کردن این اعلان‌ها، باید از تماس‌های UPDATE یا PATCH موجود استفاده کنید و notifyPreference را مشخص کنید. هنگام به‌روزرسانی یک فیلد در یک کلاس یا شی، می‌توانید یک فیلد جدید، notifyPreference به درخواست کلاس یا شی اضافه کنید تا اعلان را فعال کند.

مثال درخواست JSON برای به روز رسانی و اطلاع رسانی در یک کلاس

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …
  

تنظیم notifyPreference روی notifyOnUpdate یک اعلان را راه اندازی می کند، مشروط بر اینکه فیلد به روز شده در حال حاضر پشتیبانی شود.

زمینه های پشتیبانی شده

FlightObject

• boardingAndSeatingInfo.seatNumber
• boardingAndSeatingInfo.seatAssignment