Protokol HTTP Firebase Cloud Messaging

Dokumen ini menyediakan referensi untuk sintaks HTTP yang digunakan untuk meneruskan pesan dari server aplikasi Anda ke aplikasi klien melalui Firebase Cloud Messaging. Server aplikasi Anda harus mengarahkan semua permintaan HTTP ke endpoint ini:

https://fcm.googleapis.com/fcm/send

Parameter dan opsi yang tersedia termasuk dalam berbagai kategori berikut ini:

Sintaks pesan downstream

Bagian ini memberikan sintaks untuk mengirim pesan downstream dan menafsirkan respons HTTP dari Firebase Cloud Messaging.

Pesan HTTP downstream (JSON)

Tabel berikut ini berisi daftar target, opsi, dan payload untuk pesan JSON HTTP.

Tabel 1. Target, opsi, dan payload untuk pesan HTTP downstream (JSON).

Parameter Penggunaan Deskripsi
Target
to Opsional, string

Parameter ini menetapkan penerima pesan.

Nilai dapat berupa token pendaftaran perangkat, kunci notifikasi grup perangkat, atau topik tunggal (diawali dengan /topics/). Untuk mengirim ke beberapa topik, gunakan parameter condition.

registration_ids
Opsional, array string

Parameter ini menentukan penerima pesan multicast, yakni pesan yang dikirim ke lebih dari satu token pendaftaran.

Nilai harus berupa array token pendaftaran yang akan menjadi tujuan pengiriman pesan multicast. Array harus memuat minimal 1 dan maksimal 1.000 token pendaftaran. Untuk mengirim pesan ke satu perangkat, gunakan parameter to.

Pesan multicast hanya diperbolehkan menggunakan format HTTP JSON.

condition Opsional, string

Parameter ini menetapkan ekspresi logika dari condition yang menentukan target pesan.

Condition yang didukung: Topik, yang diformat sebagai "'yourTopic' in topic". Nilai ini peka terhadap huruf besar dan huruf kecil.

Operator yang didukung: &&, ||. Maksimum dua operator per pesan topik yang didukung.

notification_key
Tidak digunakan lagi
Opsional, string

Parameter ini tidak digunakan lagi. Sebaliknya, gunakan to untuk menentukan penerima pesan. Untuk informasi lebih lanjut tentang cara mengirim pesan ke beberapa perangkat, lihat dokumentasi untuk platform Anda.

Opsi
collapse_key Opsional, string

Parameter ini mengidentifikasi grup pesan (misalnya, dengan collapse_key: "Updates Available") yang bisa diciutkan, sehingga hanya pesan terakhir yang dikirim ketika pengiriman bisa dilanjutkan. Hal ini dimaksudkan untuk mencegah pengiriman terlalu banyak pesan yang sama ketika perangkat kembali online atau aktif.

Perlu diperhatikan bahwa urutan pesan yang akan dikirim tidak dijamin.

Catatan: Maksimum 4 kunci penciutan berbeda diizinkan pada waktu tertentu. Artinya, server koneksi FCM bisa secara bersamaan menyimpan 4 pesan berbeda per aplikasi klien. Jika melampaui jumlah ini, tidak ada jaminan manakah dari 4 kunci penciutan ini yang akan disimpan oleh server koneksi.

priority Opsional, string

Menetapkan prioritas pesan. Nilai yang valid adalah "normal" dan "tinggi." Pada iOS, ini sama dengan prioritas APN 5 dan 10.

Secara default, pesan notifikasi dikirim dengan prioritas tinggi dan pesan data dikirim dengan prioritas normal. Prioritas normal mengoptimalkan pemakaian baterai aplikasi klien dan harus digunakan kecuali jika diperlukan pengiriman dengan segera. Untuk pesan dengan prioritas normal, aplikasi dapat menerima pesan dengan penundaan yang tidak ditetapkan.

