tencent cloud

移动推送

产品动态
公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
产品简介
产品概述
产品优势
应用场景
全球化部署
购买指南
价格总览
购买指引
计费模式
免费试用
欠费说明
快速入门
创建产品和应用
Android 快速接入
iOS 快速接入
创建推送任务
查询推送记录
推送测试方法指引
产品限制说明
操作指南
推送管理
推送高级功能
实践教程
iOS 平台角标功能实践
API 文档
简介
API 概览
调用方式
推送相关接口
标签相关接口
账号相关接口
统计相关接口
用户属性相关接口
服务端错误码
服务端 SDK
API(Java)
SDK 文档
Android 接入指南
iOS 接入指南
客户端集成插件
macOS接入指南
用户及权限
快速入门配置
进阶自定义配置
资源标签
服务协议
服务等级协议
开发者协议
常见问题
iOS 常见问题
Android 常见问题
Flutter 常见问题
其他问题
移动推送政策
移动推送隐私协议
TPNS 数据处理和安全协议
Developer Agreement
联系我们
词汇表
文档移动推送API 文档统计相关接口特定时间段所有推送信息查询

特定时间段所有推送信息查询

PDF
聚焦模式
字号
最后更新时间: 2024-01-17 14:26:44

接口说明

请求方式:POST 调用频率限制:200次/小时。
服务地址/v3/statistics/get_push_record
接口服务地址与服务接入点一一对应,请选择与您的应用服务接入点对应的 服务地址
接口功能:查询特定时间段内所有任务的基本信息和设置。

参数说明

请求参数

参数名称
必选
类型
描述
startDate
String
查询起始日期,
格式:YYYY-MM-DD
查询限制:当前日期1个月内
endDate
String
查询截止日期,格式:YYYY-MM-DD
msgType
String
消息类型:
notify:通知
message:静默消息
pushType
String
推送类型:
all:全推
tag:标签推
token:设备列表/设备单推
account:账号列表/账号单推
offset
Integer
分页查询起始偏移
limit
Integer
分页查询每页消息数 (最大限制为200)

应答参数

参数名称
类型
描述
retCode
Integer
返回状态码
errMsg
String
错误信息
pushRecordData
Array
返回结果,pushRecordData 结构变量见下表
count
Integer
符合条件记录数

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
uint32
过期时间
单位 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
Intege
号码包 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 推送配置信息

"ios":{
"aps": {
"alert": {
"subtitle": "my subtitle"
},
"badge_type": 5, //App显示的角标数(可选) -2 自增,-1 不变,
"category": "INVITE_CATEGORY",
"sound":"default", //缺省代表默认音效
"mutable-content":1
},

示例说明

请求示例

{
"limit": 50,
"startDate": "2019-07-01",
"endDate": "2019-08-01",
"msgType": "notify",
"pushType": "all",
"offset": 0
}

应答示例

{
"retCode": 0,
"errMsg": "NO_ERROR",
"count": 126,
"pushRecordData": [
{
"date": "2019-11-18 11:26:54",
"pushId": "12",
"title": "测试标题",
"content": "测试日志",
"status": "PUSH_FINISHED",
"pushType": "all",
"targetList": null,
"tagSet": null,
"uploadId": 0,
"groupId": "",
"expireTime": 43200,
"messageType": "notify",
"xgMediaResources": "",
"environment": "product",
"pushConfig": {
"android": {
"n_id": 0,
"builder_id": 0,
"ring": 1,
"ring_raw": "",
"vibrate": 1,
"lights": 1,
"clearable": 1,
"icon_type": 0,
"icon_res": "",
"style_id": 0,
"small_icon": "",
"action": {
"action_type": 3,
"activity": "",
"aty_attr": null,
"browser": null,
"intent": ""
},
"custom_content": ""
},
"ios": null,
"iot": null
},
"multiPkg": true,
"source": "api"
}
]
}


帮助和支持

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

填写满意度调查问卷,共创更好文档体验。

文档反馈