账号状态

您可以使用 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

要获取独立账号的账号状态信息,请调用 将merchantIdaccountId使用相同的账号 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、唯一 batchIdmethod 设置为 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 账号:

  1. 使用 accountstatuses.get 获取 MCA 的子账号状态。

    1. 通过对 API 执行 GET 来获取 merchantIdaccountId 端点:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
    2. 您应该会收到 HTTP 200 状态代码,表示操作成功且相关账号 采用 JSON 格式的状态列表。

  2. 使用 accountstatuses.list 查看 MCA 的所有子账号状态。

    1. 使用 merchantId 对 API 端点执行 GET:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
    2. 您应该会收到 HTTP 200 状态代码,表示操作成功且相关账号 所提交的 merchantId 的状态列表(采用 JSON 格式)。

  3. 使用批量模式查看 MCA 的多个子账号 accountstatuses.custombatch

    1. 使用 accountIDmerchant IDget 构建有效的 JSON 方法。

    2. 对 API 端点执行 POST:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
    3. 您应该会收到 HTTP 200 状态代码,表示操作成功且相关账号 采用 JSON 格式的状态列表。