帳戶狀態

您可以使用 accountstatuses敬上 查看商家狀態 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。

這個方法會傳回帳戶和商品層級問題。您可以使用購物 廣告和免費 列出相關資源 accountLevelIssues 在 accountstatuses.get 的回應中傳回。

以下是因違反「到達網頁」政策而遭停權的子帳戶回應範例 網頁無法運作」。

{
 "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 查看所有帳戶狀態資訊 子帳戶

你可以使用 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"
     }
    }
   ]
  }
 ]
}

向 accountstatuses.list 發出的非 MCA 帳戶 (例如 獨立 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"
      }
     }
    ]
   }
  }
 ]
}

測試「帳戶狀態」資源

在以下範例中，我們會取得帳戶、清單，以及 custombatch.get 帳戶狀態： MCA 帳戶：

  1. 使用 accountstatuses.get 取得 MCA 的子帳戶狀態。

    1. 對 API 執行 GET，取得 merchantId 和 accountId 端點：

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

    2. 你應該會收到驗證成功和帳戶的 HTTP 200 狀態碼 狀態清單。

  2. 使用 accountstatuses.list 查看 MCA 的所有子帳戶狀態。

    1. 使用 merchantId 執行 GET 至 API 端點：

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses

    2. 你應該會收到驗證成功和帳戶的 HTTP 200 狀態碼 所提交 merchantId 的 JSON 狀態清單。

  3. 使用以下功能，以批次模式查看 MCA 的多個子帳戶： accountstatuses.custombatch。

    1. 使用 accountID、merchant ID 和 get 建構有效的 JSON 方法。

    2. 對 API 端點執行 POST：

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

    3. 你應該會收到驗證成功和帳戶的 HTTP 200 狀態碼 狀態清單。