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

alibaba.ailabs.aligenie.openvideoalbum.scenepush (视频专辑场景接入接口)

视频专辑场景接入接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
scene_type Number 可选 0
  • 默认值:0
  • 接入场景 0 无应用 1 挂靠应用
    scene_value String 可选 20081436004 如果场景是1 此处为应用id
    param_list RawVideoAlbum [] 可选
  • 最大列表长度:200
  • 视频合辑数据
    • └ v_cover_url
    • String
    • 必须
    • http://x.jpg
    • 专辑封面(竖图296 * 440,根据搜索规则,提供竖图用户搜索时可优先搜索到此内容)
    • └ actor_name
    • String []
    • 可选
    • 刘德华
    • 演员名称
    • └ alias
    • String []
    • 可选
    • 别名1
    • 别名
    • └ area
    • String
    • 可选
    • 中国
    • 区域
    • └ audition_num
    • Number
    • 可选
    • 2
    • 试看数(表示前N个视频支持试看)
    • └ 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://a.jpg
    • 专辑封面(横图,图片尺寸是295 * 167)
    • └ description
    • String
    • 可选
    • 描述
    • 描述
    • └ director_name
    • String []
    • 可选
    • 张艺谋
    • 导演名称
    • └ extend_info
    • String
    • 可选
    • {}
    • 扩展字段
    • └ forward_count
    • Number
    • 可选
    • 3000
    • 转发量
    • └ id
    • String
    • 必须
    • 10021
    • 三方视频辑ID
    • └ is_exclusive
    • Number
    • 可选
    • 0
    • 是否独播 0-非独播 1-独播
    • └ is_finished
    • Number
    • 可选
    • 0
    • 是否完结,0-否,1-是,默认0
    • └ language
    • String
    • 可选
    • 英语
    • 语言
    • └ like_count
    • Number
    • 可选
    • 1000
    • 点赞数
    • └ operation
    • String
    • 可选
    • ADD
    • 操作类型 ADD/UPDATE/DELETE
    • └ oupgc_type
    • String
    • 必须
    • PGC
    • 视频来源类型,PGC/UGC/OGC
    • └ play_count
    • Number
    • 可选
    • 3000
    • 播放量
    • └ play_order
    • Number
    • 可选
    • 0
    • 播放顺序0-顺序,1-倒序
    • └ producer_name
    • String []
    • 可选
    • 上传者
    • 上传者名称
    • └ release_time
    • Number
    • 可选
    • 1562256939000
    • 发布时间,unix时间戳,单位:毫秒
    • └ sub_title
    • String
    • 可选
    • 子标题
    • 子标题
    • └ suggest_max_price
    • Number
    • 可选
    • 1200
    • 建议最高零售价(单位:分)
    • └ suggest_min_price
    • Number
    • 可选
    • 1200
    • 建议最低零售价(单位:分)
    • └ tag_ids
    • Number []
    • 可选
    • 10001
    • 标签ID,具体取值范围参见文档说明
    • └ title
    • String
    • 必须
    • 标题
    • 标题(若需显示集数,请填写:第X集:视频名称;如第一集:天猫精灵)
    • └ total_episode
    • Number
    • 可选
    • 35
    • 包含视频总集数
    • └ uploader_name
    • String []
    • 可选
    • 上传者
    • 上传者名称
    • └ valid_end_time
    • Number
    • 可选
    • 1562256939000
    • 失效时间,unix时间戳,单位:毫秒,为空则永不失效
    • └ valid_start_time
    • Number
    • 可选
    • 1562256939000
    • 生效时间,unix时间戳,单位:毫秒,为空则立即生效
    • └ is_education
    • Boolean
    • 可选
    • false
    • 是否教育内容
    • └ course_type
    • Number
    • 可选
    • 0
    • 课程形式见类目文档
    • └ grade_stag_id
    • String
    • 可选
    • 1001001
    • 学段见类目文档
    • └ course_id
    • String
    • 可选
    • 1001001001
    • 学科见类目文档
    • └ book_version_id
    • String
    • 可选
    • 1001001001001
    • 版本见类目文档
    • └ textbook_id
    • String
    • 可选
    • 1001001001001001
    • 教材见类目文档
    • └ update_index
    • Number
    • 可选
    • 10
    • 更新到第几集,如果是未完结状态此字段必填

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAilabsAligenieOpenvideoalbumScenepushRequest req = new AlibabaAilabsAligenieOpenvideoalbumScenepushRequest();
    req.setSceneType(0L);
    req.setSceneValue("20081436004");
    List<AlibabaAilabsAligenieOpenvideoalbumScenepushRequest.RawVideoAlbum> list2 = new ArrayList<AlibabaAilabsAligenieOpenvideoalbumScenepushRequest.RawVideoAlbum>();
    AlibabaAilabsAligenieOpenvideoalbumScenepushRequest.RawVideoAlbum obj3 = new AlibabaAilabsAligenieOpenvideoalbumScenepushRequest.RawVideoAlbum();
    list2.add(obj3);
    obj3.setVCoverUrl("http://x.jpg");
    obj3.setActorName("刘德华");
    obj3.setAlias("别名1");
    obj3.setArea("中国");
    obj3.setAuditionNum(2L);
    obj3.setChargeType(0L);
    obj3.setCollectCount(3000L);
    obj3.setCommentCount(3000L);
    obj3.setCommonCateId(80021002L);
    obj3.setContentScore("10");
    obj3.setCostPrice(1000L);
    obj3.setCoverUrl("http://a.jpg");
    obj3.setDescription("描述");
    obj3.setDirectorName("张艺谋");
    obj3.setExtendInfo("{}");
    obj3.setForwardCount(3000L);
    obj3.setId("10021");
    obj3.setIsExclusive(0L);
    obj3.setIsFinished(0L);
    obj3.setLanguage("英语");
    obj3.setLikeCount(1000L);
    obj3.setOperation("ADD");
    obj3.setOupgcType("PGC");
    obj3.setPlayCount(3000L);
    obj3.setPlayOrder(0L);
    obj3.setProducerName("上传者");
    obj3.setReleaseTime(1562256939000L);
    obj3.setSubTitle("子标题");
    obj3.setSuggestMaxPrice(1200L);
    obj3.setSuggestMinPrice(1200L);
    obj3.setTagIds(new Long[] { 10001 };
    );
    obj3.setTitle("标题");
    obj3.setTotalEpisode(35L);
    obj3.setUploaderName("上传者");
    obj3.setValidEndTime(1562256939000L);
    obj3.setValidStartTime(1562256939000L);
    obj3.setIsEducation(false);
    obj3.setCourseType(0L);
    obj3.setGradeStagId("1001001");
    obj3.setCourseId("1001001001");
    obj3.setBookVersionId("1001001001001");
    obj3.setTextbookId("1001001001001001");
    obj3.setUpdateIndex(10L);
    req.setParamList(list2);
    AlibabaAilabsAligenieOpenvideoalbumScenepushResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ailabs_aligenie_openvideoalbum_scenepush_response>
        <ret_code>0</ret_code>
        <ret_msg>success</ret_msg>
    </alibaba_ailabs_aligenie_openvideoalbum_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

    返回
    顶部