REST Resource: accounts.productInputs

リソース: ProductInput

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

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

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

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

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

JSON 表現 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
フィールド
name

string

ID。商品入力の名前。形式: "{productinput.name=accounts/{account}/productInputs/{productinput}}"。最後のセクション productinput は、channel~contentLanguage~feedLabel~offerId の 4 つの部分で構成されます。商品入力名の例は「accounts/123/productInputs/online~en~US~sku123」です。
product

string

出力専用。処理されたプロダクトの名前。形式: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

必須。変更不可。商品のチャネル。
offerId

string

必須。変更不可。商品の一意の識別子。これは、製品の入力と加工後の製品で同じです。送信時に、先頭と末尾の空白文字が削除され、複数の空白文字は 1 つの空白文字に置き換えられます。詳しくは、商品データ仕様をご覧ください。
contentLanguage

string

必須。変更不可。商品の 2 文字の ISO 639-1 言語コード。
feedLabel

string

必須。変更不可。商品のフィードラベル。
attributes

object (Attributes)

省略可。商品属性のリスト。
customAttributes[]

object (CustomAttribute)

省略可。カスタム（販売者提供）属性のリスト。また、データ仕様の任意の属性を汎用形式（{ "name": "size type", "value": "regular" } など）で登録する場合にも使用できます。これは、「Google で購入」で使用される追加属性など、API で明示的に公開されていない属性を登録する場合に便利です。各カスタム属性の最大許容文字数は 10,240 文字です（名前と値の文字数の合計）。1 つの商品に設定できるカスタム属性は最大 2, 500 個で、合計サイズは 102.4 KB です。カスタム属性名のアンダースコアは、挿入時にスペースに置き換えられます。
versionNumber

string (int64 format)

省略可。商品の既存のバージョン（新しさ）を表します。複数の更新が同時に行われたときに正しい順序を維持するために使用できます。

設定すると、バージョン番号が既存の商品の現在のバージョン番号より小さい場合、挿入がブロックされます。再挿入（30 日後の商品の更新など）は、現在の versionNumber で実行できます。

プライマリ データソースへの挿入でのみサポートされます。

オペレーションが防止された場合、中断された例外がスローされます。

メソッド

delete

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

insert

 商品入力を Merchant Center アカウントにアップロードします。