سفارشی کردن یک پیام در سراسر سیستم عامل

Firebase Admin SDK و رابط برنامه‌نویسی کاربردی HTTP نسخه ۱ FCM به درخواست‌های پیام شما اجازه می‌دهند تا تمام فیلدهای موجود در شیء message را تنظیم کنند. این موارد شامل موارد زیر است:

• مجموعه‌ای مشترک از فیلدها که باید توسط تمام نمونه‌های برنامه‌ای که پیام را دریافت می‌کنند، تفسیر شوند.
• مجموعه‌ای از فیلدهای مختص پلتفرم، مانند AndroidConfig و WebpushConfig ، که فقط توسط نمونه‌های برنامه‌ای که روی پلتفرم مشخص‌شده اجرا می‌شوند، تفسیر می‌شوند.

بلوک‌های مختص پلتفرم به شما انعطاف‌پذیری لازم برای سفارشی‌سازی پیام‌ها برای پلتفرم‌های مختلف را می‌دهند تا از مدیریت صحیح آنها هنگام دریافت اطمینان حاصل شود. بک‌اند FCM تمام پارامترهای مشخص شده را در نظر گرفته و پیام را برای هر پلتفرم سفارشی‌سازی می‌کند.

چه زمانی از فیلدهای مشترک استفاده کنیم

از فیلدهای مشترک در موارد زیر استفاده کنید:

• ارسال فیلدها به هر پلتفرمی
• ارسال پیام به موضوعات

همه نمونه‌های برنامه، صرف نظر از پلتفرم، می‌توانند فیلدهای مشترک زیر را تفسیر کنند:

• message.notification.title
• message.notification.body
• message.data

چه زمانی از فیلدهای مخصوص پلتفرم استفاده کنیم

از فیلدهای مخصوص پلتفرم زمانی استفاده کنید که می‌خواهید:

• ارسال فیلدها فقط به پلتفرم‌های خاص
• ارسال فیلدهای مخصوص پلتفرم علاوه بر فیلدهای رایج

هر زمان که می‌خواهید مقادیر را فقط به پلتفرم‌های خاصی ارسال کنید، از فیلدهای مخصوص هر پلتفرم استفاده کنید. برای مثال، برای ارسال اعلان فقط به پلتفرم‌های اپل و وب اما نه به اندروید، باید از دو مجموعه فیلد جداگانه استفاده کنید، یکی برای اپل و دیگری برای وب.

وقتی پیام‌هایی با گزینه‌های تحویل خاص ارسال می‌کنید، از فیلدهای مخصوص هر پلتفرم برای تنظیم آنها استفاده کنید. در صورت تمایل می‌توانید مقادیر متفاوتی را برای هر پلتفرم تعیین کنید. با این حال، حتی وقتی می‌خواهید اساساً مقدار یکسانی را در پلتفرم‌های مختلف تنظیم کنید، باید از فیلدهای مخصوص هر پلتفرم استفاده کنید. دلیل این امر این است که هر پلتفرم ممکن است مقدار را کمی متفاوت تفسیر کند - برای مثال، زمان حیات در اندروید به عنوان زمان انقضا بر حسب ثانیه تنظیم می‌شود، در حالی که در اپل به عنوان تاریخ انقضا تنظیم می‌شود.

پیام اعلان با گزینه‌های تحویل مخصوص پلتفرم

درخواست ارسال HTTP v1 API زیر، یک عنوان و محتوای اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما برخی از لغوهای خاص پلتفرم را نیز ارسال می‌کند. به طور خاص، درخواست:

• مدت زمان ماندگاری را برای پلتفرم‌های اندروید و وب طولانی می‌کند، در حالی که اولویت پیام‌های APN (پلتفرم‌های اپل) را روی مقدار کم تنظیم می‌کند.
• کلیدهای مناسب را برای تعریف نتیجه ضربه کاربر روی اعلان در اندروید و اپل تنظیم می‌کند - به ترتیب click_action و category .

