查询视频任务相关实时汇总数据
收藏接口说明
该接口提供给开发者查询任务台推广任务的投稿视频的任务关联的交易数据。
使用限制
- 开发者只能查询当前账号有权限的任务数据。
- 不需要申请权限
- 不需要用户授权
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/match/v2/taskbox/query_video_sum_data/ |
| HTTP Method | POST |
| Scope | match.taskbox.common |
| 权限要求 | 不需要申请权限 不需要用户授权 任务台 |
请求参数
请求头
access-token必填String
当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token
content-type必填String
示例：application/json
固定值"application/json"
Body
video_ids必填Array<Int64>
示例：[939316235146214973]
视频ID，单次查询数量不可超过20个
可通过 /api/match/v2/taskbox/query_task_video_status/ 或 /api/match/v2/taskbox/agency_query_bill_link/ 接口获得推广计划绑定的视频ID
请求示例
curl --location --request POST 'https://open.douyin.com/api/match/v2/taskbox/query_video_sum_data/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"video_ids":[939316235146214973]}'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String
示例："access_token无效"
错误描述
err_no必填Int32
示例：28001003
错误码
log_id必填String
示例："202405291440576E078D8757B9"
日志id
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "20230213140437EEEDFAB3025AEA105C06", "data": { "data": [ { "billing_gmv_td": 4213103800628239000, "biling_refund_gmv_td": 6570309596556738000, "video_id": 7918906790713390000, "task_id": 3058041294486364000, "agent_id": "a2GotnoTIz", "publish_time": 1685664000 } ] } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 无 |
| 200 | 28001007 | 1. 参数不合法
2. 以下视频未授权、暂不支持查询\n7918906790713390131 | 1. 视频ID数量是否大于0小或等于20
2. 是否具有视频查询权限 |
| 200 | 28003018 | 请求频率过高 | 接口调用QPS不能超过5 |
| 200 | 28001005 | 系统内部错误，请重试 | 无 |
