Sisi server Firebase Cloud Messaging terdiri dari dua komponen:
- Backend FCM yang disediakan oleh Google.
- Server aplikasi Anda atau lingkungan server tepercaya lainnya tempat logika server Anda berjalan, 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.
Kredensial yang diperlukan untuk project Firebase
Bergantung pada fitur FCM yang diterapkan, Anda mungkin membutuhkan kredensial berikut dari project Firebase Anda:
| Kredensial | Deskripsi |
|---|---|
| Project ID | ID unik untuk project Firebase Anda, yang digunakan dalam permintaan ke endpoint HTTP FCM v1. Nilai ini tersedia di panel Setelan Firebase console. |
| Token pendaftaran | String token unik yang mengidentifikasi setiap instance aplikasi klien. Token pendaftaran diperlukan untuk pengiriman pesan satu perangkat dan grup perangkat. Perhatikan bahwa token pendaftaran harus dirahasiakan. |
| ID Pengirim | Nilai numerik unik yang dibuat saat Anda membuat project Firebase, yang tersedia di tab Cloud Messaging pada panel Settings Firebase console. ID pengirim sama dengan nomor project. ID pengirim digunakan untuk mengidentifikasi setiap pengirim yang dapat mengirim pesan ke aplikasi klien. |
| Token akses | Token OAuth 2.0 berumur pendek yang mengizinkan permintaan ke HTTP v1 API. Token ini dikaitkan dengan akun layanan milik project Firebase Anda. Untuk membuat dan merotasi token akses, ikuti langkah-langkah yang dijelaskan di artikel Mengizinkan Permintaan Kirim. |
Memilih opsi server
Anda harus memutuskan metode interaksi dengan server FCM: menggunakan Firebase Admin SDK atau FCM HTTP v1 API. 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, yang mendukung Node, Java, Python, C#, dan Go.
FCM HTTP v1 API, REST API dengan otorisasi aman dan kemampuan pengiriman pesan lintas platform yang fleksibel (Firebase Admin SDK didasarkan pada protokol ini dan memberikan semua keuntungan yang dimilikinya).
Firebase Admin SDK
Firebase Admin SDK 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
- Mengirim pesan ke grup perangkat
- Membuat perangkat berlangganan ke topik dan berhenti berlangganan dari topik
- Membuat payload pesan yang disesuaikan untuk berbagai platform target
Untuk menyiapkan Firebase Admin SDK, lihat Menambahkan Firebase Admin SDK ke Server Anda. Jika Anda sudah memiliki project Firebase, mulailah dengan Menambahkan SDK. Selain itu, pastikan untuk mengaktifkan Firebase Cloud Messaging API (V1) di halaman setelan Cloud Messaging untuk project Anda. Kemudian, setelah Firebase Admin SDK diinstal, Anda dapat mulai menulis logika untuk membuat permintaan kirim.
FCM HTTP v1 API
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 mengetahui detail tentang opsi header dan isi, lihat Mengirim Pesan menggunakan FCM HTTP v1 API.