add user push report

Author: liyaling516

getui.go

@@ -370,6 +370,21 @@ func (g *PushClient) SearchTaskDetailByCid(cid, taskId string) (resp *models.Tas
 	return searchTaskDetailByCid(g.AppId, token, cid, taskId)
 }
 
+// ReportPushTask 获取推送结果（含自定义事件）可查询消息可下发数、下发数，接收数、展示数、点击数等结果
+//
+//	用于跟踪某个用户的消息到达情况
+func (g *PushClient) ReportPushTask(taskId string) (resp *models.Response, err error) {
+	if taskId == "" {
+		err = errors.New("taskid为空")
+		return
+	}
+	token, err := g.GetToken()
+	if err != nil {
+		return
+	}
+	return reportPushTask(g.AppId, token, taskId)
+}
+
 /*
 ===============================================================
 推给所有人
@@ -655,6 +670,7 @@ func (g *PushClient) PushAllByCustomTag(scheduleTime int, customTag []string, pa
 }
 
 // PushAllByLogicTags 对指定应用的符合筛选条件的用户群发推送消息。支持定时、定速功能
+//
 //	此接口频次限制100次/天，每分钟不能超过5次(推送限制和接口执行群推共享限制)，定时推送功能需要申请开通才可以使用
 //	scheduleTime 定时推送时间戳，为0时，不定时
 //	tags为[]*models.Tag，需要自己构建tag表达式

search_api.go

@@ -6,6 +6,7 @@ import (
 )
 
 // searchTaskDetailByCid 可以查询某任务下某cid的具体实时推送路径情况
+//
 //	此接口需要SVIP权限，暂时不可用
 func searchTaskDetailByCid(appId, token string, cid, taskId string) (*models.TaskDetailResp, error) {
 	b, err := HttpRequest("GET", appId+"/task/detail/"+cid+"/"+taskId, token, nil)
@@ -22,6 +23,7 @@ func searchTaskDetailByCid(appId, token string, cid, taskId string) (*models.Tas
 }
 
 // searchSchedule 查询定时任务
+//
 //	该接口支持在推送完定时任务之后，查看定时任务状态，定时任务是否发送成功。
 func searchSchedule(appId, token, taskId string) (*models.Response, error) {
 	resp, err := RequestAPI("GET", appId+"/task/schedule/"+taskId, token, nil)
@@ -30,3 +32,14 @@ func searchSchedule(appId, token, taskId string) (*models.Response, error) {
 	}
 	return resp, nil
 }
+
+// reportPushTask
+// 查询推送数据，可查询消息可下发数、下发数，接收数、展示数、点击数等结果。支持单个taskId查询和多个taskId查询。
+// 此接口调用，仅可以查询toList或toApp的推送结果数据；不能查询toSingle的推送结果数据。
+func reportPushTask(appId, token, taskId string) (*models.Response, error) {
+	resp, err := RequestAPI("GET", appId+"/report/push/task/"+taskId, token, nil)
+	if err != nil {
+		return nil, err
+	}
+	return resp, nil
+}