获取视频包

您可以使用本接口获取商务中心下的所有商品库视频包或特定视频包的信息。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/catalog/video/get/|/v1.3/catalog/video_package/get/| |请求参数名称|dpa_video_package_id|shopping_ads_video_package_id| |请求参数类型|bc_id: number<br>catalog_id: number|bc_id: string<br>catalog_id: string| |返回参数名称|package_id<br>name<br>audit_object|shopping_ads_video_package_id<br>video_package_name<br>rejected_object| |返回参数类型|catalog_id: number<br>id: number|catalog_id: string<br>id` is deleted in v1.3|

## 请求

**地址**
https://business-api.tiktok.com/open_api/v1.3/catalog/video_package/get/

**方法**
GET

**Header**

```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|--- |--- |--- |
|bc_id {必填}|string|商务中心ID。|
|catalog_id {必填}|string|商品库ID。|
| shopping_ads_video_package_id|string|商品库视频包ID。|

示例

(code curl http)
curl -X GET -H "Access-Token:YOUR_ACCESS_TOKEN" \
--data-urlencode "bc_id=BC_ID" \
--data-urlencode "catalog_id=CATALOG_ID" \
--data-urlencode "shopping_ads_video_package_id=VIDEO_ID" \

https://business-api.tiktok.com/open_api/v1.3/catalog/video_package/get/
(/code)

返回

|字段|类型|描述|
|--- |--- |--- |
|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[]|返回数据。|
##|shopping_ads_video_package_id|string|商品库视频包ID。|
##|catalog_id|string|商品库ID。|
##|name|string|视频模板名称。|
##|create_time|string|创建时间。|
##|update_time|string|更新时间。|
##|audit|object| 视频包审核信息。|
###|audit_status|string|审核状态。枚举值: `PROCESSING`(处理中), `APPROVED`(已过审), `REJECTED`(已被拒审)。|
###|reject_info|object[]|拒审信息。只有审核状态为拒审时返回。|
####|audit_object|string| 拒审对象。|
####|reason|string| 拒审原因。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {
        "list": [
            {
                "audit": {
                    "audit_status": "PROCESSING"
                },
                "status": "AVAILABLE",
                "update_time": "2021-08-10 09:53:59",
                "video_package_name": "green screen generation",
                "shopping_ads_video_package_id": "21f62362-6afe-4d89-a83e-0f9713833dfa",
                "video_package_type": "GREEN_SCREEN",
                "create_time": "2021-08-10 09:42:09",
                "catalog_id": "6986901069595002626"
            },
            {
                "audit": {
                    "audit_status": "PROCESSING"
                },
                "status": "UNAVAILABLE",
                "update_time": "2021-08-06 09:00:43",
                "video_package_name": "GreenScreen_20210806_09:00",
                "shopping_ads_video_package_id": "25071f29-5d25-4ebe-8a50-f282e0847a87",
                "video_package_type": "GREEN_SCREEN",
                "create_time": "2021-08-06 09:00:43",
                "catalog_id": "6986901069595002626"
            },
            {
                "audit": {
                    "audit_status": "REJECTED",
                    "reject_info": [
                        {
                            "rejected_object": "Creative Video",
                            "reason": "The ad or video has no background audio or the background audio is incoherent/unclear."
                        }
                    ]
                },
                "status": "AVAILABLE",
                "update_time": "2021-08-07 00:42:06",
                "video_package_name": "GreenScreen_20210806_08:59",
                "shopping_ads_video_package_id": "ec23aa27-1ddf-497a-9777-05de58b1cc40",
                "video_package_type": "GREEN_SCREEN",
                "create_time": "2021-08-06 08:59:41",
                "catalog_id": "6986901069595002626"
            },
            ...
        ]
    },
    "request_id": "2021081012162001024506219218036157"
}
(/code);