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 chuyên dụng 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 này, hãy xem hướng dẫn Xem các vấn đề về tài khoản.

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 Merchant API AccountIssue:

• Tài nguyên chuyên biệt: Các vấn đề về tài khoản là một tài nguyên riêng. Trong Content API cho Mua sắm, các vấn đề ở cấp tài khoản là một trường lồng trong tài nguyên AccountStatus chung. Với Merchant API, bạn có thể liệt kê trực tiếp các sản phẩm đó bằng phương thức accounts.issues.list.
• Dữ liệu có cấu trúc về tác động: Tài nguyên AccountIssue cung cấp trường impactedDestinations chi tiết. Trường này cung cấp cho bạn thông tin chi tiết rõ ràng về mức độ ảnh hưởng của một vấn đề, bao gồm cả vị trí xuất hiệ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 một 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 hơn so với các giá trị dựa trên chuỗi trong Content API cho Mua sắm.
• Giá trị nhận dạng được chuẩn hoá: Mỗi vấn đề về tài khoản đều có một tài nguyên name duy nhất, đầy đủ ở định dạng accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Phương pháp chuẩn hoá này sẽ thay thế chuỗi id trong Content API for Shopping.
• Hỗ trợ bản địa hoá: Phương thức accounts.issues.list cho phép bạn chỉ định một 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ữ mà bạn muốn. Điều này không thể thực hiện được trong Content API for Shopping.
• Hành vi của tài khoản nâng cao: Khi bạn gọi accounts.issues.list trên một tài khoản nâng cao, thao tác này chỉ trả về những vấn đề áp dụng trực tiếp cho tài khoản nâng cao đó. Thao tác này không trả về 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 của tất cả tài khoản phụ. Để nhận vấn đề cho tất cả tài khoản phụ trong Merchant API, bạn phải gọi accounts.listSubaccounts rồi gọi accounts.issues.list cho từng tài khoản phụ riêng lẻ.

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/v1beta/accounts/ACCOUNT_ID/issues

Yêu cầu so sánh URL

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/v1beta/accounts/{ACCOUNT_ID}/issues
Liệt kê các vấn đề ở cấp tài khoản cho tất 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

Thông tin mô tả về 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 vấn đề	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, đây 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 pháp

Content API for Shopping	Merchant API	Phạm vi cung cấp và lưu ý
accountstatuses.get	accounts.issues.list	Có sẵn. Để nhận vấn đề cho một tài khoản, hãy 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 số phát hành riêng lẻ.
accountstatuses.list	Không có công cụ tương đương trực tiếp.	Không có thông tin. 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 tài khoản phụ của tài khoản đó. Để nhận vấn đề cho tất cả tài khoản phụ, trước tiên, bạn phải gọi accounts.listSubaccounts rồi gọi accounts.issues.list cho từng tài khoản phụ.
accountstatuses.custombatch	Không có công cụ tương đương trực tiếp.	Không có thông tin. Merchant API không hỗ trợ xử lý hàng loạt 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.

Thông tin chi tiết về các thay đổi đối với 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à sự rõ ràng hơn.

So sánh các trường

Content API for Shopping	Merchant API	Mô tả
accountLevelIssues (mảng trong AccountStatus)	accountIssues (mảng trong ListAccountIssuesResponse)	Vấn đề hiện là một tài nguyên chuyên biệt, cấp cao nhất, chứ không phải là một trường lồng nhau.
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)	Chúng tôi đã đổi tên trường này để cho rõ ràng rằng đâ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)	Giờ đây, tác động đượ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 khả dụng)	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, chẳng hạn như title và detail.