[服务升级] JPush【广播推送】和【别名设置】功能将于 2020 年 3 月 10 日进行调整(重要)

尊敬的极光开发者:

您好!感谢您长期以来对极光推送的关注和支持。

极光推送基于业务优化的需求,现需要对「广播推送」和「设置别名」功能进行必要的限制,针对所有的免费用户,具体调整方案如下:

一、广播推送

广播推送的频率限制调整为 10 次/天,超过调用限制时将返回报错码 2008,官网控制台将与 Push API 同步调整。

注:广播推送指的是调 REST API 时设置 Audience 为 all ,一次性推送消息给所有人。对别名、registrationID 、tag 等的推送均不受此影响,请注意分辨。

二、别名设置

一个别名(alias)最多允许绑定 10 个设备,若超过此限制,客户端 SDK 与 Device API 返回的错误码如下:

  • JPush Android v3.5.8 及以上、JPush iOS v3.3.2 及以上版本将返回错误码:6027;这两个版本预期在 3 月发布。

  • JPush Android v3.5.8 以下、JPush iOS v3.3.2 以下版本将会返回错误码:6017。

  • 如果您使用的依旧是老版本已经过时别名与标签接口,如 JPushInterface. setAliasAndTags 及 JPushInterface.setAlias 接口,后台检测到设置超出限制,则会通过接口回调错误码 5

  • Device API 接口会返回错误码:7015。

上述调整将于 2020-03-10 上线,请尽快调整您的业务逻辑。如果您因为业务需要,希望提高以上限制的上限,可以联系商务开通对应的 VIP 服务。

注意:在年初发布的通知中,原计划是限制别名仅允许 1 个设备设置,产品在征集开发者建议后经研究决定放宽限制,因此针对原邮件的举例说明,现更正如下:

若 App 的 alias 值在限制调整之前已经与 N 个设备建立了绑定关系,则规则调整的影响是:

  • 若 N >= 10 ,则规则调整对这 N 个设备无影响,他们将继续可以收到该 alias 的推送消息,但该 alias 无法继续新增和第 N+1 个设备的绑定关系,将返回上述错误码。

  • 若 N < 10,则新绑定的设备遵循上述规则,当累计设置的设备数超过 10 后返回错误码。

对于 N >= 10 这种情况,如果您想为该 alias 新增新设备,废弃原来绑定的旧设备信息,可以调用 Device API 对旧设备进行删除操作。

本次服务优化给您带来的不便,我们深感抱歉,如有任何疑问,可发邮件至 support@jiguang.cn

极光开发者服务团队