Package google.shopping.merchant.products.v1beta

インデックス

• ProductInputsService（インターフェース）
• ProductsService（インターフェース）
• Attributes（メッセージ）
• Certification（メッセージ）
• CloudExportAdditionalProperties（メッセージ）
• DeleteProductInputRequest（メッセージ）
• FreeShippingThreshold（メッセージ）
• GetProductRequest（メッセージ）
• InsertProductInputRequest（メッセージ）
• Installment（メッセージ）
• ListProductsRequest（メッセージ）
• ListProductsResponse（メッセージ）
• LoyaltyPoints（メッセージ）
• LoyaltyProgram（メッセージ）
• Product（メッセージ）
• ProductDetail（メッセージ）
• ProductDimension（メッセージ）
• ProductInput（メッセージ）
• ProductStatus（メッセージ）
• ProductStatus.DestinationStatus（メッセージ）
• ProductStatus.ItemLevelIssue（メッセージ）
• ProductStatus.ItemLevelIssue.Severity（列挙型）
• ProductStructuredDescription（メッセージ）
• ProductStructuredTitle（メッセージ）
• ProductSustainabilityIncentive（メッセージ）
• ProductSustainabilityIncentive.Type（列挙型）
• ProductWeight（メッセージ）
• Shipping（メッセージ）
• ShippingDimension（メッセージ）
• ShippingWeight（メッセージ）
• SubscriptionCost（メッセージ）
• SubscriptionPeriod（列挙型）
• Tax（メッセージ）
• UnitPricingBaseMeasure（メッセージ）
• UnitPricingMeasure（メッセージ）

ProductInputsService

ProductInput リソースを使用するサービス。このサービスは、オンライン チャネルを持つ商品でのみご利用いただけます。

DeleteProductInput
rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty) Merchant Center アカウントから商品入力を削除します。 商品入力を挿入、更新、削除した後、処理された商品を取得できるようになるまでに数分かかることがあります。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/content 詳細については、OAuth 2.0 Overview をご覧ください。

InsertProductInput
rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput) 商品入力を Merchant Center アカウントにアップロードします。同じ contentLanguage、offerId、dataSource の入力がすでに存在する場合、このメソッドはそのエントリを置き換えます。 商品入力を挿入、更新、削除した後、処理された商品を取得できるようになるまでに数分かかることがあります。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/content 詳細については、OAuth 2.0 Overview をご覧ください。

製品サービス

プロダクト リソースを使用するサービス。このサービスは、オンライン チャネルを持つ商品でのみご利用いただけます。

GetProduct
rpc GetProduct(GetProductRequest) returns (Product) Merchant Center アカウントから処理済み商品を取得します。 商品入力を挿入、更新、削除した後、更新された最終的な商品を取得できるようになるまでに数分かかることがあります。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/content 詳細については、OAuth 2.0 Overview をご覧ください。

ListProducts
rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) Merchant Center アカウントで処理された商品を一覧表示します。レスポンスには、pageSize で指定された数よりも少ないアイテムが含まれる場合があります。pageToken を使用して、リクエストするアイテムが他にもあるかどうかを判断します。 商品入力を挿入、更新、削除した後、更新された処理済み商品を取得できるようになるまでに数分かかることがあります。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/content 詳細については、OAuth 2.0 Overview をご覧ください。

属性

属性。

