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 包含 4 個部分：channel~contentLanguage~feedLabel~offerId。產品輸入名稱的範例為「accounts/123/productInputs/online~en~US~sku123」。
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 天後重新發布產品)。

僅支援插入主要資料來源。

如果作業遭到阻止，系統會擲回中止例外狀況。

方法

delete

 從 Merchant Center 帳戶中刪除產品輸入內容。

insert

 將產品輸入內容上傳至 Merchant Center 帳戶。