Bildirim Türleri
Mesaj Ekle ve Bildir
Arka plan
Bir kullanıcı kart ekledikten sonra, bu kullanıcıya kartla ilgili bir mesaj gönderebilir ve bu konuda bilgilendirildiğinden emin olabilirsiniz. Add Message API (Mesaj Ekle API) isteği TEXT_AND_NOTIFY değerine eşit bir message_type ile kullanıldığında aşağıdakiler gerçekleşir:
- "Kartın arka yüzü"ne (Ayrıntılar Şablonu olarak da bilinir) bir "Mesaj" öğesi eklenir ve kartın kayıtlı olduğu kullanıcılara bir push bildirimi gönderilir.
- Kullanıcı bildirime dokunduktan sonra, Google Cüzdan kartın önünde açılır (Kart görünümü olarak da bilinir) ve ekranın üst kısmında "Mesajı Görüntüle" düğmesini içeren bir açıklama metni görür.
- Açıklama metni tıklandığında kullanıcılar, yeni okunmamış mesajların vurgulandığı kartın arka tarafına yönlendirilir.
Kullanıcılara bildirim içeren iletiler gönderirken dikkat edilmesi gereken noktalar
- Kullanıcıların mesajlarla ilgili push bildirimleri alabilmesi için kartlarında bildirimleri etkinleştirmiş olması gerekir.
- İletiler, web sitenize veya uygulamanıza yönlendiren URI'lar içerebilir. Köprüler, kartla ilgili bir web sitesi veya uygulama olmalıdır. Kullanıcıları kartla ilgili olmayan bağlantılara göndermek Kabul Edilebilir Kullanım Politikası'nı ihlal eder.
- 24 saatlik süre içinde, push bildirimini tetikleyen en fazla 3 mesaj gönderebilirsiniz. Google, kullanıcılarınıza spam gönderdiğinizi tespit ederse push bildirimi teslim kotanızı kısıtlayabilir.
- Kullanıcıların kilit ekranlarında gördüğü push bildirimi 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 yayıncı mesajı hakkında kullanıcıları bilgilendirmek istediğinizde, yeni metninizi içeren Message'ın TEXT_AND_NOTIFY yerine TEXT_AND_NOTIFY değerini içerecek şekilde AddMessageRequest'i güncellemeniz gerekir.MessageType
Kartlar Sınıfında mesaj ekleme ve bilgilendirmeye yönelik örnek JSON İsteğ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"
},
…
Kartlar Nesnesinde mesaj ve bildirim eklemeye yönelik ö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"
},
…
Başarılı bir sınıf için mesaj eklemek ve bilgilendirmek 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 bildirim gönderme girişimleri, QuotaExceededException yanıtı verir. Kartta yapılacak diğer güncellemeler, Entegrasyon Adımları'nda açıklandığı gibi "TEXT_AND_NOTIFY" yerine "TEXT" kullanılarak ayarlanabilir.