將產品輸入資料上傳至 Merchant Center 帳戶。如果已有具有相同 contentLanguage、offerId 和 dataSource 的輸入內容,這個方法會取代該項目。
插入、更新或刪除產品輸入內容後,系統可能需要幾分鐘才能擷取已處理的產品。
HTTP 要求
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
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 |
必要欄位。不可變動。產品的專屬 ID。這也適用於產品輸入和已處理的產品。系統會移除開頭和結尾的空白字元,提交時則會以一個空白字元取代多個空白字元。詳情請參閱產品資料規格。 |
contentLanguage |
必要欄位。不可變動。以兩個字母表示產品的 ISO 639-1 語言代碼。 |
feedLabel |
必要欄位。不可變動。產品的動態饋給標籤。 |
attributes |
選用設定。產品屬性清單。 |
customAttributes[] |
選用設定。自訂 (商家提供) 屬性的清單。這個過程也可用於以一般格式提交資料規格的任何屬性,例如 |
versionNumber |
選用設定。代表產品的現有版本 (新推出),可在同時進行多項更新時保留正確的順序。 如果設定,當版本號碼低於現有產品的目前版本號碼時,系統就不會插入。使用目前的 這項功能僅支援插入主要資料來源。 如果作業失敗,系統會擲回取消的例外狀況。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/content
詳情請參閱 OAuth 2.0 總覽。