設定郵件優先順序

您可以為下游訊息指派兩種放送優先順序:一般和高優先順序。雖然各平台的行為略有不同,但一般和高優先順序訊息的傳送方式如下:

  • 一般優先順序:如果應用程式在前景運作,系統會立即傳送一般優先順序的訊息。如果應用程式在背景執行,訊息傳送可能會延遲。如果是時效性較低、不需立即處理的訊息,例如新電子郵件通知、保持 UI 同步,或在背景同步處理應用程式資料,請選擇一般放送優先順序。
  • 高優先順序:即使裝置處於打盹模式,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"
      }
    }
  }
}

如要進一步瞭解如何設定訊息優先順序,請參閱各平台專屬說明:

攸關人命的用途

FCM API 並非設計用於緊急警示或其他高風險活動,這類活動使用 API 或 API 故障時,可能會導致死亡、人身傷害或環境損害,例如核子設施、空中交通管制或維生系統的運作。根據第 4. a. 節7。您必須自行負責管理應用程式,確保其符合《條款》規定,並承擔因不遵守規定而造成的任何損害。Google 依「原樣」提供 API,並保留權利,可隨時基於任何理由停止提供 API 或其中任何部分或功能,或終止您的存取權限,且無須向您或您的使用者承擔責任或履行其他義務。