REST Resource: accounts.languages.productCertifications

資源:ProductCertification

產品認證資料。

JSON 表示法
{
  "name": string,
  "title": string,
  "brand": string,
  "mpn": [
    string
  ],
  "productCode": [
    string
  ],
  "countryCode": [
    string
  ],
  "productType": [
    string
  ],
  "certification": [
    {
      object (Certification)
    }
  ],
  "issues": [
    {
      object (Issue)
    }
  ],
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ]
}
欄位
name

string

必填。產品認證的專屬名稱 ID。格式:accounts/{account}/languages/{language_code}/productCertifications/{id}。其中 id 是專屬 ID,language_code 則是購物服務支援語言的雙字母 ISO 639-1 代碼,詳情請參閱 https://support.google.com/merchants/answer/160637。

title

string

必填。這是為了清楚識別要認證的產品。

brand

string

必填。這是產品的品牌名稱。品牌可用來識別產品。

mpn[]

string

(選用步驟) 這些是製造商零件編號 (MPN)。製造商零件編號可用來識別同一間製造商所有產品中的特定產品

productCode[]

string

(選用步驟) 全球交易品項識別碼的別名。

countryCode[]

string

(選用步驟) 2 個字母的國家/地區代碼 (ISO 3166-1 Alpha 2)。

productType[]

string

(選用步驟) 這是產品資料中的產品分類系統。

certification[]

object (Certification)

必填。要連結至所述產品的認證清單。

issues[]

object (Issue)

僅供輸出。伺服器產生的產品相關問題清單。

destinationStatuses[]

object (DestinationStatus)

僅供輸出。目的地的狀態。

認證

認證說明。

JSON 表示法
{
  "name": string,
  "authority": string,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string,
  "labelLink": string,
  "documentLink": string
}
欄位
name

string

必填。認證名稱。

authority

string

必填。認證機構名稱。

code

string

(選用步驟) 用來識別認證的專屬代碼。

value

string

(選用步驟) 認證的自訂值。

validUntil

string

(選用步驟) 到期日 (世界標準時間)。

問題

產品問題。

JSON 表示法
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": string,
  "applicableCountries": [
    string
  ]
}
欄位
type

string

伺服器產生的問題類型,例如「INCORRECT_TEXT_FORMATTING」、「IMAGE_NOT_SERVEABLE」等。

severity

enum (Severity)

問題的嚴重程度。

attribute

string

觸發問題的屬性 (如有)。如要進一步瞭解屬性,請參閱 https://support.google.com/manufacturers/answer/6124116。

title

string

簡短名稱,說明問題性質。

description

string

問題的詳細說明,著重於如何解決問題。

resolution

enum (IssueResolution)

解決問題的必要步驟。

destination

string

這個問題適用的目的地。

timestamp

string (Timestamp format)

這個問題出現的時間戳記。

使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

applicableCountries[]

string

僅供輸出。製造商產品發生問題的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

嚴重性

問題嚴重性。

列舉
SEVERITY_UNSPECIFIED 未指定嚴重性,從未使用。
ERROR 錯誤嚴重程度。這個問題會導致整個項目無法使用。
WARNING 警告嚴重性。這類問題會導致觸發問題的屬性無法使用,或很快就會導致整個項目無法使用。
INFO 資訊嚴重性。問題不需要立即處理。例如,用來傳達哪些屬性仍在審查中。

IssueResolution

問題解決方案。

列舉
RESOLUTION_UNSPECIFIED 未指定的解析度,從未使用。
USER_ACTION 提供資料的使用者必須採取行動,才能解決問題 (例如修正部分資料)。
PENDING_PROCESSING 問題會自動解決 (例如圖片檢索或 Google 評論)。目前無須採取任何行動。解決問題可能會導致其他問題 (例如檢索失敗)。

DestinationStatus

目的地狀態。

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

string

目的地名稱。

status

enum (Status)

目的地的狀態。

approvedCountries[]

string

僅供輸出。商品獲准刊登的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

pendingCountries[]

string

僅供輸出。待核准優惠的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

disapprovedCountries[]

string

僅供輸出。商品遭拒登的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

狀態

狀態。

列舉
UNKNOWN 未指定狀態,從未使用。
ACTIVE 產品用於這個目的地。
PENDING 目前尚未做出決定。
DISAPPROVED 產品已拒登。請查看問題。

方法

delete

依名稱刪除產品認證。

get

依名稱取得產品認證。

list

列出指定認證機構的產品認證。

patch

更新 (或在 allow_missing = true 時建立) 產品認證,將認證與產品連結。