Shopware 6 Admin API批量移除商品所有对象关联的方法问询

核心思路：直接覆盖关联字段，无需逐一查询删除 #

Shopware 6 Admin API支持通过PATCH请求或Sync API，将关联字段设为空数组[]，一次性清空所有对应类型的关联，不用先查现有关联再逐一删除。

1. 单商品批量清空关联（PATCH请求） #

针对单个商品，直接发送PATCH请求，把需要清空的关联字段设为空数组即可。常用关联字段对应：

• 交叉销售商品：crossSellings
• 媒体资源：media
• 属性组关联：properties
• 分类关联：categories
• 配件商品：accessories

示例请求：

PATCH /api/product/{productId}
Content-Type: application/json

{
  "crossSellings": [],
  "media": [],
  "properties": []
}

这个请求会直接清空该商品的所有交叉销售、媒体资源和属性组关联，无需指定任何待删除对象的ID。

2. 多商品批量处理（Sync API） #

如果要同步4100个商品，用Sync API能大幅减少HTTP请求次数，提升效率。一次请求可处理多个商品的关联清空，甚至可以在同一个请求里完成“清空+重建新关联”的操作。

示例请求（仅清空关联）：

POST /api/_action/sync
Content-Type: application/json

{
  "actions": [
    {
      "action": "upsert",
      "entity": "product",
      "payload": [
        {
          "id": "prod-001",
          "crossSellings": [],
          "media": [],
          "properties": []
        },
        {
          "id": "prod-002",
          "crossSellings": [],
          "media": [],
          "properties": []
        }
        // 批量添加所有需要处理的商品ID
      ]
    }
  ]
}

示例请求（清空+重建关联）：
如果要在清空后直接建立新关联，可在payload里同时传入新的关联数据：

POST /api/_action/sync
Content-Type: application/json

{
  "actions": [
    {
      "action": "upsert",
      "entity": "product",
      "payload": [
        {
          "id": "prod-001",
          "crossSellings": [{"productId": "cross-prod-001"}],
          "media": [{"mediaId": "media-001", "position": 1}],
          "properties": [{"groupId": "prop-group-001", "optionId": "prop-option-001"}]
        }
      ]
    }
  ]
}

这样一次请求就完成了旧关联清空和新关联建立，省去多次调用API的开销。

3. 注意事项 #

• 确保API密钥拥有product_writer权限，否则会出现权限错误。
• 部分关联字段（如media）如果需要保留资源但调整顺序，直接提交排序后的数组即可，不用先清空再添加。
• Sync API支持批量处理的数量上限可根据服务器配置调整，建议分批次处理（比如每批次500个商品），避免请求超时。

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