擷取帳戶層級問題的方式已變更,這些問題可能會影響產品和帳戶健康狀態。相較於 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) 本地化。 |