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

‏FCM HTTP v1 API ו-Notifications composer תומכים בשליחת קישורים לתמונות בתוכן המשא של התראה מוצגת, כדי שהתמונה תוכל להוריד למכשיר אחרי המסירה. התמונות שמיועדות להתראות מוגבלות לגודל של 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 מוגדר כפי שמוצג, בקשת השליחה הזו מאפשרת ללקוח המקבל לטפל בתמונה שנשלחת במטען הייעודי.