REST Resource: accounts.products

資源：產品

處理後的產品，在套用規則和補充資料來源後，由多個 product inputs 建構而成。這個經過處理的產品會與 Merchant Center 帳戶、購物廣告和 Google 跨平台顯示的產品資訊相符。每項產品都會使用單一主要資料來源產品輸入內容和多個補充資料來源輸入內容建構。插入、更新或刪除產品輸入內容後，可能需要幾分鐘的時間才能擷取更新後的處理產品。

經處理的產品及其子訊息中的所有欄位，都與產品資料規格中相應屬性的名稱相符 (但有部分例外狀況)。

JSON 表示法 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
欄位
name

string

產品名稱。格式："{product.name=accounts/{account}/products/{product}}"，其中最後一個部分 product 包含 4 個部分：channel~contentLanguage~feedLabel~offerId，產品名稱範例為「accounts/123/products/online~en~US~sku123」
channel

enum (ChannelEnum)

僅供輸出。產品的通路。
offerId

string

僅供輸出。產品的專屬 ID。產品輸入內容和經過處理的產品皆是如此。系統會移除開頭和結尾的空白字元，並在提交時將多個空白字元替換為單一空白字元。詳情請參閱產品資料規格。
contentLanguage

string

僅供輸出。產品的雙字母 ISO 639-1 語言代碼。
feedLabel

string

僅供輸出。產品的動態饋給標籤。
dataSource

string

僅供輸出。產品的主要資料來源。
attributes

object (Attributes)

僅供輸出。產品屬性清單。
customAttributes[]

object (CustomAttribute)

僅供輸出。自訂 (商家提供) 屬性清單。也可以用來以通用格式 (例如 { "name": "size type", "value": "regular" }) 提交資料規格中的任何屬性。這對於提交 API 未明確公開的屬性 (例如用於 Buy on Google 的額外屬性) 很有幫助。
productStatus

object (ProductStatus)

僅供輸出。產品狀態、資料驗證問題，也就是以非同步方式計算的產品相關資訊。
versionNumber

string (int64 format)

僅供輸出。代表產品的現有版本 (新鮮度)，可用於在同時進行多項更新時，保留正確的順序。

如果已設定，當版本編號低於現有產品的目前版本編號時，就會防止插入。您可以使用目前的 versionNumber 執行重新插入作業 (例如在 30 天後重新發布產品)。

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

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

ProductStatus

產品狀態、資料驗證問題，也就是以非同步方式計算的產品相關資訊。

JSON 表示法 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
欄位
destinationStatuses[]

object (DestinationStatus)

產品的預定目的地。
itemLevelIssues[]

object (ItemLevelIssue)

與產品相關的所有問題清單。
creationDate

string (Timestamp format)

項目建立日期，採用 ISO 8601 格式。
lastUpdateDate

string (Timestamp format)

項目上次更新的日期，採用 ISO 8601 格式。
googleExpirationDate

string (Timestamp format)

項目到期日，採用 ISO 8601 格式。

DestinationStatus

產品狀態的目的狀態。

JSON 表示法 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
欄位
reportingContext

enum (ReportingContextEnum)

報表內容名稱。
approvedCountries[]

string

已核准商品的國家/地區代碼清單 (ISO 3166-1 alpha-2)。
pendingCountries[]

string

待核准商品適用的國家/地區代碼清單 (ISO 3166-1 alpha-2)。
disapprovedCountries[]

string

產品遭拒的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

ItemLevelIssue

產品狀態的 ItemLevelIssue。

JSON 表示法 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
欄位
code

string

問題的錯誤代碼。
severity

enum (Severity)

這個問題對優惠提供的影響程度。
resolution

string

商家是否可解決這個問題。
attribute

string

屬性名稱 (如果問題是因單一屬性造成)。
reportingContext

enum (ReportingContextEnum)

問題適用的回報情境。
description

string

問題的簡短英文說明。
detail

string

問題的詳細英文說明。
documentation

string

協助解決問題的說明網頁網址。
applicableCountries[]

string

商品適用的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

嚴重性

問題對產品放送的影響程度。

列舉
SEVERITY_UNSPECIFIED 不指定。
NOT_IMPACTED 這項問題代表警告，不會對產品造成直接影響。
DEMOTED 產品會降級，且在搜尋結果中的成效很可能不佳
DISAPPROVED 問題導致產品遭到拒登。

方法

get

 從 Merchant Center 帳戶擷取已處理的產品。

list

 列出 Merchant Center 帳戶中已處理的產品。