フィールド
additional_image_links[]	string 商品アイテムの画像の追加 URL。
expiration_date	Timestamp 商品アイテムの有効期限（日付）。挿入時に指定されます。ISO 8601 形式で指定します。実際の有効期限は productstatuses の googleExpirationDate として公開されます。expirationDate があまりにも先の日付の場合は、有効期限が早くなることがあります。
disclosure_date	Timestamp Google の YouTube サービス全体の検索結果に商品を表示する日時（ISO 8601 形式）。詳しくは、[開示日]( https://support.google.com/merchants/answer/13034208) をご覧ください。
availability_date	Timestamp 予約を受け付けた商品の発送が可能になる日（ISO 8601 形式）。
gtin[]	string 商品アイテムの国際取引商品番号（GTIN）。指定できる GTIN は 10 個までです。
price	Price 商品アイテムの価格です。
installment	Installment 商品の分割払いの回数と金額。
subscription_cost	SubscriptionCost 関連付けられた定期購入契約があるアイテムの期間数（月または年）と期間ごとのお支払い額。
loyalty_points	LoyaltyPoints アイテムの購入後にユーザーに付与されるポイント。日本国内のみの対応です。
loyalty_programs[]	LoyaltyProgram この商品のユーザーにポイント プログラムの特典（割引価格、ポイントなど）を表示するために使用されるポイント プログラム情報のリスト。
product_types[]	string 商品のカテゴリ（商品データ仕様の形式）。
sale_price	Price 商品アイテムの広告表示セール価格。
sale_price_effective_date	Interval 商品アイテムがセール対象になっている期間（商品データ仕様をご覧ください）。
product_height	ProductDimension 指定された単位で表した商品の高さ。値は 0 ～ 3,000 の範囲で指定してください。
product_length	ProductDimension 指定された単位での商品の長さ。値は 0 ～ 3,000 の範囲で指定してください。
product_width	ProductDimension 指定された単位で表した商品の幅。値は 0 ～ 3,000 の範囲で指定してください。
product_weight	ProductWeight 指定された単位で表した商品の重量。値は 0 ～ 2,000 の範囲で指定してください。
shipping[]	Shipping 配送ルール。
free_shipping_threshold[]	FreeShippingThreshold 商品が送料無料になるための条件。
shipping_weight	ShippingWeight 配送する商品の重量。
shipping_length	ShippingDimension 配送する商品の長さ。
shipping_width	ShippingDimension 配送する商品の幅。
shipping_height	ShippingDimension 梱包箱の高さ。
size_types[]	string 商品のカット。アパレル商品の組み合わせサイズタイプを表すために使用できます。指定できるサイズタイプは 2 つまでです（[https://support.google.com/merchants/answer/6324497](サイズタイプ) をご覧ください）。
taxes[]	Tax 税務情報。
unit_pricing_measure	UnitPricingMeasure 商品アイテムの容量や寸法。
unit_pricing_base_measure	UnitPricingBaseMeasure 単価の分母の設定。
ads_labels[]	string ads_grouping と類似していますが、クリック単価でのみ機能します。
cost_of_goods_sold	Price 売上原価。売上総利益のレポートに使用されます。
product_details[]	ProductDetail 技術仕様または商品の追加情報。
product_highlights[]	string 商品に関する最も関連性の高いハイライトを箇条書きで説明します。
display_ads_similar_ids[]	string 広告主様が指定した推奨事項。
promotion_ids[]	string プロモーションの一意の ID です。
included_destinations[]	string このターゲット向けに含める掲載先のリストです（Merchant Center でオンになっているチェックボックスに対応します）。デフォルトの掲載先は、excludedDestinations で指定しない限り、常に含まれます。
excluded_destinations[]	string このターゲットで除外する掲載先のリストです（Merchant Center でオフになっているチェックボックスに対応します）。
shopping_ads_excluded_countries[]	string ショッピング広告のデスティネーションから商品を除外する国コード（ISO 3166-1 alpha-2）のリスト。このリストに含まれる国は、データソースの設定で設定されている国から削除されます。
lifestyle_image_links[]	string 商品アイテムのライフスタイル画像の追加 URL。商品アイテムが実際の状況で使用されている場面が写っている画像を明示的に指定するために使用します。詳しくは、ヘルプセンターの記事をご覧ください。
cloud_export_additional_properties[]	CloudExportAdditionalProperties Cloud Retail プログラムにエクスポートする追加フィールド。
certifications[]	Certification 商品認証（EU EPREL データベースに登録されている商品の省エネラベルなど）。詳しくは、ヘルプセンターの記事をご覧ください。
auto_pricing_min_price	Price 「自動割引」（https://support.google.com/merchants/answer/10295759）プロジェクトと「動的プロモーション」（https://support.google.com/merchants/answer/13949249）プロジェクトの安全保護機能。販売者の商品の割引がこの値を下回らないようにし、商品の価値と収益性を維持します。
sustainability_incentives[]	ProductSustainabilityIncentive サステナビリティ インセンティブ プログラムのリスト。
identifier_exists	bool 商品アイテムに、カテゴリに適した固有商品 ID（GTIN、MPN、ブランドなど）がない場合は、この値を false に設定します。指定しない場合のデフォルトは true です。
is_bundle	bool 商品が販売者が定める一括販売かどうか。一括販売商品とは、販売者が単一の価格で販売するさまざまな商品のカスタム グループです。
title	string 商品アイテムの商品名。
description	string 項目の説明。
link	string オンライン ショップの商品アイテムのページに直接リンクする URL。
mobile_link	string 商品のランディング ページのモバイル向けの URL。
canonical_link	string 商品アイテムのランディング ページの正規バージョンの URL。
image_link	string 商品アイテムの画像の URL。
adult	bool 商品アイテムが成人向けの場合は true に設定します。
age_group	string 商品アイテムの対象年齢層。
availability	string 商品アイテムの在庫状況。
brand	string 商品アイテムのブランド。
color	string 商品アイテムの色。
condition	string 商品アイテムの状態。
gender	string 商品アイテムの対象層の性別。
google_product_category	string 商品アイテムの Google カテゴリ（Google の商品分類を参照）。商品をクエリすると、このフィールドにはユーザーが指定した値が含まれます。現在のところ、API を使用して自動割り当てされた Google 商品カテゴリを復元する方法はありません。
item_group_id	string 同一商品のすべてのバリエーションに共通の ID。
material	string 商品アイテムの素材。
mpn	string 商品アイテムの製造者が定める製品番号（MPN）。
pattern	string 商品アイテムのパターン（水玉模様など）。
sell_on_google_quantity	int64 Google で販売可能な商品の数量。オンライン商品でのみサポートされます。
max_handling_time	int64 商品の発送準備に要する最長時間（営業日数）。
min_handling_time	int64 商品の発送準備に必要な最短日数（営業日数）。
shipping_label	string 商品の送料ラベル。アカウント単位の送料ルールで商品をグループ化するために使用されます。
transit_time_label	string 商品のお届け日数ラベル。アカウント単位のお届け日数テーブルで商品をグループ化するために使用されます。
size	string 商品アイテムのサイズ。指定できる値は 1 つのみです。サイズが異なるバリエーションの場合は、サイズごとに別々の商品を挿入します。itemGroupId 値は同じにします（[https://support.google.com/merchants/answer/6324492](サイズの定義) をご覧ください）。
size_system	string サイズが指定されているシステム。アパレル商品に推奨されます。
tax_category	string 商品の税金カテゴリ。
energy_efficiency_class	string EU 指令 2010/30/EU で定義されている省エネ性能。
min_energy_efficiency_class	string EU 指令 2010/30/EU で定義されている省エネ性能。
max_energy_efficiency_class	string EU 指令 2010/30/EU で定義されている省エネ性能。
multipack	int64 販売者が定めるマルチパックに含まれる同一商品の数。
ads_grouping	string アイテムを任意の方法でグループ化するために使用します。CPA% にのみ使用し、それ以外の場合は使用しないことをおすすめします。
ads_redirect	string 商品が商品広告のコンテキスト内で表示されるときに、広告主が商品の URL をオーバーライドできるようにします。
display_ads_id	string 動的リマーケティング キャンペーン向けの商品アイテムの ID。
display_ads_title	string 動的リマーケティング キャンペーン向けの商品アイテムのタイトル。
display_ads_link	string 動的リマーケティング キャンペーン向けの商品アイテムのランディング ページに直接つながる URL。
display_ads_value	double 動的リマーケティング キャンペーン向けの商品アイテムの利幅。
pickup_method	string 商品アイテムの受け取りオプション。
pickup_sla	string 商品アイテムの店舗受け取りの用意ができるまでの期間。
link_template	string 販売者ホスト型店舗詳細ページのリンク テンプレート。
mobile_link_template	string モバイル デバイス向けに最適化された販売者ホスト型店舗詳細ページのリンク テンプレート。
custom_label_0	string ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 0。
custom_label_1	string ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 1。
custom_label_2	string ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 2。
custom_label_3	string ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 3。
custom_label_4	string ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 4。
external_seller_id	string 複数販売者アカウントには必須です。ショッピングモールの運営者で、さまざまな販売者の商品を複数販売業者アカウントにアップロードする場合は、この属性を使用します。
pause	string このアイテムの公開は一時的に停止されます。
virtual_model_link	string 商品アイテムの 3D 画像の URL。詳しくは、ヘルプセンターの記事をご覧ください。
structured_title	ProductStructuredTitle 構造化されたタイトル: アルゴリズム（AI）生成のタイトル用。
structured_description	ProductStructuredDescription 構造化された商品説明: アルゴリズム（AI）によって生成された商品説明。

認定資格

商品の認証。最初は、EU の EPREL データベースを使用して EU のエネルギー効率ラベルの要件を満たすために導入されました。

フィールド
certification_authority	string 認証局（例: European_Commission）。最大文字数は 2,000 文字です。
certification_name	string 認証の名称（「EPREL」など）。最大文字数は 2,000 文字です。
certification_code	string 認証コード。最大文字数は 2,000 文字です。
certification_value	string 認定値（クラス、レベル、グレードとも呼ばれます）（例: 「A+」、「C」、「ゴールド」）。最大文字数は 2,000 文字です。

CloudExportAdditionalProperties

Cloud Retail API の商品プロパティ。たとえば、テレビ商品のプロパティには「Screen-Resolution」や「Screen-Size」などがあります。

フィールド
text_value[]	string 指定されたプロパティのテキスト値。たとえば、テレビ商品のテキスト値は「8K（UHD）」などです。この値の最大繰り返し数は 400 です。値は任意の順序で保存されますが、一貫した順序で保存されます。文字列の最大サイズは 256 文字です。
int_value[]	int64 指定されたプロパティの整数値。たとえば、テレビ プロダクトの画面解像度の場合は 1080 です。この値の最大繰り返し数は 400 です。値は任意の一貫した順序で保存されます。
float_value[]	float 指定されたプロパティの浮動小数点値。たとえば、テレビ商品の場合は 1.2345 です。この値の最大繰り返し数は 400 です。値は任意の一貫した順序で保存されます。
property_name	string 指定されたプロパティの名前。たとえば、テレビ商品の場合は「Screen-Resolution」です。文字列の最大サイズは 256 文字です。
bool_value	bool 指定されたプロパティのブール値。たとえば、テレビ商品の場合、画面が UHD であれば「True」、そうでない場合は「False」です。
min_value	float 指定されたプロパティの最小浮動小数点値。たとえば、テレビ商品の場合は 1.00 です。
max_value	float 指定されたプロパティの最大浮動小数点値。たとえば、テレビ商品の場合は 100.00 です。
unit_code	string 指定されたプロパティの単位。たとえば、テレビ商品の場合は「Google Pixel」などです。文字列の最大サイズは 256 B です。

DeleteProductInputRequest

DeleteProductInput メソッドのリクエスト メッセージ。

フィールド
name	string 必須。削除する商品入力リソースの名前。形式: accounts/{account}/productInputs/{product}。最後のセクション product は、channel~content_language~feed_label~offer_id の 4 つの部分で構成されます。商品名の例は「accounts/123/productInputs/online~en~US~sku123」です。
data_source	string 必須。商品入力を削除するメイン データソースまたは補助データソース。形式: accounts/{account}/dataSources/{datasource}。

FreeShippingThreshold

商品が送料無料になるための条件。

フィールド
country	string 商品アイテムの発送先となる国の CLDR 地域コード。
price_threshold	Price 送料が無料になる商品の最低価格。数値で表されます。

GetProductRequest

GetProduct メソッドのリクエスト メッセージ。

フィールド
name	string 必須。取得する商品の名前。形式: accounts/{account}/products/{product}。最後のセクション product は、channel~content_language~feed_label~offer_id の 4 つの部分で構成されます。商品名の例は「accounts/123/products/online~en~US~sku123」です。

InsertProductInputRequest

InsertProductInput メソッドのリクエスト メッセージ。

フィールド
parent	string 必須。この商品を挿入するアカウント。形式: accounts/{account}
product_input	ProductInput 必須。挿入する商品の入力。
data_source	string 必須。メインまたは補助の商品データソース名。商品がすでに存在し、指定されたデータソースが異なる場合、その商品は新しいデータソースに移動されます。 API データソースのみがサポートされています。 形式: accounts/{account}/dataSources/{datasource}。

分割払い

分割払いを表すメッセージ。

フィールド
months	int64 購入代金の分割回数。
amount	Price 購入者が毎月支払う金額。
downpayment	Price 購入者が支払う必要がある頭金の金額。
credit_type	string 分割払いのタイプ。サポートされている値は次のとおりです。*「finance」*「lease」

ListProductsRequest

ListProducts メソッドのリクエスト メッセージ。

フィールド
parent	string 必須。処理済み商品を一覧表示するアカウント。形式: accounts/{account}
page_size	int32 返す商品の最大数。サービスが返す値はこれよりも少ないことがあります。最大値は 250 です。250 を超える値は 250 に強制変換されます。指定されていない場合は、商品の最大数が返されます。
page_token	string 前回の ListProducts 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。 ページ分割を行う場合、ListProducts に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

ListProductsResponse

ListProducts メソッドのレスポンス メッセージ。

フィールド
products[]	Product 指定したアカウントの処理済み商品。これらは、ルールと補助データソースを適用した後に処理された商品です。
next_page_token	string 次のページを取得するために page_token として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

LoyaltyPoints

ポイント プログラムのポイントを表すメッセージ。

フィールド
name	string ポイント プログラムの名前。名前は、全角 12 文字または半角 24 文字に制限することをおすすめします。
points_value	int64 販売店のポイントの絶対値。
ratio	double ポイントを金額に換算するときの率。Google は、Merchant Center の設定に基づいて通貨を判断します。比率を指定しない場合は、デフォルトで 1.0 になります。

LoyaltyProgram

ポイント プログラムを表すメッセージ。

フィールド
program_label	string ポイント プログラムのラベル。これは、販売者エンティティとポイント プログラム エンティティの関係を一意に識別する内部ラベルです。システムが以下のアセット（価格やポイントなど）を販売者に関連付けられるように、ラベルを指定する必要があります。対応するプログラムが販売者アカウントにリンクされている必要があります。
tier_label	string ポイント プログラム内のティアのラベル。プログラム内のラベルのいずれかに一致している必要があります。
price	Price 特定の階層のメンバー向けの料金（即時割引価格）。通常価格以下にする必要があります。
cashback_for_future_use	Price 今後の購入に使用できるキャッシュバック。
loyalty_points	int64 購入で獲得したポイント数。
member_price_effective_date	Interval 商品がメンバー価格の対象となる日付範囲。指定しない場合、メンバー料金が常に適用されます。期間は、スペース、カンマ、スラッシュで区切られた ISO 8601 の日付のペアで表されます。
shipping_label	string 配送特典のラベル。このフィールドに値が設定されている場合、この特典にはポイント プログラムの配送特典が適用されます。フィールド値が指定されていない場合、その商品は、指定されたポイント プログラムの階層のポイント プログラムの送料の対象外です。

プロダクト

ルールと補助データソースを適用した後、複数の product inputs から構築された処理済みプロダクト。この処理済み商品は、Merchant Center アカウント、ショッピング広告、Google 掲載などの Google サービスに表示される商品と一致しています。各商品は、メインの商品データソースの入力と複数の補助データソースの入力から作成されます。商品入力を挿入、更新、削除した後、更新された処理済み商品を取得できるようになるまでに数分かかることがあります。

処理された商品とそのサブメッセージのすべてのフィールドは、商品データ仕様の対応する属性の名前と一致します（一部の例外を除く）。

フィールド
name	string 商品の名前。形式: "{product.name=accounts/{account}/products/{product}}"。最後のセクション product は、channel~content_language~feed_label~offer_id の 4 つの部分で構成されます。商品名の例は「accounts/123/products/online~en~US~sku123」です。
channel	ChannelEnum 出力専用。商品のチャネル。
offer_id	string 出力専用。商品の一意の識別子。これは、製品の入力と加工後の製品で同じです。送信時に、先頭と末尾の空白文字は削除され、複数の空白文字は 1 つの空白文字に置き換えられます。詳しくは、商品データ仕様をご覧ください。
content_language	string 出力専用。商品の 2 文字の ISO 639-1 言語コード。
feed_label	string 出力専用。商品のフィードラベル。
data_source	string 出力専用。商品のメイン データソース。
attributes	Attributes 出力専用。商品属性のリスト。
custom_attributes[]	CustomAttribute 出力専用。カスタム（販売者提供）属性のリスト。また、データ仕様の任意の属性を汎用形式（{ "name": "size type", "value": "regular" } など）で登録することもできます。これは、「Google で購入」で使用される追加属性など、API で明示的に公開されていない属性を登録する場合に便利です。
product_status	ProductStatus 出力専用。商品のステータス、データ検証の問題など、非同期で計算された商品に関する情報。
version_number	int64 出力専用。商品の既存のバージョン（新しさ）を表します。複数の更新が同時に行われたときに正しい順序を維持するために使用できます。 設定すると、バージョン番号が既存の商品の現在のバージョン番号より低い場合、挿入がブロックされます。再挿入（30 日後の商品の更新など）は、現在の version_number で実行できます。 プライマリ データソースへの挿入でのみサポートされます。 オペレーションが防止された場合、中断された例外がスローされます。

ProductDetail

商品の詳細。

フィールド
section_name	string 商品の詳細セットをグループ化するために使用されるセクション ヘッダー。
attribute_name	string 商品の詳細の名前。
attribute_value	string 商品の詳細の値。

ProductDimension

商品の寸法。

フィールド
value	double 必須。数値で表したディメンション値。値の小数点以下の桁数は最大 4 桁です。
unit	string 必須。ディメンションの単位。有効な値は次のとおりです。*「in」*「cm」

ProductInput

このリソースは、商品に対して送信する入力データであり、Merchant Center、ショッピング広告、Google 掲載に表示される処理済み商品ではありません。商品入力、ルール、補助データソースのデータが統合され、処理された Product が作成されます。

データ検証チェックに合格するために必要な商品入力属性は、主に商品データ仕様で定義されています。

必須属性は feedLabel、contentLanguage、offerId です。

商品入力を挿入、更新、削除した後、処理された商品を取得できるようになるまでに数分かかることがあります。

商品入力とそのサブメッセージのすべてのフィールドは、一部の例外を除き、カテゴリ仕様内の対応する属性の英語名と一致します。

フィールド
name	string ID。商品入力の名前。形式: "{productinput.name=accounts/{account}/productInputs/{productinput}}"。最後のセクション productinput は、channel~content_language~feed_label~offer_id の 4 つの部分で構成されます。商品入力名の例は「accounts/123/productInputs/online~en~US~sku123」です。
product	string 出力専用。処理された商品の名前。形式: "{product.name=accounts/{account}/products/{product}}"
channel	ChannelEnum 変更不可。商品のチャネル。
offer_id	string 必須。変更不可。商品の一意の識別子。これは、製品の入力と加工後の製品で同じです。送信時に、先頭と末尾の空白文字は削除され、複数の空白文字は 1 つの空白文字に置き換えられます。詳しくは、商品データ仕様をご覧ください。
content_language	string 必須。変更不可。商品の 2 文字の ISO 639-1 言語コード。
feed_label	string 必須。変更不可。商品のフィードラベル。
attributes	Attributes 省略可。商品属性のリスト。
custom_attributes[]	CustomAttribute 省略可。カスタム（販売者提供）属性のリスト。また、データ仕様の任意の属性を汎用形式（{ "name": "size type", "value": "regular" } など）で登録する場合にも使用できます。これは、「Google で購入」で使用される追加属性など、API で明示的に公開されていない属性を登録する場合に便利です。各カスタム属性の最大許容文字数は 10,240 文字です（名前と値の文字数の合計）。1 つの商品に設定できるカスタム属性は最大 2, 500 個で、合計サイズは 102.4 KB です。カスタム属性名のアンダースコアは、挿入時にスペースに置き換えられます。
version_number	int64 省略可。商品の既存のバージョン（新しさ）を表します。複数の更新が同時に行われたときに正しい順序を維持するために使用できます。 設定すると、バージョン番号が既存の商品の現在のバージョン番号より低い場合、挿入がブロックされます。再挿入（30 日後の商品の更新など）は、現在の version_number で実行できます。 プライマリ データソースへの挿入でのみサポートされます。 オペレーションが防止された場合、中断された例外がスローされます。

ProductStatus

商品のステータス、データ検証の問題など、非同期で計算された商品に関する情報。

フィールド
destination_statuses[]	DestinationStatus 商品アイテムの宛先。
item_level_issues[]	ItemLevelIssue 商品に関連するすべての問題のリスト。
creation_date	Timestamp アイテムが作成された日付（ISO 8601 形式）。
last_update_date	Timestamp アイテムが最後に更新された日付（ISO 8601 形式）。
google_expiration_date	Timestamp アイテムの有効期限の日付（ISO 8601 形式）。

DestinationStatus

商品ステータスの宛先ステータス。

フィールド
reporting_context	ReportingContextEnum レポート コンテキストの名前。
approved_countries[]	string クーポンが承認されている国コード（ISO 3166-1 alpha-2）のリスト。
pending_countries[]	string クーポンの承認が保留中の国コード（ISO 3166-1 alpha-2）のリスト。
disapproved_countries[]	string クーポンが不承認の国コード（ISO 3166-1 alpha-2）のリスト。

ItemLevelIssue

商品ステータスの ItemLevelIssue。

フィールド
code	string 問題のエラーコード。
severity	Severity この問題によるサービスへの影響。
resolution	string 販売者側で問題が解決可能かどうか。
attribute	string 属性名（問題の原因が単一属性の場合）。
reporting_context	ReportingContextEnum 問題が適用されるレポート コンテキスト。
description	string 問題の簡単な説明（英語）。
detail	string 問題の詳しい説明（英語）。
documentation	string この問題の解決に役立つウェブページの URL。
applicable_countries[]	string 問題が商品に適用される国コード（ISO 3166-1 alpha-2）のリスト。

重大度

この問題が商品の掲載にどのように影響するか。

列挙型
SEVERITY_UNSPECIFIED	指定されていません。
NOT_IMPACTED	この問題は警告であり、プロダクトには直接影響しません。
DEMOTED	商品が降格され、検索結果でのパフォーマンスが制限されている可能性が高い
DISAPPROVED	問題により商品が不承認となる。

ProductStructuredDescription

構造化された商品説明: アルゴリズム（AI）によって生成された商品説明。

フィールド
digital_source_type	string デジタル ソースの種類（「trained_algorithmic_media」など）。IPTC に準拠しています。最大文字数は 40 文字です。
content	string 説明テキストの最大文字数は 5,000 文字です

ProductStructuredTitle

構造化されたタイトル: アルゴリズム（AI）生成のタイトル用。

フィールド
digital_source_type	string デジタル ソースの種類（「trained_algorithmic_media」など）。IPTC に準拠しています。最大文字数は 40 文字です。
content	string タイトル テキストの最大文字数は 150 文字です

ProductSustainabilityIncentive

リベートや税制優遇など、持続可能性に関連するインセンティブ プログラムに関する情報。

フィールド
共用体フィールド value。サステナビリティ インセンティブの値。value は次のいずれかになります。
amount	Price インセンティブの固定額。
percentage	double インセンティブが適用されるセール価格の割合。
type	Type サステナビリティ インセンティブ プログラム。

タイプ

サポートされているサステナビリティ インセンティブ プログラムの種類。

列挙型
TYPE_UNSPECIFIED	持続可能性インセンティブの種類が指定されていないか不明である。
EV_TAX_CREDIT	電気自動車、一部の国ではプラグイン ハイブリッド車の税負担を軽減するプログラム。これらの割引は、特定の金額または販売価格の割合に基づいて設定できます。
EV_PRICE_DISCOUNT	環境ボーナスと呼ばれる補助金制度では、電気自動車の購入に対して補助金が支給されます。一部の国では、プラグイン ハイブリッド車にも補助金が支給されます。助成金の金額は、固定額または販売価格の割合にすることができます。

ProductWeight

商品の重量。

フィールド
value	double 必須。数値で表した重み。重み付けの精度は小数点以下 4 桁までです。
unit	string 必須。重量の単位。有効な値は次のとおりです。*「g」*「kg」*「oz」*「lb」

送料

商品の発送。

フィールド
price	Price 固定の送料価格（数値で指定）。
country	string 商品アイテムの発送先となる国の CLDR 地域コード。
region	string 送料が適用される地域。詳細については、region をご覧ください。
service	string サービスクラスまたは配送所要日数の自由形式の説明。
location_id	int64 AdWords API で定義されている、送料が適用される地域の数値 ID。
location_group_name	string 配送が適用される地域（地域グループ名で表されます）。
postal_code	string 送料が適用される郵便番号の範囲。郵便番号、郵便番号の接頭辞とワイルドカード（*）、2 つの郵便番号の範囲、または長さが同じ 2 つの郵便番号の接頭辞で表されます。
min_handling_time	int64 注文を受けてから発送するまでの最短発送準備時間（営業日数）。0 は、受付終了時間より前に注文を受けた場合、注文がその日のうちに発送されることを意味します。minHandlingTime は maxHandlingTime とともにのみ存在できますが、maxHandlingTime が存在する場合は必須ではありません。
max_handling_time	int64 注文の受領から発送までの最長発送準備時間（営業日数）。0 は、受付終了時間より前に注文を受けた場合、注文がその日のうちに発送されることを意味します。配送時間の指定が必要な場合は、maxHandlingTime と maxTransitTime の両方が必要です。maxHandlingTime が存在する場合、minHandlingTime は省略可能です。
min_transit_time	int64 注文の発送から配達までの最短お届け日数（営業日数）。0 は、注文が発送された当日に配達されることを意味します。minTransitTime は maxTransitTime とともにのみ存在できますが、maxTransitTime が存在する場合は必須ではありません。
max_transit_time	int64 注文の発送から配達までの最長お届け日数（営業日数）。0 は、注文が発送された当日に配達されることを意味します。配送日数を指定する場合は、maxHandlingTime と maxTransitTime の両方が必要です。maxTransitTime が存在する場合、minTransitTime は省略可能です。

ShippingDimension

商品の ShippingDimension。

フィールド
value	double 商品の送料の計算に使用する商品の寸法。
unit	string 値の単位。

ShippingWeight

商品の ShippingWeight。

フィールド
value	double 商品の送料の計算に使用する商品の重量。
unit	string 値の単位。

SubscriptionCost

商品の SubscriptionCost。

フィールド
period	SubscriptionPeriod サブスクリプション期間のタイプ。サポートされている値は次のとおりです。*「month」*「year」
period_length	int64 購入者が支払う定期購入の期間。
amount	Price 購入者が定期購入期間ごとに支払う金額。

SubscriptionPeriod

商品の定期購入期間。

列挙型
SUBSCRIPTION_PERIOD_UNSPECIFIED	サブスクリプション期間が指定されていないことを示します。
MONTH	サブスクリプション期間が月であることを示します。
YEAR	定期購入の期間が年であることを示します。

税金

商品の税金。

フィールド
rate	double 商品価格に適用される税率の割合。
country	string 商品に課税される国。CLDR 地域コードで指定します。
region	string 税率が適用される地域。
tax_ship	bool 送料に税金が課される場合は true に設定します。
location_id	int64 AdWords API で定義されている、税率が適用される地域の数値 ID。
postal_code	string 税率が適用される郵便番号の範囲。郵便番号、* ワイルドカードを使用した郵便番号の接頭辞、2 つの郵便番号の範囲、または長さが同じ 2 つの郵便番号の接頭辞で表します。例: 94114、94*、94002-95460、94*-95*。

UnitPricingBaseMeasure

商品の UnitPricingBaseMeasure。

フィールド
value	int64 単価の分母。
unit	string 分母の単位。

UnitPricingMeasure

商品の UnitPricingMeasure。

フィールド
value	double 商品アイテムの測定値。
unit	string 測定単位。