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ứcaccounts.issues.list
. - Dữ liệu có cấu trúc về tác động: Tài nguyên
AccountIssue
cung cấp trườngimpactedDestinations
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ạngaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}
. Phương pháp chuẩn hoá này sẽ thay thế chuỗiid
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ộtlanguage_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ứcaccountstatuses.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ọiaccounts.listSubaccounts
rồi gọiaccounts.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 . |