在 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 個部分組成,並以冒號分隔:- 頻道 (「線上」或「本地」)
- 內容語言 (使用雙字母標示,例如 en或fr)
- 動態饋給標籤 (可能是兩個指定國家/地區動態饋給的字母代碼,例如 US或FR)
- 優惠 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 個字元之間。需區分大小寫,可接受數字和特殊字元 _、-、. 和 ~。 |