You need to enable JavaScript to run this app.
导航
UpsertLongVideos - 创建/更新长视频
最近更新时间:2024.04.19 15:50:05首次发布时间:2024.04.18 16:41:25

该接口用于批量创建和更新长视频。

使用场景

长视频库是内容定制提供的一项扩展能力,能够将客户的长视频媒资库与内容定制丰富的横版短视频/竖版小视频资源进行关联,该能力目前可以在商品推广的场景下使用。

注意事项

  • 请求频率:不建议直接在在线服务场景 (例如推荐) 中使用,同账号下单接口限流100QPS
  • 前提条件:已完成商品推广-长视频库相关配置。

请求说明

  • 请求方式:POST
  • 请求地址:https://mercury.volcengineapi.com?Action=UpsertLongVideos&Version=2022-01-01
  • 请求头:ServiceName:volc_torchlight_api

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数
类型
是否必填
示例值
描述
Action
String

UpsertLongVideos

要执行的操作,取值:UpsertLongVideos。

Version
String

2022-01-01

API的版本,取值:2022-01-01。

Body

参数
类型
是否必填
示例值
描述
UtmSource
String

xxx_default_content

渠道号。

LongVideos
Array of UpsertLongVideo

长视频列表。

  • 支持批量请求,单次最多30条;
  • 长视频库当前最多支持50000条记录。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
UpsertFailLongVideos
Array of UpsertFailLongVideo

处理失败的长视频列表。

请求示例

{
    "UtmSource": "xxx_default_content",
    "LongVideos": [
        {
            "ExternalId": "l00000000001",
            "Name": "勇敢的心",
            "Directors": [
                "梅尔·吉布森"
            ],
            "Actors": [
                "梅尔·吉布森",
                "苏菲·玛索",
                "布莱恩·考克斯"
            ],
            "Extra": ""
        },
        {
            "ExternalId": "l00000000002",
            "Name": "大白鲨",
            "Directors": [
                "史蒂文·斯皮尔伯格"
            ],
            "Actors": [
                "罗伊·谢德",
                "罗伯特·肖",
                "理查德·德莱福斯"
            ],
            "Extra": ""
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023030614160***49389B566D982F7762",
        "Action": "UpsertLongVideos",
        "Version": "2022-01-01",
        "Service": "volc_torchlight_api",
        "Region": "cn-north-1"
    },
    "Result": {
        "UpsertFailLongVideos": []
    }
}

错误码

您可访问公共错误码,获取更多错误码信息。