现在，当您在搜索中调用 beta 版 Catalog API 时，可以返回那些不在 Shopify 上销售的品牌的产品。向 sources 添加新的 search_catalog 参数，以便在响应中包含外部产品以及来自 Shopify 商家的产品。如果您省略 sources，结果将仅限于 Shopify 商家的产品，且您无需更改任何现有调用。
变更内容
Catalog API 的 beta 版现在支持在 search_catalog 上使用 sources 参数，以控制您返回哪些产品：
- 仅限 Shopify 商家产品：省略 sources，或将 ["shopify"] 设置为
- 同时适用于 Shopify 商家和外部产品：["shopify", "external"] ["shopify", "external"]
- 仅适用于未在 Shopify 上销售的品牌的品牌：["external"] ["external"]
sources 参数适用于现有的 search_catalog 方法，无需调用新端点。当您传入其 ID 时，get_product 方法会返回一个外部产品，而 lookup_catalog 支持将在稍后推出。
外部产品始终返回 eligible.native_checkout: false，因此购物者无法通过 Shopify 结账购买它们，这些产品也不会赚取推广展示佣金。每个外部产品都包含描述、图片、价格以及指向品牌产品页面的链接，以便购物者在品牌自己的网站上完成购买。
受影响对象
此变更会影响使用目录 API 来驱动站内搜索或推荐功能，并希望包含未在 Shopify 上销售的品牌产品的应用。
在测试期间，外部产品数据来自各品牌官网，且仅当购物者位于美国时才会返回外部产品。其他国家的购物者的搜索结果将继续仅返回 Shopify 商家的产品。
操作指南
如果您只想继续返回来自 Shopify 商家的产品，则无需采取任何操作。您的现有 search_catalog 调用无需更改即可正常工作。
如果您希望包含外部产品，请更新您的 search_catalog 请求，将 sources 参数设置为 ["shopify", "external"]，或者如果只希望包含不在 Shopify 上销售的品牌，则将其设置为 ["external"]。如果您展示指向产品详情页面的链接，请确保正确处理外部产品 URL，以便购物者在选择外部产品时能跳转到品牌自己的网站。
相关文档
- 了解如何在目录 API 中返回未在 Shopify 上销售的品牌的产品：https://shopify.dev/docs/agents/catalog/global-catalog-extension#catalog-sources https://shopify.dev/docs/agents/catalog/global-catalog-extension#catalog-sources
- 了解更多关于全局目录 MCP 工具的信息：https://shopify.dev/docs/agents/catalog/global-catalog https://shopify.dev/docs/agents/catalog/global-catalog