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, 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ı kartla 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 için ö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.