{
  "message":{
     "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
     "notification":{
       "title":"Match update",
       "body":"Arsenal goal in added time, score is now 3-0"
     },
     "android":{
       "ttl":"86400s",
       "notification"{
         "click_action":"OPEN_ACTIVITY_1"
       }
     },
     "apns": {
       "headers": {
         "apns-priority": "5",
       },
       "payload": {
         "aps": {
           "category": "NEW_MESSAGE_CATEGORY"
         }
       }
     },
     "webpush":{
       "headers":{
         "TTL":"86400"
       }
     }
   }
 }

برای کسب اطلاعات بیشتر، به صفحه مرجع HTTP v1 مراجعه کنید تا جزئیات بیشتری در مورد کلیدهای موجود در بلوک‌های مخصوص پلتفرم در بدنه پیام را ببینید. برای اطلاعات بیشتر در مورد ساخت درخواست‌های ارسال که حاوی بدنه پیام هستند، به ارسال پیام با استفاده از FCM HTTP v1 API مراجعه کنید.

پیام اعلان با گزینه‌های رنگ و آیکون

در مثال زیر، درخواست ارسال، یک عنوان و محتوای اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما برخی از تغییرات خاص پلتفرم را نیز به دستگاه‌های اندروید ارسال می‌کند.

برای اندروید، این درخواست یک آیکون و رنگ خاص برای نمایش در دستگاه‌های اندروید تعیین می‌کند. همانطور که در مرجع AndroidNotification ذکر شده است، رنگ با فرمت #rrggbb مشخص می‌شود و تصویر باید یک منبع آیکون قابل ترسیم محلی در برنامه اندروید باشد.

در اینجا مثالی از جلوه بصری روی دستگاه کاربر آورده شده است:

نود جی اس

const topicName = 'industry-tech';

const message = {
  notification: {
    title: '`$FooCorp` up 1.43% on the day',
    body: 'FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
  },
  android: {
    notification: {
      icon: 'stock_ticker_update',
      color: '#7e55c3'
    }
  },
  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);
  });

جاوا

Message message = Message.builder()
    .setNotification(Notification.builder()
        .setTitle("$GOOG up 1.43% on the day")
        .setBody("$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.")
        .build())
    .setAndroidConfig(AndroidConfig.builder()
        .setTtl(3600 * 1000)
        .setNotification(AndroidNotification.builder()
            .setIcon("stock_ticker_update")
            .setColor("#f45342")
            .build())
        .build())
    .setApnsConfig(ApnsConfig.builder()
        .setAps(Aps.builder()
            .setBadge(42)
            .build())
        .build())
    .setTopic("industry-tech")
    .build();
FirebaseMessagingSnippets.java

پایتون

message = messaging.Message(
    notification=messaging.Notification(
        title='$GOOG up 1.43% on the day',
        body='$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.',
    ),
    android=messaging.AndroidConfig(
        ttl=datetime.timedelta(seconds=3600),
        priority='normal',
        notification=messaging.AndroidNotification(
            icon='stock_ticker_update',
            color='#f45342'
        ),
    ),
    apns=messaging.APNSConfig(
        payload=messaging.APNSPayload(
            aps=messaging.Aps(badge=42),
        ),
    ),
    topic='industry-tech',
)
cloud_messaging.py

برو

oneHour := time.Duration(1) * time.Hour
badge := 42
message := &messaging.Message{
	Notification: &messaging.Notification{
		Title: "$GOOG up 1.43% on the day",
		Body:  "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
	},
	Android: &messaging.AndroidConfig{
		TTL: &oneHour,
		Notification: &messaging.AndroidNotification{
			Icon:  "stock_ticker_update",
			Color: "#f45342",
		},
	},
	APNS: &messaging.APNSConfig{
		Payload: &messaging.APNSPayload{
			Aps: &messaging.Aps{
				Badge: &badge,
			},
		},
	},
	Topic: "industry-tech",
}
messaging.go

سی شارپ

