使用MassPush批量向不同设备推送不同消息-移动研发平台-阿里云

批量给不同的设备推送不同的消息/通知。

接口说明

请确保在使用该接口前，已充分了解 EMAS 移动推送产品的收费方式和价格。

在某种业务场景中，可能需要在极短时间内大量向不同设备单推不同消息，在设备数、消息数极大时，会产生较高 QPS，达到我们单来源 IP 的 QPS 限制，造成部分推送失败。

本接口针对此问题设计。它支持单次调用最大传入 100 个独立的推送任务，通过聚合请求的方式有效降低 QPS，提高大量单推的稳定性和成功率。批量推送单账号限制每秒 500 次调用。

每个独立推送任务仅支持根据设备/账号/别名三类推送目标，且暂不支持短信融合配置。

说明

SDK 需升级到 3.11.0 及以上版本。

PushTask 属性

PushTask 属性格式为：PushTask.N.Property。包含：
- 推送目标（destination）
- 推送配置（config）
- iOS 通知任务配置
- Android 通知任务配置
- Android 辅助弹窗功能配置
- HarmonyOS 通知任务配置
- 推送控制（push control）
每一个 PushTask 表示一个独立推送任务，最大支持 100 个，推送相关配置，和 Push 接口一致。
PushTask.N.Target 参数只支持 DEVICE、ACCOUNT、ALIAS 三种类型。
PushTask 不支持短信联动配置。
父节点和子节点的乘积不能超过 10000，否则视为参数无效。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

mpush:MassPush

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AppKey	integer	是	AppKey 信息。	23267207
PushTask	array<object>	是	独立推送任务组成的数组。
	array<object>	否	独立推送任务。
