Push Bildirimlerini Tetikle

Bildirim Türleri

Mesaj ekleme ve bildirim verme

Arka plan

Kullanıcılar kart ekledikten sonra kartla ilgili bir mesaj gönderebilir ve kartla ilgili bildirim almalarını tercih edebilirsiniz. TEXT_AND_NOTIFY değerine eşit bir message_type ile Add Message API isteği kullanıldığında aşağıdakiler gerçekleşir:

  1. "Kartın arkasına" (diğer adıyla Ayrıntılar Şablonu) bir "Mesaj" öğesi eklenir ve kart kayıtlı olan kullanıcılara bir push bildirimi gönderilir.
  2. Kullanıcı bildirime dokunduğunda Google Cüzdan, kartın ön yüzünde (kart görünümü) açılır ve ekranın üst kısmında "Mesajı Görüntüle" düğmesini içeren bir açıklama metni gösterilir.
  3. Açıklama metni tıklandığında kullanıcılar, yeni okunmamış mesajların vurgulandığı kartın arkasına yönlendirilir.

Kullanıcılara bildirim içeren mesajlar gönderirken dikkat edilmesi gereken noktalar

  • Kullanıcıların, mesajlarla ilgili push bildirimleri alabilmesi için kartlarında bildirimlerin etkinleştirilmiş olması gerekir.
  • Mesajlarda, web sitenize veya uygulamanıza yönlendiren URI'lar bulunabilir. Köprüler, kartla ilgili bir web sitesi veya uygulama olmalıdır. Kullanıcıları geçişle ilgili olmayan bağlantılara yönlendirmek Kabul Edilebilir Kullanım Politikası'nı ihlal eder.
  • 24 saat içinde push bildirimi tetikleyen en fazla 3 mesaj gönderebilirsiniz. Google, kullanıcılarınıza spam gönderdiğinizi tespit ederse push bildirimi yayınlama kotanızı kısıtlayabilir.
  • Kullanıcıların kilit ekranlarında gördüğü push bildirimleri Google Cüzdan tarafından kontrol edilir.
  • Normal sınıf veya nesne uç noktasını kullanarak mesaj verilerini düzenlemek ya da kaldırmak için UPDATE veya PATCH yöntemlerini kullanabilirsiniz.

Entegrasyon Adımları

AddMessage API kullanılarak eklenen yeni bir veren mesajı hakkında kullanıcıları bilgilendirmek istediğinizde, yeni metninizi içeren Message öğesinin MessageType özelliğinin TEXT yerine TEXT_AND_NOTIFY değerini alması için AddMessageRequest öğesini güncellemeniz gerekir.

Geçişler sınıfına mesaj eklemek ve bildirim göndermek için örnek JSON isteği

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

Passes nesnesinde mesaj eklemek ve bildirim göndermek için örnek JSON isteği

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

Geçiş sınıfı için mesaj eklemek ve bildirim göndermek üzere örnek Yanıt

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

İstisna işleme

3'ten fazla bildirim gönderme girişimi QuotaExceededException yanıtı verir. Kartla ilgili diğer güncellemeler, Entegrasyon Adımları bölümünde açıklandığı gibi "TEXT_AND_NOTIFY" yerine "TEXT" kullanılarak ayarlanabilir.

Alanı güncelleme ve bildirim gönderme

Arka plan

Kullanıcı bir geçiş ekledikten sonra belirli alanları güncellediğinizde push bildirimi tetiklemek isteyebilirsiniz. Bildirim, kullanıcının kilit ekranında gösterilir ve kullanıcıya kartıyla ilgili bir güncelleme olduğunu bildirir. Bu bildirim yalnızca UPDATE ve PATCH API yöntemleri kullanılarak aşağıda tanımlanan belirli bir alan alt kümesi için tetiklenir. Kartı güncellemek için bir API çağrısı yapıldığında aşağıdakiler gerçekleşir:

  1. Kullanıcının kilit ekranında, geçiş güncellemesi hakkında bilgilendiren bir push bildirimi tetiklenir ve görüntülenir.
  2. Kullanıcı bildirime dokunduğunda Google Cüzdan, kartın ön yüzüne (kart görünümü) açılır ve ekranın üst kısmında "Güncellemeyi incele" düğmesini içeren bir açıklama metni gösterilir.
  3. Düğmeyi tıklayan kullanıcı, güncellemeyle değiştirilen alanları görebildiği bir ekrana yönlendirilir.

Alan güncelleme bildirimleri gönderirken dikkat edilmesi gereken bazı noktalar

  • Kullanıcıların, güncellemelerle ilgili push bildirimlerini alabilmeleri için kartlarının bildirimlerinin etkinleştirilmiş olması gerekir.
  • 24 saat içinde push bildirimi tetikleyen en fazla 3 güncelleme gönderebilirsiniz. Google, kullanıcılarınıza spam gönderdiğinizi tespit ederse push bildirimi yayınlama kotanızı düşürebilir.
  • Kullanıcıların kilit ekranlarında gördükleri push bildirimi Google Cüzdan tarafından kontrol edilir.
  • notifyPreference alanı, yalnızca bu istekte bulunan geçici bir alandır. Gelecekte bildirim tetiklemek istediğiniz isteklerde sınıf veya nesne isteğinde bu alanı sıfırlamanız gerekir.

Entegrasyon Adımları

Bu bildirimleri tetiklemek için mevcut UPDATE veya PATCH çağrılarını kullanmanız ve notifyPreference'yi belirtmeniz gerekir. Bir sınıf veya nesnenin alanını güncellerken bildirimi tetiklemek için sınıfa ya da nesne isteğine notifyPreference adlı yeni bir alan ekleyebilirsiniz.

Sınıfta güncelleme ve bildirim için örnek JSON isteği

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

Güncellenen alanın şu anda destekleniyor olması durumunda notifyPreference, notifyOnUpdate olarak ayarlanırsa bir bildirim tetiklenir.

Desteklenen alanlar

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment