商品 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 個半形字元之間。需區分大小寫,系統接受數字和特殊字元 _、-、. 和 ~。