var message = new Message
{
    Notification = new Notification()
    {
        Title = "$GOOG up 1.43% on the day",
        Body = "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
    },
    Android = new AndroidConfig()
    {
        TimeToLive = TimeSpan.FromHours(1),
        Notification = new AndroidNotification()
        {
            Icon = "stock_ticker_update",
            Color = "#f45342",
        },
    },
    Apns = new ApnsConfig()
    {
        Aps = new Aps()
        {
            Badge = 42,
        },
    },
    Topic = "industry-tech",
};
FirebaseMessagingSnippets.cs

استراحت

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": "`$FooCorp` up 1.43% on the day",
       "body": "FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day."
     },
     "android":{
       "notification":{
         "icon":"stock_ticker_update",
         "color":"#7e55c3"
       }
     }
   }
 }

برای کسب اطلاعات بیشتر، به صفحه مرجع HTTP v1 مراجعه کنید تا جزئیات بیشتری در مورد کلیدهای موجود در بلوک‌های مخصوص پلتفرم در بدنه پیام را ببینید.

پیام اعلان با تصویر دلخواه

به خاطر داشته باشید:

• تصاویر برای اعلان‌ها به اندازه ۱ مگابایت محدود شده‌اند و در غیر این صورت توسط پشتیبانی داخلی تصویر اندروید محدود شده‌اند.
• برای اینکه بتوانید تصاویر اعلان را در یک برنامه اپل دریافت و مدیریت کنید، باید یک افزونه سرویس اعلان اضافه کنید. افزونه سرویس اعلان به برنامه شما اجازه می‌دهد تا تصویر ارسال شده در بار داده FCM را قبل از نمایش اعلان به کاربر نهایی مدیریت کند، برای نمونه کد به بخش راه‌اندازی افزونه سرویس اعلان مراجعه کنید.
• تصاویر آپلود شده با استفاده از آهنگساز اعلان‌ها به اندازه ۳۰۰ کیلوبایت محدود می‌شوند.
• تصاویر ذخیره شده یا ارائه شده از Cloud Storage مشمول محدودیت‌های سهمیه‌بندی استاندارد هستند.

در درخواست ارسال اعلان خود، گزینه‌های زیر را تنظیم کنید تا کلاینت گیرنده بتواند تصویر ارسال شده در payload را مدیریت کند:

• برای اندروید، گزینه AndroidConfig زیر را تنظیم کنید:
  • notification.image حاوی آدرس تصویر
• برای iOS، گزینه‌های ApnsConfig زیر را تنظیم کنید:
  • fcm_options.image که حاوی آدرس اینترنتی تصویر است. اپل برای شناسایی صحیح نوع منبع، الزام می‌کند که آدرس اینترنتی تصویر شامل یک پسوند فایل معتبر باشد.
  • headers({ "mutable-content": 1})

درخواست ارسال زیر یک عنوان اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما یک تصویر نیز ارسال می‌کند. در اینجا مثالی از جلوه بصری روی دستگاه کاربر آورده شده است:

نود جی اس

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);
  });

استراحت

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 مراجعه کنید تا جزئیات بیشتری در مورد کلیدهای موجود در بلوک‌های مخصوص پلتفرم در بدنه پیام را ببینید.

پیام اعلان با یک اقدام کلیک مرتبط

درخواست ارسال زیر یک عنوان اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما همچنین عملی را برای برنامه ارسال می‌کند تا در پاسخ به تعامل کاربر با اعلان انجام دهد. در اینجا مثالی از جلوه بصری روی دستگاه کاربر آورده شده است:

نود جی اس

const topicName = 'industry-tech';

const message = {
  notification: {
    title: 'Breaking News....'
  },
  android: {
    notification: {
      clickAction: 'news_intent'
    }
  },
  apns: {
    payload: {
      aps: {
        'category': 'INVITE_CATEGORY'
      }
    }
  },
  webpush: {
    fcmOptions: {
      link: 'breakingnews.html'
    }
  },
  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);
  });

استراحت

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

،

