开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

小程序任务台任务编辑

该接口用于小程序任务台创建任务编辑。

请求地址

POST https://developer.toutiao.com/api/apps/taskbox/update_task

请求参数

属性

类型

必填

描述

任务台示例

审核注意备注

access_token

string

权限 token,获取接口



task_id

number

任务ID,创建接口返回



task_name

string

任务名称

长度:限制在18个字以内





















































任务名称请勿包含公司名称!

任务标题相同,任务时间重叠。即为重复上传任务,不支持上传

同一个小程序,上传相似标题、相同页面地址的任务,会审核不通过

task_settle_type

number

结算方式,类型包含:

1-广告分成

2-支付交易CPS

3-支付交易CPS-绑定




















































支付CPS必须接入小程序担保交易,且需另外配置最长可退款时间和分佣比例

appid

string

小程序的appid,需要app的类型为小程序



start_page

string

小程序页面地址,包含path和query,path不得以 "/" 开头


示例:page/detail/detail?id=1

anchor_title

string

上传的锚点标题,最多14个字



task_icon

string

尺寸为512*512的当前任务图标,大小不超过200KB,支持PNG,JPG格式

不允许出现留边的情况,图片必须铺满






















































task_start_time

number

任务开始时间,秒级时间戳



task_end_time

number

任务结束时间,秒级时间戳。开始时间与结束时间相差要求大于30天



task_desc

string

产品介绍30-100字;任务要求<200字,条数不限。





























































举例

1.产品介绍:该产品是一个XX类型的小程序,可以XXX。

2.达人视频内需添加与小程序页面相关的内容,杜绝生硬植入。

3.达人视频内容表现积极向上,禁止出现恶俗、违背公序良俗类内容或品牌负面

4.视频原创,拒绝拼接,搬运,虚假骗互动内容。

注意:

任务台的方案 只能计算小程序内收入,如果是iOS虚拟支付的,走了小店的那部分无法计费,需要开发者在产品说明中明确写出来

如:

请注意:该小程序内iOS端的订单收入不计入分成收入,仅计算安卓端订单收入。

refer_videos

string[]

示例视频

1-5个,校验是可以打开的视频,如被删除或其他原因则不展示

会审核视频内容、视频锚点与任务的相关性,低质/无意义/录屏/不含小程序锚点会审核不通过





















































从移动端复制视频链接,正确格式为:https//v.Douyin.com /xxxxx

视频需包含任务对应的小程序锚点!

task_tags

string[]

任务标签

开发者勾选两个维度的标签:形态+内容,成为数组的两个元素


参考任务创建接口的任务标签字段说明

必须按表里的填,不要自己命名!

refer_ma_captures

string[]

小程序截图

小程序对应页面截图2张,单个截图大小上限为2M






















































refer_video_captures

string[]

小程序锚点截图

视频带该小程序锚点的截图1张,单个截图大小上限为2M






















































refer_gids

number[]

视频的gid数组



task_refund_period

number

当结算方式是支付CPS的时候必填,任务最大退款周期,仅在task_settle_type为2和3时填写,广告分成任务不用填


task_settle_type为2,不超过10天,不少于0天;
task_settle_type为3,不超过3天,不少于0天;

payment_allocate_ratio

number

当结算方式是支付CPS的时候必填,百分号整数类型(仅支持整数),仅在task_settle_type为2和3时填写。广告分成任务不用填


9(代表9%),范围为[1,29]

返回值

返回值为 JSON 形式,其中包括如下字段:

属性

数据类型

说明

error

number

错误码,0 是成功,其它为异常

message

string

成功为"success", 错误为具体 message

data

Json

包含任务id,参考下文

errCode

当服务器端无法正确返回时,会返回如下信息:

属性

数据类型

说明

error

int64

错误码

message

string

错误信息

具体对应关系为:

错误号

描述

0

请求操作成功

5401

没有支付分成比例或者最大退款周期

5402

参考视频截图数量不合法

5403

小程序落地页参考视频截图数量不合法

5404

任务描述长度不合法

5405

任务开始与结束时间必须大于 30 天

5406

小程序落地页截图数量不合法

5408

锚点标题长度不合法

5409

任务标签长度不合法

5410

任务名称长度不合法

5411

传入的 appid 不是小程序

5412

最大退款周期不合法

5413

支付分成比例不合法

5414

传入图片的宽高不合法

5415

图片大小不合法

5416

无效的图片链接

5417

任务 id 传入的数量太多

5418

找不到对应的小程序

5419

找不到 gid 列表

5420

gid 找不到对应的视频

5421

gid 数量过多

5422

超时相关的问题

5423

没有支付分成比例或者最大退款周期

5424

找不到相应的结算模式

5425

非法视频,请检查视频

5426

重复任务

5427

该小程序已经达到当天上传任务的次数限制

5428

图片解析错误

5429

当前小程序无配置,请联系相关人员添加任务相关配置

5430

当前小程序无短视频挂载能力

5431

当日灰度名额已满

5432

未满足达到发布此类任务门槛

5433

小程序未开启任务台

5434

小程序已加任务台黑名单

5435

小程序已下架

5436

小程序已经开启任务台

5437

小程序类别限制

5438

小程序未上线

5439

不支持修改非当前APPID 任务

5440

不支持修改任务类型

4001015

已上线任务不支持修改任务佣金比例

5442

任务状态非已驳回或已上线不支持修改

5501

accesstToken为空

5502

accessToken不合法

5503

appID与token不一致

5504

任务跟新,taskID必传

5507

该任务状态为审核中,不允许编辑,请耐心等待审核结果

5508

该任务已下线,不允许编辑,请重新创建任务

请求示例

POST 请求 body

{
  "access_token": "122131231231*******",
  "task_id": 12333,
  "task_name": "测试12333",
  "task_settle_type": 1,
  "appid": "tt933ee5830c062fa6",
  "start_page": "xxx",
  "anchor_title": "测试锚点标",
  "task_icon": "xxx",
  "task_start_time": 1618285226,
  "task_end_time": 1620963626,
  "task_desc": "1. sss <br>2.sss2",
  "refer_videos": [
    "http://boe.v.douyin.com/Z0JRdbe/",
    "http://boe.v.douyin.com/Z0JFXvp/"
  ],
  "task_tags": ["测试类", "心理"],
  "refer_ma_captures": [
    "https://static.runoob.com/images/demo/demo1.jpg",
    "https://static.runoob.com/images/demo/demo2.jpg"
  ],
  "refer_video_captures": ["https://static.runoob.com/images/demo/demo3.jpg"]
}

返回示例

正确返回

{
  "message": "success",
  "error": 0,
  "data": {
    "task_id": "12848125"
  }
}

错误返回

{
  "message": "ErrNo_CPSSettlement",
  "error": 5401,
  "data": {}
}

小程序任务台任务编辑

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助