Push Bildirimlerini Tetikle

Bildirim Türleri

Mesaj Ekle ve Bildir

Arka plan

Bir kullanıcı kart ekledikten sonra, kartla ilgili bir mesaj göndererek kullanıcının bu konuda bilgilendirilmesini sağlayabilirsiniz. Add Message API isteği, TEXT_AND_NOTIFY değerine eşit bir message_type ile kullanıldığında aşağıdaki işlem gerçekleşir:

  1. "Kartın arka yüzüne" (Ayrıntılar Şablonu olarak da bilinir) bir "Mesaj" öğesi eklenir ve kart kaydedilen kullanıcılara push bildirimi gönderilir.
  2. Kullanıcı bildirime dokunduğunda kartın ön tarafında Google Cüzdan açılır (Kart görünümü olarak da bilinir) ve kullanıcı ekranın üst kısmında "Mesajı Göster" düğmesinin bulunduğu bir açıklama metni görür.
  3. Açıklamayı tıklayan 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.
  • 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 ekleme ve bilgilendirme ile ilgili örnek JSON İsteğ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 defadan fazla bildirimde bulunma girişimleri, 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.