Firebase Admin SDK و رابط برنامه‌نویسی کاربردی HTTP نسخه ۱ FCM به درخواست‌های پیام شما اجازه می‌دهند تا تمام فیلدهای موجود در شیء message را تنظیم کنند. این موارد شامل موارد زیر است:

• مجموعه‌ای مشترک از فیلدها که باید توسط تمام نمونه‌های برنامه‌ای که پیام را دریافت می‌کنند، تفسیر شوند.
• مجموعه‌ای از فیلدهای مختص پلتفرم، مانند AndroidConfig و WebpushConfig ، که فقط توسط نمونه‌های برنامه‌ای که روی پلتفرم مشخص‌شده اجرا می‌شوند، تفسیر می‌شوند.

بلوک‌های مختص پلتفرم به شما انعطاف‌پذیری لازم برای سفارشی‌سازی پیام‌ها برای پلتفرم‌های مختلف را می‌دهند تا از مدیریت صحیح آنها هنگام دریافت اطمینان حاصل شود. بک‌اند FCM تمام پارامترهای مشخص شده را در نظر گرفته و پیام را برای هر پلتفرم سفارشی‌سازی می‌کند.

چه زمانی از فیلدهای مشترک استفاده کنیم

از فیلدهای مشترک در موارد زیر استفاده کنید:

• ارسال فیلدها به هر پلتفرمی
• ارسال پیام به موضوعات

همه نمونه‌های برنامه، صرف نظر از پلتفرم، می‌توانند فیلدهای مشترک زیر را تفسیر کنند:

• message.notification.title
• message.notification.body
• message.data

چه زمانی از فیلدهای مخصوص پلتفرم استفاده کنیم

از فیلدهای مخصوص پلتفرم زمانی استفاده کنید که می‌خواهید:

• ارسال فیلدها فقط به پلتفرم‌های خاص
• ارسال فیلدهای مخصوص پلتفرم علاوه بر فیلدهای رایج

هر زمان که می‌خواهید مقادیر را فقط به پلتفرم‌های خاصی ارسال کنید، از فیلدهای مخصوص هر پلتفرم استفاده کنید. برای مثال، برای ارسال اعلان فقط به پلتفرم‌های اپل و وب اما نه به اندروید، باید از دو مجموعه فیلد جداگانه استفاده کنید، یکی برای اپل و دیگری برای وب.

وقتی پیام‌هایی با گزینه‌های تحویل خاص ارسال می‌کنید، از فیلدهای مخصوص هر پلتفرم برای تنظیم آنها استفاده کنید. در صورت تمایل می‌توانید مقادیر متفاوتی را برای هر پلتفرم تعیین کنید. با این حال، حتی وقتی می‌خواهید اساساً مقدار یکسانی را در پلتفرم‌های مختلف تنظیم کنید، باید از فیلدهای مخصوص هر پلتفرم استفاده کنید. دلیل این امر این است که هر پلتفرم ممکن است مقدار را کمی متفاوت تفسیر کند - برای مثال، زمان حیات در اندروید به عنوان زمان انقضا بر حسب ثانیه تنظیم می‌شود، در حالی که در اپل به عنوان تاریخ انقضا تنظیم می‌شود.

پیام اعلان با گزینه‌های تحویل مخصوص پلتفرم

درخواست ارسال HTTP v1 API زیر، یک عنوان و محتوای اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما برخی از لغوهای خاص پلتفرم را نیز ارسال می‌کند. به طور خاص، درخواست:

• مدت زمان ماندگاری را برای پلتفرم‌های اندروید و وب طولانی می‌کند، در حالی که اولویت پیام‌های APN (پلتفرم‌های اپل) را روی مقدار کم تنظیم می‌کند.
• کلیدهای مناسب را برای تعریف نتیجه ضربه کاربر روی اعلان در اندروید و اپل تنظیم می‌کند - به ترتیب click_action و category .

