Firebase Cloud Messaging HTTP protokolü

Bu parametre bir mesajın alıcısını belirtir.

Değer; bir cihazın kayıt jetonu, cihaz grubunun bildirim anahtarı veya tek bir konu (/topics/ ön ekiyle) olabilir. Birden çok konuya ileti göndermek için condition parametresini kullanın.

Bu parametre bir çoklu yayın mesajının alıcısını belirtir. Mesaj, birden fazla kayıt jetonuna gönderilir.

Değer, çoklu yayın mesajının gönderileceği kayıt jetonları dizisi olmalıdır. Dizi en az 1, en fazla 1.000 kayıt jetonu içermelidir. Tek bir cihaza mesaj göndermek için to parametresini kullanın.

Çoklu yayın mesajlarına yalnızca HTTP JSON biçimi kullanılarak izin verilir.

Bu parametre, mesaj hedefini belirleyen koşulların mantıksal ifadesini belirtir.

Desteklenen koşul: "konularda "konunuz" olarak biçimlendirilmiş konu. Bu değer büyük/küçük harfe duyarlı değildir.

Desteklenen operatörler: &&, ||. Konu mesajı başına en fazla iki operatör desteklenir.

Bu parametre kullanımdan kaldırılmıştır. Bunun yerine, ileti alıcılarını belirtmek için to özelliğini kullanın. Birden fazla cihaza mesaj gönderme hakkında daha fazla bilgi için platformunuza ait dokümanlara bakın.

Bu parametre, daraltılabilen bir mesaj grubunu (ör.collapse_key: "Updates Available" içeren) tanımlar. Böylece, teslim devam ettirildiğinde yalnızca son mesaj gönderilir. Bunun amacı, cihaz tekrar çevrimiçi olduğunda veya etkin hale geldiğinde aynı mesajın çok fazla gönderilmesini önlemektir.

İletilerin hangi sırayla gönderileceği konusunda bir garanti olmadığını unutmayın.

Not: Aynı anda en fazla 4 farklı daraltma anahtarına izin verilir. Bu, FCM'nin istemci uygulaması başına aynı anda 4 farklı mesaj depolayabileceği anlamına gelir. Bu sayıyı aşarsanız FCM'nin hangi 4 daraltma anahtarını saklayacağına dair bir garanti yoktur.

İletinin önceliğini ayarlar. Geçerli değerler "normal" ve "high" olarak belirlenmiştir. Apple platformlarında bunlar, APN'lerin öncelikleri 5 ve 10'a karşılık gelir.

Varsayılan olarak, bildirim mesajları yüksek öncelikli, veri mesajları ise normal öncelikli olarak gönderilir. Normal öncelik, istemci uygulamasının pil tüketimini optimize eder ve hemen teslim gerekmiyorsa kullanılmalıdır. Normal önceliğe sahip mesajlarda, uygulama mesajı belirtilmemiş bir gecikmeyle alabilir.

Bir mesaj yüksek öncelikli olarak gönderildiğinde hemen gönderilir ve uygulama bir bildirim görüntüleyebilir.

Apple platformlarında, APNs yükünde content-available değerini göstermek için bu alanı kullanın. Bir bildirim veya mesaj gönderildiğinde ve bu ayar true olarak ayarlandığında etkin olmayan bir istemci uygulaması uyandırılır ve mesaj, FCM aracılığıyla değil, APN'ler üzerinden sessiz bir bildirim olarak gönderilir. APN'lerdeki sessiz bildirimlerin teslim edilmesinin garanti edilmediğini ve kullanıcının Düşük Güç Modu'nu açması, uygulamayı kapatmaya zorlama gibi faktörlere bağlı olabileceğini unutmayın. Android'de, veri mesajları varsayılan olarak uygulamayı uyandırır. Chrome'da şu anda desteklenmemektedir.

Apple platformlarında, APNs yükünde mutable-content değerini göstermek için bu alanı kullanın. Bir bildirim gönderildiğinde ve bu ayar true olarak ayarlandığında, görüntülenmeden önce bir Bildirim Hizmeti uygulama uzantısı kullanılarak bildirimin içeriği değiştirilebilir. Bu parametre Android ve web için yoksayılır.

Bu parametre, cihaz çevrimdışıysa mesajın FCM depolama alanında ne kadar süreyle (saniye cinsinden) saklanması gerektiğini belirtir. Maksimum geçerlilik süresi 4 haftadır. Varsayılan değer 4 haftadır. Daha fazla bilgi için Bir iletinin kullanım süresini ayarlama başlıklı makaleye bakın.

Bu parametre true olarak ayarlandığında, geliştiricilerin gerçekten mesaj göndermeden bir isteği test etmesine olanak tanır.

