このページは Cloud Translation API によって翻訳されました。

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（メッセージ）
ProductWeight（メッセージ）
Shipping（メッセージ）
ShippingDimension（メッセージ）
ShippingWeight（メッセージ）
SubscriptionCost（メッセージ）
SubscriptionPeriod（列挙型）
Tax（メッセージ）
UnitPricingBaseMeasure（メッセージ）
UnitPricingMeasure（メッセージ）

ProductInputsService

ProductInput リソースを使用するサービス。このサービスは、オンラインチャネルを持つ商品のみが対象となります。

DeleteProductInput

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

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Merchant Center アカウントから商品入力を削除します。

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

認可スコープ

次の OAuth スコープが必要です。

https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。

InsertProductInput

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

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Merchant Center アカウントに商品情報をアップロードします。同じ contentLanguage、offerId、dataSource を持つ入力がすでに存在する場合、このメソッドはそのエントリを置き換えます。

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

認可スコープ

次の OAuth スコープが必要です。

https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。

ProductsService

Product リソースを使用するサービス。このサービスは、オンラインチャネルを持つ商品のみが対象となります。

GetProduct

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

rpc GetProduct(GetProductRequest) returns (Product)

処理された商品を Merchant Center アカウントから取得します。

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

認可スコープ

次の OAuth スコープが必要です。

https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。

ListProducts

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

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Merchant Center アカウントにある処理済みの商品が一覧表示されます。レスポンスに含まれるアイテムが pageSize で指定された数よりも少ない場合があります。pageToken を使用して、他にもリクエストする項目があるかどうかを確認します。

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

認可スコープ

次の OAuth スコープが必要です。

https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。

属性

属性。

フィールド
`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 形式）。
`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（0 を除く）～ 3000（両端を含む）の範囲で指定してください。
`product_length`	`ProductDimension` 商品の長さ（単位: 単位）。値は 0（0 を除く）～ 3000（両端を含む）の範囲で指定してください。
`product_width`	`ProductDimension` 指定された単位での商品の幅。値は 0（0 を除く）～ 3000（両端を含む）の範囲で指定してください。
`product_weight`	`ProductWeight` 商品の重量（指定された単位）。値は 0（0 を除く）～ 2000（両端を含む）の範囲で指定してください。
`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](size type) をご覧ください）。
`taxes[]`	`Tax` 税務情報。
`unit_pricing_measure`	`UnitPricingMeasure` アイテムの計量単位と寸法。
`unit_pricing_base_measure`	`UnitPricingBaseMeasure` 単価の分母の設定。
`ads_labels[]`	`string` ads_grouping と似ていますが、CPC に対してのみ機能します。
`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）プロジェクトにおける安全保護対策。販売者の商品の割引がこの値を下回らないようにすることで、商品の価値と収益性を維持します。
`identifier_exists`	`bool` GTIN、MPN、ブランドなど、カテゴリに適した固有商品 ID が商品アイテムにない場合、この値を 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 の商品分類をご覧ください）。商品をクエリする場合、このフィールドにはユーザーが指定した値が含まれます。現時点では、自動的に割り当てられた Google 商品カテゴリを API を使用して復元する方法はありません。
`gtin`	`string` 商品アイテムの国際取引商品番号（GTIN）。
`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` アイテムを任意の方法でグループ化するために使用します。割合によるコンバージョン単価でのみ使用します。それ以外の場合は使用しないでください。
`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` 指定されたプロパティの単位。たとえば、テレビ商品の場合は「Pixels」となります。文字列の最大サイズは 256 バイトです。

DeleteProductInputRequest

DeleteProductInput メソッドに対するリクエストメッセージ。

フィールド

フィールド
`name`	`string` 必須。削除する商品入力リソースの名前。形式: accounts/{account}/productInputs/{product}
`data_source`	`string` 必須。商品入力を削除するメインデータソースまたは補助データソース。形式: `accounts/{account}/dataSources/{datasource}`

name

string

必須。削除する商品入力リソースの名前。形式: accounts/{account}/productInputs/{product}

data_source

string

必須。商品入力を削除するメインデータソースまたは補助データソース。形式: accounts/{account}/dataSources/{datasource}

FreeShippingThreshold

商品が送料無料の対象となる条件です。

フィールド

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

country

string

商品アイテムの配送先国の CLDR 地域コード。

price_threshold

Price

送料が無料になる最低商品価格。数値で表されます。

GetProductRequest

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

フィールド

フィールド
`name`	`string` 必須。取得する商品の名前。形式: `accounts/{account}/products/{product}`

name

string

必須。取得する商品の名前。形式: accounts/{account}/products/{product}

InsertProductInputRequest

InsertProductInput メソッドに対するリクエストメッセージ。

フィールド

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

parent

string

必須。この商品が挿入されるアカウント。形式: accounts/{account}

product_input

ProductInput

必須。挿入する商品入力。

data_source

string

必須。メインまたは補助の商品データソースの名前。商品がすでに存在し、指定されたデータソースが異なる場合、商品は新しいデータソースに移動されます。形式: accounts/{account}/dataSources/{datasource}

分割払い

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

フィールド
`months`	`int64` 購入代金の分割回数です。
`amount`	`Price` 購入者が毎月支払う金額。
`downpayment`	`Price` 購入者が支払う前払い金額の金額。
`credit_type`	`string` 分割払いの種類。サポートされている値: * "`finance`" * "`lease`"

ListProductsRequest

ListProducts メソッドに対するリクエストメッセージ。

フィールド

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

parent

string

必須。処理された商品を一覧表示するアカウント。形式: accounts/{account}

page_size

int32

