全局目录 REST API 已于 2026 年 4 月弃用，并将于 2026 年 11 月 2 日停止服务。如果您的应用仍在调用该 API，则需在此日期之前迁移至实现通用商务协议（UCP）的全局目录 MCP。
变更内容
2026年4月，我们弃用了全局目录REST API，并改用全局目录MCP。
2026年11月2日，REST API将停止处理流量；此后，所有对https://discover.shopifyapps.com/global/...的请求（包括针对已保存目录的请求）都将失败，具体涵盖以下情况：
- GET /global/v2/search
- GET /global/v2/p/{upid}
- GET /global/v2/p/by-variant/{vid}
- POST /global/v2/lookup
全局目录MCP可在https://catalog.shopify.com/api/ucp/mcp获取，并提供以下UCP目录工具：
- search_catalog: 跨所有 Shopify 商家搜索商品，支持筛选、分页和买家上下文。
- lookup_catalog: 按标识符批量查询商品或变体，每次请求最多 50 个。
- get_product: 获取包含变体选择和可用性信号的商品完整详情。
您需要执行的操作
如果您的应用仍在调用全局目录 REST API，请在 2026 年 11 月 2 日之前迁移至全局目录 MCP：
- 将每个 REST 调用切换为对应的 UCP 工具：
- 搜索（/global/v2/search）→ search_catalog
- 查找（/global/v2/p/{upid}）和按变体查找（/global/v2/p/by-variant/{vid}）→ get_product，传递gid://shopify/p/{upid}或gid://shopify/ProductVariant/{id}
- 批量查找（/global/v2/lookup）→ lookup_catalog
- 向https://catalog.shopify.com/api/ucp/mcp发送请求。在每条请求中，请包含带有meta.ucp-agent.profile的代理配置文件 URL。
- 如果查询已保存的目录，请将其ID作为catalog.catalog_id传递，而不是使用已保存目录端点URL。
- 将您的应用更新为UCP目录请求和响应模式。
身份验证方式不变。您可以继续从Dev Dashboard客户端凭据生成Bearer令牌。要在迁移前试用这些工具，请使用Shopify AI Toolkit或通过UCP CLI运行ucp catalog search。
更多详情，请参阅全局目录MCP文档。