Varsayılan değer: false.

Bu parametre, mesajın yükünün özel anahtar/değer çiftlerini belirtir.

Örneğin, data:{"score":"3x1"}: ile

Apple platformlarında mesaj APN'ler üzerinden gönderiliyorsa özel veri alanlarını temsil eder. FCM aracılığıyla gönderilirse AppDelegate application:didReceiveRemoteNotification: içinde anahtar/değer sözlüğü olarak gösterilir.

Android'de bu, 3x1 dize değerine sahip score adında ekstra bir intent ile sonuçlanır.

Anahtar ayrılmış bir kelime olmamalıdır ("from", "message_type" veya "google" ya da "gcm" ile başlayan herhangi bir kelime). Bu tabloda tanımlanan kelimelerin hiçbirini (collapse_key gibi) kullanmayın.

Dize türlerindeki değerler önerilir. Nesnelerdeki veya dize olmayan diğer veri türlerindeki değerleri (ör. tamsayılar veya boole'ler) dizeye dönüştürmeniz gerekir.

Bildirimin başlığı.

Bu alan, telefonlarda ve tabletlerde görünmez.

Bildirimin gövde metni.

Cihaz bildirimi aldığında çalacak ses.

İstemci uygulamasının ana paketinde veya uygulamanın veri kapsayıcısının Library/Sounds klasöründe ses dosyalarını belirten dize. Daha fazla bilgi için iOS Geliştirici Kitaplığı'na bakın.

Ana ekran uygulama simgesindeki rozetin değeri.

Belirtilmezse rozet değişmez.

0 olarak ayarlanırsa rozet kaldırılır.

Bir kullanıcının bildirimi tıklamasıyla ilişkilendirilen işlem.

APNs yükündeki category değerine karşılık gelir.

Bildirimin alt başlığı.

Uygulamanın dize kaynaklarında, gövde metninin kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak gövde dizesi anahtarı.

APNs yükündeki loc-key değerine karşılık gelir.

Daha fazla bilgi için Yük Anahtarı Referansı ve Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme bölümlerine göz atın.

Gövde metnini kullanıcının geçerli yerelleştirmesine göre yerelleştirmek için body_loc_key içindeki biçim tanımlayıcıların yerine kullanılacak değişken dizesi değerleri.

APNs yükündeki loc-args değerine karşılık gelir.

Daha fazla bilgi için Yük Anahtarı Referansı ve Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme bölümlerine göz atın.

Uygulamanın dize kaynaklarında, başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak başlık dizesinin anahtarı.

APNs yükündeki title-loc-key değerine karşılık gelir.

Daha fazla bilgi için Yük Anahtarı Referansı ve Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme bölümlerine göz atın.

Başlık metnini kullanıcının geçerli yerelleştirmesine göre yerelleştirmek için title_loc_key içindeki biçim belirleyicilerin yerine kullanılacak değişken dizesi değerleri.

APNs yükündeki title-loc-args değerine karşılık gelir.

Daha fazla bilgi için Yük Anahtarı Referansı ve Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme bölümlerine göz atın.

Bildirimin başlığı.

Bildirimin gövde metni.

Bildirimin kanal kimliği (Android O'da yeni).

Bu kanal kimliğine sahip herhangi bir bildirim alınmadan önce uygulamanın bu kanal kimliğiyle bir kanal oluşturması gerekir.

İstekte bu kanal kimliğini göndermezseniz veya sağlanan kanal kimliği henüz uygulama tarafından oluşturulmamışsa FCM, uygulama manifestinde belirtilen kanal kimliğini kullanır.

Bildirimin simgesi.

Çekilebilir myicon kaynağı için bildirim simgesini myicon olarak ayarlar. İstekte bu anahtarı göndermezseniz FCM, uygulama manifestinizde belirtilen başlatıcı simgesini görüntüler.

Cihaz bildirimi aldığında çalacak ses.

"default" veya uygulama içinde paket haline getirilmiş ses kaynağının dosya adını destekler. Ses dosyaları /res/raw/ içinde bulunmalıdır.

Bildirim çekmecesindeki mevcut bildirimlerin yerini alan tanımlayıcı.

Belirtilmezse her istek yeni bir bildirim oluşturur.

Belirtilmişse ve aynı etikete sahip bir bildirim zaten gösteriliyorsa yeni bildirim, bildirim çekmecesindeki mevcut bildirimin yerini alır.

Bildirimin, #rrggbb biçiminde gösterilen simge rengi.

Bir kullanıcının bildirimi tıklamasıyla ilişkilendirilen işlem.

Belirtilirse kullanıcı bildirimi tıkladığında, eşleşen amaç filtresine sahip bir etkinlik başlatılır.

Uygulamanın dize kaynaklarında, gövde metninin kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak gövde dizesi anahtarı.

Daha fazla bilgi için Dize Kaynakları bölümüne bakın.

Gövde metnini kullanıcının geçerli yerelleştirmesine göre yerelleştirmek için body_loc_key içindeki biçim tanımlayıcıların yerine kullanılacak değişken dizesi değerleri.

Daha fazla bilgi için Biçimlendirme ve Stil bölümüne bakın.

Uygulamanın dize kaynaklarında, başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak başlık dizesinin anahtarı.

Daha fazla bilgi için Dize Kaynakları bölümüne bakın.

Başlık metnini kullanıcının geçerli yerelleştirmesine göre yerelleştirmek için title_loc_key içindeki biçim belirleyicilerin yerine kullanılacak değişken dizesi değerleri.

Daha fazla bilgi için Biçimlendirme ve Stil bölümüne bakın.

Bildirimin başlığı.

Bildirimin gövde metni.

Bildirimin simgesi için kullanılacak URL.

Bir kullanıcının bildirimi tıklamasıyla ilişkilendirilen işlem.

Tüm URL değerleri için HTTPS gereklidir.

Bu parametre, mesajı alan istemci uygulamalarını (kayıt jetonları) belirtir.

Çoklu yayın mesajlarına (birden fazla kayıt jetonuna gönderme) yalnızca HTTP JSON biçimi kullanılarak izin verilir.

Bu parametre, mesaj yükünün anahtar/değer çiftlerini belirtir. Anahtar/değer parametrelerinin sayısına ilişkin bir sınır yoktur ancak toplam 4.096 baytlık mesaj boyutu sınırı vardır.

Örneğin, Android'de "data.score"."3x1", 3x1 dize değerine sahip score adında ekstra bir amaçla sonuçlanır.

Anahtar ayrılmış bir kelime olmamalıdır ("from", "message_type" veya "google" ya da "gcm" ile başlayan herhangi bir kelime). Bu tabloda tanımlanan kelimelerin hiçbirini (collapse_key gibi) kullanmayın.

• message_id: Başarıyla işlenen her mesaj için benzersiz bir kimlik belirten dize.
• error: Alıcı için mesaj işlenirken oluşan hatayı belirten dize. Olası değerler tablo 9'da bulunabilir.

• İstemci uygulamasının FCM'deki kaydı silinirse.
• İstemci uygulamasının kaydı otomatik olarak silinirse bu durum, kullanıcı uygulamanın yüklemesini kaldırırsa meydana gelebilir. Örneğin, iOS'te APNs Geri Bildirim Hizmeti APNs jetonunu geçersiz olarak bildirmiştir.
• Kayıt jetonunun süresi dolarsa (örneğin, Google kayıt jetonlarını yenilemeye karar verebilir veya iOS cihazlarda APNs jetonunun süresi dolmuş olabilir).
• İstemci uygulaması güncellendiğinde ancak yeni sürüm mesaj alacak şekilde yapılandırılmamışsa.

• Yetkilendirme üst bilgisi eksik veya HTTP isteğinde geçersiz söz dizimi içeriyor.
• Belirtilen sunucu anahtarının ait olduğu Firebase projesi yanlış.
• Yalnızca eski sunucu anahtarları: İsteğin kaynağı, Sunucu anahtarı IP'lerinde beyaz listeye eklenmemiş olan bir sunucudur.

Sunucu isteği zamanında işleyemedi. Aynı isteği tekrar göndermeyi deneyin. Bu durumda, şunları yapmanız gerekir:

• FCM Bağlantı Sunucusu'ndan gelen yanıta dahil edilmişse Retry-After üst bilgisini dikkate alın.
• Yeniden deneme mekanizmanıza eksponansiyel geri yükleme uygulayın. (ör. ilk yeniden denemeden önce bir saniye beklediyseniz sonrakinden önce en az iki saniye bekleyin, ardından 4 saniye bekleyin). Birden fazla mesaj gönderiyorsanız aynı anda tüm mesajlar için yeni bir istek gönderilmesini önlemek amacıyla her mesajı ayrı bir rastgele sayı kadar gecikmeli olarak erteleyin.

Sorunlara neden olan gönderenler kara listeye alınma riskiyle karşı karşıyadır.

Belirli bir cihaza gönderilen iletilerin oranı çok yüksek. Bir Apple uygulaması, APNs sınırlarını aşan bir hızda mesaj gönderirse bu hata mesajını alabilir

Bu cihaza gönderilen mesajların sayısını azaltın ve göndermeyi yeniden denemek için üstel geri yükleme özelliğini kullanın.