返される商品の最大数。サービスが返す値はこれよりも少ないことがあります。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。指定しない場合は、商品の最大数が返されます。

page_token

string

前回の ListProducts 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、ListProducts に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

ListProductsResponse

ListProducts メソッドに対するレスポンスメッセージ。

フィールド

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

products[]

Product

指定したアカウントの処理済み商品。これらは、ルールと補助データソースの適用後に処理された商品です。

next_page_token

string

次のページを取得するために page_token として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

LoyaltyPoints

ポイントを表すメッセージ。

フィールド

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

name

string

ポイントプログラムの名前。名前は全角 12 文字またはローマ字 24 文字までにすることをおすすめします。

points_value

int64

販売店のポイント（絶対値）。

ratio

double

ポイントを金額に換算するときの率。通貨は Merchant Center の設定に基づきます。比率を指定しないと、デフォルトの 1.0 になります。

LoyaltyProgram

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

フィールド
`program_label`	`string` ポイントプログラムのラベル。これは、販売者のエンティティとポイントプログラムエンティティの関係を一意に識別する内部ラベルです。ラベルは、システムが以下のアセット（価格、ポイントなど）を販売者に関連付けるために指定する必要があります。対応するプログラムが販売アカウントにリンクされている必要があります。
`tier_label`	`string` ポイントプログラム内のレベルのラベル。プログラム内のラベルのいずれかと一致する必要があります。
`price`	`Price` 特定の階層のメンバーの料金（インスタント割引料金）。通常価格以下の値を指定してください。
`cashback_for_future_use`	`Price` 今後の購入に使用できるキャッシュバック。
`loyalty_points`	`int64` 購入で獲得したポイント数。

製品

ルールと補助データソースを適用した後、複数の [product input][[google.shopping.content.bundles.Products.ProductInput] から構築された処理済みの商品。処理された商品は、Merchant Center アカウント、ショッピング広告、その他の Google 掲載に表示される商品と一致します。各プロダクトは、1 つのプライマリデータソースプロダクト入力と、複数の補助データソース入力から構築されています。商品入力を挿入、更新、または削除した後、更新された処理済みの商品を取得できるようになるまでに数分かかることがあります。

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

フィールド
`name`	`string` 商品の名前。形式: `"{product.name=accounts/{account}/products/{product}}"`
`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` 商品の詳細の値。

section_name

string

一連の商品の詳細をグループ化するために使用するセクションヘッダー。

attribute_name

string

商品の詳細の名前。

attribute_value

string

商品の詳細の値。

ProductDimension

商品の寸法。

フィールド

フィールド
`value`	`double` 必須。数値で表されるディメンション値。値の最大精度は小数点以下 4 桁です。
`unit`	`string` 必須。ディメンションの単位。有効な値: * "`in`" * "`cm`"

value

double

必須。数値で表されるディメンション値。値の最大精度は小数点以下 4 桁です。

unit

string

必須。ディメンションの単位。有効な値: * "in" * "cm"

ProductInput

このリソースは、Merchant Center、ショッピング広告、または Google サービスに表示される処理済み商品ではなく、商品に登録した入力データを表します。商品入力、ルール、補助データソースデータを組み合わせて処理済みの [product][google.shopping.content.bundles.Products.Product] を作成します。

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

次の属性は必須です: [feedLabel][google.shopping.content.bundles.Products.feed_label]、[contentLanguage][google.shopping.content.bundles.Products.content_language]、および [offerId][google.shopping.content.bundles.Products.offer_id]。

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

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

フィールド
`name`	`string` ID。商品入力の名前。形式: `"{productinput.name=accounts/{account}/productInputs/{productinput}}"`
`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 文字（名前と値の文字数の合計）です。商品ごとに最大 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` 属性の名前（問題の原因が 1 つの属性の場合）。
`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 文字です

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 文字です

digital_source_type

string

デジタルソースのタイプ（例: 「trained_algorithmic_media」）。IPTC に準拠している。最大文字数は 40 文字です。

content

string

タイトルテキストの最大文字数は 150 文字です

ProductWeight

商品の重量。

フィールド

フィールド
`value`	`double` 必須。数値で表される重み。重みの最大精度は小数点以下 4 桁です。
`unit`	`string` 必須。重量の単位。指定できる値は次のとおりです。* "`g`" * "`kg`" * "`oz`" * "`lb`"

value

double

必須。数値で表される重み。重みの最大精度は小数点以下 4 桁です。

unit

string

必須。重量の単位。指定できる値は次のとおりです。* "g" * "kg" * "oz" * "lb"

配送

商品の送料。

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

ShippingDimension

商品の ShippingDimension。

フィールド

フィールド
`value`	`double` 商品アイテムの送料を計算するために使用される商品の寸法。
`unit`	`string` 値の単位。

value

double

商品アイテムの送料を計算するために使用される商品の寸法。

unit

string

値の単位。

ShippingWeight

商品の ShippingWeight です。

フィールド

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

value

double

商品アイテムの送料の計算に使用する商品の重量。

unit

string

値の単位。

SubscriptionCost

商品の SubscriptionCost。

フィールド

フィールド
`period`	`SubscriptionPeriod` 定期購入の期間のタイプ。サポートされている値: * "`month`" * "`year`"
`period_length`	`int64` 購入者が支払う定期購入の期間数。
`amount`	`Price` 定期購入の期間ごとに購入者が支払う金額。

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` 分母の単位。

value

int64

単価の分母。

unit

string

分母の単位。

UnitPricingMeasure

商品の UnitPricingMeasure。

フィールド

フィールド
`value`	`double` 商品アイテムの計量単位。
`unit`	`string` 単位。

value

double

商品アイテムの計量単位。

unit

string

単位。