Content API for Shopping の各商品 ID には、次の種類があります。
- 特典 ID
offerId
は、販売者が商品に割り当てる文字列です。この ID は個々の商品を表します。offerId
は Merchant Center データベース内の一連のオファーに対して一意で、通常は数字の連続した番号です。offerId
には、販売者が商品に割り当てる内部 SKU 番号を指定できます。- REST ID
- REST ID は、Google によって割り当てられた商品の一意の識別子です。
- REST ID は、REST API 呼び出しの
productId
です。 REST ID は
online:en:label:1111111111
形式の集計です。REST ID は、コロンで区切られた次の 4 つの部分で構成されます。- チャネル(「オンライン」または「ローカル」)
- コンテンツの言語(
en
、fr
などの 2 文字の表記を使用) - フィードラベル(
US
、FR
などのフィードの対象国の 2 文字のコード) - 特典 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 |
offerId を含む完全な ID。 |
productId |
API 呼び出しで REST ID を参照するために使用します。 | online:en:label:1111111111 |
プロダクトの REST ID です。 |
id |
REST ID および productId と同じ値。 |
online:en:label:1111111111 |
productId を参照するために、商品の JSON 本文内で使用されます。 |
external_seller_id |
マーケットプレイスによって選択された販売者 ID。 | example-Seller1 |
複数販売者アカウントの場合は必須です。1 ~ 50 文字で指定してください。大文字と小文字が区別されます。数字と、特殊文字(_、-、.、~)を使用できます。 |