יש שתי אפשרויות להקצאת עדיפות מסירה להודעות במורד הזרם: עדיפות רגילה ועדיפות גבוהה. אף על פי שההתנהגות שונה מעט בפלטפורמות השונות, הצגת הודעות רגילות והודעות עם עדיפות גבוהה מתבצעת באופן הבא:
- עדיפות רגילה. הודעות בעדיפות רגילה נשלחות באופן מיידי כשהאפליקציה בחזית. יכול להיות שיהיה עיכוב במסירת הודעות מאפליקציות שפועלות ברקע. להודעות שפחות רגישות לזמן, כמו התראות על אימייל חדש, שמירה על סנכרון של ממשק המשתמש או סנכרון של נתוני האפליקציה ברקע, כדאי לבחור עדיפות מסירה רגילה.
- עדיפות גבוהה. שירות FCM מנסה להעביר הודעות בעדיפות גבוהה באופן מיידי, גם אם המכשיר במצב שינה. הודעות בעדיפות גבוהה מיועדות לתוכן שרלוונטי לזמן מסוים ומוצג למשתמשים.
הנה דוגמה להודעה בעדיפות רגילה שנשלחה באמצעות פרוטוקול FCM HTTP v1 כדי להודיע למנוי של מגזין שיש תוכן חדש להורדה:
{
"message":{
"topic":"subscriber-updates",
"notification":{
"body" : "This week's edition is now available.",
"title" : "NewsMagazine.com",
},
"data" : {
"volume" : "3.21.15",
"contents" : "http://www.news-magazine.com/world-week/21659772"
},
"android":{
"priority":"normal"
},
"apns":{
"headers":{
"apns-priority":"5"
}
},
"webpush": {
"headers": {
"Urgency": "high"
}
}
}
}
לפרטים נוספים על הגדרת העדיפות של ההודעה בפלטפורמה ספציפית:
תרחישי שימוש קריטיים
ממשקי ה-API של FCM לא מיועדים להתרעות על מצבי חירום או לפעילויות אחרות בסיכון גבוה שבהן השימוש בממשקי ה-API או תקלה בהם עלולים לגרום למוות, לנזקי גוף או לנזק סביבתי, כמו תפעול של מתקנים גרעיניים, בקרה אווירית או מערכות מצילות חיים. כל שימוש כזה אסור במפורש במסגרת סעיף 4. א. 7 בתנאים ובהגבלות. אתם האחראים הבלעדיים לניהול התאימות של האפליקציה לתנאים, ולכל נזק שנובע מאי-תאימות. Google מספקת את ממשקי ה-API "כמו שהם", ושומרת לעצמה את הזכות להפסיק את השימוש בממשקי ה-API או בכל חלק או תכונה שלהם, או להפסיק את הגישה שלך אליהם מכל סיבה שהיא ובכל זמן, ללא אחריות או מחויבות אחרת כלפיך או כלפי המשתמשים שלך.