OpenAI 商品 Feed 規格：每個欄位一次看懂

Q: OpenAI 商品 Feed 有哪些必填欄位？

9 個：item_id、title、description、url、brand、seller_name、image_url、availability、price。

OpenAI Stable 商品 Feed 規格有 9 個必填欄位：item_id、title、description、url、brand、seller_name、image_url、availability、price。可用 SFTP 傳 Parquet、jsonl.gz、csv.gz 或 tsv.gz，至少每天送一次完整快照，也可以走 API。Draft 規格只供規劃。

所有欄位一覽

下表的分級照規格原文：必填、選填、條件必填，以及要先設定整合或市場才會採用的欄位。規格裡沒有「建議」這一級。

欄位	分級	內容
`item_id`	必填	商品或變體 ID，唯一且不變
`title`	必填	名稱加變體，≤150 字元
`description`	必填	純文字事實，≤5,000 字元
`url`	必填	公開商品頁（http/https）
`brand`	必填	品牌，不可填占位字
`seller_name`	必填	實際供貨的賣家，每列都要填
`image_url`	必填	該變體主圖，JPEG 或 PNG
`availability`	必填	`in_stock` · `out_of_stock` · `pre_order` · `backorder` · `unknown`
`price`	必填	原價，金額＋幣別，例如 `79.99 USD`
`group_id`	條件必填	變體的母商品 ID，不能與任何 `item_id` 相同
`listing_has_variations`	條件必填	變體列填 `true`
`variant_dict`	條件必填	選定的規格，例如 `{"color":"Black"}`
`is_eligible_search`	選填	是否可被搜尋，預設 true；要下架填 false
`gtin`	選填	8／12／13／14 碼，檢查碼要正確
`mpn`	選填	製造商料號，需搭配 `brand`
`condition`	選填	`new` · `refurbished` · `used`
`product_category`	選填	以 `>` 分隔的分類路徑
`material` / `color` / `size`	選填	材質，以及選定的顏色、尺寸
`gender` / `age_group`	選填	`male` · `female` · `unisex` / `newborn` · `infant` · `toddler` · `kids` · `adult`
`dimensions`	選填	至少兩個方向加 `unit`（in、cm、ft、m、mm）
`weight` + `item_weight_unit`	選填	淨重，單位 g、kg、oz、lb
`additional_image_urls`	選填	其他圖片
`sale_price`	選填	低於 `price`，同幣別
`shipping_price`	選填	運費，沒填視為未知
`accepts_returns` / `return_deadline_in_days` / `return_policy`	選填	是否接受退貨、天數、政策網址
`review_count` / `star_rating`	選填	商品評論數；評分 0–5，兩位小數
`shipping` / `size_system` / `store_review_count` / `store_star_rating` / `accepts_exchanges` / `is_digital`	需另外設定	相關整合設定好才會採用
`target_countries` / `store_country`	依市場設定	標準上傳為 `["US"]` 與 US
`is_ads_eligible` / `ads_metadata`	條件必填	另外的廣告計畫才需要
`is_eligible_checkout` / `seller_privacy_policy` / `seller_tos`	條件必填	啟用結帳整合時才需要

規格也接受舊欄位名（id、sku、item_group_id、enable_search、return_window 等），而且有些會蓋掉新欄位。只送新的欄位名就好。

價格、庫存與變體

價格： 金額、空格、ISO 4217 幣別，例如 79.99 USD，不加千分位。特價開始或結束時要更新；日期欄位不會自動排程。
庫存： 值不合法或沒填，整列會被拒絕。
變體： 每個變體一列，共用 group_id，但各自有價格、庫存、圖片，並填 listing_has_variations=true 與 variant_dict。
和 Google 命名不同： OpenAI 用 pre_order、group_id；Google Merchant Center 用 preorder、item_group_id。

格式、大小與更新

格式： Parquet（優先）、jsonl.gz、csv.gz、tsv.gz，UTF-8。
傳送： SFTP 檔案或 API；促銷只能走 API。OpenAI 建議每天一份完整檔加上 API 即時更新。
大小： 每個分片最多 50 萬件、約 500 MB，檔名固定。
下架： 從快照拿掉的商品最多保留 14 天；要下架請送 is_eligible_search=false。
第一次上傳： OpenAI 建議先送約 100 件的樣本。

OpenAI 自己的頁面有不一致：有一頁說 Feed 是 CSV 或 JSON，最佳實務頁用的是 Draft 欄位名。請以 Stable 規格頁為準。

常見問題

OpenAI 商品 Feed 有哪些必填欄位？

9 個：item_id、title、description、url、brand、seller_name、image_url、availability、price。

可以送 XML Feed 嗎？

檔案規格列的是 Parquet、jsonl.gz、csv.gz、tsv.gz，沒有 XML。Google Merchant 的 XML 要轉檔，並把 item_group_id 改成 group_id、preorder 改成 pre_order。

Feed 多久要更新一次？

至少每天一次完整快照，價格或庫存變動時另外更新。

可以用 Draft 規格嗎？

不行。OpenAI 標明 Draft 不用於正式環境，請用 Stable。