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

alibaba.ailabs.aligenie.opencontent.scenepush (音频场景接入接口)

天猫精灵音频挂靠场景接入

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
scene_type Number 可选 1
  • 默认值:0
  • 0 无场景接入 1 关联应用接入
    scene_value String 可选 2020081244001 如果关联应用此字段为应用id
    batch_content BatchContent 可选 详细内容列表
    • └ category_id
    • Number
    • 必须
    • 80001
    • 类目ID,具体参见开放平台类目相关描述
    • open_contents
    • OpenContent []
    • 可选
    • 内容信息
    • └ album_description
    • String
    • 可选
    • 专辑描述信息
    • 内容所属专辑或分类描述信息
    • └ album_raw_id
    • Number
    • 可选
    • 1001
    • 内容在原平台所属专辑或分类的id
    • └ album_title
    • String
    • 可选
    • 七日歌
    • 内容所属专辑或分类名称/标题,这里如果专辑标题是空则不同步专辑信息
    • author
    • Author
    • 可选
    • 作者信息
    • └ content_author
    • String
    • 可选
    • 李想
    • 内容作者,对应音乐为作词、作曲人,对应小说故事为原著作者
    • └ voice_author
    • String
    • 可选
    • 李念
    • 主播,演唱者,演播者
    • └ charge_type
    • Number
    • 必须
    • 0
    • 商业化类型请先和平台小二确认再调用! 0-免费、1-一号两端鉴权单篇售卖、2-一号两端鉴权专辑售卖、3-天猫精灵侧分销零售专辑售卖、4-天猫精灵超级会员售卖 当取4时s_super_vip_free必须为true否则为false
    • └ description
    • String
    • 可选
    • 内容描述
    • 内容描述信息(限长500)
    • └ description_type
    • String
    • 可选
    • TTS
    • 描述类型,如果描述是TTS类型会做TTS处理
    • └ duration
    • Number
    • 必须
    • 123
    • 时长(单位:秒)
    • └ extend_info
    • String
    • 可选
    • {}
    • 其他扩展字段,不同类型内容有不同要求,具体请参加详细说明文档extend_info字段部分
    • image_url
    • ImageUrl
    • 必须
    • 封面图片信息
    • └ large
    • String
    • 可选
    • http://large.png
    • 大图链接(具体大小范围暂无标准,接入方自定)
    • └ medium
    • String
    • 可选
    • http://mediam.png
    • 中图链接(具体大小范围暂无标准,接入方自定)
    • └ small
    • String
    • 可选
    • http://small.png
    • 小图链接(具体大小范围暂无标准,接入方自定)
    • └ img
    • String
    • 可选
    • http://small.png
    • 如果不知道放那个就传默认图片
    • └ operation
    • String
    • 必须
    • ADD
    • 操作方式,支持新增和下线操作(ADD/OFFLINE)
    • └ play_count
    • Number
    • 必须
    • 100212
    • 内容在原平台播放次数
    • └ play_order
    • Number
    • 必须
    • 0
    • 播放顺序 0 正序 1 倒序
    • play_urls
    • PlayUrl []
    • 可选
    • 播放链接
    • └ bitrate
    • Number
    • 可选
    • 128
    • 码率
    • └ type
    • String
    • 可选
    • audio
    • 节目音视频类型,目前支持audio及video两种类型
    • └ url
    • String
    • 可选
    • http://adad.mp3
    • 可播放链接
    • └ product_desc
    • String
    • 可选
    • 产品描述信息
    • 产品描述信息
    • └ raw_id
    • Number
    • 必须
    • 100101
    • 内容在原平台的id,当只推送专辑信息时,此值可填0
    • └ release_time
    • Number
    • 必须
    • 1515326176
    • 内容发布时间,1970年1月1日至当前的秒数(unix时间戳)
    • └ remark
    • String
    • 可选
    • 备注1
    • 备注
    • └ sort_num
    • Number
    • 可选
    • 1
    • 在有所属专辑/分类的场景下,标识此音频在专辑/分类下的顺序值,从1开始
    • └ tag_ids
    • Number []
    • 可选
    • 235
    • 标签id见智能应用平台
    • └ title
    • String
    • 可选
    • 内容标题1
    • 内容标题
    • └ vip_free
    • Boolean
    • 必须
    • false
    • 是否vip付费
    • └ cost_price
    • Number
    • 可选
    • 223
    • 成本价(单位分),没有明确区分就成本最高最低传一样的值
    • └ suggest_min_price
    • Number
    • 可选
    • 234
    • 最小建议零售价(单位分),没有明确区分就成本最高最低传一样的值
    • └ suggest_max_price
    • Number
    • 可选
    • 324
    • 最大建议零售价(单位分),没有明确区分就成本最高最低传一样的值
    • └ is_album_audition
    • Boolean
    • 可选
    • false
    • 专辑是否支持试听,默认为false
    • └ is_audition
    • Boolean
    • 可选
    • false
    • 内容分集是否支持试听,默认为false
    • └ is_super_vip_free
    • Boolean
    • 可选
    • false
    • 是否仅大会员内容
    • └ score
    • Number
    • 可选
    • 75
    • 专辑评分

    响应参数

    名称 类型 示例值 描述
    ret_code Number 200 错误码
    ret_msg String 成功 返回信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAilabsAligenieOpencontentScenepushRequest req = new AlibabaAilabsAligenieOpencontentScenepushRequest();
    req.setSceneType(1L);
    req.setSceneValue("2020081244001");
    AlibabaAilabsAligenieOpencontentScenepushRequest.BatchContent obj1 = new AlibabaAilabsAligenieOpencontentScenepushRequest.BatchContent();
    obj1.setCategoryId(80001L);
    List<AlibabaAilabsAligenieOpencontentScenepushRequest.OpenContent> list3 = new ArrayList<AlibabaAilabsAligenieOpencontentScenepushRequest.OpenContent>();
    AlibabaAilabsAligenieOpencontentScenepushRequest.OpenContent obj4 = new AlibabaAilabsAligenieOpencontentScenepushRequest.OpenContent();
    list3.add(obj4);
    obj4.setAlbumDescription("专辑描述信息");
    obj4.setAlbumRawId(1001L);
    obj4.setAlbumTitle("七日歌");
    AlibabaAilabsAligenieOpencontentScenepushRequest.Author obj6 = new AlibabaAilabsAligenieOpencontentScenepushRequest.Author();
    obj6.setContentAuthor("李想");
    obj6.setVoiceAuthor("李念");
    list5.setAuthor(obj6);
    obj4.setChargeType(0L);
    obj4.setDescription("内容描述");
    obj4.setDescriptionType("TTS");
    obj4.setDuration(123L);
    obj4.setExtendInfo("{}");
    AlibabaAilabsAligenieOpencontentScenepushRequest.ImageUrl obj8 = new AlibabaAilabsAligenieOpencontentScenepushRequest.ImageUrl();
    obj8.setLarge("http://large.png");
    obj8.setMedium("http://mediam.png");
    obj8.setSmall("http://small.png");
    obj8.setImg("http://small.png");
    list7.setImageUrl(obj8);
    obj4.setOperation("ADD");
    obj4.setPlayCount(100212L);
    obj4.setPlayOrder(0L);
    List<AlibabaAilabsAligenieOpencontentScenepushRequest.PlayUrl> list11 = new ArrayList<AlibabaAilabsAligenieOpencontentScenepushRequest.PlayUrl>();
    AlibabaAilabsAligenieOpencontentScenepushRequest.PlayUrl obj12 = new AlibabaAilabsAligenieOpencontentScenepushRequest.PlayUrl();
    list11.add(obj12);
    obj12.setBitrate(128L);
    obj12.setType("audio");
    obj12.setUrl("http://adad.mp3");
    list9.setPlayUrls(list11);
    obj4.setProductDesc("产品描述信息");
    obj4.setRawId(100101L);
    obj4.setReleaseTime(1515326176L);
    obj4.setRemark("备注1");
    obj4.setSortNum(1L);
    obj4.setTagIds(new Long[] { 235 };
    );
    obj4.setTitle("内容标题1");
    obj4.setVipFree(false);
    obj4.setCostPrice(223L);
    obj4.setSuggestMinPrice(234L);
    obj4.setSuggestMaxPrice(324L);
    obj4.setIsAlbumAudition(false);
    obj4.setIsAudition(false);
    obj4.setIsSuperVipFree(false);
    obj4.setScore(75L);
    obj1.setOpenContents(list3);
    req.setBatchContent(obj1);
    AlibabaAilabsAligenieOpencontentScenepushResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ailabs_aligenie_opencontent_scenepush_response>
        <ret_code>200</ret_code>
        <ret_msg>成功</ret_msg>
    </alibaba_ailabs_aligenie_opencontent_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

    返回
    顶部