Merchant Center アカウントに商品情報をアップロードします。同じ contentLanguage、offerId、dataSource を持つ入力がすでに存在する場合、このメソッドはそのエントリを置き換えます。
商品入力を挿入、更新、削除した後、処理された商品を取得できるようになるまでに数分かかることがあります。
HTTP リクエスト
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
必須。この商品が挿入されるアカウント。形式: accounts/{account} |
クエリ パラメータ
パラメータ | |
---|---|
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 表現 |
---|
{ "name": string, "product": string, "channel": enum ( |
フィールド | |
---|---|
name |
ID。商品入力の名前。形式: |
product |
出力専用。処理された商品の名前。形式: |
channel |
必須。変更不可。商品のチャネル。 |
offerId |
必須。変更不可。商品の一意の識別子です。商品入力と処理済み商品についても同様です。送信時に先頭と末尾の空白文字は削除され、複数の空白文字は 1 つの空白文字に置き換えられます。詳しくは、商品データ仕様をご覧ください。 |
contentLanguage |
必須。変更不可。商品の 2 文字の ISO 639-1 言語コード。 |
feedLabel |
必須。変更不可。商品のフィードラベル。 |
attributes |
省略可。商品属性のリスト。 |
customAttributes[] |
省略可。カスタム(販売者指定)属性のリスト。また、データ仕様の任意の属性を一般形式で登録するためにも使用できます(例: |
versionNumber |
省略可。商品の既存のバージョン(新鮮さ)を表します。複数の更新が同時に行われたときに正しい順序を保持するために使用できます。 設定すると、バージョン番号が既存のプロダクトの現在のバージョン番号よりも小さい場合、挿入できなくなります。再挿入(30 日後に商品を更新するなど)は、現在の メイン データソースへの挿入でのみサポートされます。 オペレーションが阻止されると、中止された例外がスローされます。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/content
詳しくは、OAuth 2.0 の概要をご覧ください。