取得產品供應專案的狀態

注意事項

ProductStatuses 資源僅適用于封閉式 Beta 參與者。 如需參與封閉式 Beta 或 open-Beta 計畫的相關資訊，請連絡您的帳戶管理員。

在 Beta 期間，所有 Store 程式設計項目和檔都可能會變更。

若要取得您市集中狀態設定為 [不核准] 或 [警告] 的產品供應專案清單，請使用 取得產品狀態範本。

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses

回應本文是 ProductStatuses 物件。 如果存放區不包含 [不核准] 或 [警告] 狀態的產品，字 resources 段會包含空陣列。

{
  "resources": []
}

以下是當產品狀態設定為 [警告] 和 [不核准] 時，回應的外觀。 字 itemLevelIssues 段包含您應該解決的問題清單。

{
  "resources": [
    {
      "productId": "online:en:CA:9",
      "title": "Slip Resistant - Shoes For Crews...",
      "status": "Warning",
      "creationDate": "2018-10-08T07:38:00Z",
      "lastUpdateDate": "2020-09-29T14:35:54Z",
      "expirationDate": "2020-10-29T14:35:54Z",
      "itemLevelIssues": [
        {
          "code": "GtinPlusBrandRequiredWarn",
          "description": "Missing one or more identifiers - The Brand and GTIN or Brand and MPN are required.",
          "servability": "Unaffected"
        }
      ]
    },

    . . .

    {
      "productId": "online:en:CA:7",
      "title": "No Slip - Shoes For Crews...",
      "status": "Disapproved",
      "creationDate": "2018-10-08T07:38:00Z",
      "lastUpdateDate": "2020-09-29T14:35:54Z",
      "expirationDate": "2020-10-29T14:35:54Z",
      "itemLevelIssues": [
        {
          "code": "EVRejectedErr",
          "description": "The offer was rejected by the external validation component: EV.",
          "servability": "Disapproved"
        },
        {
          "code": "EV_39",
          "description": "Trademark content",
          "servability": "Disapproved"
        }
      ]
    }
  ]
}

根據預設，要求最多會傳回 25 個供應專案。 若要傳回不同數目的供應專案，請包含 max-results 查詢參數。

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  "https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses?max-results=5"

如果狀態設定為 [取消核准] 或 [警告] 的供應專案數目大於 最大結果，則回應會包含 字 nextPageToken 段。

{
  "nextPageToken": "W3sidG9rZW4iOm51bGwsInJhbmdlIjp7Im1pbiI6IjA1QzFFNTNEMUYwRjg2IiwibWF4IjoiMDVDMUU1NUIyRDk3NEEifX1d",
  "resources": [...]
}

若要取得供應專案的下一頁，請在下一個呼叫中包含 接續權杖 查詢參數，並將其設定為權杖。

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  "https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses?max-results=5&continuation-token=W3sidG9rZW4iOm..."

一般呼叫模式是在迴圈中呼叫此範本，直到回應不包含 字 nextPageToken 段為止。

取得產品供應專案的摘要狀態計數

ProductStatuses 資源供應商店中產品供應專案狀態的摘要檢視。 檢視會報告已核准和已核准的供應專案，以及擱置檢閱或即將到期的供應專案。

若要要求摘要檢視，請使用 摘要檢視範本。 設定 {merchantId} 為您想要檢視來源之存放區的識別碼。

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatusessummary

回應是 ProductStatusesSummary 物件。

{
  "merchantId":12345,
  "approved":189,
  "expiring":14,
  "disapproved":3,
  "pending":10
}

當供應專案的狀態變更時，摘要檢視最多可能需要兩個小時才能反映變更。