Firebase Cloud Messaging HTTP protokolü

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

Değer, bir cihazın kayıt jetonu, bir cihaz grubunun bildirim anahtarı veya tek bir konu olabilir (önüne /topics/ eklenir). 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ının dizisi olmalıdır. Dizi en az 1 ve en fazla 1.000 kayıt jetonu içermelidir. Tek bir cihaza mesaj göndermek için to parametresini kullanın.

Çoklu yayın iletilerine 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"" şeklinde 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 için destek sonlandırılmıştır. Bunun yerine, mesaj 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 bakın.

Bu parametre, yayın devam ettirildiğinde yalnızca son iletinin gönderilmesi için daraltılabilen bir ileti grubunu (ör. collapse_key: "Updates Available" ile) tanımlar. Bu, cihaz tekrar internete bağlandığında veya etkinleştiğinde aynı mesajların çok fazla gönderilmesini önlemek içindir.

Mesajların gönderilme sırasının garanti edilmediğini unutmayın.

Not: Herhangi bir zamanda en fazla 4 farklı daraltma anahtarına izin verilir. Bu, FCM'ün istemci uygulaması başına aynı anda 4 farklı mesaj saklayabileceği anlamına gelir. Bu sayıyı aşarsanız FCM'ün hangi 4 daraltma anahtarını saklayacağı garanti edilmez.

İletinin önceliğini ayarlar. Geçerli değerler "normal" ve "yüksek"tir. Apple platformlarında bunlar APN'ler için 5 ve 10. önceliklere 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 anında yayınlama gerekmediği sürece kullanılmalıdır. Normal öncelikli mesajlar, uygulama tarafından belirtilmeyen bir gecikmeyle alınabilir.

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 FCM üzerinden değil, sessiz bir bildirim olarak APN'ler üzerinden gönderilir. APN'lerdeki sessiz bildirimlerin gönderilmesinin garanti edilmediğini ve kullanıcının düşük güç modunu etkinleştirmesi, uygulamadan zorla çıkması gibi faktörlere bağlı olabileceğini unutmayın. Android'de veri mesajları varsayılan olarak uygulamayı uyandırır. Chrome'da şu anda desteklenmiyor.

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 belirlendiğinde, bildirimin içeriği bildirim hizmeti uygulama uzantısı kullanılarak görüntülenmeden önce 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 (saniye cinsinden) tutulacağını belirtir. Desteklenme süresi maksimum 4 hafta, varsayılan değer 4 haftadır. Daha fazla bilgi için Mesajın geçerlilik süresini ayarlama başlıklı makaleyi inceleyin.

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

false, varsayılan değerdir.

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

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

Apple platformlarında, ileti APN'ler üzerinden gönderiliyorsa özel veri alanlarını temsil eder. FCM üzerinden gönderilirse AppDelegate application:didReceiveRemoteNotification:'te anahtar/değer sözlüğü olarak temsil edilir.

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 kelimelerden hiçbirini kullanmayın (collapse_key gibi).

Dize türünde değerler önerilir. Nesnelerdeki veya dize olmayan diğer veri türlerindeki (ör. tam sayılar veya boole değerleri) 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 çalınacak ses.

İstemci uygulamasının ana paketindeki veya uygulamanın veri kapsayıcısının Library/Sounds klasöründeki ses dosyalarını belirten dize. Daha fazla bilgi için iOS Developer Library'e bakın.

Ana ekran uygulama simgesinde bulunan rozetin değeri.

Belirtilmemişse rozet değiştirilmez.

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

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

APN'ler 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ı.

APN'ler yükünde loc-key değerine karşılık gelir.

Daha fazla bilgi için Yük Anahtarı Referansı ve Uzak Bildirimlerinizin İçeriğini Yerelleştirme başlıklı makaleleri inceleyin.

Ana metni kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için body_loc_key içindeki biçim belirteçleri 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 Uzak Bildirimlerinizin İçeriğini Yerelleştirme başlıklı makaleleri inceleyin.

Başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için 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 Uzak Bildirimlerinizin İçeriğini Yerelleştirme başlıklı makaleleri inceleyin.

Başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için title_loc_key içindeki biçim belirteçleri yerine kullanılacak değişken dize değerleri.

APN'ler yükünde title-loc-args değerine karşılık gelir.

Daha fazla bilgi için Yük Anahtarı Referansı ve Uzak Bildirimlerinizin İçeriğini Yerelleştirme başlıklı makaleleri inceleyin.

Bildirimin başlığı.

Bildirimin gövde metni.

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

Uygulama, bu kanal kimliğine sahip bir bildirim alınmadan önce bu kanal kimliğiyle bir kanal oluşturmalıdır.

İ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 kaynak myicon için bildirim simgesini myicon olarak ayarlar. İstekte bu anahtarı göndermezseniz FCM, uygulama manifest dosyanızda 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 simge rengi. #rrggbb biçiminde ifade edilir.

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

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

Ana metni kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için uygulamanın dize kaynaklarındaki ana metin dizesinin anahtarı.

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

Ana metni kullanıcının mevcut yerelleştirmesine göre yerelleştirmek için body_loc_key içindeki biçim belirteçleri yerine kullanılacak değişken dize değerleri.

Daha fazla bilgi için Biçimlendirme ve Stil başlıklı makaleyi inceleyin.

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

Daha fazla bilgi için Dize Kaynakları başlıklı makaleyi inceleyin.

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 başlıklı makaleyi inceleyin.

Bildirimin başlığı.

Bildirimin gövde metni.

Bildirim simgesinde kullanılacak URL.

Kullanıcının bildirimi tıklamasıyla ilişkili 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ın yükü için anahtar/değer çiftlerini belirtir. Anahtar/değer parametrelerinin sayısı için bir sınırlama yoktur ancak toplam ileti boyutu sınırı 4096 bayttır.

Örneğin, Android'de "data.score"."3x1", 3x1 dize değerine sahip score adlı bir intent ekstrası 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 mesaj için benzersiz bir kimliği belirten dize.
• error: Alıcı için ileti işlenirken oluşan hatayı belirten dize. Olası değerleri tablo 9'da bulabilirsiniz.

• İstemci uygulaması FCM ile kaydını iptal ederse.
• İstemci uygulamasının otomatik olarak kaydının silinmesi (kullanıcı uygulamayı kaldırırsa bu durumla karşılaşılabilir). Örneğin, iOS'te APNs Geri Bildirim Hizmeti APNs jetonunu geçersiz olarak bildirmişse.
• 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.

• HTTP isteğinde yetkilendirme üstbilgisi eksik veya geçersiz söz dizimi içeriyor.
• Belirtilen sunucu anahtarının ait olduğu Firebase projesi yanlış.
• Yalnızca eski sunucu anahtarları: İstek, sunucu anahtarı IP'lerinde beyaz listeye eklenmemiş bir sunucudan geldi.

Sunucu isteği zamanında işleyemedi. Aynı isteği tekrar deneyin ancak şunu 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 yükleme uygulayın. (ör. ilk yeniden denemeden önce bir saniye beklediyseniz bir sonrakinden önce en az iki saniye, ardından 4 saniye bekleyin vb.). Birden fazla mesaj gönderiyorsanız tüm mesajlar için aynı anda yeni bir istek göndermemek amacıyla her bir mesajı bağımsız olarak rastgele bir süre daha geciktirebilirsiniz.

Sorunlara neden olan gönderenler kara listeye alınabilir.

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 eksponansiyel geri yüklemeyi kullanın.