Définir la priorité d'un message

Vous avez deux options pour attribuer une priorité de distribution aux messages en aval : normale et élevée. Bien que le comportement diffère légèrement selon les plates-formes, la diffusion des messages de priorité normale et élevée fonctionne comme suit :

  • Priorité normale : Les messages de priorité normale sont distribués immédiatement lorsque l'application est au premier plan. Pour les applications mises en arrière-plan, la diffusion peut être retardée. Pour les messages moins urgents, comme les notifications de nouveaux e-mails, la synchronisation de votre UI ou la synchronisation des données de l'application en arrière-plan, choisissez la priorité de distribution normale.
  • Priorité élevée : FCM tente de distribuer immédiatement les messages à priorité élevée, même si l'appareil est en mode Sommeil. Les messages à priorité élevée sont destinés aux contenus urgents et visibles par l'utilisateur.

Voici un exemple de message à priorité normale envoyé à l'aide du protocole HTTP v1 FCM pour informer un abonné à un magazine que de nouveaux contenus sont disponibles au téléchargement :

{
  "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"
      }
    }
  }
}

Pour en savoir plus sur la définition de la priorité des messages sur une plate-forme spécifique :

Cas d'utilisation critiques pour la vie

Les API FCM ne sont pas conçues pour les alertes d'urgence ni pour d'autres activités à haut risque pour lesquelles l'utilisation ou la défaillance des API pourrait entraîner la mort, des blessures corporelles ou des dommages environnementaux, comme l'exploitation d'installations nucléaires, le contrôle du trafic aérien ou les systèmes de survie. Toute utilisation de ce type est expressément interdite en vertu de la section 4. a. 7 des Conditions d'utilisation. Vous êtes seul responsable de la conformité de votre application avec les Conditions d'utilisation et de tout dommage résultant de votre non-respect de ces conditions. Google fournit les API "telles quelles" et se réserve le droit d'interrompre les API ou toute partie ou fonctionnalité de celles-ci, ou encore votre accès à celles-ci, pour quelque raison que ce soit et à tout moment, sans responsabilité ni obligation envers vous ou vos utilisateurs.