從 accountstatuses 遷移至帳戶問題

擷取帳戶層級問題的方式已變更,這些問題可能會影響產品和帳戶健康狀態。相較於 Content API for Shopping 中的 accountstatuses 資源,Merchant API 導入了專屬的 AccountIssue 資源,可提供更結構化且詳細的資訊。

如要進一步瞭解如何使用新功能,請參閱查看帳戶問題指南。

注意:在 Merchant API 中,帳戶層級問題和匯總產品狀態是分開的。另請參閱指南,瞭解如何從 accountstatuses 遷移至匯總產品狀態。

主要差異

以下是 Merchant API AccountIssue 資源的主要改善項目和差異:

  • 專屬資源:帳戶問題是專屬資源。在 Content API for Shopping 中,帳戶層級問題是一般 AccountStatus 資源中的巢狀欄位。使用 Merchant API,您就能直接透過 accounts.issues.list 方法列出這些資訊。
  • 結構化影響資料:AccountIssue 資源提供詳細的 impactedDestinations 欄位。這個欄位會清楚列出問題的影響,包括目的地 (例如購物廣告)、特定區域,以及問題在該區域的嚴重程度。
  • 嚴重程度為列舉:severity 欄位現在是列舉 (值包括 CRITICAL、ERROR、SUGGESTION),與 Content API for Shopping 中以字串為基礎的值相比,更容易以程式輔助方式處理。
  • 標準化 ID:每個帳戶問題都有專屬的完整資源 name,格式為 accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}。這個標準化方法會取代 Content API for Shopping 的 id 字串。
  • 本地化支援:accounts.issues.list 方法可讓您指定 language_code,以偏好的語言接收問題詳細資料,例如標題和說明。這在 Content API for Shopping 中是無法做到的。
  • 進階帳戶行為:在進階帳戶上呼叫 accounts.issues.list 時,只會傳回直接套用至該進階帳戶的問題。不會傳回任何子帳戶的問題。在 Content API for Shopping 中,accountstatuses.list 方法會傳回所有子帳戶的狀態。如要透過 Merchant API 取得所有子帳戶的問題,請先呼叫 accounts.listSubaccounts,再分別呼叫各個子帳戶的 accounts.issues.list。

要求

在 Merchant API 中,您可以列出特定 Merchant Center 帳戶的問題。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

要求網址比較

要求說明 Content API for Shopping Merchant API
列出單一帳戶的帳戶層級問題 GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
列出進階帳戶所有子帳戶的帳戶層級問題 GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses 無法使用。您必須逐一檢查子帳戶。

ID

Merchant API 中的帳戶和問題 ID 已變更。

ID 比較

ID 說明 Content API for Shopping Merchant API
帳戶 ID {MERCHANT_ID} 和 {ACCOUNT_ID} 做為路徑參數。 {ACCOUNT_ID} 做為路徑參數,格式為 accounts/{ACCOUNT_ID}。
問題 ID 回應主體中的 id 欄位 (例如 "products-that-enable-dishonest-behavior-hacking-policy")。 回應主體中的 name 欄位,也就是完整資源名稱 (例如 accounts/12345/issues/example-issue-id)。

方法

Merchant API 已整合並簡化擷取帳戶問題的方法。

方法比較

Content API for Shopping Merchant API 適用範圍和注意事項
accountstatuses.get accounts.issues.list 可用。如要取得單一帳戶的問題,請使用 accounts.issues.list 並指定帳戶 ID。Merchant API 沒有單一問題的 get 方法。
accountstatuses.list 沒有直接對應的功能。 不適用。Merchant API 中的 accounts.issues.list 方法只會傳回指定帳戶的問題,不會傳回子帳戶的問題。如要取得所有子帳戶的問題,請先呼叫 accounts.listSubaccounts,然後為每個子帳戶呼叫 accounts.issues.list。
accountstatuses.custombatch 沒有直接對應的功能。 不適用。Merchant API 不支援批次處理帳戶問題。您必須為每個帳戶分別發出 list 呼叫。

詳細欄位變更

帳戶問題資源中的欄位已更新,提供更清楚的結構。

欄位比較

Content API for Shopping Merchant API 說明
accountLevelIssues (AccountStatus 中的陣列) accountIssues (ListAccountIssuesResponse 中的陣列) 問題現在是專屬的頂層資源,而非巢狀欄位。
id (字串) name (字串) 問題 ID 現在是完整資源名稱,例如 accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}。
title (字串) title (字串) 沒有變更。
detail (字串) detail (字串) 沒有變更。
documentation (字串) documentationUri (字串) 為求明確,欄位已重新命名,指出這是網址。
severity (字串) severity (列舉) 嚴重性現在是結構化列舉 (CRITICAL、ERROR、SUGGESTION),而非字串。
country (字串)、destination (字串) impactedDestinations (重複訊息) 影響現在會以清單形式呈現,並依目的地、區域和嚴重程度,將受影響的區域分組。country 欄位已由 Impact 訊息中的 regionCode 取代。
(無法使用) language_code、time_zone (要求參數) list 要求中的新參數可將人類可讀欄位 (例如 title 和 detail) 本地化。