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

اعلان‌های راه‌اندازی شده توسط شریک

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

پس زمینه

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

اعلان‌های خودکار توسط Google Wallet راه‌اندازی می‌شوند

اطلاعیه آتی

Google Wallet سه ساعت قبل از پرواز یک اعلان برای کاربر ارسال می کند. زمان پرواز توسط class.localScheduledDepartureDateTime تعریف می شود.

برای دریافت این اعلان، کاربر باید اعلان ها را فعال کرده باشد. برای بررسی این موضوع، آن‌ها می‌توانند به تنظیمات > اعلان‌ها بروید و ببینند آیا به‌روزرسانی‌های مجوزهای شما روشن است یا خیر.

اگر کاربر اعلان‌ها را برای صفحه قفل فعال کرده باشد، در قسمت اعلان‌ها و در صفحه قفل نشان داده می‌شود.

اعلان فرمت غیر قابل تغییر زیر را دارد:

  Boarding pass for your flight to class.destination.airportIataCode
  

اگر آنها روی اعلان ضربه بزنند و قفل دستگاه خود را باز کنند، مجوز آنها در برنامه Google Wallet ظاهر می شود.

اگر کاربر چندین پاس داشته باشد، فقط زودترین پاس قابل استفاده نشان داده می شود. اگر آنها مجوزهای گروه‌بندی‌شده را براساس کارت‌های پرواز چندگانه گروه اضافه کرده باشند، اعلان فقط یکی از مجوزهای گروه را نشان می‌دهد. با این حال، وقتی کاربر روی آن ضربه می‌زند، می‌تواند برای دیدن سایر پاس‌های آن گروه، انگشت خود را به چپ و راست بکشد.

اعلان پین شده است و پس از باز کردن آن توسط کاربر، به‌طور خودکار رد نمی‌شود. رد خودکار 60 دقیقه پس از class.localScheduledDepartureDateTime انجام می شود.localScheduledDepartureDateTime.

اعلان به روز رسانی پرواز

وقتی قسمت‌های خاصی از یک پرواز تغییر می‌کند، کاربرانی که یک یا چند کارت پرواز اضافه کرده‌اند، اعلان فشاری را در دستگاه‌های خود دریافت می‌کنند. این تنها در صورت رعایت شرایط خاص اتفاق می افتد.

ترمینال و گیت مبدا

اگر class.origin.terminal یا class.origin.gate را تغییر دهید و شرایط زیر برقرار باشد، اعلانی مبنی بر تغییر فیلد ارسال می‌شود.

• کمتر از سه ساعت تا class.localScheduledDepartureDateTime باقی مانده است.

این اعلان به شکل زیر است: "Sample Airlines گیت شما را به A1 به روز کرده است." قالب را نمی توان تغییر داد.

زمان سوار شدن و زمان حرکت

اگر class.localBoardingDateTime یا class.localEstimatedOrActualDepartureDateTime را تغییر دهید و شرایط زیر برآورده شود، اعلانی مبنی بر تغییر فیلد ارسال می شود.

• کمتر از 24 ساعت تا class.localScheduledDepartureDateTime باقی مانده است.
• زمان مربوطه حداقل 10 دقیقه یا بیشتر تغییر می کند.

اعلان در قالب زیر است: "_Sample Airlines ساعت پرواز شما را به ساعت 6:00 بعد از ظهر به روز کرده است._" قالب یا زبان را نمی توان سفارشی کرد.