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

Method: accounts.productInputs.insert

HTTP リクエスト
パスパラメータ
クエリパラメータ
リクエストの本文
レスポンスの本文
- JSON 表現
認可スコープ

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

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

HTTP リクエスト

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ

パラメータ
`parent`	`string` 必須。この商品が挿入されるアカウント。形式: accounts/{account}

parent

string

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

クエリパラメータ

パラメータ

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

dataSource

string

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

リクエスト本文

リクエストの本文には 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]。

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

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

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現

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

{
  "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}}"`
`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 文字（名前と値の文字数の合計）です。商品ごとに最大 2, 500 個のカスタム属性を設定できます。合計サイズは 102.4 KB です。カスタム属性名のアンダースコアは、挿入時にスペースに置き換えられます。
`versionNumber`	`string (int64 format)` 省略可。商品の既存のバージョン（新しさ）を表します。複数の更新が同時に行われたときに正しい順序を保持するために使用できます。設定すると、バージョン番号が既存のプロダクトの現在のバージョン番号よりも小さい場合、挿入できなくなります。再挿入（30 日後に商品を更新するなど）は、現在の `versionNumber` で実行できます。メインデータソースへの挿入でのみサポートされます。オペレーションが阻止されると、中止された例外がスローされます。

認可スコープ

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

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

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