Jika dikirim dengan prioritas tinggi, pesan akan dikirim dengan segera dan aplikasi dapat menampilkan notifikasi.

content_available Opsional, boolean

Pada iOS, gunakan kolom ini untuk mewakili content-available dalam payload APN. Jika notifikasi atau pesan dikirim dan parameter ini disetel ke true, aplikasi klien yang tidak aktif akan diaktifkan, dan pesan akan dikirim melalui APN sebagai notifikasi diam dan tidak melalui server koneksi FCM. Perhatikan bahwa notifikasi diam pada APN tidak dijamin akan dikirim, dan dapat bergantung pada faktor-faktor seperti apakah pengguna mengaktifkan Mode Daya Rendah, menghentikan aplikasi secara paksa, dll. Pada Android, pesan data akan mengaktifkan aplikasi secara default. Chrome, untuk saat ini, belum didukung.

mutable_content Opsional, boolean JSON

Saat ini hanya untuk perangkat iOS 10+. Di iOS, gunakan kolom ini untuk mewakili mutable-content di dalam payload APN. Jika notifikasi dikirim dan parameter ini ditetapkan ke true, isi notifikasi dapat dimodifikasi sebelum ditampilkan dengan menggunakan ekstensi aplikasi Notification Service. Parameter ini akan diabaikan untuk Android dan web.

time_to_live Opsional, angka

Parameter ini menetapkan berapa lama (dalam detik) pesan harus disimpan dalam penyimpanan FCM jika perangkat sedang offline. Waktu aktif maksimum yang didukung adalah 4 minggu, dan nilai defaultnya adalah 4 minggu. Untuk mengetahui informasi lebih lanjut, lihat Menyetel masa aktif pesan.

restricted_package_
name
(khusus Android)
Opsional, string Parameter ini menetapkan nama paket aplikasi yang harus sesuai dengan token pendaftaran agar bisa menerima pesan.
dry_run Opsional, boolean

Jika disetel ke true, parameter ini memungkinkan developer untuk menguji permintaan tanpa benar-benar mengirim pesan.

Nilai default adalah false.

Payload
data Opsional, objek

Parameter ini menetapkan key-value pair kustom pada payload pesan.

Misalnya, dengan data:{"score":"3x1"}:

Pada iOS, jika pesan dikirim melalui APN, ini mewakili kolom data kustom. Jika dikirim melalui server koneksi FCM, pesan akan diwakili sebagai kamus nilai kunci dalam AppDelegate application:didReceiveRemoteNotification:.

Pada Android, ini akan menghasilkan ekstra intent yang disebut score dengan nilai string 3x1.

Kunci tidak boleh berupa kata yang telah digunakan ("from" atau kata apa pun yang dimulai dengan "google" atau "gcm"). Jangan gunakan kata apa pun yang ditentukan dalam tabel ini (seperti collapse_key).

Nilai dalam jenis string direkomendasikan. Anda harus mengonversi nilai dalam objek atau jenis data non-string lainnya (misalnya, bilangan bulat atau boolean) menjadi string.

notification Opsional, objek Parameter ini menetapkan key-value pair yang bisa dilihat pengguna yang telah ditetapkan sebelumnya pada payload notification. Lihat Dukungan payload notification untuk mengetahui detailnya. Untuk informasi lebih lanjut mengenai opsi pesan notifikasi dan pesan data, lihat Jenis pesan. Jika payload notifikasi disediakan atau opsi content_available ditetapkan ke true untuk pesan ke perangkat iOS, pesan tersebut akan dikirim melalui APN. Jika tidak, pesan akan dikirim melalui server koneksi FCM.

Dukungan payload notifikasi

Tabel di bawah ini mencantumkan kunci yang telah ditetapkan sebelumnya yang tersedia untuk membuat pesan notifikasi untuk iOS dan Android.

Tabel 2a. iOS — kunci untuk pesan notifikasi

