目录

撤回语音播报消息

场景介绍

当推送的语音播报消息内容有误或者存在违规情况时,可能会引起用户投诉或监管部门处罚等不良后果。Push Kit为您提供消息撤回功能,降低此类推送可能造成的影响。

  • 消息撤回当前仅支持使用Token和notifyId撤回。

  • 若要使用消息撤回功能,请确保您在推送语音播报消息时设置了notifyId字段。

  • 消息撤回仅支持以下类型:

    还未下发到端侧的消息。

    已在终端展示但用户还未点击的消息。

约束与限制

撤回语音播报消息能力支持Phone、Tablet、PC/2in1。并且从API版本5.1.0(18)开始,新增支持Wearable设备;从API版本6.1.0(23)开始,新增支持TV设备;从API版本26.0.1开始,新增支持Car设备。

开发步骤

  1. 参考发送语音播报消息章节进行消息推送,确保应用可正常收到语音播报消息。

  2. 应用服务端调用REST API撤回语音播报消息,消息详情可参见消息撤回,请求示例如下:

    // Request URL
    POST "https://push-api.cloud.huawei.com/v1/[clientId]/messages:revoke"
     
    // Request Header
    Content-Type:application/json
    Authorization:Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
    push-type: 2
     
    // Request Body
    {
      "notifyId": 1234567,
      "token": [
        "pushToken1",
        "pushToken2",
        "pushToken3"
      ]
    }

撤回消息接口使用v1版本URL,并且路径参数使用clientId。与其他场景化消息推送接口使用的v3版本不同,路径参数使用clientId而非projectId。