触发推送通知

通知类型

添加消息和通知

背景

用户添加卡券后，您可能需要向他们发送一条 并确保用户收到通知使用 Add Message API 请求，其 message_type 等于 TEXT_AND_NOTIFY，会出现以下情况：

  1. “Message” 该列表项被添加到了（也称为详细信息 模板），并向已保存卡券的用户发送推送通知。
  2. 用户点按通知后，打开的 Google 钱包会随即打开 卡券（也称为卡片视图）后，用户会在 显示“View Message”的屏幕按钮。
  3. 点击标注会将用户带到卡券的后端，在这里， 未读消息会突出显示。

向用户发送带有通知的消息时的一些注意事项

  • 用户必须启用通知，其卡券才能接收 与消息相关的推送通知。
  • “信息”应用可能包含指向您网站或应用的 URI。超链接必须是 与卡券相关的网站或应用。这违反了 使用限制政策 将用户引导至与卡券无关的链接。
  • 在 24 小时制。如果出现以下情况，Google 可能会限制您的推送通知传送配额： 认为您在向用户发送垃圾邮件。
  • 用户在锁定屏幕上看到的推送通知由 Google 控制 钱包。
  • 您可以使用 UPDATE 或 PATCH 使用常规类或对象修改或移除消息数据的方法 端点。

集成步骤

当您想要通知用户有关使用 AddMessage API，您需要更新 AddMessageRequest 这样，Message 就可以 其中包含您的新文本，其类型为 MessageType TEXT_AND_NOTIFY，而非 TEXT。

在卡券类中添加消息和通知的 JSON 请求示例

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

在卡券对象中添加消息和通知的 JSON 请求示例

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

针对卡券类添加消息和通知的响应示例

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

异常处理

如果尝试发送通知超过 3 次，则会导致 QuotaExceededException 响应。对 卡券可使用“TEXT”进行设置而非 “TEXT_AND_NOTIFY”如集成 步骤。