Push Bildirimlerini Tetikle

Bildirim Türleri

Mesaj ekleme ve bildirim verme

Arka plan

Bir kullanıcı kart ekledikten sonra, kartla ilgili bir mesaj göndererek kullanıcının bu konuda bilgilendirilmesini sağlayabilirsiniz. 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çıklamayı tıklayan kullanıcılar, okunmamış yeni mesajların vurgulandığı kartın arka tarafı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.
  • Mesajlar, web sitenizin veya uygulamanızın URI'lerini içerebilir. 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. Kartta yapılacak diğer güncellemeler, Entegrasyon Adımları bölümünde açıklandığı gibi "TEXT_AND_NOTIFY" yerine "TEXT" kullanılarak ayarlanabilir.