(已废弃)提交素材
您可以使用本接口为动态场景提交素材。
提交素材后,您需使用/dynamic_scene/task/create/创建一个异步任务。
注意
动态场景API目前处于测试阶段。若要申请使用该接口,请通过白名单功能管理。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/dynamic_scene/material/submit/| /v1.3/dynamic_scene/material/submit/|
|请求参数类型|advertiser_id: number |advertiser_id`: string |
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/dynamic_scene/material/submit/
**方法** POST
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
#|slots {必填}|[]object|槽位,最大数量为6。|
##|order {必填}|number|槽位在故事线的顺序,范围:0-5。|
##|tag {必填}|string|槽位的标签。|
##|video_ids {必填}|[]string|视频素材。您可以通过[上传视频](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)接口获取视频ID。但在该字段中填入的ID不得多于10个。 |
##|mute|boolean|是否关闭分镜的原声。默认值: `false`。如果您将其设为 `true`, 那么 `bgm_volume` 为 `100`。<br> 注意: 无背景乐情况下(没有`music_ids`以及不开启`auto_soundtrack`)不允许将`mute`设为`true`。|
##|bgm_volume|number| 背景乐音量,范围是[0, 100]。|
|auto_soundtrack|boolean|是否自动创建背景乐。默认值:`false`。|
|music_ids|[]string|音乐素材。您可以通过[上传音乐](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)接口获取音乐ID。|
示例
(code curl http)
{
"slots": [{
"order": 0,
"tag": "asd",
"video_ids": ["32wdsd3232784yjfvh343dsf"],
"mute": false,
"bgm_volume: 30
}],
"auto_soundtrack": false,
"advertiser_id": 75960823018
}
(/code)
返回
|字段|类型|描述|
|---|---|---|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。|
#|material_package_id|string|素材包ID。|
|request_id |string|请求的日志id,唯一标识一个请求。 |