您可以使用
accountstatuses
用于查看您的 Merchant Center 账号状态的资源
中心账号或 MCA(多客户账号)及所有关联的子账号
。
拥有多个网店或多个品牌,并分别销售商品的商家 网站可以选择在 MCA 下设置子账号。
商家有责任遵守购物广告 广告和免费 商品详情政策。Google Google 购物保留强制执行这些政策并做出适当回应的权利 如果我们发现了违反这些政策的内容或行为,
请参阅账号问题参考 以详细了解常见的账号问题。
accountstatuses.get
您可以使用 accountstatuses.get
查看
单一商家账号。
您可以使用 destination
参数来控制哪些商品问题
返回的值。如果未指定目的地,默认响应包括
destination: Shopping
的状态。
下面是一个示例请求,其中 merchantId
是 MCA 账号 ID,
“accountId
”是该 MCA 的子账号:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
要获取独立账号的账号状态信息,请调用
将merchantId
和accountId
使用相同的账号 ID accountstatuses.get
。
此方法会返回账号级和商品级问题。您可以使用购物
广告和免费
listing修复资源
accountstatuses.get
的响应中返回了 accountLevelIssues
。
下面是针对“着陆页”被中止的子账号的响应示例 页面无法正常显示”。
{
"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
您可以使用accountstatuses.list
查看所有
您的 MCA 的子账号。
您可以将过滤条件与 accountstatuses.list
搭配使用,按以下条件过滤商品问题:
目标。如果未指定目标平台,响应会包含状态
价格为 destination: Shopping
。
以下是获取所有子账号的账号状态信息的示例请求
(位于 MCA merchantId
下):
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
以下是示例响应:
{
"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"
}
}
]
}
]
}
对非 MCA 账号的 accountstatuses.list
调用(例如,
独立的 Merchant Center 账号)会返回 403
错误。
以下是为独立调用 accountstatuses.list
的示例响应
账号:
{
"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'."
}
}
批处理模式
采用 GET
方法的 accountstatuses.custombatch
会返回账号
多客户账号中多个子账号的状态信息。
请求 JSON 包含 MCA 账号的 merchantId
、
子账号的 accountId
、唯一 batchId
和 method
设置为
get
。
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
以下是请求 JSON 正文示例:
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
以下是 JSON 响应正文示例:
{
"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"
}
}
]
}
}
]
}
测试 Account Statuses 资源
在以下示例中,我们会获取、列出和 custombatch.get
属性
MCA 账号:
使用
accountstatuses.get
获取 MCA 的子账号状态。通过对 API 执行
GET
来获取merchantId
和accountId
端点:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
您应该会收到
HTTP 200
状态代码,表示操作成功且相关账号 采用 JSON 格式的状态列表。
使用
accountstatuses.list
查看 MCA 的所有子账号状态。使用
merchantId
对 API 端点执行 GET:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
您应该会收到
HTTP 200
状态代码,表示操作成功且相关账号 所提交的merchantId
的状态列表(采用 JSON 格式)。
使用批量模式查看 MCA 的多个子账号
accountstatuses.custombatch
。使用
accountID
、merchant ID
和get
构建有效的 JSON 方法。对 API 端点执行 POST:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
您应该会收到
HTTP 200
状态代码,表示操作成功且相关账号 采用 JSON 格式的状态列表。