REST Resource: accounts.languages.productCertifications

資源:產品認證

產品認證資料。

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 則是 Google 購物支援的語言的雙字母 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
}
欄位
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
}
欄位
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 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

嚴重性

問題嚴重性。

列舉
SEVERITY_UNSPECIFIED 未指定的嚴重性,從未使用。
ERROR 錯誤嚴重性。這個問題會導致無法使用整個項目。
WARNING 警示嚴重性。問題可能出在因使用者無法使用觸發該屬性的屬性,或是不久後導致整個項目無法使用的情況。
INFO 資訊嚴重性。不需要立即處理的問題。舉例來說,這個欄位會用來通知哪些屬性尚待審核。

IssueResolution

問題的解決方式。

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

DestinationStatus

目的地狀態。

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

string

目的地的名稱。

status

enum (Status)

目的地狀態。

狀態

狀態。

列舉
UNKNOWN 未指定的狀態,從未使用。
ACTIVE 產品適用於這個目的地。
PENDING 這項決定尚待審核。
DISAPPROVED 產品遭到拒登。請查看問題。

方法

delete

按照名稱刪除產品認證。

get

按名稱取得產品認證。

list

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

patch

更新連結認證與產品的產品認證 (若 allow_missing = true 則建立)。