产品 Feed 规范
提供结构化产品 Feed，以便 ChatGPT 准确索引和显示您的产品，包含最新的价格和可用性。
注意：使用代理商务协议进行构建对所有人开放。ChatGPT 中的即时结账目前仅对批准的合作伙伴可用。要申请参与即时结账，请在此处填写表单。
概述
产品 Feed 规范定义了商家如何与 OpenAI 共享结构化产品数据，以便 ChatGPT 能够在搜索和购物体验中准确展示他们的产品。
工作原理
- 准备您的 Feed。使用产品 Feed 规范格式化您的目录（请参阅字段参考以获取带有示例值的必需和可选属性）。
- 交付 Feed。使用集成部分描述的首选交付方法和文件格式共享 Feed。
- 摄取和索引。OpenAI 摄取 Feed，验证记录，并为 ChatGPT 中的检索和排名索引产品元数据。
- 保持新鲜。每当产品、定价或可用性发生变化时更新 Feed，以确保用户看到准确的信息。
关键要点
- 结构化的真实来源。OpenAI 依赖商家提供的 Feed——这确保了准确的定价、可用性和其他关键细节。
- 为发现而构建。Feed 为 ChatGPT 中的产品匹配、索引和排名提供支持。
- 集成指南。规范定义了可靠摄取的首选交付方法和文件格式。
- 字段参考。提供了完整的必需和可选属性列表（带示例）以帮助您验证 Feed。
- 新鲜度很重要。频繁更新可提高匹配质量并减少缺货或价格不匹配的情况。
集成概述
在提供产品数据之前，商家必须在 chatgpt.com/merchants 注册。
本节概述了关键物流：如何交付 Feed、可接受的文件格式以及验证数据所需的初始步骤，以便工程团队可以有信心地进行规划。
所有传输都通过加密的 HTTPS 进行到白名单端点，以保护商家和客户信息，并确保只有经批准的合作伙伴可以发送或更新产品 Feed。
| 主题 | 详情 |
|---|---|
| 交付模型 | 商家将 Feed 推送到 OpenAI 在相互同意的端点或安全传输位置。 |
| 文件格式 | 支持的格式为 TSV、CSV、XML 或 JSON。选择适合您现有导出流程的任何一种。 |
| 刷新频率 | 我们的系统每 15 分钟接受一次更新。 |
| 初始加载 | 发送样本或完整的初始 Feed，以便我们的索引团队在实时更新开始之前验证解析。 |
必需字段
产品标识
| 属性 | 数据类型 | 支持的值 | 描述 | 示例 | 要求 | 验证规则 |
|---|---|---|---|---|---|---|
| id | String | — | 产品唯一标识符（SKU） | SKU12345 | 必需 / 唯一 | Feed 中唯一 |
| title | String (UTF-8) | — | 产品标题 | Men's Running Shoes - Blue | 必需 / 显示 | 最多 150 字符；避免全大写 |
| description | String (UTF-8) | — | 产品描述 | Lightweight running shoes with breathable mesh | 必需 / 显示 | 最多 5000 字符 |
| link | URL | RFC 1738 | 产品详情页 URL | https://example.com/product/12345 | 必需 | HTTPS 首选 |
| image_link | URL | RFC 1738 | 主产品图片 | https://cdn.example.com/img/12345.jpg | 必需 / 显示 | HTTPS，最小 250x250px |
定价和可用性
| 属性 | 数据类型 | 支持的值 | 描述 | 示例 | 要求 | 验证规则 |
|---|---|---|---|---|---|---|
| price | Money | amount currency | 产品价格 | 79.99 USD | 必需 / 显示 | 正数，包含货币 |
| availability | Enum | in_stock, out_of_stock, preorder, backorder | 库存状态 | in_stock | 必需 / 显示 | 小写字符串 |
| enabled_checkout | Boolean | true, false | 是否启用结账 | true | 必需 | 布尔值 |
变体
| 属性 | 数据类型 | 支持的值 | 描述 | 示例 | 要求 | 验证规则 |
|---|---|---|---|---|---|---|
| item_group_id | String | — | 变体组 ID | GROUP_12345 | 推荐（变体） | — |
| item_group_title | String (UTF-8) | — | 组产品标题 | Men's Trail Running Shoes | 可选 | 最多 150 字符 |
| color | String | — | 变体颜色 | Blue | 推荐（服装） | 最多 40 字符 |
| size | String | — | 变体尺寸 | 10 | 推荐（服装） | 最多 20 字符 |
| gender | Enum | male, female, unisex | 性别目标 | male | 推荐（服装） | 小写字符串 |
履行
| 属性 | 数据类型 | 支持的值 | 描述 | 示例 | 要求 | 验证规则 |
|---|---|---|---|---|---|---|
| shipping | String | country:region:service_class:price | 配送方式/费用/区域 | US:CA:Overnight:16.00 USD | 适用时必需 | 允许多个条目；使用冒号分隔符 |
| delivery_estimate | Date | ISO 8601 | 预计到达日期 | 2025-08-12 | 可选 | 必须是未来日期 |
商家信息
| 属性 | 数据类型 | 支持的值 | 描述 | 示例 | 要求 | 验证规则 |
|---|---|---|---|---|---|---|
| seller_name | String | — | 卖家名称 | Example Store | 必需 / 显示 | 最多 70 字符 |
| seller_url | URL | RFC 1738 | 卖家页面 | https://example.com/store | 必需 | HTTPS 首选 |
| seller_privacy_policy | URL | RFC 1738 | 卖家特定政策 | https://example.com/privacy | 如果 enabled_checkout 为 true，则必需 | HTTPS 首选 |
| seller_tos | URL | RFC 1738 | 卖家特定服务条款 | https://example.com/terms | 如果 enabled_checkout 为 true，则必需 | HTTPS 首选 |
推荐字段
为了提高产品发现和排名，强烈建议包括：
- 额外图片（
additional_image_link） - 品牌（
brand） - 类别（
google_product_category） - 产品类型（
product_type） - 评分（
rating,review_count） - GTIN（
gtin） - MPN（
mpn）
文件格式
支持以下文件格式：
- TSV（制表符分隔值）
- CSV（逗号分隔值）
- XML（可扩展标记语言）
- JSON（JavaScript 对象表示法）
选择最适合您现有导出流程的格式。
更新频率
- 支持的最高频率：每 15 分钟
- 建议频率：
- 高库存变化：每小时
- 中等变化：每天
- 低变化：每周
保持 Feed 新鲜以确保准确的产品信息和更好的用户体验。
验证
在提交之前：
- 验证所有必填字段都存在
- 检查数据格式和类型
- 确保 URL 可访问
- 验证图片链接
- 测试文件编码（UTF-8）
资源
有关完整的字段参考和详细示例，请参阅英文版本或访问 OpenAI 开发者文档。