{
  "message":{
     "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
     "notification":{
       "title":"Match update",
       "body":"Arsenal goal in added time, score is now 3-0"
     },
     "android":{
       "ttl":"86400s",
       "notification"{
         "click_action":"OPEN_ACTIVITY_1"
       }
     },
     "apns": {
       "headers": {
         "apns-priority": "5",
       },
       "payload": {
         "aps": {
           "category": "NEW_MESSAGE_CATEGORY"
         }
       }
     },
     "webpush":{
       "headers":{
         "TTL":"86400"
       }
     }
   }
 }

برای کسب اطلاعات بیشتر، به صفحه مرجع HTTP v1 مراجعه کنید تا جزئیات بیشتری در مورد کلیدهای موجود در بلوک‌های مخصوص پلتفرم در بدنه پیام را ببینید. برای اطلاعات بیشتر در مورد ساخت درخواست‌های ارسال که حاوی بدنه پیام هستند، به ارسال پیام با استفاده از FCM HTTP v1 API مراجعه کنید.

پیام اعلان با گزینه‌های رنگ و آیکون

در مثال زیر، درخواست ارسال، یک عنوان و محتوای اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما برخی از تغییرات خاص پلتفرم را نیز به دستگاه‌های اندروید ارسال می‌کند.

برای اندروید، این درخواست یک آیکون و رنگ خاص برای نمایش در دستگاه‌های اندروید تعیین می‌کند. همانطور که در مرجع AndroidNotification ذکر شده است، رنگ با فرمت #rrggbb مشخص می‌شود و تصویر باید یک منبع آیکون قابل ترسیم محلی در برنامه اندروید باشد.

در اینجا مثالی از جلوه بصری روی دستگاه کاربر آورده شده است:

نود جی اس

const topicName = 'industry-tech';

const message = {
  notification: {
    title: '`$FooCorp` up 1.43% on the day',
    body: 'FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
  },
  android: {
    notification: {
      icon: 'stock_ticker_update',
      color: '#7e55c3'
    }
  },
  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);
  });

جاوا

Message message = Message.builder()
    .setNotification(Notification.builder()
        .setTitle("$GOOG up 1.43% on the day")
        .setBody("$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.")
        .build())
    .setAndroidConfig(AndroidConfig.builder()
        .setTtl(3600 * 1000)
        .setNotification(AndroidNotification.builder()
            .setIcon("stock_ticker_update")
            .setColor("#f45342")
            .build())
        .build())
    .setApnsConfig(ApnsConfig.builder()
        .setAps(Aps.builder()
            .setBadge(42)
            .build())
        .build())
    .setTopic("industry-tech")
    .build();
FirebaseMessagingSnippets.java

پایتون

message = messaging.Message(
    notification=messaging.Notification(
        title='$GOOG up 1.43% on the day',
        body='$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.',
    ),
    android=messaging.AndroidConfig(
        ttl=datetime.timedelta(seconds=3600),
        priority='normal',
        notification=messaging.AndroidNotification(
            icon='stock_ticker_update',
            color='#f45342'
        ),
    ),
    apns=messaging.APNSConfig(
        payload=messaging.APNSPayload(
            aps=messaging.Aps(badge=42),
        ),
    ),
    topic='industry-tech',
)
cloud_messaging.py

برو

oneHour := time.Duration(1) * time.Hour
badge := 42
message := &messaging.Message{
	Notification: &messaging.Notification{
		Title: "$GOOG up 1.43% on the day",
		Body:  "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
	},
	Android: &messaging.AndroidConfig{
		TTL: &oneHour,
		Notification: &messaging.AndroidNotification{
			Icon:  "stock_ticker_update",
			Color: "#f45342",
		},
	},
	APNS: &messaging.APNSConfig{
		Payload: &messaging.APNSPayload{
			Aps: &messaging.Aps{
				Badge: &badge,
			},
		},
	},
	Topic: "industry-tech",
}
messaging.go

سی شارپ

