Firebase Cloud Messaging HTTP protokolü

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

Bu değer; cihazın kayıt jetonu, cihaz grubunun tek bir konu (öneki /topics/). Birden çok konuya e-posta göndermek için condition parametresinden yararlanın.

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

Değer, çoklu yayın mesajı. Dizide en az 1, en fazla 1.000 olmalıdır kayıt jetonlarıdır. Tek bir cihaza mesaj göndermek için şunu kullanın: to parametresinden yararlanın.

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

Bu parametre, mesaj hedefini belirler.

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

Desteklenen operatörler: &&, ||. En fazla iki operatör sayısı desteklenir.

Bu parametrenin desteği sonlandırıldı. Bunun yerine, belirtmek için to kullanın ileti alıcılarına Şu adrese ileti gönderme hakkında daha fazla bilgi: için birden fazla cihaz kullanıyorsanız platformunuzla ilgili belgelere bakın.

Bu parametre bir ileti grubunu tanımlar (ör. collapse_key: "Updates Available") daraltılabilir. Böylece yalnızca teslim devam ettirilebildiğinde son ileti gönderilir. Bu şekilde, gönderme işleminin birden fazla Cihaz tekrar çevrimiçi olduğunda veya etkin hale geldiğinde aynı mesajların birçoğu.

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. Bunun anlamı, FCM, istemci uygulaması başına aynı anda 4 farklı mesaj depolayabilir. Şu durumda: aşıldığında FCM'nin hangi 4 daraltma anahtarını saklayacağı konusunda bir garanti verilmez.

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

Varsayılan olarak, bildirim mesajları yüksek öncelikli ve veri mesajlarıyla gönderilir normal öncelikte gönderilir. Normal öncelik, istemci uygulamasının pil tüketimi ve hemen teslimat gerekmiyorsa kullanılmalıdır. Uygulama, normal öncelikli mesajları şu şekilde alabilir: belirtilmemiş.

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

Apple platformlarında content-available simgesini temsil etmek için bu alanı kullanın APNs yükü. true olarak ayarlanan bir bildirim veya mesaj gönderildiğinde, Etkin olmayan istemci uygulaması uyandırılır ve mesaj, APN'ler üzerinden sessiz bir bildirim olarak gönderilir. web sitesine göz atın. APN'lerdeki sessiz bildirimlerin etkin olmadığını unutmayın. Teslim edileceği garanti edilir ve kullanıcının Düşük Güç'ü açması gibi faktörlere bağlı olabilir Mod, uygulamadan çıkmaya zorlama gibi işlemler. Android'de, veri mesajları varsayılan olarak uygulamayı uyandırır. Şu tarihte: Chrome, şu anda desteklenmiyor.

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

Bu parametre, mesajın FCM depolama alanında ne kadar süreyle (saniye cinsinden) saklanması gerektiğini belirtir emin olun. 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 bir isteğidir.

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 aracılığıyla gönderilirse AppDelegate application:didReceiveRemoteNotification: dilinde 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" veya "gcm" gibi). Bu tabloda tanımlanan kelimelerin hiçbirini kullanmayın (ör. collapse_key).

