NotificationMessagePayload interface

Interface que representa um payload da mensagem de notificação da API legada do FCM. As mensagens de notificação permitem que os desenvolvedores enviem até 4 KB de pares de chave-valor predefinidos. As chaves aceitas são descritas abaixo.

Consulte Criar solicitações de envio para ver exemplos de código e documentação detalhada.

Assinatura:

export interface NotificationMessagePayload 

Propriedades

Propriedade Tipo Descrição
selo string O valor do selo no ícone do app de tela inicial.Se não for especificado, o selo não será alterado.Se definido como 0, o selo será removido.**Plataformas:** iOS
corpo string O texto do corpo da notificação.**Plataformas:** iOS, Android, Web
bodyLocArgs (em inglês) string Valores de string variáveis a serem usados no lugar dos especificadores de formato no body_loc_key para identificar o texto do corpo na localização atual do usuário.O valor precisa ser uma matriz JSON com strings.**iOS:** corresponde a loc-args no payload de APNs. Consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas para mais informações.**Android:** consulte Formatação e estilo para mais informações.**Plataformas:** iOS, Android
bodyLocKey (link em inglês) string A chave da string do corpo nos recursos de string do app a ser usada para identificar o texto do corpo na localização atual do usuário.**iOS:** corresponde a loc-key no payload de APNs. Consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas para mais informações.**Android:** consulte Recursos de string para mais informações.**Plataformas:** iOS, Android
clickAction. string Ação associada a um clique do usuário na notificação. Se especificado, uma atividade com um filtro de intent correspondente é iniciada quando um usuário clica na notificação.* **Plataformas:** Android
cor string A cor do ícone de notificação, expressa no formato #rrggbb.**Plataformas:** Android
ícone string O ícone da notificação.**Android:** define o ícone da notificação como myicon para o recurso drawable myicon. Se você não enviar essa chave na solicitação, o FCM exibirá o ícone na tela de início especificado no manifesto do app.**Web:** o URL a ser usado para o ícone da notificação.**Plataformas:** Android, Web
som string O som que será reproduzido quando o dispositivo receber uma notificação. Compatível com "default" para o som de notificação padrão do dispositivo ou o nome de arquivo de um recurso de som empacotado no app. Os arquivos de som precisam estar em /res/raw/.**Plataformas:** Android
marcar string Identificador usado para substituir notificações existentes na gaveta de notificações.Se não for especificado, cada solicitação criará uma nova notificação.Se especificada e uma notificação com a mesma tag já estiver sendo exibida, a nova notificação substituirá a notificação existente na gaveta de notificações.**Plataformas:** Android
title string O título da notificação.**Plataformas:** iOS, Android, Web
titleLocArgs (em inglês) string Valores de string variáveis a serem usados no lugar dos especificadores de formato no title_loc_key para identificar o texto do título na localização atual do usuário.O valor precisa ser uma matriz JSON com strings.**iOS:** corresponde a title-loc-args no payload de APNs. Consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas para mais informações.**Android:** consulte Formatação e estilo para mais informações.**Plataformas:** iOS, Android
titleLocKey (link em inglês) string A chave da string do título nos recursos de string do app a ser usada para localizar o texto do título na localização atual do usuário.**iOS:** corresponde a title-loc-key no payload de APNs. Consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas para mais informações.**Android:** consulte Recursos de string para mais informações.**Plataformas:** iOS, Android

NotificationMessagePayload.badge

O valor do indicador no ícone do app da tela inicial.

Se não é especificado, o indicador não é alterado.

Se for definido como 0, o selo será removido.

**Plataformas:** iOS

Assinatura:

badge?: string;

NotificationMessagePayload.body

O texto do corpo da notificação.

**Plataformas:** iOS, Android, Web

Assinatura:

body?: string;

NotificationMessagePayload.bodyLocArgs

Valores de string variáveis a serem usados no lugar dos especificadores de formato em body_loc_key para identificar o texto do corpo na localização atual do usuário.

O valor deve ser uma matriz JSON em string.

**iOS:** corresponde a loc-args no payload de APNs. Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

**Android**: consulte Formatação e estilo para mais informações.

**Plataformas:** iOS, Android

Assinatura:

bodyLocArgs?: string;

NotificationMessagePayload.bodyLocKey

A chave da string do corpo nos recursos de string do app a ser usada para identificar o texto do corpo na localização atual do usuário.

**iOS:** corresponde a loc-key no payload de APNs. Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

**Android**: consulte Recursos de string para mais informações.

**Plataformas:** iOS, Android

Assinatura:

bodyLocKey?: string;

NotificationMessagePayload.clickAction

Ação associada a um clique do usuário na notificação. Se especificado, uma atividade com um filtro de intent correspondente é iniciada quando um usuário clica na notificação.

* **Plataformas**: Android

Assinatura:

clickAction?: string;

NotificationMessagePayload.color

A cor do ícone de notificação, expressa no formato #rrggbb.

**Plataformas:** Android

Assinatura:

color?: string;

NotificationMessagePayload.icon

O ícone da notificação.

**Android**: define o ícone da notificação como myicon para o recurso drawable myicon. Se você não enviar essa chave na solicitação, o FCM exibirá o ícone na tela de início especificado no manifesto do app.

**Web**: o URL a ser usado para o ícone da notificação.

**Plataformas**: Android, Web

Assinatura:

icon?: string;

NotificationMessagePayload.son

O som que será reproduzido quando o dispositivo receber uma notificação. Compatível com "default" para o som de notificação padrão do dispositivo ou o nome de arquivo de um recurso de som empacotado no app. Os arquivos de som precisam estar em /res/raw/.

**Plataformas:** Android

Assinatura:

sound?: string;

NotificationMessagePayload.tag

Identificador usado para substituir notificações existentes na gaveta de notificações.

Se não está especificado, cada solicitação cria uma nova notificação.

Se estiver especificado e uma notificação com a mesma tag já estiver sendo mostrada, a nova notificação substituirá a notificação existente na gaveta de notificações.

**Plataformas:** Android

Assinatura:

tag?: string;

NotificationMessagePayload.title

O título da notificação.

**Plataformas:** iOS, Android, Web

Assinatura:

title?: string;

NotificationMessagePayload.titleLocArgs

Valores de string variáveis a serem usados no lugar dos especificadores de formato em title_loc_key para identificar o texto do título na localização atual do usuário.

O valor deve ser uma matriz JSON em string.

**iOS:** corresponde a title-loc-args no payload de APNs. Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

**Android**: consulte Formatação e estilo para mais informações.

**Plataformas:** iOS, Android

Assinatura:

titleLocArgs?: string;

NotificationMessagePayload.titleLocKey

A chave da string do título nos recursos de string do app a ser usada para identificar o texto do título na localização atual do usuário.

**iOS:** corresponde a title-loc-key no payload de APNs. Para mais informações, consulte Referência da chave de payload e Como localizar o conteúdo de notificações remotas.

**Android**: consulte Recursos de string para mais informações.

**Plataformas:** iOS, Android

Assinatura:

titleLocKey?: string;