商品 ID

在 Content API for Shopping 中，不同類型的產品 ID 如下：

優惠 ID

offerId 是商家指派給產品的字串，此 ID 代表個別產品。

offerId 專屬於 Merchant Center 資料庫中的產品組合，且通常為一個連續數字。

offerId 可以是商家指派給產品的內部 SKU 號碼。

REST 編號

REST ID 是 Google 為產品指定的專屬 ID。

REST ID 是 REST API 呼叫的productId。

REST ID 是以 online:en:label:1111111111 格式彙整。REST ID 是由以下 4 個部分組成，並以冒號分隔：

1. 頻道 (「線上」或「本地」)
2. 內容語言 (使用雙字母標示，例如 en 或 fr)
3. 動態饋給標籤 (可能是兩個指定國家/地區動態饋給的字母代碼，例如 US 或 FR)
4. 優惠 ID

您會將此顯示為 channel:contentLanguage:feedLabel:offerId，例如 online:en:US:1111111111。

外部賣方 ID (市集)

市集必須指派 external_seller_id 給上傳至多重賣家帳戶的優惠。這個欄位代表個別賣家。

external_seller_id 值須區分大小寫，且必須符合下列條件：

• 長度介於 1 至 50 個字元之間
• 只能使用英數字元 ASCII 字元、底線 (_)、連字號 (-)、半形句號 (.) 和波浪號 (~)

這與內部 seller_id 欄位不同。

下表摘要說明可與產品建立關聯的部分 ID：

屬性	說明	範例	Notes
offerId	商家指派給產品的 ID。	1111111111	字串資料類型，這是產品優惠的專屬 ID。
REST 編號	Google 指派給產品的 ID。格式為 channel:contentLanguage:feedLabel:offerId。	online:en:label:1111111111	完整 ID，包含 offerId。
productId	用於在 API 呼叫中參照 REST ID。	online:en:label:1111111111	這是產品的 REST ID。
id	與 REST ID 和 productId 相同。	online:en:label:1111111111	在產品的 JSON 主體中使用，以參照其 productId。
external_seller_id	市集選擇的賣方 ID。	example-Seller1	對於多重賣方帳戶，此為必填屬性。長度必須介於 1 至 50 個字元之間。需區分大小寫，可接受數字和特殊字元 _、-、. 和 ~。