Method: accounts.productInputs.insert

將產品輸入資料上傳至 Merchant Center 帳戶。如果已有具有相同 contentLanguage、offerId 和 dataSource 的輸入內容，這個方法會取代該項目。

插入、更新或刪除產品輸入內容後，系統可能需要幾分鐘才能擷取已處理的產品。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。要插入這項產品的帳戶。格式：accounts/{account}

查詢參數

參數
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 表示法 
{
  "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

必要欄位。不可變動。產品的專屬 ID。這也適用於產品輸入和已處理的產品。系統會移除開頭和結尾的空白字元，提交時則會以一個空白字元取代多個空白字元。詳情請參閱產品資料規格。
contentLanguage

string

必要欄位。不可變動。以兩個字母表示產品的 ISO 639-1 語言代碼。
feedLabel

string

必要欄位。不可變動。產品的動態饋給標籤。
attributes

object (Attributes)

選用設定。產品屬性清單。
customAttributes[]

object (CustomAttribute)

選用設定。自訂 (商家提供) 屬性的清單。這個功能也可用於以一般格式 (例如 { "name": "size type", "value": "regular" }) 提交資料規格的任何屬性。如要提交 API 未明確公開的屬性 (例如用於 Buy on Google 的其他屬性)，這項功能就能派上用場。每個自訂屬性的字元數上限為 10240 個 (代表名稱和值的字元總和)。每項產品最多可以設定 2500 個自訂屬性，總大小為 102.4 kB。插入自訂屬性名稱時，底線會替換成空格。
versionNumber

string (int64 format)

選用設定。代表產品的現有版本 (新推出)，可在同時進行多項更新時保留正確的順序。

如果設定，當版本號碼低於現有產品的目前版本號碼時，系統就不會插入。使用目前的versionNumber重新插入功能 (例如，30 天後更新產品)。

這項功能僅支援插入主要資料來源。

如果作業失敗，系統會擲回取消的例外狀況。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。