Parameter Penggunaan Deskripsi
title Opsional, string

Judul notifikasi.

Kolom ini tidak ditampilkan di ponsel dan tablet iOS.

body Opsional, string

Teks isi notifikasi.

sound Opsional, string, atau Kamus

Suara yang diputar saat perangkat menerima notifikasi.

String yang menentukan file suara dalam paket utama aplikasi klien atau dalam folder Library/Sounds di container data aplikasi. Lihat Library Developer iOS untuk informasi selengkapnya.

Untuk notifikasi penting, gunakan kamus yang berisi informasi suara untuk pemberitahuan penting. Lihat Library Developer iOS untuk kunci yang diperlukan. Untuk notifikasi reguler, gunakan string suara sebagai gantinya.

badge Opsional, string

Nilai badge pada ikon aplikasi layar utama.

Jika tidak ditentukan, badge tidak diubah.

Jika disetel ke 0, badge dihapus.

click_action Opsional, string

Tindakan yang terkait dengan klik pengguna pada notifikasi.

Sesuai dengan category dalam payload APN.

subtitle Opsional, string

Subtitel notifikasi.

body_loc_key Opsional, string

Kunci ke string isi di dalam resource string aplikasi yang akan digunakan untuk melokalkan teks isi ke bahasa pengguna saat ini.

Sesuai dengan loc-key di payload APN.

Baca Referensi Kunci Payload dan Melokalkan Isi Notifikasi Jarak Jauh untuk mengetahui informasi selengkapnya.

body_loc_args Opsional, array JSON sebagai string

Nilai string variabel yang akan digunakan sebagai pengganti penentu format dalam body_loc_key untuk melokalkan teks isi ke bahasa pengguna saat ini.

Sesuai dengan loc-args dalam payload APN.

Baca Referensi Kunci Payload dan Melokalkan Isi Notifikasi Jarak Jauh untuk mengetahui informasi selengkapnya.

title_loc_key Opsional, string

Kunci ke string judul di dalam resource string aplikasi yang akan digunakan untuk melokalkan teks judul ke bahasa pengguna saat ini.

Sesuai dengan title-loc-key di payload APN.

Baca Referensi Kunci Payload dan Melokalkan Isi Notifikasi Jarak Jauh untuk mengetahui informasi selengkapnya.

title_loc_args Opsional, array JSON sebagai string

Nilai string variabel yang akan digunakan sebagai pengganti penentu format dalam title_loc_key untuk melokalkan teks judul ke bahasa pengguna saat ini.

Sesuai dengan title-loc-args dalam payload APN.

Baca Referensi Kunci Payload dan Melokalkan Isi Notifikasi Jarak Jauh untuk mengetahui informasi selengkapnya.

Tabel 2b. Android — kunci untuk pesan notifikasi

Parameter Penggunaan Deskripsi
title Opsional, string

Judul notifikasi.

body Opsional, string

Teks isi notifikasi.

android_channel_id Opsional, string

ID saluran notifikasi (baru di Android O).

Aplikasi harus membuat saluran dengan ID saluran ini sebelum menerima notifikasi apa pun dengan ID saluran ini.

Jika Anda tidak mengirim ID saluran ini pada permintaan, atau jika ID saluran yang disediakan belum dibuat oleh aplikasi, FCM akan menggunakan ID saluran yang ditentukan dalam manifes aplikasi.

icon Opsional, string

Ikon notifikasi.

Menyetel ikon notifikasi ke myicon untuk resource myicon yang dapat digambar. Jika Anda tidak mengirim kunci ini dalam permintaan, maka FCM akan menampilkan ikon peluncur yang ditentukan dalam manifes aplikasi.

sound Opsional, string

Suara yang diputar saat perangkat menerima notifikasi.

Mendukung "default" atau nama file resource suara yang disertakan dalam aplikasi. File suara harus berada di /res/raw/.

