- JSON 表現
- Installment
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- 送料
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- 税金
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- 認定資格
- ProductStructuredTitle
- ProductStructuredDescription
属性。
JSON 表現 |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
フィールド | |
---|---|
additional |
商品アイテムの画像の追加 URL。 |
expiration |
商品アイテムの有効期限(日付)。挿入時に指定されます。ISO 8601 形式で指定します。実際の有効期限は |
disclosure |
Google の YouTube サービス全体の検索結果に商品を公開する日時(ISO 8601 形式)。詳しくは、[開示日]( https://support.google.com/merchants/answer/13034208) をご覧ください。 |
availability |
予約を受け付けた商品の発送が可能になる日(ISO 8601 形式)。 |
gtin[] |
商品アイテムの国際取引商品番号(GTIN)。指定できる GTIN は 10 個までです。 |
price |
商品アイテムの価格です。 |
installment |
商品の分割払いの回数と金額。 |
subscription |
サブスクリプション契約が関連付けられているアイテムの期間数(月または年)と期間ごとのお支払い額。 |
loyalty |
アイテムの購入後にユーザーに付与されるポイント。日本国内のみ対応。 |
loyalty |
この商品のユーザーにポイント プログラムの特典(割引価格、ポイントなど)を表示するために使用されるポイント プログラム情報のリスト。 |
product |
商品のカテゴリ(商品データ仕様の形式)。 |
sale |
商品アイテムの広告表示セール価格。 |
sale |
商品アイテムがセール対象になっている期間(商品データ仕様をご覧ください)。 |
product |
指定された単位で表した商品の高さ。値は 0 ~ 3,000 の範囲で指定してください。 |
product |
指定された単位での商品の長さ。値は 0 ~ 3,000 の範囲で指定してください。 |
product |
指定された単位で表した商品の幅。値は 0 ~ 3,000 の範囲で指定してください。 |
product |
指定された単位で表した商品の重量。値は 0 ~ 2,000 の範囲で指定してください。 |
shipping[] |
配送ルール。 |
free |
商品が送料無料になるための条件。 |
shipping |
配送する商品の重量。 |
shipping |
梱包箱の奥行。 |
shipping |
配送する商品の幅。 |
shipping |
梱包箱の高さ。 |
size |
商品のカット。アパレル商品の組み合わせサイズタイプを表すために使用できます。指定できるサイズタイプは 2 つまでです([https://support.google.com/merchants/answer/6324497](サイズタイプ) をご覧ください)。 |
taxes[] |
税務情報。 |
unit |
商品アイテムの容量や寸法。 |
unit |
単価の分母の設定。 |
ads |
adsGrouping と類似していますが、クリック単価でのみ機能します。 |
cost |
売上原価。売上総利益のレポートに使用されます。 |
product |
技術仕様または商品の追加情報。 |
product |
商品に関する最も関連性の高いハイライトを箇条書きで説明します。 |
display |
広告主様が指定した推奨事項。 |
promotion |
プロモーションの一意の ID です。 |
included |
このターゲット向けに含める掲載先のリストです(Merchant Center でオンになっているチェックボックスに対応します)。デフォルトの掲載先は、 |
excluded |
このターゲットで除外する掲載先のリストです(Merchant Center でオフになっているチェックボックスに対応します)。 |
shopping |
ショッピング広告の掲載先から商品を除外する国コード(ISO 3166-1 alpha-2)のリスト。このリストに含まれる国は、データソースの設定で設定されている国から削除されます。 |
lifestyle |
商品アイテムのライフスタイル画像の追加 URL。商品アイテムが実際の状況で使用されている場面が写っている画像を明示的に指定するために使用します。詳しくは、ヘルプセンターの記事をご覧ください。 |
cloud |
Cloud Retail プログラムにエクスポートする追加フィールド。 |
certifications[] |
商品認証(EU EPREL データベースに登録されている商品のエネルギー効率ラベルなど)。詳しくは、ヘルプセンターの記事をご覧ください。 |
auto |
「自動割引」(https://support.google.com/merchants/answer/10295759)プロジェクトと「動的プロモーション」(https://support.google.com/merchants/answer/13949249)プロジェクトの安全保護機能。販売者の商品の割引がこの値を下回らないようにし、商品の価値と収益性を維持します。 |
identifier |
商品アイテムに、カテゴリに適した固有商品 ID(GTIN、MPN、ブランドなど)がない場合は、この値を false に設定します。指定しない場合のデフォルトは true です。 |
is |
商品が販売者が定める一括販売かどうか。一括販売商品とは、販売者が単一の価格で販売するさまざまな商品のカスタム グループです。 |
title |
商品アイテムの商品名。 |
description |
項目の説明。 |
link |
オンライン ショップの商品アイテムのページに直接リンクする URL。 |
mobile |
商品のランディング ページのモバイル向けの URL。 |
canonical |
商品アイテムのランディング ページの正規バージョンの URL。 |
image |
商品アイテムの画像の URL。 |
adult |
商品アイテムが成人向けの場合は true に設定します。 |
age |
商品アイテムの対象年齢層。 |
availability |
商品アイテムの在庫状況。 |
brand |
商品アイテムのブランド。 |
color |
商品アイテムの色。 |
condition |
商品アイテムの状態。 |
gender |
商品アイテムの対象層の性別。 |
google |
商品アイテムの Google カテゴリ(Google の商品分類を参照)。商品をクエリすると、このフィールドにはユーザーが指定した値が含まれます。現在のところ、API を使用して自動割り当てされた Google 商品カテゴリを復元する方法はありません。 |
item |
同一商品のすべてのバリエーションに共通の ID。 |
material |
商品アイテムの素材。 |
mpn |
商品アイテムの製造者が定める製品番号(MPN)。 |
pattern |
商品アイテムのパターン(水玉模様など)。 |
sell |
Google で販売可能な商品の数量。オンライン商品でのみサポートされます。 |
max |
商品の発送準備に要する最長時間(営業日数)。 |
min |
商品の発送準備に必要な最短日数(営業日数)。 |
shipping |
商品の送料ラベル。アカウント単位の送料ルールで商品をグループ化するために使用されます。 |
transit |
商品のお届け日数ラベル。アカウント単位のお届け日数テーブルで商品をグループ化するために使用されます。 |
size |
商品アイテムのサイズ。指定できる値は 1 つのみです。サイズが異なるバリエーションの場合は、サイズごとに別々の商品を挿入します。 |
size |
サイズが指定されているシステム。アパレル商品に推奨されます。 |
tax |
商品の税カテゴリ。アカウント単位の税金設定で詳細な税ネクサスを設定するために使用されます。 |
energy |
EU 指令 2010/30/EU で定義されている省エネ性能。 |
min |
EU 指令 2010/30/EU で定義されている省エネ性能。 |
max |
EU 指令 2010/30/EU で定義されている省エネ性能。 |
multipack |
販売者が定めるマルチパックに含まれる同一商品の数。 |
ads |
アイテムを任意の方法でグループ化するために使用します。CPA% のみに使用し、それ以外の場合は使用しないことをおすすめします。 |
ads |
商品が商品広告のコンテキスト内で表示されるときに、広告主が商品の URL をオーバーライドできるようにします。 |
display |
動的リマーケティング キャンペーン向けの商品アイテムの ID。 |
display |
動的リマーケティング キャンペーン向けの商品アイテムのタイトル。 |
display |
動的リマーケティング キャンペーン向けの商品アイテムのランディング ページに直接つながる URL。 |
display |
動的リマーケティング キャンペーン向けの商品アイテムの利幅。 |
pickup |
商品アイテムの受け取りオプション。 |
pickup |
商品アイテムの店舗受け取りの用意ができるまでの期間。 |
link |
販売者ホスト型店舗詳細ページのリンク テンプレート。 |
mobile |
モバイル デバイス向けに最適化された販売者ホスト型店舗詳細ページのリンク テンプレート。 |
custom |
ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 0。 |
custom |
ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 1。 |
custom |
ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 2。 |
custom |
ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 3。 |
custom |
ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 4。 |
external |
複数販売者アカウントには必須です。ショッピングモールの運営者で、さまざまな販売者の商品を複数販売業者アカウントにアップロードする場合は、この属性を使用します。 |
pause |
このアイテムの公開は一時的に停止されます。 |
virtual |
商品アイテムの 3D 画像の URL。詳しくは、ヘルプセンターの記事をご覧ください。 |
structured |
構造化されたタイトル: アルゴリズム(AI)生成のタイトル用。 |
structured |
構造化された商品説明: アルゴリズム(AI)によって生成された商品説明。 |
分割払い
分割払いを表すメッセージ。
JSON 表現 |
---|
{ "months": string, "amount": { object ( |
フィールド | |
---|---|
months |
購入代金の分割回数。 |
amount |
購入者が毎月支払う金額。 |
downpayment |
購入者が支払う頭金の金額。 |
credit |
分割払いのタイプ。サポートされている値は次のとおりです。*「 |
SubscriptionCost
商品の SubscriptionCost。
JSON 表現 |
---|
{ "period": enum ( |
フィールド | |
---|---|
period |
サブスクリプション期間のタイプ。サポートされている値は次のとおりです。*「 |
period |
購入者が支払う定期購入の期間。 |
amount |
購入者が定期購入期間ごとに支払う金額。 |
SubscriptionPeriod
商品の定期購入期間。
列挙型 | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
定期購入の期間が指定されていないことを示します。 |
MONTH |
サブスクリプション期間が月であることを示します。 |
YEAR |
定期購入の期間が年であることを示します。 |
LoyaltyPoints
ポイント プログラムのポイントを表すメッセージ。
JSON 表現 |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
フィールド | |
---|---|
name |
ポイント プログラムの名前。名前は、全角 12 文字または半角 24 文字に制限することをおすすめします。 |
points |
販売店のポイントの絶対値。 |
ratio |
ポイントを金額に換算するときの率。Google は、Merchant Center の設定に基づいて通貨を判断します。ratio を省略すると、デフォルトで 1.0 になります。 |
LoyaltyProgram
ポイント プログラムを表すメッセージ。
JSON 表現 |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
フィールド | |
---|---|
program |
ポイント プログラムのラベル。これは、販売者エンティティとポイント プログラム エンティティの関係を一意に識別する内部ラベルです。システムが以下のアセット(価格やポイントなど)を販売者に関連付けられるように、ラベルを指定する必要があります。対応するプログラムが販売者アカウントにリンクされている必要があります。 |
tier |
ポイント プログラム内のティアのラベル。プログラム内のラベルのいずれかに一致している必要があります。 |
price |
特定の階層のメンバー向けの料金(即時割引価格)。通常価格以下にする必要があります。 |
cashback |
今後の購入に使用できるキャッシュバック。 |
loyalty |
購入で獲得したポイント数。 |
member |
商品がメンバー価格の対象となる日付範囲。指定しない場合、メンバー料金が常に適用されます。期間は、スペース、カンマ、スラッシュで区切られた ISO 8601 の日付のペアで表されます。 |
shipping |
配送特典のラベル。このフィールドに値が設定されている場合、この特典にはポイント プログラムの配送特典が適用されます。フィールド値が指定されていない場合、その商品は、指定されたポイント プログラムの階層のポイント プログラムの送料の対象外となります。 |
ProductDimension
商品の寸法。
JSON 表現 |
---|
{ "value": number, "unit": string } |
フィールド | |
---|---|
value |
必須。数値で表されたディメンション値。値の小数点以下の桁数は最大 4 桁です。 |
unit |
必須。ディメンションの単位。有効な値は次のとおりです。*「 |
ProductWeight
商品の重量。
JSON 表現 |
---|
{ "value": number, "unit": string } |
フィールド | |
---|---|
value |
必須。数値で表した重み。重み付けの精度は小数点以下 4 桁までです。 |
unit |
必須。重量の単位。有効な値は次のとおりです。*「 |
送料
商品の発送。
JSON 表現 |
---|
{
"price": {
object ( |
フィールド | |
---|---|
price |
固定の送料価格(数値で指定)。 |
country |
商品アイテムの発送先となる国の CLDR 地域コード。 |
region |
送料が適用される地域。詳細については、region をご覧ください。 |
service |
サービスクラスまたは配送所要日数の自由形式の説明。 |
location |
AdWords API で定義されている、送料が適用される地域の数値 ID。 |
location |
配送が適用される地域(地域グループ名で表されます)。 |
postal |
送料が適用される郵便番号の範囲。郵便番号、郵便番号の接頭辞とワイルドカード(*)、2 つの郵便番号の範囲、または長さが同じ 2 つの郵便番号の接頭辞で表されます。 |
min |
注文を受けてから発送するまでの最短発送準備時間(営業日数)0 は、受付終了時間より前に注文を受けた場合、注文がその日のうちに発送されることを意味します。 |
max |
注文の受領から発送までの最長発送準備時間(営業日数)。0 は、受付終了時間より前に注文を受けた場合、注文がその日のうちに発送されることを意味します。配送日数を指定する場合は、 |
min |
注文の発送から配達までの最短お届け日数(営業日数)。0 は、注文が発送された当日に配達されることを意味します。 |
max |
注文の発送から配達までの最長お届け日数(営業日数)。0 は、注文が発送された当日に配達されることを意味します。配送日数を指定する場合は、 |
FreeShippingThreshold
商品が送料無料になるための条件。
JSON 表現 |
---|
{
"country": string,
"priceThreshold": {
object ( |
フィールド | |
---|---|
country |
商品アイテムの発送先となる国の CLDR 地域コード。 |
price |
送料が無料になる商品の最低価格。数値で表されます。 |
ShippingWeight
商品の ShippingWeight。
JSON 表現 |
---|
{ "value": number, "unit": string } |
フィールド | |
---|---|
value |
商品の送料の計算に使用する商品の重量。 |
unit |
値の単位。 |
ShippingDimension
商品の ShippingDimension。
JSON 表現 |
---|
{ "value": number, "unit": string } |
フィールド | |
---|---|
value |
商品の送料の計算に使用する商品の寸法。 |
unit |
値の単位。 |
税金
商品の税金。
JSON 表現 |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
フィールド | |
---|---|
rate |
商品価格に適用される税率の割合。 |
country |
商品に税金が課される国。CLDR 地域コードで指定します。 |
region |
税率が適用される地域。 |
tax |
送料に税金が課される場合は true に設定します。 |
location |
AdWords API で定義されている、税率が適用される地域の数値 ID。 |
postal |
税率が適用される郵便番号の範囲。郵便番号、* ワイルドカードを使用した郵便番号の接頭辞、2 つの郵便番号の範囲、または長さが同じ 2 つの郵便番号の接頭辞で表されます。例: 94114、94*、94002-95460、94*-95*。 |
UnitPricingMeasure
商品の UnitPricingMeasure。
JSON 表現 |
---|
{ "value": number, "unit": string } |
フィールド | |
---|---|
value |
商品アイテムの測定値。 |
unit |
測定の単位。 |
UnitPricingBaseMeasure
商品の UnitPricingBaseMeasure。
JSON 表現 |
---|
{ "value": string, "unit": string } |
フィールド | |
---|---|
value |
単価の分母。 |
unit |
分母の単位。 |
ProductDetail
商品の詳細。
JSON 表現 |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
フィールド | |
---|---|
section |
商品の詳細セットをグループ化するために使用されるセクション ヘッダー。 |
attribute |
商品の詳細の名前。 |
attribute |
商品の詳細の値。 |
CloudExportAdditionalProperties
Cloud Retail API の商品プロパティ。たとえば、テレビ商品のプロパティには「Screen-Resolution」や「Screen-Size」などがあります。
JSON 表現 |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
フィールド | |
---|---|
text |
指定されたプロパティのテキスト値。たとえば、テレビ商品のテキスト値は「8K(UHD)」などです。この値の最大繰り返し数は 400 です。値は任意の順序で保存されますが、一貫した順序で保存されます。文字列の最大サイズは 256 文字です。 |
int |
指定されたプロパティの整数値。たとえば、テレビ プロダクトの画面解像度の場合は 1080 です。この値の最大繰り返し数は 400 です。値は任意の順序で保存されますが、一貫した順序で保存されます。 |
float |
指定されたプロパティの浮動小数点値。たとえば、テレビ商品の場合は 1.2345 です。この値の最大繰り返し数は 400 です。値は任意の順序で保存されますが、一貫した順序で保存されます。 |
property |
指定されたプロパティの名前。たとえば、テレビ商品の場合は「Screen-Resolution」です。文字列の最大サイズは 256 文字です。 |
bool |
指定されたプロパティのブール値。たとえば、テレビ商品の場合、画面が UHD であれば「True」、そうでない場合は「False」です。 |
min |
指定されたプロパティの最小浮動小数点値。たとえば、テレビ商品の場合は 1.00 です。 |
max |
指定されたプロパティの最大浮動小数点値。たとえば、テレビ商品の場合は 100.00 です。 |
unit |
指定されたプロパティの単位。たとえば、テレビ商品の場合は「Google Pixel」などです。文字列の最大サイズは 256 B です。 |
認定資格
商品の認証。最初は、EU EPREL データベースを使用して EU の省エネラベルの要件を満たすために導入されました。
JSON 表現 |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
フィールド | |
---|---|
certification |
認証局(例: European_Commission)。最大文字数は 2,000 文字です。 |
certification |
認証の名前(「EPREL」など)。最大文字数は 2,000 文字です。 |
certification |
認証コード。最大文字数は 2,000 文字です。 |
certification |
認定値(クラス、レベル、グレードとも呼ばれます)(例: 「A+」、「C」、「ゴールド」)。最大文字数は 2,000 文字です。 |
ProductStructuredTitle
構造化されたタイトル: アルゴリズム(AI)生成のタイトル用。
JSON 表現 |
---|
{ "digitalSourceType": string, "content": string } |
フィールド | |
---|---|
digital |
デジタル ソースの種類(「trained_algorithmic_media」など)。IPTC に準拠しています。最大文字数は 40 文字です。 |
content |
タイトル テキストの最大文字数は 150 文字です |
ProductStructuredDescription
構造化された商品説明: アルゴリズム(AI)によって生成された商品説明。
JSON 表現 |
---|
{ "digitalSourceType": string, "content": string } |
フィールド | |
---|---|
digital |
デジタル ソースの種類(「trained_algorithmic_media」など)。IPTC に準拠しています。最大文字数は 40 文字です。 |
content |
説明テキストの最大文字数は 5,000 文字です |