שליחת הודעות לקבוצות מכשירים ב-Web/JavaScript

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

המספר המקסימלי של חברים במפתח התראות הוא 20.

ניהול קבוצות מכשירים

לפני ששולחים הודעות לקבוצת מכשירים, צריך:

1. מקבלים טוקני רישום לכל מכשיר שרוצים להוסיף לקבוצה.

2. יוצרים את notification_key, שמזהה את קבוצת המכשירים על ידי מיפוי של קבוצה מסוימת (בדרך כלל משתמש) לכל אסימוני ההרשמה המשויכים לקבוצה. אפשר ליצור מפתחות של התראות בשרת האפליקציות.

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

ניהול קבוצות של מכשירים בשרת האפליקציה

יצירת קבוצת מכשירים

כדי ליצור קבוצת מכשירים, צריך לשלוח בקשת POST עם שם הקבוצה ורשימה של אסימוני הרישום של המכשירים. הפונקציה FCM מחזירה notification_key חדש שמייצג את קבוצת המכשירים.

בקשת HTTP POST

שולחים בקשה כמו זו אל https://fcm.googleapis.com/fcm/notification:

https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID

{
   "operation": "create",
   "notification_key_name": "appUser-Chris",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
                        "cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
                        ... ]

השדה notification_key_name הוא שם או מזהה (למשל, שם משתמש) שיחודי לקבוצה נתונה. הערכים notification_key_name ו-notification_key ייחודיים לקבוצה של אסימוני רישום. אם יש לכם כמה אפליקציות לקוח לאותו מזהה שולח, חשוב שהערך של notification_key_name יהיה ייחודי לכל אפליקציית לקוח. כך אפשר לוודא שההודעות יגיעו רק לאפליקציית היעד הרצויה.

פורמט התגובה

בקשה מוצלחת מחזירה notification_key שדומה לזה:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

שומרים את notification_key ואת notification_key_name התואם כדי להשתמש בהם בפעולות הבאות.

בתהליך אחזור של מפתח ההתראה

אם אתם צריכים לאחזר מפתח התראה קיים, תוכלו להשתמש ב-notification_key_name בבקשת GET כמו שמוצג:

https://fcm.googleapis.com/fcm/notification?notification_key_name=appUser-Chris
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{}

לכל בקשת GET לשם נתון של מפתח התראות, השרת מחזיר מחרוזת ייחודית עם קידוד. למרות שכל מחרוזת עשויה להיראות כמפתח שונה, היא למעשה ערך תקין של notification_key.

הוספה והסרה של מכשירים מקבוצת מכשירים

כדי להוסיף או להסיר מכשירים מקבוצה קיימת, צריך לשלוח בקשת POST עם הפרמטר operation שמוגדר add או remove, ולספק את אסימוני הרישום להוספה או להסרה.

בקשת HTTP POST

לדוגמה, כדי להוסיף מכשיר עם אסימון הרישום bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... ל-appUser-Chris, צריך לשלוח את הבקשה הבאה:

{
   "operation": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

פורמט התגובה

אם הבקשה להוספה או להסרה של מכשיר בוצעה בהצלחה, תקבלו notification_key שדומה לדוגמה הבאה:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

מפתחות לניהול של קבוצות מכשירים

בטבלה הבאה מפורטים המפתחות ליצירת קבוצות של מכשירים, להוספת חברים ולהסרת חברים.

טבלה 10. מפתחות לניהול של קבוצות מכשירים.

שליחת הודעות במורד הזרם לקבוצות של מכשירים

כדי לשלוח הודעות לקבוצות של מכשירים, משתמשים ב-HTTP v1 API. אם אתם שולחים כרגע לקבוצות מכשירים באמצעות ממשקי ה-API מהדור הקודם לשליחת HTTP או XMPP, או כל אחת מהגרסאות הקודמות של Firebase Admin SDK ל-Node.js על סמך הפרוטוקולים הקודמים, מומלץ מאוד לעבור ל-API HTTP v1 בהקדם האפשרי. ממשקי ה-API הקודמים לשליחה יושבתו ויוסרו ביוני 2024.

שליחת הודעות לקבוצת מכשירים דומה מאוד לשליחת הודעות למכשיר ספציפי, ומשתמשים באותה שיטה לאישור בקשות שליחה. מגדירים את השדה token למפתח ההתראות הקבוצתי:

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
   "message":{
      "token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
      "data":{
        "hello": "This is a Firebase Cloud Messaging device group message!"
      }
   }
}

curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"message":{
   "data":{
     "hello": "This is a Firebase Cloud Messaging device group message!"
   },
   "token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send