文档中心 > API类目 > 天猫精灵开放API

alibaba.ailabs.aligenie.openvideo.scenepush (视频单集场景接入API)

视频单集场景接入API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
scene_type Number 可选 0
  • 默认值:0
  • 内容接入场景0 无应用挂靠 1 应用挂靠
    scene_value String 可选 23423 挂靠的应用id,在智能应用平台的地址栏可见
    param_list RawSingleVideo [] 可选
  • 最大列表长度:999
  • 待推送的视频数据
    • └ v_cover_url
    • String
    • 可选
    • http://c.jpg
    • 视频封面(竖图296 * 440,根据搜索规则,提供竖图用户搜索时可优先搜索到此内容)
    • └ actor_name
    • String []
    • 可选
    • 刘德华
    • 演员
    • └ album_id
    • String
    • 可选
    • 100001
    • 所属视频集ID
    • └ alias
    • String []
    • 可选
    • 别名1
    • 别名
    • └ area
    • String
    • 可选
    • 中国
    • 区域
    • └ audition_second
    • Number
    • 必须
    • 180
    • 试看秒数,若支持试看填1,否则填0
    • └ charge_type
    • Number
    • 必须
    • 0
    • 付费类型 0-免费、1-VIP免费、2-单点、3-天猫超级会员 务必和所属专辑保持一致
    • └ collect_count
    • Number
    • 可选
    • 3000
    • 收藏量
    • └ comment_count
    • Number
    • 可选
    • 3000
    • 评论量
    • └ common_cate_id
    • Number
    • 可选
    • 80021002
    • 系统类目ID,取值见智能应用平台
    • └ content_score
    • String
    • 可选
    • 10
    • 内容质量评分
    • └ cost_price
    • Number
    • 可选
    • 1000
    • 成本价(单位:分)
    • └ cover_url
    • String
    • 必须
    • http://d.jpg
    • 视频封面(横图,图片尺寸是295 * 167)
    • └ description
    • String
    • 可选
    • 视频介绍
    • 视频描述信息
    • └ director_name
    • String []
    • 可选
    • 张艺谋
    • 导演
    • └ duration
    • Number
    • 必须
    • 500
    • 视频时长,单位:秒
    • └ extend_info
    • String
    • 可选
    • {"a":1}
    • 扩展字段
    • └ forward_count
    • Number
    • 可选
    • 3000
    • 转发量
    • └ id
    • String
    • 可选
    • 10001
    • 视频ID,不同的专辑间也要保证唯一
    • └ is_exclusive
    • Number
    • 可选
    • 0
    • 是否独播 0-非独播 1-独播
    • └ language
    • String
    • 可选
    • 英语
    • 语言
    • └ like_count
    • Number
    • 可选
    • 3000
    • 点赞数
    • └ operation
    • String
    • 必须
    • ADD
    • 操作类型ADD/DELETE/UPDATE
    • └ order_index
    • Number
    • 可选
    • 3
    • 视频在所属视频集中的排序号
    • └ oupgc_type
    • String
    • 必须
    • PGC
    • 视频来源类型,PGC/UGC/OGC
    • └ play_count
    • Number
    • 可选
    • 3000
    • 播放量
    • └ play_url
    • String
    • 可选
    • {"1080P":"http://abc.mp4"}
    • 播放链接,Map,key为support_definition的值
    • └ producer_name
    • String []
    • 可选
    • 100
    • 出品人
    • └ release_time
    • Number
    • 可选
    • 1000
    • 发布时间,unix时间戳,单位毫秒
    • └ sub_title
    • String
    • 可选
    • 子标题
    • 子标题
    • └ suggest_max_price
    • Number
    • 可选
    • 1200
    • 建议最高零售价(单位:分),只在第一次同步时生效不支持修改
    • └ suggest_min_price
    • Number
    • 可选
    • 1200
    • 建议最低零售价(单位:分)只在第一次同步时生效不支持修改
    • └ support_definition
    • String []
    • 可选
    • 480P
    • 支撑的分辨率,此字段要和play_url严格匹配
    • └ tag_ids
    • Number []
    • 可选
    • 10321
    • 系统标签ID,取值见智能应用平台
    • └ title
    • String
    • 必须
    • 视频标题
    • 视频标题
    • └ uploader_name
    • String []
    • 可选
    • 上传者
    • 上传者名称
    • └ valid_end_time
    • Number
    • 可选
    • 1562256939000
    • 失效时间,unix时间戳,单位:毫秒,为空则永不失效
    • └ valid_start_time
    • Number
    • 可选
    • 1562256939000
    • 生效时间,unix时间戳,单位:毫秒,为空则立即生效

    响应参数

    名称 类型 示例值 描述
    ret_code Number 0 状态码
    ret_msg String success 描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAilabsAligenieOpenvideoScenepushRequest req = new AlibabaAilabsAligenieOpenvideoScenepushRequest();
    req.setSceneType(0L);
    req.setSceneValue("23423");
    List<AlibabaAilabsAligenieOpenvideoScenepushRequest.RawSingleVideo> list2 = new ArrayList<AlibabaAilabsAligenieOpenvideoScenepushRequest.RawSingleVideo>();
    AlibabaAilabsAligenieOpenvideoScenepushRequest.RawSingleVideo obj3 = new AlibabaAilabsAligenieOpenvideoScenepushRequest.RawSingleVideo();
    list2.add(obj3);
    obj3.setVCoverUrl("http://c.jpg");
    obj3.setActorName("刘德华");
    obj3.setAlbumId("100001");
    obj3.setAlias("别名1");
    obj3.setArea("中国");
    obj3.setAuditionSecond(180L);
    obj3.setChargeType(0L);
    obj3.setCollectCount(3000L);
    obj3.setCommentCount(3000L);
    obj3.setCommonCateId(80021002L);
    obj3.setContentScore("10");
    obj3.setCostPrice(1000L);
    obj3.setCoverUrl("http://d.jpg");
    obj3.setDescription("视频介绍");
    obj3.setDirectorName("张艺谋");
    obj3.setDuration(500L);
    obj3.setExtendInfo("{\"a\":1}");
    obj3.setForwardCount(3000L);
    obj3.setId("10001");
    obj3.setIsExclusive(0L);
    obj3.setLanguage("英语");
    obj3.setLikeCount(3000L);
    obj3.setOperation("ADD");
    obj3.setOrderIndex(3L);
    obj3.setOupgcType("PGC");
    obj3.setPlayCount(3000L);
    obj3.setPlayUrl("{\"1080P\":\"http://abc.mp4\"}");
    obj3.setProducerName("100");
    obj3.setReleaseTime(1000L);
    obj3.setSubTitle("子标题");
    obj3.setSuggestMaxPrice(1200L);
    obj3.setSuggestMinPrice(1200L);
    obj3.setSupportDefinition("480P");
    obj3.setTagIds(new Long[] { 10321 };
    );
    obj3.setTitle("视频标题");
    obj3.setUploaderName("上传者");
    obj3.setValidEndTime(1562256939000L);
    obj3.setValidStartTime(1562256939000L);
    req.setParamList(list2);
    AlibabaAilabsAligenieOpenvideoScenepushResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ailabs_aligenie_openvideo_scenepush_response>
        <ret_code>0</ret_code>
        <ret_msg>success</ret_msg>
    </alibaba_ailabs_aligenie_openvideo_scenepush_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部