用户投稿任务
收藏能力介绍
本能力当前为能力实验室能力，可能会有回收或能力开放范围调整，具体能力说明可在开发者后台控制台-我的应用-能力管理-能力实验室中查看详细说明。
开发者在接入并使用抖音开放平台移动应用投稿、h5 投稿能力的基础上，支持通过引导投稿用户授权来获取用户发布单条作品的播放和互动数据完成情况，从而实现开发者或应用关联品牌/商家实现抖音 UGC 营销。
使用场景
能力支持开发者按规则定制任务条件并在取得用户授权后查询该用户的投稿作品数据完成情况，如视频点赞量是否过 100、播放量是否过 500、评论、收藏、分享量是否达到指定值等，同时支持开发者自定义组合任务，更加灵活地搭建抖音阵地用户激励和营销工具，流程如下：
应用内提供任务领取入口 | 进行作品发布 | 发布成功返回落地页 | 用户领取并授权 | 任务结果查询 |
| | | | 开发者发放任务奖励 |
适用范围
当前能力仅支持移动应用、网站应用进行申请开通。
准入条件
适用主体类型：
开发者主体需为企业、党政机关或事业单位
应用类型为抖音开放平台正式移动、网站应用
使用规范
- 1.接受并遵循现有平台应用基础规范：链接
- 2.开发者当前可用场景范围：【抖音活动营销】可面向自研开发者/服务商，for企业客户或线下商家搭建和定制、面向抖音C端用户使用的营销活动。【企业服务】可支持企业搭建面向内部员工抖音视频宣传考核能力；面向企业内部使用时不可将后台的能力、授权码、相关功能暴露给线上或线下的普通用户使用。
- 3.应用可用：应用在正常运行，平台将定期回查可用性（移动应用上架应用市场可下载，网站应用有可以打开的地址，并可以根据账号进行能力体验）；
- 4.授权环节明确信息：获取投稿作品数据的授权，不允许与登录授权等其他能力融合在一起；应该在实际用户需要发布作品前/后，有上下文操作环境下触发授权；在授权前，明确告知用户开发者拿到授权后的使用用途、频次等信息；
特殊说明
任务创建规则
- •任务名称
- ◦长度不超过 50 个字符，仅支持中文、数字和英文字符
- •任务有效期
- ◦起始时间：对应任务条件生效的秒级时间戳（不早于接口调用调用时间）
- ◦结束时间：对应 任务条件失效的秒级时间戳，距离任务起始时间的跨度最长支持31天（不得早于任务开始时间）
- •任务统计条件
- ◦必传一项数据维度如播放、点赞、评论、分享、收藏、下载（一个任务id仅支持传1项）同时传入对应维度左右区间的具体数值，取10的整数，最小为0
- ◦最终生效区间：
- ▪播放数：0≤任务传入数值x≤1000w
- ▪点赞、评论、分享、收藏、下载：0≤任务传入数值x≤10w
接入流程
步骤 | 说明 |
创建应用 | |
申请能力 | |
申请信息填写 | 开发者可根据「能力实验室」具体能力申请界面对应的申请要求，提供对应能力申请材料。 |
平台审核 | 平台会结合申请应用在功能实用性、监管措施、使用场景等方面进行评估；审核时间为 5 个工作日左右，审核结果以站内信的形式通知。 |
使用能力 |
|
接口列表
名称 | 类型 | 描述 |
OpenAPI | 通过该接口创建单项投稿任务用于任务核销入参 | |
绑定视频 | OpenAPI | 通过该接口将授权用户指定作品关联至开发者应用下用于任务核销校验 |
OpenAPI | 查询授权用户指定作品在开发者所创建任务下的完成情况 | |
OpenAPI | 查询授权用户指定作品的基础信息如封面、标题等 |
