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 文字で指定してください。大文字と小文字が区別されます。数字、特殊文字（_、-、.、~）を使用できます。 |