tag Opsional, string

Pengenal digunakan untuk mengganti notifikasi yang ada di panel samping notifikasi.

Jika tidak ditentukan, setiap permintaan akan membuat notifikasi baru.

Jika ditentukan dan notifikasi dengan tag yang sama telah ditampilkan, notifikasi yang baru akan menggantikan notifikasi lama di panel samping notifikasi.

color Opsional, string

Warna ikon notifikasi, dinyatakan dalam format #rrggbb.

click_action Opsional, string

Tindakan yang terkait dengan klik pengguna pada notifikasi.

Jika ditentukan, aktivitas dengan filter intent yang cocok akan diluncurkan ketika pengguna mengklik notifikasi.

body_loc_key Opsional, string

Kunci ke string isi di dalam resource string aplikasi yang akan digunakan untuk melokalkan teks isi ke bahasa pengguna saat ini.

Lihat Resource String untuk informasi lebih lanjut.

body_loc_args Opsional, array JSON sebagai string

Nilai string variabel yang akan digunakan sebagai pengganti penentu format dalam body_loc_key untuk melokalkan teks isi ke bahasa pengguna saat ini.

Lihat Pengaturan Format dan Gaya untuk informasi lebih lanjut.

title_loc_key Opsional, string

Kunci ke string judul di dalam resource string aplikasi yang akan digunakan untuk melokalkan teks judul ke bahasa pengguna saat ini.

Lihat Resource String untuk informasi lebih lanjut.

title_loc_args Opsional, array JSON sebagai string

Nilai string variabel yang akan digunakan sebagai pengganti penentu format dalam title_loc_key untuk melokalkan teks judul ke bahasa pengguna saat ini.

Lihat Pengaturan Format dan Gaya untuk informasi lebih lanjut.

Tabel 2c. Web (JavaScript) — kunci untuk pesan notifikasi

Parameter Penggunaan Deskripsi
title Opsional, string

Judul notifikasi.

body Opsional, string

Teks isi notifikasi.

icon Opsional, string

URL yang akan digunakan untuk ikon notifikasi.

click_action Opsional, string

Tindakan yang terkait dengan klik pengguna pada notifikasi.

Untuk semua nilai URL, diperlukan HTTPS.

Pesan HTTP downstream (Teks Biasa)

Tabel berikut berisi daftar sintaks untuk target, opsi, dan payload dalam pesan HTTP downstream teks biasa.

Tabel 3. Target, opsi, dan payload untuk pesan HTTP teks biasa downstream.

Parameter Penggunaan Deskripsi
Target
registration_id Wajib, string

Parameter ini menetapkan aplikasi klien (ID pendaftaran) yang menerima pesan.

Pengiriman pesan multicast (mengirim ke lebih dari 1 ID pendaftaran) hanya diizinkan menggunakan format JSON HTTP.

Opsi
collapse_key Opsional, string Lihat tabel 1 untuk detailnya.
time_to_live Opsional, angka Lihat tabel 1 untuk detailnya.
restricted_package_name Opsional, string Lihat tabel 1 untuk detailnya.
dry_run Opsional, boolean Lihat tabel 1 untuk detailnya.
Payload
data.<key> Opsional, string

Parameter ini menetapkan key-value pair pada payload pesan. Tidak ada batas jumlah pada parameter nilai kunci, tetapi ada batas ukuran pesan total sebesar 4 KB.

Misalnya, pada Android, "data.score"."3x1" akan menghasilkan ekstra intent bernama score dengan nilai string 3x1.

Kunci tidak boleh berupa kata yang telah digunakan ("from" atau kata apa pun yang dimulai dengan "google" atau "gcm"). Jangan gunakan kata apa pun yang ditentukan dalam tabel ini (misalnya collapse_key).

Menafsirkan respons pesan downstream

Server aplikasi harus mengevaluasi header respons atau isi pesan untuk menafsirkan respons pesan yang dikirim dari FCM. Tabel berikut menjelaskan kemungkinan respons.

