tencent cloud

PrevNext

文档反馈

请输入关键字

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
            }
        ]
    }
    
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款