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 つの部分で構成されます。- チャネル(「オンライン」、「ローカル」)
- コンテンツの言語(2 文字表記、
en
、fr
など) - フィードラベル(フィードの対象国を表す 2 文字のコード。例:
US
、FR
) - 特典 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 |
文字列データ型、商品の販売状況を表す一意の識別子。 |
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 |
商品の JSON 本文内で productId を参照するために使用されます。 |
external_seller_id |
マーケットプレイスによって選択された販売者 ID。 | example-Seller1 |
複数販売業者アカウントには必須。1 ~ 50 文字で指定してください。大文字と小文字が区別されます。数字、特殊文字(_、-、.、~)を使用できます。 |