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

必要欄位。產品認證格式的專屬名稱識別碼:accounts/{account}/languages/{language_code}/productCertifications/{id}。id 是部分專屬識別碼,language_code 則是根據購物支援語言使用的 2 個字母 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,
  "value": string,
  "link": string,
  "logo": string,

  // Union field _valid_until can be only one of the following:
  "validUntil": string
  // End of list of possible types for union field _valid_until.
}
欄位
name

string

必要欄位。認證的名稱。

authority

string

必要欄位。認證機構的名稱。

value

string

必要欄位。認證的自訂值。

聯集欄位 _valid_until

_valid_until 只能是下列其中一個值:

validUntil

string

選填欄位,到期日 (世界標準時間)。

問題

產品問題。

JSON 表示法
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": 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)

問題發生時的時間戳記。

RFC3339 UTC 的「Zulu」格式的時間戳記,單位為奈秒解析度,最多可達 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

嚴重程度

問題嚴重性。

列舉
SEVERITY_UNSPECIFIED 未指定嚴重性。
ERROR 錯誤嚴重性。導致該商品無法使用整個商品。
WARNING 警告嚴重性。這個問題可避免讓屬性使用觸發該屬性的屬性,或是很快就造成整個商品無法使用。
INFO 資訊嚴重性。這個問題不需立即處理,例如,用來傳達哪些屬性仍處於待審查狀態。

問題解決

問題的解決方式。

列舉
RESOLUTION_UNSPECIFIED 未指定的解析度,一律不使用。
USER_ACTION 提供資料的使用者必須採取行動才能解決問題 (例如修正部分資料)。
PENDING_PROCESSING 系統會自動解決相關問題,例如圖片檢索或 Google 審核。目前不需要採取任何行動。如果採用其他方法,問題解決可能會導致其他問題 (例如檢索失敗)。

目的地狀態

目的地狀態。

JSON 表示法
{
  "destination": string,
  "status": enum (Status)
}
欄位
destination

string

目的地的名稱。

status

enum (Status)

目的地的狀態。

狀態

狀態。

列舉
UNKNOWN 未指定的狀態,永遠不會使用。
ACTIVE 這個目的地會使用這項產品。
PENDING 該決策仍在進行中。
DISAPPROVED 產品遭到拒登。請查看問題。

方法

delete

依名稱刪除產品認證。

get

依名稱取得產品認證。

list

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

patch

更新 (或許可:如果 allow_missing = true) 將產品認證與產品連結。