Tabel 4. Header respons pesan HTTP downstream.

Respons Deskripsi
200 Pesan berhasil diproses. Isi respons akan berisi detail lebih lanjut tentang status pesan, tetapi formatnya akan bergantung pada apakah permintaannya JSON atau teks biasa. Lihat tabel 5 untuk informasi selengkapnya.
400 Hanya berlaku untuk permintaan JSON. Menunjukkan bahwa permintaan tersebut tidak bisa diurai sebagai JSON, atau permintaan tersebut berisi kolom tidak valid (misalnya, meneruskan string yang seharusnya berisi angka). Sebab pasti kegagalan dijelaskan dalam respons dan masalah tersebut harus ditangani sebelum permintaan bisa dicoba lagi.
401 Terjadi error saat mengautentikasi akun pengirim.
5xx Error dalam rentang 500-599 (misalnya 500 atau 503) menunjukkan bahwa ada error internal dalam server koneksi FCM saat mencoba memproses permintaan, atau server untuk sementara tidak tersedia (misalnya, karena waktu tunggu). Pengirim harus mencoba lagi nanti, dengan mematuhi header Retry-After apa pun yang termasuk dalam respons. Server aplikasi harus mengimplementasikan back-off eksponensial.

Tabel berikut berisi daftar kolom dalam isi respons pesan downstream (JSON).

Tabel 5. Isi respons pesan HTTP downstream (JSON).

Parameter Penggunaan Deskripsi
multicast_id Wajib, angka ID unik (angka) yang mengidentifikasi pesan multicast.
success Wajib, angka Jumlah pesan yang diproses tanpa error.
failure Wajib, angka Jumlah pesan yang tidak bisa diproses.
results Wajib, array objek Array objek yang mewakili status pesan yang diproses. Objek tersebut tercantum dalam urutan yang sama dengan permintaan (misalnya, untuk setiap ID pendaftaran dalam permintaan, hasilnya dicantumkan dalam indeks yang sama dalam respons).
  • message_id: String yang menetapkan ID unik untuk setiap pesan yang berhasil diproses.
  • registration_id: String opsional yang menetapkan token pendaftaran untuk aplikasi klien tempat pesan diproses dan dikirim.
  • error: String yang menetapkan error yang terjadi ketika memproses pesan untuk penerima. Nilai yang mungkin dapat ditemukan dalam tabel 9.

Tabel 6. Isi respons HTTP pesan topik (JSON).

Parameter Penggunaan Deskripsi
message_id Opsional, angka ID pesan topik ketika FCM telah berhasil menerima permintaan dan akan mencoba mengirimkannya ke semua perangkat yang berlangganan.
error Opsional, string Error yang terjadi ketika memproses pesan. Kemungkinan nilai dapat dilihat di tabel 9.

Tabel 7. Respons sukses untuk isi respons pesan HTTP downstream (Teks Biasa).

Parameter Penggunaan Deskripsi
id Wajib, string Parameter ini menetapkan ID pesan unik yang berhasil diproses oleh server koneksi FCM.
registration_id Opsional, string Parameter ini menetapkan token pendaftaran untuk aplikasi klien tempat pesan diproses dan dikirim.

Tabel 8. Respons error untuk isi respons pesan HTTP downstream (Teks Biasa).

Parameter Penggunaan Deskripsi
Error Wajib, string Parameter ini menetapkan nilai error ketika memproses pesan untuk penerima. Lihat tabel 9 untuk detailnya.

Kode respons error untuk pesan downstream

Tabel berikut berisi daftar kode respons error untuk pesan downstream.

Tabel 9. Kode respons error untuk pesan downstream.