PushType	string	是	推送类型。取值： MESSAGE：表示消息。 NOTICE：表示通知。枚举值： MESSAGE : MESSAGE NOTICE : NOTICE	MESSAGE
DeviceType	string	是	设备类型，取值范围为： HARMONY：鸿蒙设备 iOS：iOS 设备 ANDROID：Android 设备 ALL：当 AppKey 为旧版本双端应用时，代表同时推送 Android 和 iOS 设备；当 AppKey 为新版本单端应用时，效果和指定该应用类型对应的设备类型一样。枚举值： ALL : ALL ANDROID : ANDROID iOS : iOS	HARMONY
Target	string	是	推送目标。可取值： DEVICE：根据设备推送。 ACCOUNT：根据账号推送。 ALIAS：根据别名推送。枚举值： ACCOUNT : ACCOUNT ALIAS : ALIAS DEVICE : DEVICE	DEVICE
TargetValue	string	是	根据 Target 来设定，多个值使用逗号分隔，超过限制需要分多次推送。 Target=DEVICE，值如`deviceid1,deviceid2`（最多支持 1000 个）。 Target=ACCOUNT，值如`account1,account2`（最多支持 1000 个）。 Target=ALIAS，值如`alias1,alias2`（最多支持 1000 个）。	deviceid1,deviceid2
StoreOffline	boolean	否	离线消息/通知是否保存。StoreOffline 默认设置为 false。若保存，在推送时候用户不在线，在过期时间（ExpireTime）内用户上线时会被再次发送。ExpireTime 默认为 72 小时。iOS 通知走 APNs 链路，不受 StoreOffline 影响。	true
SendChannels	string	否	指定发送通道，取值如下： accs：阿里云自有通道 huawei：华为通道 honor：荣耀通道 xiaomi：小米通道 oppo：OPPO 通道 vivo：vivo 通道 meizu：魅族通道 gcm：谷歌 GCM 通道（旧版 HTTP） fcm: 谷歌 Firebase 通道（HTTP v1 API） apns：APNs 通道 harmony: 鸿蒙通道说明如果未配置此参数，则代表所有通道均可使用。如果配置了此参数，则严格使用参数中的通道。如果配置的通道和发送策略冲突（如 iOS 通知仅走 APNs 通道，但本参数中不包含 apns），则不实施发送。若配置 gcm，则可以走谷歌 GCM 和 FCM 通道，若配置 fcm，则只能走谷歌 FCM 通道。	accs,huawei,xiaomi
PushTime	string	否	用于定时发送。不设置缺省是立即发送。时间格式按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 YYYY-MM-DDThh:mm:ssZ。	2019-02-20T00:00:00Z
ExpireTime	string	否	离线消息/通知的过期时间，和 StoreOffline 配合使用，过期则不会再被发送，最长保存 72 小时。默认为 72 小时。时间格式按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 YYYY-MM-DDThh:mm:ssZ，过期时间不能小于当前时间或者定时发送时间加上 3 秒（`ExpireTime > PushTime+3 秒`），3 秒是为了冗余网络和系统延迟造成的误差。建议单推不小于 1 分钟，全推、批量推送不少于 10 分钟。	2019-02-20T00:00:00Z
JobKey	string	否	推送任务自定义标识，当 JobKey 不为空时，回执日志中会附带该字段。查看回执日志参见回执日志。	123
Title	string	否	推送时通知/消息的标题，长度限制：200 字节。在 Android 推送和 Harmony 推送时必填；在 iOS 推送通知时非必填，如果填写，则： iOS 10+通知显示标题。 iOS 8.2 <= iOS 系统 < iOS 10：替换通知应用名称。	title
Body	string	否	Android 和 Harmony 推送时通知的内容/消息的内容；iOS 消息/通知内容，推送的内容大小是有限制的，参见产品限制。	hello
Trim	boolean	否	是否自动对过长标题、内容进行截断。注：仅支持明确限制标题、内容的厂商通道，对 APNs、华为、荣耀通道等不限制标题、内容，只限制总请求体大小的不适用。	false
iOSApnsEnv	string	否	iOS 的通知是通过 APNs 中心来发送的，需要填写对应的环境信息。 DEV：开发环境，适用于 Xcode 直接安装调试的应用。 PRODUCT：生产环境，适用于 App Store、TestFlight、Ad Hoc 及企业分发的应用。枚举值： DEV : DEV PRODUCT : PRODUCT	DEV
iOSRemind	boolean	否	消息推送时设备不在线（即与移动推送的服务端的长连接通道不通），则这条推送会做为通知，通过苹果的 APNs 通道送达一次。说明离线消息转通知仅适用于生产环境。	true
iOSSubtitle	string	否	iOS 通知副标题内容（iOS 10+）。	subtitle
iOSRemindBody	string	否	iOS 消息转通知时使用的 iOS 通知内容，仅当 iOSApnsEnv=PRODUCT && iOSRemind 为 true 时有效。	ios通知body
iOSMusic	string	否	iOS 通知声音。指定存放在 app bundle 或沙盒 Library/Sounds 目录下的音频文件名，请参见：iOS 推送如何设定通知声音。若指定为空串（””），通知为静音；若不设置，默认填充 default 为系统提示音。	””
iOSBadge	integer	否	iOS 应用图标右上角角标。说明若 iOSBadgeAutoIncrement 设置为 True，则此项必须为空。	0
iOSBadgeAutoIncrement	boolean	否	是否开启角标自增功能，默认为 false。说明当该项为 true 时，iOSBadge 必须为空。角标自增功能由推送服务端维护每个设备的角标计数，需要用户使用 V1.9.5 以上版本的 SDK，并且需要用户主动同步角标数字到服务端。	true
iOSSilentNotification	boolean	否	是否开启 iOS 静默通知。	true
iOSMutableContent	boolean	否	iOS 通知处理扩展标记（iOS 10+）。如果设为 true，则 APNs 推送的通知在弹出前，可先到达 Extension 进行处理。静默通知时，必须设为 true。	true
iOSNotificationCategory	string	否	指定 iOS 通知 Category（iOS 10+）。	ios
iOSNotificationCollapseId	string	否	设备收到有相同 CollapseId 的消息，会合并成一条。设备不在线，连续发相同 CollapseId 的消息，通知栏只会显示一条，iOS 10+支持设置此参数。	ZD2011
iOSNotificationThreadId	string	否	通过该属性对 iOS 的远程通知进行分组，标记折叠的组别识别名。仅支持 iOS 12.0+版本。	abc
iOSInterruptionLevel	string	否	中断级别，取值： passive：系统在不点灯、不播放声音的情况下将通知添加到通知列表中。 active：系统立即显示通知，点亮屏幕，并可以播放声音。 time-sensitive：系统立即呈现通知，点亮屏幕，并可以播放声音，但不会突破系统通知控制。 critical：系统立即显示通知，屏幕亮起，并绕过静音开关播放声音。枚举值： critical : critical time-sensitive : time-sensitive active : active passive : passive	active
iOSRelevanceScore	number	否	摘要突出显示分数。取值范围：[0,1]的浮点数。	0.01
iOSExtParameters	string	否	iOS 通知的扩展属性。 iOS10+可以在此指定富媒体推送通知的资源 Url：`{"attachment": "https://xxxx.xxx/notification_pic.png"}` 。该参数要以 JSON map 的格式传入，否则会解析出错。	{"attachment": "https://xxxx.xxx/notification_pic.png"}
iOSLiveActivityEvent	string	否	启动、更新、结束实时活动。枚举：start \| update \| end	start
iOSLiveActivityId	string	否	由设备上报到用户服务器的 Live Activity ID，Live Activity 的唯一标识符。	66B94673-B32E-4CA7-863C-3E523054FD46
iOSLiveActivityAttributesType	string	否	待启动的 Live Activity 类型。说明 iOSLiveActivityEvent 为 start 时必填	OrderActivityAttributes
iOSLiveActivityAttributes	string	否	JSON 字符串，灵动岛推送透传静态参数。包含静态的用户自定义信息，如产品编号、订单信息等。说明 iOSLiveActivityEvent 为 start 时必填	{"orderId": "12345", "product": "Shoes"}
iOSLiveActivityContentState	string	否	灵动岛推送透传动态参数，包含实时更新信息，如价格、库存变化等	{"status": "delivered", "estimatedArrival": "2023-12-31T12:00:00Z"}
iOSLiveActivityDismissalDate	integer	否	结束的 Live Activity 在锁屏上会保留到该指定时间，最长为 4 小时。	1743131967
iOSLiveActivityStaleDate	integer	否	秒级时间戳，标记该活动的内容过期时间。	1743131967
AndroidNotifyType	string	否	通知的提醒方式。可取值： VIBRATE：振动（默认值） SOUND：声音 BOTH：声音和振动 NONE：静音枚举值： SOUND : SOUND NONE : NONE VIBRATE : VIBRATE BOTH : BOTH	VIBRATE
AndroidRemind	boolean	否	推送类型为消息时设备不在线，则这条推送会使用辅助弹窗功能。默认值为 false，仅当 PushType=MESSAGE 时生效。如果消息转通知推送成功，收到通知是展示的数据为服务端设置的 AndroidPopupTitle 和 AndroidPopupBody 参数值，点击通知在辅助弹窗的 onSysNoticeOpened 方法中获取到的数据是服务端设置的 Title 和 Body 参数值。	true
AndroidOpenType	string	否	点击通知后动作。可取值： APPLICATION：打开应用（默认值） ACTIVITY：打开应用 AndroidActivity URL：打开 URL NONE：无跳转枚举值： APPLICATION : APPLICATION NONE : NONE ACTIVITY : ACTIVITY URL : URL	APPLICATION
AndroidActivity	string	否	设定通知打开的 activity。仅当 PushTask.N.AndroidOpenType=”Activity”时传入，如：`com.alibaba.cloudpushdemo.bizactivity`。	com.alibaba.cloudpushdemo.bizactivity
AndroidOpenUrl	string	否	Android 收到推送后打开对应的 url。仅当 PushTask.N.AndroidOpenType=”URL”时传入。	https://xxxx.xxx
AndroidPopupActivity	string	否	指定点击通知后跳转的 Activity。	com.alibaba.cloudpushdemo.bizactivity
AndroidPopupTitle	string	否	辅助弹窗模式下标题内容。AndroidPopupActivity 参数不为空时，该参数必填。长度限制：50 个字符，中英文都算一个字符。如使用厂商通道，则需同时符合厂商通道的限制，具体内容参见： Android 端辅助通道推送限制。	hello
AndroidPopupBody	string	否	辅助弹窗模式下 Body 内容。AndroidPopupActivity 参数不为空时，该参数必填。长度限制：200 个字符，中英文都算一个字符。如使用厂商通道，则需同时符合厂商通道的限制，具体内容参见： Android 端辅助通道推送限制。	hello
AndroidRenderStyle	string	否	通知样式，取值为： 0：标准模式（默认） 1：长文本模式（支持华为、荣耀、小米、OPPO、魅族、自有通道） 2：大图模式（支持自有通道，不支持小米机型） 3：列表模式（支持华为、荣耀、小米、OPPO、自有通道）说明若使用非标准模式，此参数必须提供。	1
AndroidBigTitle	string	否	长文本模式下的标题，长度限制：200 个字节（1 个汉字算作 3 字节）。当前仅支持荣耀通道和华为通道 EMUI11 及以上版本。若长文本模式下未提供此参数，则从 Title、AndroidPopupTitle 里取第一个非空值。	示例长标题
AndroidBigBody	string	否	长文本模式下的 body，长度限制：1000 字节（1 个汉字算作 3 字节），发送时受具体厂商通道的限制。当前支持：　华为：EMUI10 及以上　荣耀：Magic UI 4.0 及以上　小米：MIUI10 及以上　OPPO：ColorOS5.0 以上　魅族：Flyme 　自有通道：安卓 SDK3.6.0 及以上若长文本模式下未提供此参数，则从 Body、AndroidPopupBody 里取第一个非空值。	示例长文本
AndroidBigPictureUrl	string	否	大图模式下的图片 URL，当前支持：自有通道：安卓 SDK3.6.0 及以上。	https://imag.example.com/image.png
AndroidXiaomiBigPictureUrl `deprecated`	string	否	该参数已废弃，小米从 2023.08 开始，官方在新设备/系统已经不再支持推送时动态设置小图标、右侧图标、大图片功能。	https://f6.market.xiaomi.com/download/MiPass/aaa/bbb.png
AndroidImageUrl	string	否	大图标 URL。当前支持：华为 EMUI（仅长文本模式、Inbox 模式下适用）荣耀 Magic UI（仅长文本模式下适用）自有通道：安卓 SDK3.5.0 及以上	https://imag.example.com/image.png
AndroidXiaomiImageUrl `deprecated`	string	否	该参数已废弃，小米从 2023.08 开始，官方在新设备/系统已经不再支持推送时动态设置小图标、右侧图标、大图片功能。	https://imag.example.com/image.png
AndroidInboxBody	string	否	Inbox 模式下的正文，内容为合法的 JSON Array，且元素不超过 5 个。当前支持：华为：EMUI9 及以上荣耀：Magic UI 4.0 及以上小米：MIUI10 及以上 OPPO：ColorOS 5.0 以上自有通道：安卓 SDK3.6.0 及以上	["第一行","第二行"]
AndroidNotificationBarType	integer	否	Android 自定义通知栏样式，取值：1-100。	2
AndroidNotificationBarPriority	integer	否	Android 通知在通知栏展示时排列位置的优先级。可取值： -2，-1，0，1，2。	0
AndroidNotificationNotifyId	integer	否	标识每条消息在通知显示时的唯一标识，不同的通知栏消息可以相同的 NotifyId，实现新的通知栏消息覆盖老的，当前支持除 FCM 通道外的其他厂商通道。	100001
AndroidNotificationChannel	string	否	Android app 的 channelId，需要与 app 中的 channelId 能对应上。设置 NotificationChannel 参数，具体用途请参见常见问题：Android 8.0 以上设备通知接收不到。因 OPPO 通知私信通道的 channel_id 与 app 的 channelId 相同，故 OPPO 通道推送时，channel_id 取此值。华为、FCM、阿里云自有通道推送中，channel_id 取此值。	1
AndroidNotificationHuaweiChannel	string	否	设置 Huawei 通知消息分类 importance 参数，决定用户设备消息通知行为，取值如下： LOW：资讯营销类消息 NORMAL：服务与通讯类消息说明当前华为通道建议使用 AndroidMessageHuaweiCategory 进行通知分类，可不再使用 AndroidNotificationHuaweiChannel。需要在 Huawei 平台申请，申请链接。枚举值： LOW : LOW NORMAL : NORMAL	LOW
AndroidNotificationHonorChannel	string	否	设置荣耀通知消息分类 importance 参数，决定用户设备消息通知行为，取值如下： LOW：资讯营销类消息 NORMAL：服务与通讯类消息需要在荣耀平台申请，申请链接。枚举值： LOW : LOW NORMAL : NORMAL	LOW
AndroidNotificationXiaomiChannel	string	否	设置小米通知类型的 channelId，需要在小米平台申请，详见：申请链接。说明小米通道单个应用最多可申请 8 个 channel，请提前做好规划。	michannel
AndroidNotificationVivoChannel	string	否	设置 vivo 通知消息分类，取值为： 0：运营类消息（默认） 1：系统类消息说明当前 vivo 通道建议使用 AndroidMessageVivoCategory 进行通知分类，可不再使用 AndroidNotificationVivoChannel。需要在 vivo 平台申请，详见：申请链接。枚举值： 0 : 0 1 : 1	0
AndroidNotificationGroup	string	否	消息分组，同一组消息在通知栏里只显示最新一条和当前该组接受到的消息总数目，不会展示所有消息也无法展开。当前支持：华为荣耀自有通道	group-1
AndroidNotificationThreadId	string	否	消息分组，同一组消息在通知栏里折叠展示，可展开，不同组通知分开展示。当前支持：自有通道安卓 SDK3.9.2 及以上	thread-1
AndroidExtParameters	string	否	设定通知的扩展属性。当推送类型 PushType 设置为 MESSAGE 消息类型时，该属性不生效。该参数要以 JSON map 的格式传入，否则会解析出错。	{"key1":"value1","api_name":"PushNoticeToAndroidRequest"}
AndroidMessageHuaweiUrgency	string	否	华为通道透传消息投递优先级，取值如下： HIGH NORMAL 需要申请权限，具体请参见：申请链接。枚举值： HIGH : HIGH NORMAL : NORMAL	HIGH
AndroidMessageHuaweiCategory	string	否	作用一：完成自分类权益申请后，用于标识消息类型，确定消息提醒方式，对特定类型消息加快发送，取值请参考华为推送官方文档的消息分类标准，填写文档表格中的“云端通知 category 取值”或“本地通知 category 取值”。作用二：申请特殊权限后，用于标识高优先级透传场景，取值如下： VOIP：音视频通话 PLAY_VOICE：语音播报说明对于“云端通知 category 取值”为“不涉及”的一概走阿里云自有通道，对于“本地通知 category 取值”为“不涉及”的一概走华为通道。	SUBSCRIPTION
AndroidMessageOppoCategory	string	否	OPPO 将消息分类：通讯与服务、内容与营销两个类别进行管理。通讯与服务（需申请权限）： IM：即时聊天、音频、视频通话 ACCOUNT：个人账号与资产变化 DEVICE_REMINDER：个人设备提醒 ORDER：个人订单/物流状态变化 TODO：个人日程/待办 SUBSCRIPTION：个人订阅内容与营销： NEWS：新闻资讯 CONTENT：内容推荐 MARKETING：平台活动 SOCIAL：社交动态详细请参考 OPUSH 消息分类细则	MARKETING
AndroidMessageOppoNotifyLevel	integer	否	OPPO 通道通知栏消息提醒等级。可取值为： 1：通知栏 2：通知栏+锁屏（通讯与服务类消息默认通知级别） 16：通知栏+锁屏+横幅+震动+铃声（需申请权限）说明使用 AndroidMessageOppoNotifyLevel 参数时，必须同时传 AndroidMessageOppoCategory 参数。	1
AndroidMessageVivoCategory	string	否	vivo 将消息分为：系统消息、运营消息两个类别进行管理。系统消息： IM：即时消息 ACCOUNT：账号与资产 TODO：日程待办 DEVICE_REMINDER：设备信息 ORDER：订单与物流 SUBSCRIPTION：订阅提醒运营消息： NEWS：新闻 CONTENT：内容推荐 MARKETING：运营活动 SOCIAL：社交动态说明详细请参考分类说明	TODO
AndroidTargetUserType	integer	否	设置厂商通道通知类型： 0：正式通知（默认）。 1：测试通知。说明本参数配置后等价于同时配置 AndroidHuaweiTargetUserType、AndroidHonorTargetUserType、AndroidVivoPushMode、AndroidOppoIntentEnv 四个参数，具体厂商通道的对应参数能覆盖本参数。当前支持：华为通道、荣耀通道、vivo 通道、OPPO 流体云。	1
AndroidHuaweiTargetUserType	integer	否	设置华为通道通知类型： 0：正式通知（默认）。 1：测试通知。说明每个应用每日可发送该测试通知 500 条且不受每日单设备推送数量上限要求。枚举值： 0 : 0 1 : 1	1
AndroidHonorTargetUserType	integer	否	设置荣耀通道通知类型： 0：正式通知（默认）。 1：测试通知。说明每个应用每日可发送该测试通知 1000 条且不受每日单设备推送数量上限要求。	1
AndroidVivoPushMode	integer	否	设置 vivo 通道通知类型： 0：正式推送（默认）。 1：测试推送。说明测试推送请事先在 vivo 控制台配置测试设备。测试设备 RegId 可在设备启动日志中搜索“onReceiveRegId regId”获得。枚举值： 0 : 0 1 : 1	1
AndroidOppoIntentEnv	integer	否	设置 OPPO 流体云推送环境 0：正式环境（默认）。 1：测试环境。说明 OPPO 流体云测试环境需要参考环境搭建在客户端搭建	1
AndroidHuaweiBusinessType	integer	否	设置华为快通知参数 0：发送华为普通通知（默认）。 1：发送华为快通知。	1
AndroidHuaweiReceiptId	string	否	华为通道回执 ID，该回执 ID 可以在华为通道推送运营平台的回执参数配置中查看。说明如果在华为通道推送运营平台配置的默认回执配置是阿里云回执，则无需提供，如果不是，建议优先在阿里云 EMAS 移动推送控制台中配置华为通道默认回执 ID。	RCP4C123456
AndroidVivoReceiptId	string	否	vivo 通道回执 ID，该回执 ID 可以在 vivo 开放平台推送服务的应用信息中查看。说明如果在 vivo 开放平台配置的默认回执配置是阿里云回执，则无需提供，如果不是，建议优先在阿里云 EMAS 移动推送控制台中配置 vivo 通道默认回执 ID。	123
AndroidBadgeClass	string	否	角标设置应用入口 Activity 的全类名说明仅华为/荣耀产商通道推送时有效	com.alibaba.cloudpushdemo.bizactivity
AndroidBadgeAddNum	integer	否	设置角标累加值，在原角标的基础上进行累加，取值范围[1~99]。说明仅华为/荣耀厂商通道推送时有效。AndroidBadgeAddNum 与 AndroidBadgeSetNum 同时存在时，以 AndroidBadgeSetNum 为准	1
AndroidBadgeSetNum	integer	否	设置角标数字固定值，取值范围[0~99]。说明厂商通道推送时仅华为、荣耀通道生效。阿里云自有通道推送时仅华为机型、荣耀机型与 vivo 机型上生效。	5
AndroidMusic	string	否	华为厂商通道通知声音。指定存放在客户端项目 app/src/main/res/raw/目录下的音频文件名，不需要携带文件格式后缀名。若不设置，则使用默认铃声。	alicloud_notification_sound
HarmonyRemind	boolean	否	推送类型为消息时设备不在线，则这条推送会使用辅助弹窗功能。默认值为 false，仅当 PushType=MESSAGE 时生效。如果消息转通知推送成功，收到通知是展示的数据为服务端设置的 HarmonyRemindTitle 和 HarmonyRemindBody 参数值。	false
HarmonyRemindTitle	string	否	Harmony 消息转通知时使用的 Harmony 通知标题，仅当 HarmonyRemind 为 true 时有效。	新消息
HarmonyRemindBody	string	否	Harmony 消息转通知时使用的 Harmony 通知内容，仅当 HarmonyRemind 为 true 时有效。	您有一条新消息，请查收
HarmonyCategory	string	否	通知消息类别。完成申请通知消息自分类权益后，用于标识消息类型，不同的通知消息类型影响消息展示和提醒方式。取值如下： IM：即时聊天 VOIP：音视频通话 SUBSCRIPTION：订阅 TRAVEL：出行 HEALTH：健康 WORK：工作事项提醒 ACCOUNT：账号动态 EXPRESS：订单&物流 FINANCE：财务 DEVICE_REMINDER：设备提醒 MAIL：邮件 CUSTOMER_SERVICE：客服消息 MARKETING：新闻、内容推荐、社交动态、产品促销、财经动态、生活资讯、调研、功能推荐、运营活动（仅对内容进行标识，不会加快消息发送），统称为资讯营销类消息详情参见鸿蒙官网 Notification.category	IM
HarmonyNotificationSlotType	string	否	使用指定类型的通知渠道。仅在阿里云自有通道在线时有效。 SOCIAL_COMMUNICATION: 社交通信。 SERVICE_INFORMATION: 服务提醒。 CONTENT_INFORMATION: 内容资讯。 CUSTOMER_SERVICE: 客服消息。该类型用于用户与商家之间的客服消息，需由用户主动发起。 OTHER_TYPES: 其他。详情参见鸿蒙官网 SlotType	SOCIAL_COMMUNICATION
HarmonyNotifyId	integer	否	每条消息在通知显示时的唯一标识。不携带时，推送服务自动为每条消息生成一个唯一标识；不同的通知消息可以拥有相同的 notifyId，实现新消息覆盖旧消息功能。详情参见鸿蒙官网 Notification.notifyId	0
HarmonyActionType	string	否	点击通知后动作。可取值： APP_HOME_PAGE：打开应用首页 APP_CUSTOM_PAGE：打开应用自定义页面	APP_HOME_PAGE
HarmonyAction	string	否	应用内置页面 ability 对应的 action。重要当 HarmonyActionType 为 APP_CUSTOM_PAGE 时，字段 HarmonyUri 和 HarmonyAction 至少填写一个。详情参见鸿蒙官网 ClickAction.action	com.example.action
HarmonyUri	string	否	应用内置页面 ability 对应的 uri。重要当 HarmonyActionType 为 APP_CUSTOM_PAGE 时，字段 HarmonyUri 和 HarmonyAction 至少填写一个。当存在多个 Ability 时，分别填写不同 Ability 的 action 和 uri，优先使用 action 查找对应的应用内置页面。详情参见鸿蒙官网 ClickAction.uri	https://www.example.com:8080/push/example
HarmonyRenderStyle	string	否	通知消息样式： NORMAL: 普通通知（默认值） MULTI_LINE: 多行文本样式	NORMAL
HarmonyImageUrl	string	否	通知右侧大图标 URL，URL 使用的协议必须是 HTTPS 协议。说明支持图片格式为 png、jpg、jpeg、heif、gif、bmp，图片长*宽<25000 像素。详情参见鸿蒙官网 Notification.image	https://example.com/xxx.png
HarmonyInboxContent	string	否	多行文本样式的内容，当 HarmonyRenderStyle 为 MULTI_LINE 时，本字段必填，最多支持 3 条内容。	["1.content1","2.content2","3.content3"]
HarmonyExtParameters	string	否	设定通知的扩展属性。当推送类型 PushType 设置为 MESSAGE 消息类型时，该属性不生效。该参数要以 JSON map 的格式传入，否则会解析出错。	{"key1":"value1","api_name":"PushNoticeToAndroidRequest"}
HarmonyTestMessage	boolean	否	测试消息标识： false：正常消息（默认值） true：测试消息详情参见鸿蒙官网 pushOptions.testMessage	true
HarmonyReceiptId	string	否	鸿蒙通道回执 ID，该回执 ID 可以在鸿蒙通道推送运营平台的回执参数配置中查看。说明如果在鸿蒙通道推送运营平台配置的默认回执配置是阿里云回执，则无需提供，如果不是，建议优先在阿里云 EMAS 移动推送控制台中配置鸿蒙通道默认回执 ID。详情参见鸿蒙官网 pushOptions.receiptId	RCPB***DFD5
HarmonyExtensionPush	boolean	否	PushType 为 NOTICE 时，是否为鸿蒙通知扩展消息。 true：发送通知扩展消息 false：发送普通通知(默认值) 通知扩展消息需要先在鸿蒙侧申请权限才能发送，相关内容请参考鸿蒙文档发送通知扩展消息。鸿蒙 SDK1.2.0 版本开始支持。	true
HarmonyExtensionExtraData	string	否	通知扩展消息的额外数据。发送鸿蒙通知扩展消息时有效。概念上等同鸿蒙通知扩展消息的 extraData 字段，具体定义参考鸿蒙 ExtensionPayload 说明。鸿蒙 SDK1.2.0 版本开始支持。	示例额外数据
HarmonyBadgeAddNum	integer	否	鸿蒙应用角标累加数字。参考鸿蒙角标 addNum 字段说明。鸿蒙 SDK1.2.0 版本开始支持。	1
HarmonyBadgeSetNum	integer	否	鸿蒙应用角标设置数字。参考鸿蒙角标 setNum 字段说明。鸿蒙 SDK1.2.0 版本开始支持。	1
SendSpeed `deprecated`	integer	否	该参数已废弃。	0
AndroidXiaoMiNotifyTitle `deprecated`	string	否	该参数已废弃，所有第三方辅助弹窗都由新参数 AndroidPopupTitle 统一支持。	无
AndroidXiaoMiNotifyBody `deprecated`	string	否	该参数已废弃，所有第三方辅助弹窗都由新参数 AndroidPopupBody 统一支持。	无
AndroidXiaoMiActivity `deprecated`	string	否	该参数已废弃，所有第三方辅助弹窗都由新参数 AndroidPopupActivity 统一支持。	无
AndroidMeizuNoticeMsgType	integer	否	魅族消息类型 0 公信消息（默认） 1 私信消息枚举值： 0 : 公信消息（默认） 1 : 私信消息	0
AndroidOppoPrivateMsgTemplateId `deprecated`	string	否	OPPO 私信模板 ID 警告 OPPO 私信模板功能已不再由 MaasPush 支持。如需使用该功能，请改用 Push、PushV2 或 MassPushV2 接口	687557242b1634hzef3zd5013
AndroidOppoPrivateTitleParameters `deprecated`	object	否	OPPO 私信模版标题参数
	string	否	OPPO 私信模版标题中的变量名，变量值	my_title
