推消息给Android设备-阿里云帮助中心

调用PushMessageToAndroid推送消息给Android设备。

接口说明

该接口默认只发送给在线设备，要发送离线保存消息请使用推送高级接口。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	PushMessageToAndroid	系统规定参数。取值： PushMessageToAndroid。
AppKey	Long	是	23267207	AppKey信息。
Body	String	是	my body	发送的消息内容。
Target	String	是	ALL	推送目标。可取值： DEVICE：根据设备推送。 ACCOUNT：根据账号推送。 ALIAS：根据别名推送。 TAG：根据标签推送。 ALL：推送给全部设备。
TargetValue	String	是	all	根据Target来设定，多个值使用逗号分隔，超过限制需要分多次推送。 Target=DEVICE，值如 `deviceid111,deviceid1111` （最多支持1000个）。 Target=ACCOUNT，值如 `account111,account222` （最多支持1000个）。 Target=ALIAS，值如 `alias111,alias222` （最多支持1000个）。 Target=TAG，支持单Tag和多Tag，格式请参见标签格式。 Target=ALL，值为all。
Title	String	是	my title	发送的消息的标题。
JobKey	String	否	123	推送任务自定义标识，当JobKey不为空时，回执日志中会附带该字段。查看回执日志参见回执日志。

返回数据

名称	类型	示例值	描述
MessageId	String	501029	标志一次推送的消息ID。
RequestId	String	9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC	请求ID。

示例

请求示例

http(s)://cloudpush.aliyuncs.com/?Action=PushMessageToAndroid
&AppKey=23267207
&Body=my body
&Target=ALL
&TargetValue=all
&Title=my title
&<公共请求参数>

正常返回示例

XML 格式

<PushMessageToAndroidResponse>
      <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
      <MessageId>501029</MessageId>
</PushMessageToAndroidResponse>

JSON 格式

{
  "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC",
  "MessageId": "501029"
}

错误码

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