阅读993 返回首页    go 阿里云 go 技术社区[云栖]

推通知给Android设备__推送相关_API 列表_OpenAPI 2.0_移动推送-阿里云

PushNoticeToAndroid

描述

推送通知给Android。

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

请求参数

名称 类型 是否必须 描述
Action String 是 操作接口名称，取值：PushNoticeToAndroid
AppKey Long 是 AppKey信息
Target String 是 推送目标：
  • DEVICE:根据设备推送
  • ACCOUNT:根据账号推送
  • ALIAS:根据别名推送
  • TAG:根据标签推送
  • ALL:推送给全部设备
TargetValue String 是 根据Target来设定，多个值使用逗号分隔，最多支持100个。
  • Target=DEVICE，值如deviceid111,deviceid1111
  • Target=ACCOUNT，值如account111,account222
  • Target=ALIAS，值如alias111,alias222
  • Target=TAG，支持单Tag和多Tag，格式请参考标签格式
  • Target=ALL，值为ALL
Title String 是 发送的通知标题
Body String 是 发送的通知内容
ExtParameters String 否 自定义的KV结构，供开发者扩展使用，针对Android设备。该参数要以json map的格式传入。

响应参数

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

错误码

错误代码 描述 HTTP 状态码 语义
InvalidTarget Target must be [DEVICE、ACCOUNT、TAG、ALIAS、ALL]. 400 Target只能取DEVICE、ACCOUNT、TAG、ALIAS、ALL其中之一进行发送
InvalidParameter The specified Title.length can not be greater than 60.] 400 Title不能大于60个Byte（中文算三个）
AppLimitExceed The specified payload beyond the permitted range(1800Byte).] 400 请求内容超过系统限制，请参考产品限制
InvalidJsonExtParameter The specified ExtParameter is not valid json format of map. 400 ExtParameter参数应为json格式的map结构

示例

请求示例

  1. https://cloudpush.aliyuncs.com/?Action=PushNoticeToAndroid
  2. &AppKey=23267207
  3. &Target=ALL&
  4. &TargetValue=ALL
  5. &Title=title
  6. &Body=body
  7. &ExtParameters={"key1":"value1","api_name":"PushNoticeToAndroidRequest"}
  8. &<公共请求参数>

返回示例

XML格式

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <PushNoticeToAndroidResponse>
  3.     <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
  4.     <MessageId>501029</MessageId>
  5. </PushNoticeToAndroidResponse>

JSON格式

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

最后更新：2016-12-08 14:09:14

  上一篇：go 推消息给iOS设备__推送相关_API 列表_OpenAPI 2.0_移动推送-阿里云
  下一篇：go 推通知给iOS设备__推送相关_API 列表_OpenAPI 2.0_移动推送-阿里云