Di chuyển từ accountstatuses sang Vấn đề về tài khoản

Cách bạn truy xuất các vấn đề ở cấp tài khoản có thể ảnh hưởng đến sản phẩm và tình trạng tài khoản đã thay đổi. So với tài nguyên accountstatuses trong Content API for Shopping, Merchant API giới thiệu một tài nguyên AccountIssue riêng biệt cung cấp thông tin chi tiết và có cấu trúc hơn.

Để biết thêm thông tin về cách sử dụng tính năng mới, hãy xem hướng dẫn Xem các vấn đề về tài khoản.

Lưu ý: Trong Merchant API, các vấn đề ở cấp tài khoản và trạng thái tổng hợp của sản phẩm được tách riêng. Hãy xem hướng dẫn của chúng tôi để di chuyển từ accountstatuses sang trạng thái tổng hợp của sản phẩm.

Những điểm khác biệt chính

Sau đây là những điểm cải tiến và khác biệt chính trong tài nguyên AccountIssue của Merchant API:

• Tài nguyên riêng biệt: Các vấn đề về tài khoản là tài nguyên riêng. Trong Content API for Shopping, các vấn đề ở cấp tài khoản là một trường lồng ghép trong tài nguyên AccountStatus chung. Với Merchant API, bạn có thể liệt kê trực tiếp các vấn đề này bằng phương thức accounts.issues.list.
• Dữ liệu tác động có cấu trúc: Tài nguyên AccountIssue cung cấp một trường impactedDestinations chi tiết. Trường này cung cấp bảng chi tiết rõ ràng về tác động của một vấn đề, bao gồm cả đích đến (ví dụ: quảng cáo Mua sắm), khu vực cụ thể và mức độ nghiêm trọng của vấn đề ở khu vực đó.
• Mức độ nghiêm trọng dưới dạng enum: Trường severity hiện là một enum (với các giá trị như CRITICAL, ERROR, SUGGESTION), giúp bạn dễ dàng xử lý theo phương thức lập trình so với các giá trị dựa trên chuỗi trong Content API for Shopping.
• Giá trị nhận dạng được chuẩn hoá: Mỗi vấn đề về tài khoản đều có một name tài nguyên duy nhất, đầy đủ ở định dạng accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Phương pháp chuẩn hoá này thay thế chuỗi id từ Content API for Shopping.
• Hỗ trợ bản địa hoá: Phương thức accounts.issues.list cho phép bạn chỉ định language_code để nhận thông tin chi tiết về vấn đề, chẳng hạn như tiêu đề và nội dung mô tả, bằng ngôn ngữ bạn muốn. Bạn không thể thực hiện việc này trong Content API for Shopping.
• Hành vi nâng cao của tài khoản: Khi bạn gọi accounts.issues.list trên một tài khoản nâng cao, phương thức này chỉ trả về các vấn đề áp dụng trực tiếp cho tài khoản nâng cao đó. Phương thức này không trả về các vấn đề cho bất kỳ tài khoản phụ nào. Trong Content API for Shopping, phương thức accountstatuses.list sẽ trả về trạng thái cho tất cả các tài khoản phụ. Để nhận các vấn đề cho tất cả các tài khoản phụ trong Merchant API, bạn phải gọi accounts.listSubaccounts, sau đó gọi accounts.issues.list cho từng tài khoản phụ.

Yêu cầu

Trong Merchant API, bạn có thể liệt kê các vấn đề về tài khoản cho một tài khoản Merchant Center cụ thể.

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

So sánh URL yêu cầu

Nội dung mô tả yêu cầu	Content API for Shopping	Merchant API
Liệt kê các vấn đề ở cấp tài khoản cho một tài khoản	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Liệt kê các vấn đề ở cấp tài khoản cho tất cả các tài khoản phụ của một tài khoản nâng cao	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Không có. Bạn phải lặp lại các tài khoản phụ.

Giá trị nhận dạng

Giá trị nhận dạng cho tài khoản và vấn đề đã thay đổi trong Merchant API.

So sánh giá trị nhận dạng

Nội dung mô tả giá trị nhận dạng	Content API for Shopping	Merchant API
Giá trị nhận dạng tài khoản	{MERCHANT_ID} và {ACCOUNT_ID} dưới dạng tham số đường dẫn.	{ACCOUNT_ID} dưới dạng tham số đường dẫn ở định dạng accounts/{ACCOUNT_ID}.
Giá trị nhận dạng số phát hành	Trường id trong nội dung phản hồi (ví dụ: "products-that-enable-dishonest-behavior-hacking-policy").	Trường name trong nội dung phản hồi, là tên tài nguyên đầy đủ (ví dụ: accounts/12345/issues/example-issue-id).

Phương thức

Các phương thức truy xuất vấn đề về tài khoản đã được hợp nhất và đơn giản hoá trong Merchant API.

So sánh phương thức

Content API for Shopping	Merchant API	Phạm vi cung cấp và ghi chú
accountstatuses.get	accounts.issues.list	Có sẵn. Để nhận các vấn đề cho một tài khoản, hãy sử dụng accounts.issues.list và chỉ định mã tài khoản. Merchant API không có phương thức get cho một vấn đề.
accountstatuses.list	Không có phương thức tương đương trực tiếp.	Không có. Phương thức accounts.issues.list trong Merchant API chỉ trả về các vấn đề cho tài khoản được chỉ định, chứ không phải các tài khoản phụ của tài khoản đó. Để nhận các vấn đề cho tất cả các tài khoản phụ, trước tiên, bạn phải gọi accounts.listSubaccounts, sau đó gọi accounts.issues.list cho từng tài khoản phụ.
accountstatuses.custombatch	Không có phương thức tương đương trực tiếp.	Không có. Merchant API không hỗ trợ xử lý hàng loạt cho các vấn đề về tài khoản. Bạn phải thực hiện các lệnh gọi list riêng lẻ cho từng tài khoản.

Thay đổi chi tiết về trường

Các trường trong tài nguyên vấn đề về tài khoản đã được cập nhật để cung cấp cấu trúc và tính rõ ràng hơn.

So sánh trường

Content API for Shopping	Merchant API	Mô tả
accountLevelIssues (mảng trong AccountStatus)	accountIssues (mảng trong ListAccountIssuesResponse)	Các vấn đề hiện là một tài nguyên cấp cao nhất, riêng biệt, chứ không phải là một trường lồng ghép.
id (chuỗi)	name (chuỗi)	Giá trị nhận dạng vấn đề hiện là tên tài nguyên đầy đủ, ví dụ: accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (chuỗi)	title (chuỗi)	Sẽ không có thay đổi nào.
detail (chuỗi)	detail (chuỗi)	Sẽ không có thay đổi nào.
documentation (chuỗi)	documentationUri (chuỗi)	Đã đổi tên trường để rõ ràng hơn, cho biết đây là một URL.
severity (chuỗi)	severity (enum)	Mức độ nghiêm trọng hiện là một enum có cấu trúc (CRITICAL, ERROR, SUGGESTION) thay vì một chuỗi.
country (chuỗi), destination (chuỗi)	impactedDestinations (thông báo lặp lại)	Tác động hiện được cấu trúc thành một danh sách, nhóm đích đến, khu vực và mức độ nghiêm trọng cho từng khu vực bị ảnh hưởng. Trường country được thay thế bằng regionCode trong thông báo Impact.
(Không có)	language_code, time_zone (tham số yêu cầu)	Các tham số mới trong yêu cầu list cho phép bản địa hoá các trường mà con người có thể đọc được như title và detail.