Google Merchant Center の商品テーブル スキーマ
概要
Google Merchant Center レポートデータが BigQuery に転送されるときに、商品と商品問題データの形式は基本的に Content API の Products リソースと Productstatuses リソースの関連フィールドの形式に対応します。
個々の販売者 ID を使用している場合、データは Products_MERCHANT_ID という名前のデーブルに書き込まれます。MCA アカウントを使用している場合は Products_AGGREGATOR_ID にデータが書き込まれます。
スキーマ
Products_ テーブルのスキーマは次のとおりです。
| 列 | BigQuery のデータ型 | 説明 | データの例 |
|---|---|---|---|
product_data_timestamp |
TIMESTAMP |
商品データのタイムスタンプ。 | 2023-09-14 11:49:50 UTC |
product_id |
STRING |
商品の Content API の REST ID。形式は channel:content_language:feed_label:offer_id です。これが主キーです。 |
online:en:AU:666840730 |
merchant_id |
INTEGER |
販売アカウント ID | 1234 |
aggregator_id |
INTEGER |
マルチクライアント アカウントのアグリゲータ アカウント ID | 12345 |
offer_id |
STRING |
販売者が指定した商品の ID。 | tddy123uk |
title |
STRING |
商品アイテムの商品名。 | TN2351 black USB |
description |
STRING |
商品アイテムの説明。 | 「TN2351 black USB」で、XJS が LLCD エクスペリエンスに与える影響が再定義されました。 |
link |
STRING |
販売者が指定した商品のランディング ページの URL。 | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
mobile_link |
STRING |
販売者が提供したランディング ページのモバイル デバイス向けの URL。 | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
image_link |
STRING |
販売者が提供したメインの商品画像の URL。 | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
additional_image_links |
STRING、REPEATED |
販売者が提供した商品アイテムの追加の URL。 | |
content_language |
STRING |
商品アイテムの 2 文字の ISO 639-1 言語コード。 | en |
target_country |
STRING |
商品で複数の国をターゲットにできるようにするための変更に伴い、これは非推奨になりました（常に NULL に設定されます）。代わりに、destinations.approved_countries、destinations.pending_countries、destinations.disapproved_countries の各フィールドを使用して、対象国のそれぞれのステータスを読み取ります。issues.applicable_countries フィールドに示されているように、問題は一部の対象国にのみ適用されるようになりました。 | null |
feed_label |
STRING |
販売者が提供した商品アイテムのフィードラベル（提供しなかった場合は -）。 |
US |
channel |
STRING |
商品アイテムのチャネル（online または local） |
local、online |
expiration_date |
TIMESTAMP |
販売者が提供した商品アイテムの有効期限（日時）。挿入時に指定されます。提供されていない場合は、null に設定されます。 | 2023-10-14 00:00:00 UTC |
google_expiration_date |
TIMESTAMP |
Google ショッピングで商品アイテムが期限切れになる日時。null に設定しないでください。 | 2023-10-14 00:00:00 UTC |
adult |
BOOLEAN |
商品アイテムが成人向けの場合は true に設定します。 | true、false |
age_group |
STRING |
販売者が提供した商品アイテムの対象年齢層。提供されていない場合は NULL。 | newborn、infant、toddler、kids、adult |
availability |
STRING |
販売者が提供した商品アイテムの在庫状況。 | in stock、out of stock |
availability_date |
TIMESTAMP |
販売者が提供した、注文済みの商品アイテムが配達可能になる日時。提供されていない場合は NULL。 | 2023-10-14 00:00:00 UTC |
brand |
STRING |
販売者が提供した商品アイテムのブランド。提供されていない場合は NULL。 | ブランド名 |
google_brand_id |
STRING |
商品アイテムの Google ブランド ID。 | 12759524623914508053 |
color |
STRING |
販売者が提供した商品アイテムの色。提供されていない場合は NULL。 | Silver、Gray、Multi |
condition |
STRING |
販売者が提供した商品アイテムの状態。 | new、used、refurbished |
custom_labels |
RECORD |
販売者が提供したカスタムラベル（ショッピング広告で商品アイテムのカスタム グループに使用）。提供されていない場合は NULL。 | |
custom_labels.label_0 |
STRING |
カスタムラベル 0。 | my custom label |
custom_labels.label_1 |
STRING |
カスタムラベル 1。 | my custom label |
custom_labels.label_2 |
STRING |
カスタムラベル 2。 | my custom label |
custom_labels.label_3 |
STRING |
カスタムラベル 3。 | my custom label |
custom_labels.label_4 |
STRING |
カスタムラベル 4。 | my custom label |
gender |
STRING |
販売者が提供した商品アイテムの対象性別。提供されていない場合は NULL。 | unisex、male、female |
gtin |
STRING |
販売者が提供した商品アイテムの国際取引商品番号（GTIN）。提供されていない場合は NULL。 | 3234567890126 |
item_group_id |
STRING |
販売者が提供した共通の ID（同一商品のすべてのバリエーションに使用）。提供されていない場合は NULL。 | AB12345 |
material |
STRING |
販売者が提供した商品アイテムの素材。提供されていない場合は NULL。 | Leather |
mpn |
STRING |
販売者が提供した商品アイテムの商品の製造番号（MPN）。提供されていない場合は、NULL に設定されます。 | GO12345OOGLE |
pattern |
STRING |
販売者が提供したパターン。提供されていない場合は NULL。 | Striped |
price |
RECORD |
販売者が提供した商品アイテムの価格。 | |
price.value |
NUMERIC |
商品価格。 | 19.99 |
price.currency |
STRING |
価格の通貨。 | USD |
sale_price |
RECORD |
販売者が提供した商品アイテムのセール価格。 | |
sale_price.value |
NUMERIC |
商品アイテムの販売価格。提供されていない場合は NULL。 | 19.99 |
sale_price.currency |
STRING |
販売価格の通貨。提供されていない場合は NULL。 | USD |
sale_price_effective_start_date |
TIMESTAMP |
商品アイテムの販売開始日時。 | 2023-10-14 00:00:00 UTC |
sale_price_effective_end_date |
TIMESTAMP |
商品アイテムの販売終了日時。 | 2023-10-14 00:00:00 UTC |
google_product_category |
INTEGER |
商品アイテムの Google 商品カテゴリ ID。提供されていない場合は NULL。 | 2271 |
google_product_category_ids |
INTEGER, REPEATED |
商品アイテムの Google 商品カテゴリのフルパス（一連の ID として保存）。提供されていない場合は NULL。 | |
google_product_category_path |
STRING |
人が読める形式のバージョンのフルパス。提供されていない場合は空になります。 | Apparel & Accessories > Clothing > Dresses |
product_type |
STRING |
販売者が提供した商品アイテムのカテゴリ。 | Home > Women > Dresses > Maxi Dresses |
additional_product_types |
STRING、REPEATED |
商品アイテムの追加カテゴリ。 | |
destinations |
RECORD、REPEATED |
商品アイテムの宛先。 | |
destinations.name |
STRING |
宛先の名前（Shopping のみサポート）。これは、Merchant Center のマーケティング手法の「ショッピング広告」と「ローカル在庫広告」に対応しています。 |
ショッピング |
destinations.status* |
STRING |
商品で複数の国をターゲットにできるようにするための変更に伴い、これは非推奨になりました（常に NULL に設定されます）。代わりに、destinations.approved_countries、destinations.pending_countries、destinations.disapproved_countries の各フィールドを使用して、対象国のそれぞれのステータスを読み取ります。issues.applicable_countries フィールドに示されているように、問題は一部の対象国にのみ適用されるようになりました。 | NULL |
destinations.approved_countries |
STRING, REPEATED |
クーポンが承認済みの CLDR 地域コードのリスト。 | US、CH |
destinations.pending_countries |
STRING, REPEATED |
クーポンが保留中の CLDR 地域コードのリスト。 | US、CH |
destinations.disapproved_countries |
STRING, REPEATED |
クーポンが不承認の CLDR 地域コードのリスト。 | US、CH |
issues |
RECORD、REPEATED |
商品に関連するアイテムレベルの問題の一覧。 | |
issues.code |
STRING |
問題のエラーコード。 | image_too_generic |
issues.servability |
STRING |
この問題によるサービスへの影響。 | disapproved、unaffected |
issues.resolution |
STRING |
販売者側で問題が解決可能かどうか。 | merchant_action、pending_processing |
issues.attribute_name |
STRING |
属性名（問題の原因が単一属性の場合）。それ以外の場合は null。 | 画像のリンク |
issues.destination |
STRING |
問題の適用先。常に Shopping に設定。 |
ショッピング |
issues.short_description |
STRING |
問題の簡単な説明（英語）。 | Generic image |
issues.detailed_description |
STRING |
問題の詳しい説明（英語）。 | Use an image that shows the product |
issues.documentation |
STRING |
この問題の解決に役立つウェブページの URL。 | https://support.google.com/merchants/answer/6098288 |
issues.applicable_countries |
STRING, REPEATED |
問題が適用される CLDR テリトリー コードのリスト。 | CH |