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. コンテンツの言語(enfr などの 2 文字の表記を使用)
  3. フィードラベル(USFR などのフィードの対象国の 2 文字のコード)
  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 文字列データ型。商品の固有 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 文字で指定してください。大文字と小文字が区別されます。数字と、特殊文字(_、-、.、~)を使用できます。