如何使用Amazon SP-API的patchListingsItem操作更新listing图片？

SP-API patchListingsItem 接口更新Listing图片请求体规范 #

1. path参数取值 #

• 替换主图：/attributes/main_product_image
• 全量替换所有辅图：/attributes/other_product_images
• 追加新的辅图（不覆盖原有内容）：/attributes/other_product_images/-

2. value参数构造规则 #

图片属性的value数组中，每个对象包含以下核心字段：

• value：内层对象，存储图片链接、尺寸、类型标识
• marketplace_id：对应站点ID，例如美国站为ATVPDKIKX0DER
  注意：图片属性无需传入language_tag字段

3. 完整请求体示例 #

示例1：替换商品主图

{
  "productType": "LUGGAGE",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/main_product_image",
      "value": [
        {
          "value": {
            "link": "https://你的图片存储地址/主图.jpg",
            "height": 1500,
            "width": 1500,
            "variant": "MAIN"
          },
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    }
  ]
}

示例2：全量替换所有辅图

{
  "productType": "LUGGAGE",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/other_product_images",
      "value": [
        {
          "value": {
            "link": "https://你的图片存储地址/辅图1.jpg",
            "height": 1500,
            "width": 1500,
            "variant": "PT01"
          },
          "marketplace_id": "ATVPDKIKX0DER"
        },
        {
          "value": {
            "link": "https://你的图片存储地址/辅图2.jpg",
            "height": 1500,
            "width": 1500,
            "variant": "PT02"
          },
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    }
  ]
}

注意事项 #

• 图片尺寸需满足对应站点SP-API要求，多数站点要求主图边长不低于1000像素
• variant字段主图固定取值为MAIN，辅图按展示顺序从PT01开始依次递增
• 若需要删除指定辅图，可先调用接口拉取当前所有辅图列表，剔除待删除项后用replace操作全量覆盖即可

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