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 則是根據 https://support.google.com/merchants/answer/160637 提供的購物支援語言雙字母 ISO 639-1 代碼。

title

string

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

brand

string

必要欄位。這是產品的品牌名稱。品牌可用來識別產品。

mpn[]

string

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

productCode[]

string

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

countryCode[]

string

(選用步驟) 包含兩個英文字母的國家/地區代碼 (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,
  "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) 產品認證,將認證與產品連結。