来源中的信息
发生了什么
根据 Shopify Developer Changelog（sourceId: shopify-changelog；evidenceId: evidence:1b7e67cb92e7a98b2a4e90c1），Catalog API 的 search_catalog 支持通过 catalog.filters.media 按 image、video 或 model_3d 筛选商品。
该筛选为可选能力；多个媒体类型按 AND 组合，例如同时请求 video 和 model_3d 时，只返回同时具备两类媒体的商品。既有查询继续返回原有商品集合。
search_catalog、get_product 和 lookup_catalog 的商品媒体数组现在可返回视频和 3D 模型资产链接；在 search_catalog 中，匹配结果会在同一响应中提供这些链接。
筛选仅作用于 search_catalog；未识别的媒体类型不会使请求失败，而会被忽略并在 result.messages[] 中以 not_found 提示。
经营影响
为什么重要
对使用 Catalog API 的应用和工具，这项变化把“先取商品、再逐个检查媒体、最后丢弃不符合商品”的流程，收敛为一次带条件的搜索。
对拥有视频或 3D 模型素材的商品，应用可以更直接地识别并渲染相应资产；这改善的是目录接入效率和内容呈现，不等同于平台已经承诺流量或转化提升。
编辑观察
分析判断
核心变化是媒体条件进入目录搜索本身，因此集成方可以把媒体类型作为候选商品筛选条件，而不是在客户端承担完整的过滤循环。
这更像面向应用开发者的目录能力更新，而不是所有 Shopify 店铺前台搜索的改版；是否产生商家可见影响，取决于商家是否使用调用这些接口的应用或工具。
由于现有查询保持不变，短期重点不是迁移旧逻辑，而是确认新筛选是否适合已有的商品发现、内容渲染或 AI 商品目录工作流。
适用范围
对卖家的影响
使用相关应用或工具、且商品已配置视频或 3D 模型媒体的全球卖家，可能更容易被这些应用按媒体能力筛选和展示；影响范围不包括未接入这些 API 的普通店铺。
如果服务商采用新筛选，卖家需要关注商品媒体是否确实可用，因为筛选结果会直接决定应用获得哪些商品及其资产链接。
没有视频或 3D 模型资产的卖家不会因该 API 更新自动获得新的媒体呈现能力，也没有证据表明仅凭此次更新就会改变商品排名或销售表现。
行动建议
现在应该做什么
- 1
盘点使用 Catalog API 的集成
this-week确认自有应用、代理工具或 AI 商品目录是否调用 search_catalog、get_product 或 lookup_catalog，并标记哪些流程需要识别视频或 3D 模型媒体。
- 2
在测试环境验证媒体筛选
this-week用 image、video、model_3d 以及组合条件测试 search_catalog，检查 AND 逻辑、同响应资产链接和 result.messages[] 对未知类型的反馈。
- 3
观察服务商是否启用新能力
monitor向关键应用服务商确认其是否采用该筛选及媒体链接返回；在确认前，不要将视频或 3D 模型素材的新增展示当作已生效。
暂时不要做什么
- 不要把这项 Catalog API 更新扩大解释为所有 Shopify 店铺前台搜索、排序或流量规则的变化，也不要仅凭该更新承诺转化提升。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
The Catalog API now returns video and 3D model media on products that have it, and supports filtering search results by media type. You can request only products that have video or 3D model media attached, and matching products return links to those assets in the same response. The new filter is optional, and existing queries keep returning the same products. What changed search_catalog, get_product, and lookup_catalog now return video and 3D model assets on a product's media array. Previously it carried images only. Catalog API search accepts a new filter, catalog.filters.media. Each entry names a media type: image, video, or model_3d. Entries combine with AND, so asking for video and model_3d returns only products that have both. An unrecognized type doesn't fail the request. The API ignores it and reports it in result.messages[] with the code not_found. Products that match come back with media asset URLs, so a client can render a product without a second request to fetch its media. Previously you had to request products, inspect each one for usable media, and discard products that didn't have any. The new filter replaces that pattern. There's no change to existing filters, no ne
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年9月16日 00:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.