שליחת תמונה במטען הייעודי (payload) של ההתראות

‫FCM HTTP v1 API והכלי ליצירת התראות תומכים בשליחת קישורים לתמונות במטען הייעודי (payload) של התראות שמוצגות, כדי שהתמונות יורדו למכשיר אחרי שההתראות נמסרות. הגודל של תמונות בהתראות מוגבל ל-1MB, והן כפופות למגבלות אחרות שקשורות לתמיכה בתמונות ב-Android.

יצירת בקשת השליחה

בבקשה לשליחת ההתראה, מגדירים את האפשרות הבאה של AndroidConfig:

  • ‫notification.image עם כתובת ה-URL של התמונה

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

שרטוט פשוט של תמונה בהתראה לרשת המדיה

Node.js

const topicName = 'industry-tech';

const message = {
  notification: {
    title: 'Sparky says hello!'
  },
  android: {
    notification: {
      imageUrl: 'https://foo.bar.pizza-monster.png'
    }
  },
  apns: {
    payload: {
      aps: {
        'mutable-content': 1
      }
    },
    fcm_options: {
      image: 'https://foo.bar.pizza-monster.png'
    }
  },
  webpush: {
    headers: {
      image: 'https://foo.bar.pizza-monster.png'
    }
  },
  topic: topicName,
};

getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

REST

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":{
     "topic":"industry-tech",
     "notification":{
       "title":"Sparky says hello!",
     },
     "android":{
       "notification":{
         "image":"https://foo.bar/pizza-monster.png"
       }
     },
     "apns":{
       "payload":{
         "aps":{
           "mutable-content":1
         }
       },
       "fcm_options": {
           "image":"https://foo.bar/pizza-monster.png"
       }
     },
     "webpush":{
       "headers":{
         "image":"https://foo.bar/pizza-monster.png"
       }
     }
   }
 }

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

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