Firebase Cloud Messaging HTTP protokolü

Bu parametre, iletinin alıcısını belirtir.

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

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

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

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

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

Desteklenen koşul: "Konularda "konu" 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 parametrenin desteği sonlandırıldı. Bunun yerine, ileti alıcılarını belirtmek için to kullanın. Birden fazla cihaza mesaj gönderme hakkında daha fazla bilgi için platformunuzun dokümanlarına göz atın.

Bu parametre, daraltılabilen bir ileti grubunu (ör.collapse_key: "Updates Available" ile) tanımlar. Böylece, teslim devam ettirilebilecekse yalnızca son mesaj gönderilir. Bunun amacı, cihaz tekrar internete bağlandığında veya etkinleştiğinde aynı mesajların çok sayıda gönderilmesini önlemektir.

Mesajların hangi sırayla gönderileceğine dair herhangi bir garanti verilmediğini unutmayın.

Not: Herhangi bir zamanda 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ğı konusunda bir garanti verilmez.

İletinin önceliğini ayarlar. Geçerli değerler "normal" ve "yüksek"tir. Apple platformlarında Bunlar, APN 5 ve 10 önceliklerine karşılık gelir.

Varsayılan olarak, bildirim mesajları yüksek öncelikli, veri mesajları ise normal öncelikli gönderilir. Normal öncelik, istemci uygulamasının pil tüketimini optimize eder ve acil teslimat gerekmiyorsa kullanılmalıdır. Normal önceliğe sahip mesajlar için uygulama, mesajı belirtilmeyen bir gecikmeyle alabilir.

Yüksek öncelikli bir mesaj 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 temsil etmek 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, APN'ler üzerinden FCM üzerinden değil sessiz 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ı, uygulamadan çıkmaya 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 temsil etmek için bu alanı kullanın. Bir bildirim gönderildiğinde ve bu ayar true olarak ayarlandığında bildirimin içeriği, görüntülenmeden önce Bildirim Hizmeti uygulama uzantısı kullanılarak 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üre boyunca (saniye cinsinden) saklanması gerektiğini belirtir. Desteklenme süresi maksimum 4 hafta, varsayılan değer 4 haftadır. Daha fazla bilgi için Bir iletinin kullanım ömrünü ayarlama konusuna bakın.

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

false, varsayılan değerdir.

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

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

Apple platformlarında mesaj APN'ler üzerinden gönderilirse özel veri alanlarını temsil eder. FCM ile 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 fazladan bir intent ile sonuçlanır.

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

Dize türlerindeki değerlerin kullanılması önerilir. Nesnelerdeki veya dize dışı diğer veri türlerindeki (ör. tam sayılar ya da booleler) değerleri 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 göz atın.

Ana ekrandaki uygulama simgesindeki rozetin değeri.

Belirtilmezse rozet değiştirilmez.

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

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

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

Bildirimin alt başlığı.

Gövde metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak, uygulamanın dize kaynaklarındaki gövde dizesinin anahtarı.

APNs yükünde 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 kullanılacak body_loc_key içindeki biçim tanımlayıcılarının yerine kullanılacak değişken dize değerleri.

APNs yükünde 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.

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

APNs yükünde 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 mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak olan title_loc_key içindeki biçim tanımlayıcılarının yerine kullanılacak değişken dize değerleri.

APNs yükünde 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 yenidir).

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 manifest dosyasında belirtilen kanal kimliğini kullanır.

Bildirimin simgesi.

Çekilebilir kaynak myicon için bildirim simgesini myicon olarak ayarlar. Bu anahtarı istekte göndermezseniz FCM, uygulama manifestinizde belirtilen başlatıcı simgesini gösterir.

Cihaz bildirimi aldığında çalacak ses.

"default" veya uygulamada paket halinde sunulan bir ses kaynağının dosya adını destekler. Ses dosyaları /res/raw/ içinde bulunmalıdır.

Bildirim çekmecesindeki mevcut bildirimleri değiştirmek için kullanılan 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 ifade edilen simge rengi.

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

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

Gövde metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak, uygulamanın dize kaynaklarındaki gövde dizesinin 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 kullanılacak body_loc_key içindeki biçim tanımlayıcılarının yerine kullanılacak değişken dize değerleri.

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

Başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak, uygulamanın dize kaynaklarındaki 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 mevcut yerelleştirmesine göre yerelleştirmek için kullanılacak olan title_loc_key içindeki biçim tanımlayıcılarının yerine kullanılacak değişken dize değerleri.

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

Bildirimin başlığı.

Bildirimin gövde metni.

Bildirim simgesi için kullanılacak URL.

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.

Yalnızca HTTP JSON biçimi kullanılarak çoklu yayın mesajlaşmasına (birden fazla kayıt jetonuna gönderme) izin verilir.

Bu parametre, mesaj yükünün anahtar/değer çiftlerini belirtir. Anahtar/değer parametrelerinin sayısıyla ilgili bir sınır yoktur ancak toplam mesaj boyutu sınırı 4.096 bayttır.

Örneğin, Android'de "data.score"."3x1", 3x1 dize değerine sahip olan score adında ekstra bir intent oluşturur.

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

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

• İstemci uygulamasının FCM kaydını iptal etmesi durumunda.
• İstemci uygulamasının kaydı otomatik olarak silinirse (kullanıcı uygulamayı kaldırırsa bu durum gerçekleşebilir). Örneğin, iOS'te APNs Geri Bildirim Hizmeti, APNs jetonunun geçersiz olduğunu bildirdiyse.
• Kayıt jetonunun süresi dolarsa (örneğin, Google, iOS cihazlar için kayıt jetonlarını yenilemeye karar verebilir veya APNs jetonunun süresi dolmuş olabilir).
• İstemci uygulaması güncellenmişse 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 alınmamış bir sunucudur.

Sunucu isteği zamanında işleyemedi. Aynı isteği yeniden deneyin, ancak şunları yapmanız gerekir:

• FCM Bağlantı Sunucusu'ndan gelen yanıta dahilse Retry-After üst bilgisini dikkate alın.
• Yeniden deneme mekanizmanıza eksponansiyel geri çekilme uygulayın. (Örneğin, ilk yeniden denemeden önce bir saniye beklediyseniz, sonraki denemeden önce en az iki saniye, ardından 4 saniye vb. bekleyin). Birden fazla mesaj gönderiyorsanız tüm mesajlar için aynı anda yeni bir istek gönderilmesini önlemek amacıyla her birini rastgele ek miktarda ayrı ayrı geciktirin.

Soruna neden olan gönderenler kara listeye alınma riskiyle karşı karşıya kalır.

Belirli bir cihaza gönderilen mesajların 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 mesaj sayısını azaltın ve göndermeyi yeniden denemek için üstel geri yükleme yöntemini kullanın.