获取视频信息
您可以使用本接口获取素材库中可用于创建广告的视频的信息。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/file/video/ad/info/|/v1.3/file/video/ad/info/|
|请求参数类型 |advertiser_id: number|advertiser_id: string|
|返回参数名称|poster_url<br>url|video_cover_url<br>preview_url|
|废弃返回参数|/|id|
|新增返回参数|/|preview_url_expire_time`|
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/file/video/ad/info/
**方法** GET
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。 |
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告账号。 |
|video_ids {必填}|string[]|视频 ID 列表。<br><br>最大数量：60。<br><br><p><span style="color:darkred"><b>注意</b></span>：若视频不可用于创建广告，视频 ID 将被忽略。 |
示例
(code curl http)
curl --get -H "Access-Token:xxx" \\
--data-urlencode "advertiser_id=ADVERTISER_ID" \\
--data-urlencode "video_ids=VIDEO_IDS" \\
https://business-api.tiktok.com/open_api/v1.3/file/video/ad/info/
(/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|返回数据。 |
#|list |list |视频数据。 |
##|displayable|boolean |视频能否在平台中展示。|
##|width |number|视频宽度。 |
##|video_cover_url |string|视频封面临时URL。 有效期6小时，过期需重新获取。<br><br>URL中的`x-expires`参数后会包含过期时间，格式为Epoch/Unix时间戳，单位为秒。<br>示例：`http://p16-sign-sg.tiktokcdn.com/v0201/b99a388e3709470be5c~tplv-noop.image?x-expires=<strong>1671742348</strong>&x-signature=FziJhvED9NDTDmPofv3I%3D`。 |
##|bit_rate |number|码率，单位bps。 |
##|format |string|视频格式。 |
##|preview_url |string|视频预览链接。有效期6小时，过期需重新获取。<br><br>若想了解本预览链接的过期时间，请查看`preview_url_expire_time`。 |
##|preview_url_expire_time|string|视频预览链接过期时间，格式为`YYYY-MM-DD HH:MM:SS`(UTC+0)。|
##|duration |float|视频时长，单位秒。 |
##|height |number|视频高度。 |
##|signature |string|视频文件MD5。 |
##|video_id |string|视频ID，可用于广告投放中创建广告。|
##|size |number|视频大小，单位Byte。 |
##|material_id|string|素材ID。|
##|allowed_placements |string[] |视频可投放版位。受音乐版权限制，创意工具工具生成的部分素材只能投放到 TikTok 版位。投放到其他版位时将会导致审核不通过。枚举值详见[枚举值-广告管理-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
##|allow_download |boolean |视频是否允许下载。受音乐版权限制，创意工具生成的部分素材只允许预览，禁止下载和传播。 |
##|file_name |string |视频名称。|
##|create_time |string |创建时间。UTC 时间，格式：2020-06-10T07:39:14Z。 |
##|modify_time |string |修改时间。UTC 时间，格式：2020-06-10T07:39:14Z。 |
|request_id |string|请求的日志ID，唯一标识一个请求。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"list": [
{
"format": "mp4",
"preview_url": "http://v16-tiktokcdn-com.akamaized.net/2a19f67683ed9aa54b3df2e5c842f15d/5fccd703/video/tos/alisg/tos-alisg-v-0000/9a0033884eab42248ad6b46f7b11e44c/?a=0&br=3114&bt=1557&cd=0%7C0%7C0&cr=0&cs=0&dr=0&ds=3&er=&l=2020120607050201011517615618A693BE&lr=ad&mime_type=video_mp4&qs=0&rc=anNlbnRuOWU2eDMzZjYzM0Apdjh3ZHJuOWZzZTMzNDY6eWdwMnFebGgzYG1fLS0uMDRzc2RtX2huaDNfMHItLWAwLS06Yw%3D%3D&vl=&vr=",
"file_name": "wanfadong_tagging_test.mp4",
"video_cover_url": "http://p16-sign-sg.tiktokcdn.com/v0201/94ebe1a3e6734559a16f3e81c43787ec~tplv-noop.image?x-expires=1607259907&x-signature=Oy4%2FyYvkw%2FLTWz97pFCDx0Y6o4g%3D",
"height": 720,
"width": 1280,
"bit_rate": 1594584,
"create_time": "2020-11-16T08:19:57Z",
"modify_time": "2020-11-16T08:19:57Z",
"signature": "b24f08f569b73a33eec93edb8f4423e2",
"duration": 5.312,
"video_id": "v070331c0000bup3cb66kkoqaktb5psg",
"material_id": "6895633277416374000",
"allowed_placements": [
"PLACEMENT_TOPBUZZ",
"PLACEMENT_TIKTOK",
"PLACEMENT_HELO",
"PLACEMENT_PANGLE"
],
"allow_download": true,
"size": 1058804
}
]
},
"request_id": "2020120607050201011517615618A693BE"
}
(/code);