如何创建JSON_LISTINGS_FEED的JSON？产品类型及属性疑问

一、获取图书的Product Type #

亚马逊图书类的productType是系统预定义的枚举值，获取方式有两种：

• 通过Catalog Items API查询：用图书的ISBN或ASIN调用searchItems或getItem接口，返回结果里的productType字段就是你需要的值，常见的图书类型包括PAPERBACK_BOOK、HARDCOVER_BOOK、EBOOK、AUDIO_BOOK等。
• 卖家后台导出模板：手动创建一个同类型的图书listing，导出对应的模板文件，里面会明确标注该品类的productType。

二、图书上架必填属性（JSON_LISTINGS_FEED） #

图书类核心必填属性清单：

• productType：上面获取到的枚举值
• sku：你自定义的库存单位编码
• isbn：全新创建listing时必填（10或13位有效ISBN）；若跟卖现有ASIN则填asin
• title：完整书名
• author：作者名称
• publisher：出版社名称
• publication_date：出版日期，格式为YYYY-MM-DD
• language：图书语言，比如en-US、zh-CN
• binding：装帧类型，比如Paperback（平装）、Hardcover（精装）
• condition_type：商品状态，枚举值如New（全新）、Used_LikeNew（二手-近乎全新）
• price：价格对象，格式为{"amount": 14.99, "currencyCode": "USD"}（货币代码需匹配站点）

可选但建议补充的属性：

• bullet_point：数组格式的产品卖点，最多5条
• description：图书详细描述
• image_url：主图的公开可访问链接
• subject_keyword：分类关键词，帮助提升搜索权重

三、JSON_LISTINGS_FEED示例模板 #

{
  "productType": "PAPERBACK_BOOK",
  "sku": "MY_STORE_BOOK_001",
  "isbn": "9781234567890",
  "title": "The Beginner's Guide to Amazon SP-API",
  "author": "Jane Smith",
  "publisher": "Tech Publishing Inc.",
  "publication_date": "2024-05-15",
  "language": "en-US",
  "binding": "Paperback",
  "condition_type": "New",
  "price": {
    "amount": 19.99,
    "currencyCode": "USD"
  },
  "bullet_point": [
    "Step-by-step guide to SP-API feeds integration",
    "Practical examples for book listings",
    "Troubleshooting common feed errors"
  ],
  "description": "This book teaches you how to integrate Amazon's Selling Partner API for book listings, covering feed creation, error handling, and best practices to get your books live quickly.",
  "image_url": "https://your-image-host.com/book-cover-main.jpg"
}

四、排障技巧 #

• 如果提交feed后报错，调用getFeedDocument获取错误详情，亚马逊会明确指出缺失的字段或格式错误，针对性补改即可。
• 可以参考卖家后台的Listing Quality and Suppression工具，它会列出listing的合规问题，和API报错信息对应，帮助快速定位属性问题。
• 所有枚举属性（比如condition_type、binding）必须使用亚马逊规定的值，不能自定义，若不确定可在卖家后台的手动listing创建页面查看可选值。

内容的提问来源于stack exchange，提问作者Naitchi