var message = new Message
{
    Notification = new Notification()
    {
        Title = "$GOOG up 1.43% on the day",
        Body = "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
    },
    Android = new AndroidConfig()
    {
        TimeToLive = TimeSpan.FromHours(1),
        Notification = new AndroidNotification()
        {
            Icon = "stock_ticker_update",
            Color = "#f45342",
        },
    },
    Apns = new ApnsConfig()
    {
        Aps = new Aps()
        {
            Badge = 42,
        },
    },
    Topic = "industry-tech",
};
FirebaseMessagingSnippets.cs

استراحت

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": "`$FooCorp` up 1.43% on the day",
       "body": "FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day."
     },
     "android":{
       "notification":{
         "icon":"stock_ticker_update",
         "color":"#7e55c3"
       }
     }
   }
 }

برای کسب اطلاعات بیشتر، به صفحه مرجع HTTP v1 مراجعه کنید تا جزئیات بیشتری در مورد کلیدهای موجود در بلوک‌های مخصوص پلتفرم در بدنه پیام را ببینید.

پیام اعلان با تصویر دلخواه

به خاطر داشته باشید:

• تصاویر برای اعلان‌ها به اندازه ۱ مگابایت محدود شده‌اند و در غیر این صورت توسط پشتیبانی داخلی تصویر اندروید محدود شده‌اند.
• برای اینکه بتوانید تصاویر اعلان را در یک برنامه اپل دریافت و مدیریت کنید، باید یک افزونه سرویس اعلان اضافه کنید. افزونه سرویس اعلان به برنامه شما اجازه می‌دهد تا تصویر ارسال شده در بار داده FCM را قبل از نمایش اعلان به کاربر نهایی مدیریت کند، برای نمونه کد به بخش راه‌اندازی افزونه سرویس اعلان مراجعه کنید.
• تصاویر آپلود شده با استفاده از آهنگساز اعلان‌ها به اندازه ۳۰۰ کیلوبایت محدود می‌شوند.
• تصاویر ذخیره شده یا ارائه شده از Cloud Storage مشمول محدودیت‌های سهمیه‌بندی استاندارد هستند.

در درخواست ارسال اعلان خود، گزینه‌های زیر را تنظیم کنید تا کلاینت گیرنده بتواند تصویر ارسال شده در payload را مدیریت کند:

• برای اندروید، گزینه AndroidConfig زیر را تنظیم کنید:
  • notification.image حاوی آدرس تصویر
• برای iOS، گزینه‌های ApnsConfig زیر را تنظیم کنید:
  • fcm_options.image که حاوی آدرس اینترنتی تصویر است. اپل برای شناسایی صحیح نوع منبع، الزام می‌کند که آدرس اینترنتی تصویر شامل یک پسوند فایل معتبر باشد.
  • headers({ "mutable-content": 1})

درخواست ارسال زیر یک عنوان اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما یک تصویر نیز ارسال می‌کند. در اینجا مثالی از جلوه بصری روی دستگاه کاربر آورده شده است:

نود جی اس

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);
  });

استراحت

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 مراجعه کنید تا جزئیات بیشتری در مورد کلیدهای موجود در بلوک‌های مخصوص پلتفرم در بدنه پیام را ببینید.

پیام اعلان با یک اقدام کلیک مرتبط

درخواست ارسال زیر یک عنوان اعلان مشترک را به همه پلتفرم‌ها ارسال می‌کند، اما همچنین عملی را برای برنامه ارسال می‌کند تا در پاسخ به تعامل کاربر با اعلان انجام دهد. در اینجا مثالی از جلوه بصری روی دستگاه کاربر آورده شده است:

نود جی اس

const topicName = 'industry-tech';

const message = {
  notification: {
    title: 'Breaking News....'
  },
  android: {
    notification: {
      clickAction: 'news_intent'
    }
  },
  apns: {
    payload: {
      aps: {
        'category': 'INVITE_CATEGORY'
      }
    }
  },
  webpush: {
    fcmOptions: {
      link: 'breakingnews.html'
    }
  },
  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);
  });

استراحت

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