Shopify商品搜索新增媒体类型筛选

Shopify更新Catalog API，支持按媒体类型筛选商品，并在商品媒体字段中返回视频和3D模型资源链接。新筛选项为可选功能，现有查询返回的商品不变，无需迁移。

对出海团队的影响

对开发AR试穿、3D商品展示等购物应用的团队，这项更新可减少逐个拉取、检查并剔除缺少媒体资源商品的操作，也省去单独获取资源链接的请求。筛选仅适用于search_catalog，get_product和lookup_catalog也可返回新增资源链接。需要注意：客户端须在agent profile中声明dev.shopify.catalog.global的draft版本，才能收到视频和3D资源；稳定版虽会执行筛选，但媒体字段仍只返回图片。

接下来怎么做

如需视频或3D资源，可先在测试环境声明draft版扩展，并给search_catalog添加catalog.filters.media。多个类型按AND组合，同时指定video和model_3d，只会返回两者兼具的商品；仅需图片的团队可保持现状。

建议校验返回的media资源链接及sources中的文件格式，并为“有对应媒体、但无客户端可用格式”的情况准备降级展示。

建议检查result.messages[]：未知媒体类型不会导致请求失败，而会被忽略并以not_found提示，避免误以为筛选已生效。