商品 ID

以下是 Content API for Shopping 的各種產品 ID:

優惠 ID
offerId 是由商家指派給產品的字串。這個 ID 代表個別產品。
offerId 專用於 Merchant Center 資料庫中的一組商品,通常為數字序號。
offerId 可以是商家指派給產品的內部 SKU 編號。
REST ID
REST ID 是 Google 指派給產品的專屬 ID。
REST ID 是 REST API 呼叫的 productId

REST ID 會以 online:en:label:1111111111 格式匯總。REST ID 由以下 4 個部分組成,以冒號分隔:

  1. 管道 (「線上」或「本地」)
  2. 內容語言 (使用 2 個字母的標示,例如 enfr)
  3. 動態饋給標籤 (可以是動態饋給指定國家/地區的兩字母代碼,例如 USFR)
  4. 優惠 ID

您要將其合併為 channel:contentLanguage:feedLabel:offerId,例如 online:en:US:1111111111

外部賣方 ID (市集)

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

external_seller_id 值區分大小寫,並且必須符合下列條件:

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

這與內部 seller_id 欄位不同。

下表摘要列出可與產品建立關聯的部分 ID:

屬性 說明 範例 附註
offerId 商家指派給產品的 ID。 1111111111 字串資料類型,是產品優惠的專屬 ID。
REST ID 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 個字元之間。需區分大小寫,可接受數字和特殊字元 _、-、. 和 ~。