AndroidOppoPrivateContentParameters `deprecated`	object	否	OPPO 私信模版内容参数
	string	否	OPPO 私信模版内容中的变量名，变量值	my_content
HarmonyLiveViewPayload	string	否	鸿蒙实况窗数据结构 LiveViewPayload 的 JSON 字符串，开发接入请参考文档HarmonyOS 实况窗推送指南	{ "activityId": 1, "operation": 0, "event": "TAXI", "status": "DRIVER_ON_THE_WAY", "activityData": { "notificationData": { "type": 3 } } }
AndroidHuaweiLiveNotificationPayload	string	否	华为安卓实况窗数据结构 LiveNotificationPayload 的 JSON 字符串，开发接入请参考文档华为实况窗推送指南	{ "activityId": 1, "operation": 1, "event": "TAXI", "activityData": { "notificationData": { "type": 3 } } }
AndroidOppoIntelligentIntent	string	否	OPPO 流体云的意图共享数据结构 IntelligentIntent 的 JSON 字符串，开发接入请参考文档 OPPO 流体云推送指南	{ "intentName": "Example.Progress", "identifier": "d71ebd3119877b12ecdb6c4fe96b068e", "timestamp": 1729485000989, "serviceId": { "launcher": "999800001", "fluidCloud": "999900001" }, "intentAction": { "actionStatus": 0 }, "intentEntity": { "entityName": "TAXI" } }
AndroidOppoDeleteIntentData	string	否	OPPO 流体云的意图删除数据结构 data 的 JSON 字符串，当 AndroidOppoIntelligentIntent 参数已填写时此参数无效，开发接入请参考文档 OPPO 流体云推送指南	{ "intentName": "Example.Progress", "entityIds": [ "A580202509130712" ], "serviceId": { "launcher": "999800001", "fluidCloud": "999900001" } }
IdempotentToken	string	否	用于防止 API 调用端重试造成服务端重复推送的一个幂等参数。15 分钟内使用相同 IdempotentToken 进行调用时，只会进行一次推送，后续返回第一次成功推送的结果。说明参数格式为标准 36 位 UUID(8-4-4-4-12)，每个有效字符是 0-9 或 a-f 范围内的一个十六进制的数字，不区分大小写。此参数仅用于避免重试造成的重复推送，无法避免并发调用造成的重复推送。	c8016d13-6e76-410c-9bda-769383d11787

