文档中心 > API类目 > 手淘用户增长

taobao.usergrowth.book.sync (生态读书基本信息同步)

生态读书基本信息同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
lead_role_names String 可选 叶凡,许暖 主角名称列表
publish_time Date 可选 2021-10-12 15:42:38 书籍的发布时间;新增操作时必填
total_word_number Number 可选 1030071 书籍总字数;新增操作时必填
second_category String 可选 10 二级类目,参考文档填写;新增操作时必填
author String 可选 二桥 作者;新增操作时必填
first_category String 可选 1 一级类目,参考文档填写;新增操作时必填
recommend_reason String 可选 他撩上瘾的马甲大佬竟是他前妻! 推荐理由
update_time Date 可选 2021-10-12 15:42:38 书籍的更新时间;新增操作时必填
completed Boolean 可选 true 书籍是否完结;新增操作时必填
start_paid_chapter_number Number 可选 4 开始付费的章节序号;例如,如果前三章是免费的,第四章开始需要付费,startPaidChapterIndex 的值就应该是 4
book_id String 必须 36696 书籍id
cover_url String 可选 https://gw.alicdn.com/imgextra/i4/O1CN01MdM8vj1gqtztCF9wm_!!6000000004194-0-tps-600-800.jpg 书籍封面URL;通常4:3格式; 图片需要先上传至图片空间;此处仅支持图片空间的url, 非图片空间URL则会报错;新增操作时必填
extra Json 可选 {"key":"value"} 扩展参数
data_action String 必须 ADD 数据操作,ADD:新增 UPDATE:更新
name String 可选 我在寺庙当咸鱼 书籍名称;新增操作时必填
total_chapters Number 可选 1111 书籍总章节;新增操作时必填
introduction String 可选 我就想好好的称霸大陆,系统你为什么要逼着我当和尚? 书籍简介;新增操作时必填
book_tags String 可选 标签1,标签2 书籍标签

响应参数

名称 类型 示例值 描述
result TopResult 同步结果
  • └ success
  • Boolean
  • true
  • 是否执行成功
  • └ error_code
  • String
  • C-1314-11-001
  • 错误码
  • └ error_msg
  • String
  • 入参(author)不满足要求
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UsergrowthBookSyncRequest req = new UsergrowthBookSyncRequest();
req.setLeadRoleNames("叶凡,许暖");
req.setPublishTime(StringUtils.parseDateTime("2021-10-12 15:42:38"));
req.setTotalWordNumber(1030071L);
req.setSecondCategory("10");
req.setAuthor("二桥");
req.setFirstCategory("1");
req.setRecommendReason("他撩上瘾的马甲大佬竟是他前妻!");
req.setUpdateTime(StringUtils.parseDateTime("2021-10-12 15:42:38"));
req.setCompleted(true);
req.setStartPaidChapterNumber(4L);
req.setBookId("36696");
req.setCoverUrl("https://gw.alicdn.com/imgextra/i4/O1CN01MdM8vj1gqtztCF9wm_!!6000000004194-0-tps-600-800.jpg");
req.setExtraString("{\"key\":\"value\"}");
req.setDataAction("ADD");
req.setName("我在寺庙当咸鱼");
req.setTotalChapters(1111L);
req.setIntroduction("我就想好好的称霸大陆,系统你为什么要逼着我当和尚?");
req.setBookTags("标签1,标签2");
UsergrowthBookSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<usergrowth_book_sync_response>
    <result>
        <success>true</success>
        <error_code>C-1314-11-001</error_code>
        <error_msg>入参(author)不满足要求</error_msg>
    </result>
</usergrowth_book_sync_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

返回
顶部