Dize türlerindeki değerlerin kullanılması önerilir. Değerleri nesnelerdeki veya diğer dize olmayan veri türlerindeki değerleri dönüştürmeniz gerekir (ör. tam sayılar veya boole'ler) dize.

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 paketindeki veya Uygulamanın veri kapsayıcısının Library/Sounds klasörü. Bkz. 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ığı.

Uygulamanın dize kaynaklarında bulunan ve Gövde metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirin.

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

Görüntüleyin Yük Anahtarı Referansı ve Daha fazlası için Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme ekleyebilirsiniz.

Şurada biçim belirteçleri yerine kullanılacak değişken dize değerleri: Gövde metninibody_loc_key kullanıcının mevcut yerelleştirmesi.

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

Görüntüleyin Yük Anahtarı Referansı ve Daha fazlası için Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme ekleyebilirsiniz.

Uygulama dizesi kaynaklarında kullanılan başlık dizesinin anahtarı başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirin.

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

Görüntüleyin Yük Anahtarı Referansı ve Daha fazlası için Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme ekleyebilirsiniz.

Şurada biçim belirteçleri yerine kullanılacak değişken dize değerleri: Başlık metnini yerelleştirerektitle_loc_key kullanıcının mevcut yerelleştirmesi.

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

Görüntüleyin Yük Anahtarı Referansı ve Daha fazlası için Uzaktan Bildirimlerinizin İçeriğini Yerelleştirme ekleyebilirsiniz.

Bildirimin başlığı.

Bildirimin gövde metni.

bildirimin kanal kimliği (Android O'da yeni bir özellik).

Bu kanal kimliğine sahip herhangi bir bildirimin etkinleştirilmesi için uygulamanın bu kanal kimliğiyle bir kanal oluşturması gerekir. alındı.

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

Bildirimin simgesi.

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

Cihaz bildirimi aldığında çalacak ses.

"default" veya bir ses kaynağının dosya adını destekler paketlenmiş halidir. Ses dosyaları /res/raw/ içinde bulunmalıdır.

Bildirimdeki mevcut bildirimlerin yerine kullanılan tanımlayıcı çekmecesi.

Belirtilmezse her istek yeni bir bildirim oluşturur.

Belirtilmişse ve aynı etikete sahip bir bildirim zaten bulunuyorsa gösterilirse, yeni bildirim, bildirim çekmecesi.

Bildirimin, #rrggbb biçiminde ifade edilen simge rengi.

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

Belirtilmişse eşleşen intent filtresine sahip bir etkinlik Kullanıcı bildirimi tıkladığında

Uygulamanın dize kaynaklarında bulunan ve Gövde metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirin.

Görüntüleyin Dize Kaynakları bölümünde bulabilirsiniz.

Şurada biçim belirteçleri yerine kullanılacak değişken dize değerleri: Gövde metninibody_loc_key kullanıcının mevcut yerelleştirmesi.

Görüntüleyin Biçimlendirme ve Stil başlıklı makaleyi inceleyin.

Uygulama dizesi kaynaklarında kullanılan başlık dizesinin anahtarı başlık metnini kullanıcının mevcut yerelleştirmesine göre yerelleştirin.

Görüntüleyin Dize Kaynakları bölümünde bulabilirsiniz.

Şurada biçim belirteçleri yerine kullanılacak değişken dize değerleri: Başlık metnini yerelleştirerektitle_loc_key kullanıcının mevcut yerelleştirmesi.

Görüntüleyin Biçimlendirme ve Stil başlıklı makaleyi inceleyin.

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ına ilişkin bir sınırlama yoktur. ancak 4.096 baytlık toplam ileti boyutu sınırı vardır.

Örneğin, Android'de "data.score"."3x1" kullanımı fazladan amaç sağlar 3x1 dize değerini içeren score adlı bir adlandırılmış olmalı.

Anahtar, ayrılmış bir kelime ("from", "message_type" veya "google" veya "gcm" gibi). Bu tabloda tanımlanan kelimelerin hiçbirini kullanmayın (ör. collapse_key).

• message_id: Başarıyla işlenen her öğe için benzersiz bir kimlik belirten dize mesajını alırsınız.
• error: ileti alır. 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 (bu durum, Kullanıcı uygulamayı kaldırır. Örneğin iOS'te, APN'ler Geri Bildirim Hizmeti, APNs jetonunun geçersiz olduğunu bildirdi.
• Kayıt jetonunun süresi dolarsa (örneğin, Google, ya da iOS cihazlar için APNs jetonunun süresi dolmuş olmalıdır).
• İ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:

• Retry-After FCM Bağlantı Sunucusu.
• Yeniden deneme mekanizmanıza eksponansiyel geri çekilme uygulayın. (ör. bir saniye beklediyseniz önce tekrar denemeden önce en az iki saniye, ardından 4 saniye vb. bekleyin). Birden fazla mesaj gönderiyorsanız her birini rastgele bir miktarda ilave ederek ayrı ayrı geciktirin Böylece tüm mesajlar için aynı anda yeni bir istek gönderilmesini önleyebilirsiniz.

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. Apple uygulaması Mesajları APNs sınırlarını aşan bir hızda gönderir. Bu hata mesajını alabilir

Azaltın bu cihaza gönderilen mesajların sayısı ve eksponansiyel geri yükleme kullanma tekrar deneyin.