Bạn có thể sử dụng tài nguyên accountstatuses
để xem trạng thái của tài khoản Merchant Center hoặc MCA (tài khoản nhiều khách hàng) và tất cả tài khoản phụ liên kết với tài khoản đó.
Những người bán có nhiều cửa hàng trực tuyến hoặc thương hiệu bán trên các trang web riêng biệt có thể chọn có tài khoản phụ trong Tài khoản nhiều khách hàng (MCA).
Người bán có trách nhiệm tuân thủ các chính sách của quảng cáo Mua sắm và trang thông tin miễn phí. Google Mua sắm giữ quyền thực thi những chính sách này và phản hồi một cách thích hợp nếu phát hiện thấy nội dung hoặc hành vi vi phạm những chính sách này.
Hãy xem tài liệu tham khảo Vấn đề về tài khoản để biết thông tin chi tiết về các vấn đề thường gặp liên quan đến tài khoản.
accountstatuses.get
Bạn có thể sử dụng accountstatuses.get
để xem thông tin trạng thái tài khoản của một
tài khoản người bán.
Bạn có thể sử dụng tham số destination
để kiểm soát những vấn đề về sản phẩm được trả về. Khi một đích đến không được chỉ định, phản hồi mặc định sẽ bao gồm các trạng thái cho destination: Shopping
.
Dưới đây là yêu cầu mẫu, trong đó merchantId
là mã tài khoản MCA và accountId
là tài khoản phụ của MCA đó:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Để nhận thông tin trạng thái tài khoản cho một tài khoản độc lập, hãy gọi
accountstatuses.get
với cùng một mã tài khoản cho merchantId
và accountId
.
Phương thức này trả về các vấn đề ở cấp tài khoản và cấp mặt hàng. Bạn có thể sử dụng các tài nguyên Quảng cáo Mua sắm và Trang thông tin miễn phí để khắc phục sự cố accountLevelIssues
được trả về trong phản hồi từ accountstatuses.get
.
Dưới đây là phản hồi mẫu cho một tài khoản phụ đã bị tạm ngưng do vi phạm "trang đích không hoạt động".
{
"kind": "content#accountStatus",
"accountId": "123456789",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
},
{
"code": "missing_condition_microdata",
"servability": "unaffected",
"resolution": "merchant_action",
"description": "Missing or invalid data [condition]",
"detail": "Add valid structured data markup to your landing page",
"documentation": "https://support.google.com/merchants/answer/6183460",
"numItems": "5"
},
{
"code": "mobile_landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable mobile landing page",
"detail": "Update your website or landing page URL to enable access from mobile devices",
"documentation": "https://support.google.com/merchants/answer/6098296",
"numItems": "3"
}
]
}
]
}
accountstatuses.list
Bạn có thể sử dụng accountstatuses.list
để xem thông tin trạng thái tài khoản trên tất cả các tài khoản phụ của Tài khoản nhiều khách hàng (MCA).
Bạn có thể sử dụng bộ lọc với accountstatuses.list
để lọc vấn đề về sản phẩm theo điểm đến. Khi bạn không chỉ định đích đến, phản hồi sẽ bao gồm các trạng thái cho destination: Shopping
.
Dưới đây là yêu cầu mẫu để lấy thông tin trạng thái tài khoản cho tất cả các tài khoản phụ trong merchantId
của MCA:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Dưới đây là câu trả lời mẫu:
{
"kind": "content#accountstatusesListResponse",
"resources": [
{
"kind": "content#accountStatus",
"accountId": "1234567",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
},
{
"kind": "content#accountStatus",
"accountId": "123456789",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "home_page_issue",
"title": "Website URL not provided",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/176793"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
]
}
Lệnh gọi đến accountstatuses.list
cho tài khoản không phải MCA (ví dụ: tài khoản Merchant Center độc lập) sẽ trả về lỗi 403
.
Dưới đây là phản hồi mẫu về cách gọi accountstatuses.list
cho một tài khoản độc lập:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "forbidden",
"message": "111111111 is not a multi-client account (MCA). The only account
service operations allowed on non-MCAs are 'get', 'update',
'authinfo' and 'claimwebsite'."
}
],
"code": 403,
"message": "111111111 is not a multi-client account (MCA). The only account
service operations allowed on non-MCAs are 'get', 'update',
'authinfo' and 'claimwebsite'."
}
}
Chế độ lô
accountstatuses.custombatch
có phương thức GET
sẽ trả về thông tin trạng thái tài khoản cho nhiều tài khoản phụ trong một tài khoản nhiều khách hàng.
JSON yêu cầu bao gồm merchantId
của số tài khoản MCA, accountId
của tài khoản phụ, batchId
riêng biệt và method
được đặt thành get
.
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Dưới đây là nội dung JSON của yêu cầu mẫu:
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
Dưới đây là nội dung phản hồi JSON mẫu:
{
"kind": "content#accountstatusesCustomBatchResponse",
"entries": [
{
"batchId": 9,
"accountStatus": {
"kind": "content#accountStatus",
"accountId": "1212121212",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "home_page_issue",
"title": "Website URL not provided",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/176793"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
},
{
"batchId": 99,
"accountStatus": {
"kind": "content#accountStatus",
"accountId": "1313131313",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
}
]
}
Kiểm tra tài nguyên Trạng thái tài khoản
Trong ví dụ sau, chúng tôi sẽ lấy danh sách và trạng thái tài khoản custombatch.get
cho
tài khoản nhiều khách hàng:
Xem trạng thái tài khoản phụ của Tài khoản nhiều khách hàng bằng
accountstatuses.get
.Lấy
merchantId
vàaccountId
bằng cách thực hiệnGET
cho điểm cuối API:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Bạn sẽ nhận được mã trạng thái
HTTP 200
nếu đã thành công và danh sách trạng thái tài khoản trong JSON.
Xem tất cả trạng thái tài khoản phụ của MCA bằng
accountstatuses.list
.Thực hiện GET cho điểm cuối API bằng
merchantId
của bạn:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Bạn sẽ nhận được mã trạng thái
HTTP 200
nếu đã gửi thành công và danh sách trạng thái tài khoản trong JSON chomerchantId
đã gửi.
Xem nhiều tài khoản phụ của MCA ở chế độ hàng loạt bằng
accountstatuses.custombatch
.Tạo JSON hợp lệ bằng cách sử dụng phương thức
accountID
,merchant ID
vàget
.Thực hiện POST tới điểm cuối API:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Bạn sẽ nhận được mã trạng thái
HTTP 200
nếu đã thành công và danh sách trạng thái tài khoản trong JSON.