开发者社区 问答 正文

推消息给Android设备怎么实现?



PushMessageToAndroid



描述


推送消息给Android设备。
[backcolor=transparent]注:该接口默认只发送给在线设备,要发送离线保存消息请用 推送高级接口

请求参数

名称类型是否必须描述
ActionString操作接口名称,取值:PushMessageToAndroid
AppKeyLongAppKey信息
TargetString推送目标:
  • DEVICE:根据设备推送
  • ACCOUNT:根据账号推送
  • ALIAS:根据别名推送
  • TAG:根据标签推送
  • ALL:推送给全部设备
TargetValueString根据Target来设定,多个值使用逗号分隔,最多支持100个。
  • Target=DEVICE,值如deviceid111,deviceid1111
  • Target=ACCOUNT,值如account111,account222
  • Target=ALIAS,值如alias111,alias222
  • Target=TAG,支持单Tag和多Tag,格式请参考 标签格式
  • Target=ALL,值为all
TitleString发送的消息的标题
BodyString发送的消息内容


响应参数

名称类型描述
MessageIdString标志一次推送的消息ID


错误码

错误代码描述HTTP 状态码语义
InvalidTargetTarget must be [DEVICE、ACCOUNT、TAG、ALIAS、ALL].400Target只能取DEVICE、ACCOUNT、TAG、ALIAS、ALL其中之一进行发送


示例



请求示例

  1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//cloudpush.aliyuncs.com/?Action=PushMessageToAndroid
  2. [backcolor=transparent]&[backcolor=transparent]AppKey[backcolor=transparent]=[backcolor=transparent]23267207
  3. [backcolor=transparent]&[backcolor=transparent]Target[backcolor=transparent]=[backcolor=transparent]ALL[backcolor=transparent]&
  4. [backcolor=transparent]&[backcolor=transparent]TargetValue[backcolor=transparent]=[backcolor=transparent]ALL
  5. [backcolor=transparent]&[backcolor=transparent]Title[backcolor=transparent]=[backcolor=transparent]title
  6. [backcolor=transparent]&[backcolor=transparent]Body[backcolor=transparent]=[backcolor=transparent]body
  7. [backcolor=transparent]&<公共请求参数>


返回示例



XML格式

  1. [backcolor=transparent]<?[backcolor=transparent]xml version[backcolor=transparent]=[backcolor=transparent]"1.0"[backcolor=transparent] encoding[backcolor=transparent]=[backcolor=transparent]"UTF-8"[backcolor=transparent]?>
  2. [backcolor=transparent]<PushMessageToAndroidResponse>
  3. [backcolor=transparent]    [backcolor=transparent]<RequestId>[backcolor=transparent]9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC[backcolor=transparent]</RequestId>
  4. [backcolor=transparent]    [backcolor=transparent]<MessageId>[backcolor=transparent]501029[backcolor=transparent]</MessageId>
  5. [backcolor=transparent]</PushMessageToAndroidResponse>


JSON格式

  1. [backcolor=transparent]{
  2. [backcolor=transparent]  [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC"[backcolor=transparent],
  3. [backcolor=transparent]  [backcolor=transparent]"MessageId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"501029"
  4. [backcolor=transparent]}

展开
收起
猫饭先生 2017-10-23 10:28:25 1357 分享 版权
阿里云 AI 助理回答

推送消息给Android设备指南

推送概述

要向Android设备推送消息,您应使用阿里云EMAS移动推送服务的高级接口,并指定DeviceTypeANDROIDPushTypeMESSAGE。此方法替代了即将废弃的PushMessageToAndroid接口,确保您可以利用更全面的推送功能。

请求参数配置

  • Action: 必填,设置为PushMessageToAndroid
  • AppKey: 必填,您的AppKey信息。
  • Target: 必填,指定推送目标。可选值包括:
    • DEVICE: 根据设备ID推送。
    • ACCOUNT: 根据账号推送。
    • ALIAS: 根据别名推送。
    • TAG: 根据标签推送。
    • ALL: 推送给所有设备。
  • TargetValue: 必填,根据Target类型设定具体值,多个值以逗号分隔,总数限制最多1000个(原说明中误为100个,请以1000为准)。
  • Title: 必填,消息标题。
  • Body: 必填,消息内容。
  • StoreOffline(可选): 设置是否离线保存消息,默认为false。若设为true,当用户不在线时,消息将在72小时内保留并待用户上线后重新发送。

响应参数

  • MessageId: 成功推送后返回的消息唯一标识符。

错误处理

  • InvalidTarget: 当Target值不在允许的范围[DEVICE, ACCOUNT, TAG, ALIAS, ALL]内时,会返回400错误。

注意事项

  • 收费与权限:在使用前,请充分了解EMAS移动推送产品的收费方式和价格。
  • 离线消息:默认仅推送给在线设备,需通过StoreOffline参数实现离线消息保存。
  • API授权:调用API需要正确的RAM权限配置,具体操作请参考相关文档中的授权信息部分。

示例请求

尽管示例URL未提供完整,正确的构造请求应包含所有必要参数,形如:

http://cloudpush.aliyuncs.com/?Action=PushMessageToAndroid&AppKey=您的AppKey&Target=TARGET_TYPE&TargetValue=目标值列表&Title=消息标题&Body=消息内容&其他通用参数...

请替换您的AppKeyTARGET_TYPE目标值列表消息标题消息内容等占位符为实际值,并根据需求添加其他通用参数。

参考资料: - PushMessageToAndroid 接口文档提及的高级接口使用建议与参数详情。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答