单个任务推送信息查询

Recent Pages

单个任务推送信息查询

最后更新时间：2024-01-17 14:26:44

接口说明
请求方式：POST。
调用频率限制：200次/小时。
服务地址/v3/statistics/get_push_record
接口服务地址与服务接入点一一对应，请选择与您的应用服务接入点对应的 服务地址。
接口功能：根据任务的 pushid 查询该条任务的基本信息和设置。
参数说明
请求参数
参数名称
必选
类型
描述
pushId
是
String
推送任务 ID
应答参数
参数名称
类型
描述
retCode
Integer
返回状态码
errMsg
String
错误信息
pushRecordData
Array
返回结果，pushRecordData 结构变量见下表
pushRecordData
参数名称
类型
说明
取值说明
date
String
推送时间
格式：YYYY-MM-DD hh:mm:ss
pushId
String
消息ID
-
title
String
推送标题
-
content
String
推送内容
-
status
String
推送状态
PUSH_INIT //任务已创建
PUSH_WAIT// 等待任务被调度
PUSH_STARTED// 推送中
PUSH_FINISHED// 推送完成
PUSH_FAILED//推送失败
PUSH_CANCELED// 用户取消推送
PUSH_DELETED// 推送被删除
PUSH_REVOKED//推送已被撤回
PUSH_COLLAPSED//推送已被覆盖
PUSH_DELETED_PUSH_MSG//推送被终止
pushType
String
推送目标
all //全推
tag //标签推送
token_list //设备列表
account_list //账号列表
package_account_push //号码包推送
messageType
String
推送类型
notify //通知
message //消息
environment
String
推送环境
product //生产环境
dev //开发环境
expireTime
Integer
过期时间
单位 s
xgMediaResources
String
富媒体信息
-
multiPkg
Boolean
是否多包名推送
true //开启多包名推送
false //关闭多包名推送
targetList
Array(String)
推送账号或推送设备列表
pushType 为 token_list 或 account_list 时有效
collapseID
Integer
消息覆盖 ID
pushType 为 all、tag、package_account_push 时有效
tagSet
Object
标签设置
pushType 为 tag 时有效
数据结构：
{
"op":"OR", //标签间逻辑操作
"tagWithType":[
{ "tagTypeName":"xg_user_define", //标签类型
"tagValue":"test68" //标签值}
]
}
uploadId
Integer
号码包 ID
pushType 为 package_account_push 时有效
pushConfig
Object
推送配置信息
"Android"：Android 推送相关配置信息，具体参考下述代码
"iOS"：iOS 推送相关配置信息， 具体参考下述代码
配置信息
Android 推送配置信息
"android": {
        "ring": 1, //响铃     
        "vibrate": 1,//震动
        "lights": 1,//呼吸灯
        "clearable": 1, //是否可清除     
        "action": {
            "action_type": 3,// 动作类型，1，打开activity或app本身；2，打开浏览器；3，打开Intent         
            "intent": "" //SDK版本需要大于等于1.0.9，然后在客户端的intent配置data标签，并设置scheme属性
        },
      "custom_content":"{}"
    }
    ```
#### iOS 推送配置信息
﻿
```json
"ios":{
        "aps": {
            "alert": {
                "subtitle": "my subtitle"
            },
            "badge_type": 5, //App显示的角标数(可选) -2 自增，-1 不变，
            "category": "INVITE_CATEGORY",
            "sound":"default",//缺省代表默认音效
            "mutable-content":1
        },
          }
示例说明
请求示例
{
    "pushId": "133703"
}
应答示例
{
    "retCode": 0,
    "errMsg": "NO_ERROR",
    "pushRecordData": [
        {
            "date": "2019-07-25 20:06:28",
            "pushId": 133703,
            "title": "1",
            "content": "2",
            "status": "PUSH_FINISHED",
            "pushType": "tag",
            "targetList": null,
            "tagSet": {
                "op": "OR",
                "tagWithType": [
                    {
                        "tagTypeName": "xg_user_define",
                        "tagValue": "test68"
                    }
                ]
            },
            "uploadId": 0,
            "expireTime": 86400,
            "messageType": "notify",
            "xgMediaResources": "",
            "environment": "product",
            "collapseID": 0,
            "pushConfig": {
                "android": {
                    "ring": 1,
                    "vibrate": 0,
                    "lights": 1,
                    "clearable": 1,
                    "action": {
                        "action_type": 1
                    },
                    "custom_content": "{}"
                },
                "ios": null
            },
            "multiPkg": false
        }
    ]
}
﻿

tencent cloud

Recent Pages

单个任务推送信息查询

接口说明

参数说明

请求参数

应答参数

pushRecordData

配置信息

Android 推送配置信息

示例说明

请求示例

应答示例

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

参数名称	必选	类型	描述
pushId	是	String	推送任务 ID

参数名称	类型	说明	取值说明
date	String	推送时间	格式：YYYY-MM-DD hh:mm:ss
pushId	String	消息ID	-
title	String	推送标题	-
content	String	推送内容	-
status	String	推送状态	PUSH_INIT //任务已创建 PUSH_WAIT// 等待任务被调度 PUSH_STARTED// 推送中 PUSH_FINISHED// 推送完成 PUSH_FAILED//推送失败 PUSH_CANCELED// 用户取消推送 PUSH_DELETED// 推送被删除 PUSH_REVOKED//推送已被撤回 PUSH_COLLAPSED//推送已被覆盖 PUSH_DELETED_PUSH_MSG//推送被终止
pushType	String	推送目标	all //全推 tag //标签推送 token_list //设备列表 account_list //账号列表 package_account_push //号码包推送
messageType	String	推送类型	notify //通知 message //消息
environment	String	推送环境	product //生产环境 dev //开发环境
expireTime	Integer	过期时间	单位 s
xgMediaResources	String	富媒体信息	-
multiPkg	Boolean	是否多包名推送	true //开启多包名推送 false //关闭多包名推送
targetList	Array(String)	推送账号或推送设备列表	pushType 为 token_list 或 account_list 时有效
collapseID	Integer	消息覆盖 ID	pushType 为 all、tag、package_account_push 时有效
tagSet	Object	标签设置	pushType 为 tag 时有效数据结构： `{ "op":"OR", //标签间逻辑操作 "tagWithType":[ { "tagTypeName":"xg_user_define", //标签类型 "tagValue":"test68" //标签值} ] }`
uploadId	Integer	号码包 ID	pushType 为 package_account_push 时有效
pushConfig	Object	推送配置信息	"Android"：Android 推送相关配置信息，具体参考下述代码 "iOS"：iOS 推送相关配置信息，具体参考下述代码

tencent cloud

注册

登录

Recent Pages

单个任务推送信息查询

接口说明

参数说明

请求参数

应答参数

pushRecordData

配置信息

Android 推送配置信息

示例说明

请求示例

应答示例

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？