获取商品库视频的操作结果
您可以使用本接口了解商品库视频上传是否成功，以及上传失败的后续操作建议。
使用前需知
您需已拥有一个商品库视频操作任务的日志 ID，用于查询对应操作结果。
若想上传商品库视频并获取日志 ID，可使用/catalog/video/file/。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/catalog/video/log/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| bc_id {必填} | string | 商务中心 ID。<br><br>若想获取您有权访问的商务中心列表，可使用[/bc/get/](1737115687501826.html)。 |
| catalog_id{必填} | string | 商品库 ID。<br><br>若想获取某个商务中心中的电商商品库列表，可使用 [/catalog/get/](1740315452868610.html)，筛选对应的 `catalog_type` 为 `ECOM` 的 `catalog_id`值。<br><br>您需对商品库有商品库管理（目录管理）或广告推广权限。若想获取您有商品库管理或广告推广权限的商品库， 可使用[/bc/asset/get/](1739432717798401.html)。将`asset_type` 设置为 `CATALOG`，筛选对应的 `catalog_role` 为 `ADMIN` 或 `AD_PROMOTE`的 `asset_id` 值。 |
| feed_log_id {必填}| string |商品库视频处理日志的 ID。 <br><br>若想上传商品库视频并获取日志 ID，可使用[/catalog/video/file/](1803655037415489.html)。 |
| language | string |支持的语言。<br><br>枚举值：<br><br>枚举值：<ul><li> `en`：英文</li><li>`zh-CN`：中文</li><li>`ja-JP`：日文</li><li>`de`：德语</li><li>`es`：西班牙语</li><li> `fr`：法语</li><li>`hi-IN`：印地语（印度）</li><li>`id`：印尼语</li><li>`it`：意大利语</li><li>`ko`：韩语</li><li>`ms`：马来语</li><li>`ru`：俄语</li><li>`th`：泰语</li><li>`tr`：土耳其语</li><li>`vi`：越南语</li></ul><br>默认值：`en`。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/catalog/video/log/' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
"bc_id": "{{bc_id}}",
"catalog_id": "{{catalog_id}}",
"feed_log_id": "{{feed_log_id}}"
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| video_feed_log | object | 商品库视频处理结果。|
##| catalog_id | string | 商品库 ID。|
##| feed_id | string | 更新源 ID。 |
##| add_count | number |新增的视频总数。 |
##| update_count | number | 修改的视频总数。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段值始终为 0。 |
##| delete_count | number | 删除的商品总数。 |
##| error_count | number | 出现上传错误的商品数量。 |
##| warn_count| number | 出现上传提示的商品数量。 |
##| process_status | string | 处理状态。<br><br>枚举值：`PROCESSING`，`SUCCESS`，`FAILED`，`WAITING`。 |
##| start_time | string | 视频处理任务的开始时间，格式为`YYYY-MM-DD HH:MM:SS`(UTC+0)。 <br><br> 示例：`2024-01-01 00:00:00`。 |
##| end_time | string | 视频处理任务的结束时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。 <br><br>示例：`2024-01-01 00:00:00`。 |
#| feed_log_data | object | 详细处理信息。 |
##| download_path | object | 文件下载地址，包含所有错误和提示信息，键是语言，值是文件地址。|
##| error_affected_videos | object[] | 错误信息。 |
###| affected_video_count | number | 受影响视频数。 |
###| affected_video_item_list | object[] | 受影响视频列表，只展示前五条。 |
####| index | number | 视频索引，代表该视频在所上传视频列表中的位置。 <br><br>例如，索引值为 `2` 代表该商品为通过 [/catalog/video/file/](1803655037415489.html)上传的视频列表中的第 1 个商品，位于 CSV 文件中的第二行。 |
####| video_name | string | 视频名称。 |
####| video_link | string | 视频文件的 URL。 <br><br>示例： https://www.tiktok.com/tiktok_t_shirt.mp4 |
####| sku_id_list | string | 要与该视频（`video_link`）绑定的电商商品库商品的 SKU ID 列表。<br><br>示例： `"SKU_ID_1, SKU_ID_2"`。 |
####| description | string | 视频的简短描述。|
####| category | string | 视频的商品类别。<br><br>示例：Apparel & Accessories> Clothing> Shirts |
###| field | string | 问题字段。|
###| issue | string | 问题信息。|
###| suggestion | string |解决建议。 |
##| warn_affected_videos | object[] | 提示信息。|
###| affected_video_count | number | 受影响视频数。 |
###| affected_video_item_list | object[] | 受影响视频列表，只展示前五条。 |
####| index | number | 视频索引，代表该视频在所上传视频列表中的位置。 <br><br>例如，索引值为 `2` 代表该商品为通过 [/catalog/video/file/](1803655037415489.html)上传的视频列表中的第 1 个商品，位于 CSV 文件中的第二行。 |
####| video_name | string | 视频名称。 |
####| video_link | string | 视频文件的 URL。 <br><br>示例： https://www.tiktok.com/tiktok_t_shirt.mp4 |
####| sku_id_list | string | 要与该视频（`video_link`）绑定的电商商品库商品的 SKU ID 列表。<br><br>示例： `"SKU_ID_1, SKU_ID_2"`。 |
####| description | string | 视频的简短描述。|
####| category | string | 视频的商品类别。<br><br>示例：Apparel & Accessories> Clothing> Shirts |
###| field | string | 问题字段。|
###| issue | string | 问题信息。|
###| suggestion | string |解决建议。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"video_feed_log": {
"update_mode": null,
"process_status": "SUCCESS",
"catalog_id": "{{catalog_id}}",
"delete_count": 0,
"feed_id": "{{feed_id}}",
"start_time": "{{start_time}}",
"error_count": 0,
"feed_log_data": {
"error_affected_videos": null,
"download_path": {},
"warn_affected_videos": null
},
"end_time": "{{end_time}}",
"warn_count": 0,
"add_count": 1,
"update_count": 0
}
}
}
(/code)