Product IDs

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 つの部分で構成されます。

1. チャネル（「オンライン」、「ローカル」）
2. コンテンツの言語（2 文字表記、en、fr など）
3. フィードラベル（フィードの対象国を表す 2 文字のコード。例: US、FR）
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	文字列データ型、商品の販売状況を表す一意の識別子。
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 文字で指定してください。大文字と小文字が区別されます。数字、特殊文字（_、-、.、~）を使用できます。