Error Kode HTTP Tindakan yang Direkomendasikan
Token Pendaftaran Hilang 200 + error: MissingRegistration Periksa apakah permintaan memuat token pendaftaran (pada registration_id dalam pesan teks biasa, atau pada kolom to atau registration_ids dalam JSON).
Token Pendaftaran Tidak Valid 200 + error: InvalidRegistration Periksa format token pendaftaran yang Anda teruskan ke server. Pastikan format tersebut cocok dengan token pendaftaran yang diterima oleh aplikasi klien ketika mendaftar ke Firebase Notifications. Jangan potong atau tambah karakter tambahan.
Perangkat Tidak Terdaftar 200 + error:NotRegistered Token pendaftaran yang ada bisa menjadi tidak valid dalam sejumlah skenario, termasuk:
  • Jika aplikasi klien membatalkan pendaftaran di FCM.
  • Jika pendaftaran aplikasi klien dibatalkan secara otomatis, yang bisa terjadi jika pengguna meng-uninstal aplikasi. Misalnya, pada iOS, jika Layanan Masukan APNS melaporkan token APNS sebagai tidak valid.
  • Jika token pendaftaran tidak berlaku (misalnya, Google mungkin memutuskan untuk memperbarui token pendaftaran, atau token APN sudah tidak berlaku untuk perangkat iOS).
  • Jika aplikasi klien diupdate tetapi versi yang baru belum dikonfigurasi untuk menerima pesan.
Untuk semua kasus tersebut, hapus token pendaftaran dari server aplikasi dan jangan gunakan lagi untuk mengirim pesan.
Nama Paket Tidak Valid 200 + error: InvalidPackageName Pastikan bahwa pesan ditujukan ke token pendaftaran yang nama paketnya cocok dengan nilai yang diteruskan dalam permintaan.
Error Autentikasi 401 Akun pengirim yang digunakan untuk mengirim pesan tidak bisa diautentikasi. Kemungkinan penyebabnya sebagai berikut:
  • Header otorisasi dalam permintaan HTTP tidak ada, atau memuat sintaks yang tidak valid.
  • Project Firebase yang mencakup kunci server yang ditentukan adalah project yang salah.
  • Hanya kunci server lama — permintaan berasal dari server yang tidak termasuk dalam daftar aman pada IP kunci Server.
Pastikan token yang Anda kirim di dalam header Autentikasi adalah kunci Server yang benar yang terkait dengan project Anda. Lihat Memeriksa validitas kunci Server untuk informasi selengkapnya. Jika Anda menggunakan kunci server lama, sebaiknya upgrade ke kunci baru yang tidak memiliki batasan IP.
Pengirim Tidak Cocok 200 + error: MismatchSenderId Token pendaftaran terikat pada grup pengirim tertentu. Ketika aplikasi klien mendaftar ke FCM, aplikasi tersebut harus menetapkan pengirim mana saja yang diizinkan untuk mengirim pesan. Anda harus menggunakan salah satu ID pengirim tersebut ketika mengirim pesan ke aplikasi klien. Jika Anda beralih ke pengirim yang berbeda, maka token pendaftaran yang ada tidak akan berfungsi.
JSON Tidak Valid 400 Pastikan pesan JSON diformat dengan benar dan berisi kolom yang valid (misalnya, memastikan bahwa jenis data yang benar yang diteruskan).
Parameter Tidak Valid 400 + error: InvalidParameters Pastikan parameter yang dimasukkan memiliki nama dan jenis yang tepat.
Pesan Terlalu Besar 200 + error: MessageTooBig Pastikan ukuran total data payload yang disertakan dalam pesan tidak melebihi batas FCM, yaitu 4.096 byte untuk sebagian besar pesan, atau 2.048 byte untuk pesan ke topik. Ini mencakup kunci dan nilainya.
Kunci Data Tidak Valid 200 + error:
InvalidDataKey
Pastikan data payload tidak memuat kunci (misalnya from, atau gcm, atau nilai apa pun yang diawali dengan google) yang digunakan secara internal oleh FCM. Perlu diperhatikan bahwa beberapa kata (misalnya collapse_key) juga digunakan oleh FCM, tetapi diizinkan dalam payload, yang dalam hal ini nilai payload akan diganti oleh nilai FCM.
Waktu untuk Aktif Tidak Valid 200 + error: InvalidTtl Pastikan nilai yang digunakan dalam time_to_live adalah bilangan bulat yang mewakili durasi dalam detik antara 0 dan 2.419.200 (4 minggu).
Waktu Tunggu 5xx atau 200 + error:Unavailable

