擷取可能影響產品和帳戶健康狀態的帳戶層級問題時，方式有所變更。與 Content API for Shopping 中的 accountstatuses 資源相比，Merchant API 導入了專屬的 AccountIssue 資源，可提供更結構化且詳細的資訊。
如要進一步瞭解如何使用這項新功能，請參閱查看帳戶問題指南。
主要差異
以下是 Merchant API AccountIssue 資源的主要改良項目和差異：
- 專屬資源：帳戶問題是獨立的資源。在 Shopping 內容 API 中，帳戶層級問題是 general
AccountStatus資源中的巢狀欄位。你可以使用 Merchant API 的accounts.issues.list方法直接列出這些項目。 - 結構化影響資料：
AccountIssue資源提供詳細的impactedDestinations欄位。這個欄位會清楚列出問題的影響，包括目的地 (例如購物廣告)、特定區域，以及該區域的問題嚴重程度。 - 嚴重程度 (列舉)：
severity欄位現在是列舉 (值包括CRITICAL、ERROR、SUGGESTION)，與 Shopping 內容 API 中以字串為基礎的值相比，更容易以程式輔助方式處理。 - 標準化 ID：每個帳戶問題都有專屬的完整資源
name，格式為accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}。這項標準化做法會取代 Content API for Shopping 的id字串。 - 本地化支援：
accounts.issues.list方法可讓您指定language_code，以偏好語言接收問題詳細資料，例如標題和說明。購物內容 API 無法執行這項操作。 - 進階帳戶行為：在進階帳戶上呼叫
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/v1beta/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/v1beta/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) 本地化。 |