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. チャネル(「online」または「local」)
  2. コンテンツの言語(2 文字の指定を使用、例: enfr
  3. フィードラベル(フィードの対象国の 2 文字のコード。USFR など)
  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 文字で指定してください。大文字と小文字が区別されます。数字と特殊文字(_、-、.、~)を使用できます。