返回参数

名称	类型	描述	示例值
	object
MessageIds	object
MessageId	array	批量消息 ID 列表，每个消息 ID 对应传入的 PushTask 的推送结果
	string	消息 ID	501030
RequestId	string	请求 ID。	9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC

示例

正常返回示例

JSON格式

{
  "MessageIds": {
    "MessageId": [
      "501030"
    ]
  },
  "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC"
}

错误码

HTTP status code	错误码	错误信息	描述
400	Invalid%s.Format	The specified %s format is invalid.	参数格式错误。
400	AccountDisabled	Your account is not enabled.	功能未启用。
400	FileNotExist	The specified file does not exist.	指定的文件不存在。
400	IncorrectPassword	The password is incorrect.	密码错误。
400	NotApnsCertificate	The Certificate is not an APNs certificate.	不是APNs证书。
400	PermissionDenied	The specified AppKey is not authorized.
400	SendSpeedNotSupported	SendSpeed is not supported for specified Target.	制定目标不支持SendSpeed参数。
400	SmsProfileConfigFailed	Failed to configure SMS profile.	SMS配置失败。
400	SmsProfileGetFailed	Failed to get SMS profile.	SMS配置获取失败。
400	SmsRoleAuthorizeFailed	Failed to authorize SMS role.	SMS角色授权失败。
400	SmsRoleUnauthorized	The SMS role is unauthorized.	SMS角色没有授权。
400	TagsNumberBeyondLimit	The number of tags bound to this app exceeds the limit.	当前app绑定的tag数量超过限制。
400	Invalid%s.LengthExceed	The specified %s length cannot be greater than %s.	参数长度超限。
400	Invalid%s.BytesExceed	The specified %s exceeds the %s bytes limit.	参数的字节数超限。
400	Invalid%s.Empty	The specified %s cannot be empty.	参数不能为空。
400	Invalid.Parameter	The specified parameter is invalid: %s.	参数%s无效。
400	TargetNotSupported	Target is not supported for batch push.	批量推送不支持的Target。
500	InternalError	The request processing has failed due to some unknown error. Please try again. If the error still exists, submit a ticket.	服务端错误，建议重试，仍然失败则提工单
500	Timeout	The request processing is timeout.	请求处理超时。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。