閱讀993 返回首頁    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_移動推送-阿裏雲