צד השרת של Firebase Cloud Messaging מורכב משני רכיבים:
- ה-backend של FCM ש-Google מספקת.
- שרת האפליקציה או סביבת שרת מהימנה אחרת שבה פועל הלוגיקה של השרת, כמו Cloud Functions for Firebase או סביבות ענן אחרות שמנוהלות על ידי Google.
שרת האפליקציה או סביבת השרת המהימנה שולחים בקשות להודעות לקצה העורפי של FCM, שמעביר את ההודעות לאפליקציות הלקוח שפועלות במכשירי המשתמשים.
באמצעות פרוטוקולי שרת האפליקציות Firebase Admin SDK או FCM, אתם יכולים ליצור בקשות להודעות ולשלוח אותן ליעדים מהסוגים הבאים:
- שם הנושא
- תנאי
- טוקן רישום אחד (FCM)
- שם קבוצת המכשירים (הוצא משימוש, יוסר ב-29 בספטמבר 2027)
אתם יכולים לשלוח הודעות עם מטען ייעודי (payload) של התראות שמורכב משדות מוגדרים מראש, מטען ייעודי של נתונים מהשדות שהגדרתם בעצמכם או הודעה שמכילה את שני סוגי המטענים הייעודיים. למידע נוסף, קראו את המאמר סוגי הודעות.
הדרישות לסביבת השרת המהימנה
סביבת שרת האפליקציה צריכה לעמוד בקריטריונים הבאים:
- יכולת לשלוח בקשות הודעה בפורמט תקין לקצה העורפי של FCM.
- יכולת לטפל בבקשות ולשלוח אותן מחדש באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff).
- יכולת לאחסן באופן מאובטח פרטי כניסה לאימות של השרת וטוקנים לרישום לקוחות.
פרטי הכניסה הנדרשים לפרויקט ב-Firebase
בהתאם לתכונות של FCM שאתם מטמיעים, יכול להיות שתצטרכו את פרטי הכניסה הבאים מהפרויקט ב-Firebase:
| פרטי כניסה | תיאור |
|---|---|
| מזהה פרויקט | מזהה ייחודי של הפרויקט ב-Firebase, שמשמש בבקשות לנקודת הקצה של FCM v1 HTTP. הערך הזה זמין בחלונית Settings במסוף Firebase. |
| טוקן רישום | מחרוזת טוקן ייחודית שמזהה כל מופע של אפליקציית לקוח. אסימון הרישום נדרש להעברת הודעות למופע יחיד של אפליקציה ולקבוצת מכשירים. חשוב לזכור שצריך לשמור על הסודיות של אסימוני הרישום. |
| מזהה השולח | ערך מספרי ייחודי שנוצר כשיוצרים את הפרויקט ב-Firebase, וזמין בכרטיסייה Cloud Messaging בחלונית Settings (הגדרות) במסוף Firebase. מזהה השולח זהה למספר הפרויקט. מזהה השולח משמש לזיהוי כל שולח שיכול לשלוח הודעות לאפליקציית הלקוח. |
| טוקן גישה | אסימון OAuth 2.0 לטווח קצר שמאשר בקשות ל-HTTP v1 API. האסימון הזה משויך לחשבון שירות ששייך לפרויקט Firebase שלכם. כדי ליצור טוקני גישה ולהחליף אותם, פועלים לפי השלבים שמפורטים בקטע אישור בקשות שליחה. |
בחירת אפשרות לשרת
תצטרכו להחליט איך לתקשר עם שרתי FCM: באמצעות Firebase Admin SDK או באמצעות FCM HTTP v1 API. השיטה המומלצת היא Firebase Admin SDK, כי היא תומכת בשפות תכנות פופולריות וכוללת שיטות נוחות לטיפול באימות ובהרשאה.
האפשרויות לאינטראקציה עם שרתי FCM כוללות:
Firebase Admin SDK, שתומך ב-Node, ב-Java, ב-Python, ב-C# וב-Go.
FCM HTTP v1 API, ממשק API בארכיטקטורת REST עם הרשאה מאובטחת ויכולות גמישות להעברת הודעות בפלטפורמות שונות (Firebase Admin SDK מבוסס על הפרוטוקול הזה ומספק את כל היתרונות המובנים שלו).
Firebase Admin SDK
ה-Firebase Admin SDK מטפל באימות מול ה-backend ומאפשר לשלוח הודעות ולנהל מינויים לנושאים. בעזרת Firebase Admin SDK, אתם יכולים:
- שליחת הודעות למופעים ספציפיים של אפליקציות
- שליחת הודעות לנושאים ולהצהרות תנאי שתואמות לנושא אחד או יותר
- שליחת הודעות לקבוצות מכשירים
- הרשמה של מופעי אפליקציה לנושאים וביטול ההרשמה שלהם לנושאים
- יצירת מטען ייעודי (payload) של הודעות שמותאם לפלטפורמות יעד שונות
כדי להגדיר את Firebase Admin SDK, קראו את המאמר הוספת Firebase Admin SDK לשרת. אם כבר יש לכם פרויקט ב-Firebase, התחילו מהשלב הוספת ה-SDK. בנוסף, חשוב לוודא שהפעלתם את Firebase Cloud Messaging API (V1) בדף ההגדרות של העברת הודעות בענן בפרויקט. אחרי שמתקינים את Firebase Admin SDK, אפשר להתחיל לכתוב לוגיקה כדי ליצור בקשות שליחה.
FCM HTTP v1 API
FCM מספק את FCM HTTP v1 API למפתחים שמעדיפים פרוטוקול שרת גולמי.
כדי לשלוח הודעה, שרת האפליקציה שולח בקשת POST עם כותרת HTTP וגוף HTTP שמורכב מצמדי מפתח/ערך בפורמט JSON. לפרטים על האפשרויות של הכותרת וגוף ההודעה, קראו את המאמר שליחת הודעה באמצעות FCM HTTP v1 API.