Server tidak bisa memproses permintaan secara tepat waktu. Coba lagi permintaan yang sama, tetapi Anda harus:

  • Mematuhi header Retry-After jika dimasukkan dalam respons dari Server Koneksi FCM.
  • Mengimplementasikan back-off eksponensial dalam mekanisme percobaan ulang. (misalnya, jika Anda menunggu 1 detik sebelum percobaan pertama, tunggu minimal 2 detik sebelum percobaan berikutnya, kemudian 4 detik dan seterusnya). Jika Anda mengirim beberapa pesan, tunda setiap pesan secara independen dengan jumlah acak tambahan agar tidak mengeluarkan permintaan baru untuk semua pesan secara bersamaan.

Pengirim yang menyebabkan masalah berisiko dimasukkan ke daftar hitam.

Error Server Internal 500 atau 200 + error:InternalServerError Server mengalami error ketika mencoba memproses permintaan. Anda bisa mencoba lagi permintaan yang sama sesuai persyaratan yang tercantum dalam "Waktu Tunggu" (lihat baris di atas). Jika error tetap berlanjut, hubungi dukungan Firebase.
Jumlah Pesan Perangkat Terlampaui 200 + error:
DeviceMessageRate
Exceeded

Jumlah pesan untuk perangkat tertentu terlalu tinggi. Jika aplikasi iOS mengirim pesan dengan jumlah yang melebihi batas APN, pesan error ini mungkin ditampilkan.

Kurangi jumlah pesan yang dikirim ke perangkat ini dan gunakan backoff eksponensial untuk mencoba mengirimkan pesan lagi.

Jumlah Pesan Topik Terlampaui 200 + error:
TopikMessageRate
Exceeded
Jumlah pesan untuk pelanggan topik tertentu terlalu tinggi. Kurangi jumlah pesan yang dikirim untuk topik ini dan gunakan backoff eksponensial untuk mencoba mengirimkan pesan lagi.
Kredensial APN Tidak Valid 200 + error:
InvalidApnsCredential
Pesan yang ditargetkan ke perangkat iOS tidak bisa dikirim, karena kunci autentikasi APNs yang diperlukan tidak diupload atau tidak berlaku lagi. Periksa validitas kredensial pengembangan dan produksi Anda.

Pengelolaan grup perangkat

Tabel berikut ini berisi kunci untuk membuat grup perangkat dan menambah serta menghapus anggota. Untuk mengetahui informasi selengkapnya, baca panduan untuk platform Anda, iOS atau Android.

Tabel 10. Kunci pengelolaan grup perangkat.

Parameter Penggunaan Deskripsi
operation Wajib, string Operasi yang akan dijalankan.Nilai yang valid adalah create, add, dan remove.
notification_key_name Wajib, string Nama grup perangkat buatan pengguna yang bisa dibuat atau diubah.
notification_key Wajib (kecuali untuk operasi create, string Pengenal unik untuk grup perangkat. Nilai ini ditampilkan sebagai respons untuk operasi create yang berhasil, dan diperlukan untuk semua operasi berikutnya pada grup perangkat.
registration_ids Opsional, array string Token perangkat yang akan ditambahkan atau dihapus. Jika Anda menghapus semua token pendaftaran yang ada dari grup perangkat, FCM akan menghapus grup perangkat tersebut.

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.