Lingkungan server Anda dan FCM

Sisi server Firebase Cloud Messaging terdiri dari dua komponen:

  • Backend FCM yang disediakan oleh Google.
  • Server aplikasi Anda atau lingkungan server tepercaya lainnya untuk menjalankan logika server, seperti Cloud Functions for Firebase atau lingkungan cloud lain yang dikelola oleh Google.

Server aplikasi Anda atau lingkungan server tepercaya mengirimkan permintaan pesan ke backend FCM, yang kemudian merutekan pesan ke aplikasi klien yang berjalan di perangkat pengguna.

Persyaratan untuk lingkungan server tepercaya

Lingkungan server aplikasi Anda harus memenuhi kriteria berikut:

  • Mampu mengirim permintaan pesan yang diformat dengan benar ke backend FCM.
  • Mampu menangani permintaan dan mengirimnya kembali menggunakan backoff eksponensial.
  • Mampu menyimpan kredensial otorisasi server dan token pendaftaran klien dengan aman.

Memilih opsi server

Anda harus memutuskan metode interaksi dengan server FCM: menggunakan Firebase Admin SDK atau protokol mentah. Karena mendukung berbagai bahasa pemrograman populer dan memiliki metode praktis untuk menangani autentikasi dan otorisasi, Firebase Admin SDK adalah metode yang direkomendasikan.

Opsi untuk berinteraksi dengan server FCM meliputi hal berikut:

Firebase Admin SDK untuk FCM

Admin FCM API menangani autentikasi dengan backend dan memfasilitasi pengiriman pesan serta pengelolaan langganan topik. Dengan Firebase Admin SDK, Anda dapat:

  • Mengirim pesan ke setiap perangkat secara terpisah
  • Mengirim pesan ke topik dan pernyataan kondisi yang cocok dengan satu topik atau lebih
  • Membuat perangkat berlangganan ke topik dan berhenti berlangganan dari topik
  • Membuat payload pesan yang disesuaikan untuk berbagai platform target

Admin Node.js SDK menyediakan metode untuk mengirim pesan ke grup perangkat.

Untuk menyiapkan Firebase Admin SDK, lihat Menambahkan Firebase Admin SDK ke Server Anda. Jika Anda sudah memiliki project Firebase, mulailah dengan Menambahkan SDK tersebut. Selain itu, pastikan untuk mengaktifkan Cloud Messaging API di halaman setelan Cloud Messaging untuk project Anda. Kemudian, setelah Firebase Admin SDK diinstal, Anda dapat mulai menulis logika ke membuat permintaan kirim.

Protokol server FCM

FCM menyediakan FCM HTTP v1 API untuk developer yang lebih memilih protokol server mentah.

Untuk mengirim pesan, server aplikasi akan menerbitkan permintaan POST dengan header HTTP dan isi HTTP yang terdiri dari key-value pair JSON. Untuk detail tentang opsi header dan isi, lihat Mem-build Permintaan Kirim Server Aplikasi