פיתוח בקשות לשליחה בשרת האפליקציה

באמצעות פרוטוקולי השרת של אפליקציות Firebase Admin SDK או FCM, אפשר ליצור בקשות להודעות ולשלוח אותן לסוגי היעדים הבאים:

• שם הנושא
• תנאי
• טוקן רישום מכשיר
• שם קבוצת המכשירים (פרוטוקול בלבד)

אפשר לשלוח הודעות עם מטען ייעודי (payload) של התראות שמורכב משדות מוגדרים מראש, מטען ייעודי של נתונים שמורכב משדות שהוגדרו על ידי המשתמש, או הודעה שמכילה את שני סוגי המטען הייעודי. מידע נוסף זמין במאמר סוגי הודעות.

חשוב: בקשות שנשלחות גם עבור Firebase Admin SDK וגם עבור פרוטוקול HTTP v1 צריכות לכלול את מזהה הפרויקט של פרויקט Firebase עבור האפליקציה שלכם. המזהה הזה זמין בכרטיסייה הגדרות כלליות של הפרויקט במסוף Firebase. בנוסף, בשתי השיטות לשליחת הודעות צריך לאשר את בקשות השליחה.

בדף הזה מופיעות דוגמאות לשליחת הודעות התראה באמצעות Firebase Admin SDK (שכולל תמיכה ב-Node,‏ Java,‏ Python,‏ C#‎ ו-Go) ופרוטוקול HTTP בגרסה 1.

שליחת הודעות שמופעלת בהן האפשרות 'הפעלה ישירה' (Android בלבד)

אפשר לשלוח הודעות למכשירים במצב אתחול ישיר באמצעות ממשקי ה-API של HTTP v1 או של HTTP מדור קודם. לפני ששולחים למכשירים במצב אתחול ישיר, צריך לוודא שהשלמתם את השלבים להפעלת האפשרות לקבלת הודעות FCM במכשירי לקוח במצב אתחול ישיר.

זהירות: חשוב לשים לב לחשיפה של הודעות שמופעלת בהן האפשרות 'אתחול ישיר'. כל משתמש עם גישה למכשיר יכול לראות את ההודעות האלה בלי להזין את פרטי הכניסה שלו.

שליחה באמצעות FCM v1 HTTP API

בקשת ההודעה חייבת לכלול את המפתח "direct_boot_ok" : true באפשרויות AndroidConfig של גוף הבקשה. לדוגמה:

https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send
Content-Type:application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
  "message":{
    "token" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
    "data": {
      "score": "5x1",
      "time": "15:10"
    },
    "android": {
      "direct_boot_ok": true,
    },
}