共用方式為

如何取得產品供應專案的狀態？

  • 發行項

當您在目錄或市集中新增或更新產品供應專案時，供應專案會先經過初始驗證，再進行編輯檢閱。 該程式最多可能需要 36 小時。 若要查看供應專案是否通過檢閱程式，請使用 狀態 資源。

注意事項

若要取得其狀態設定為 [不核准] 或 [警告] 的產品清單，請參閱 取得產品供應專案的狀態。

以下是您用來取得資源的 Status 基底 URI。

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

若要取得產品供應專案的狀態，請將下列範本附加至基底 URI。

{bmcMerchantId}/catalogs/{catalogId}/status

設定 {bmcMerchantId} 為您的 BMC 市集識別碼，並設定為 {catalogId} 包含您想要取得其狀態之產品供應專案的目錄識別碼。

每個 HTTP 要求都必須包含使用者的 OAuth 存取權杖和您的開發人員權杖。 若要指定使用者的存取權杖，請設定 AuthenticationToken 標頭。 若要指定您的開發人員權杖，請設定 DeveloperToken 標頭。

如果您代表其他客戶管理目錄，您必須設定：

您不需要指定存取權杖或開發人員權杖即可下載報表;您只需要指定它們即可取得狀態。

根據預設，內容 API 會使用 JSON 物件來表示狀態。 若要使用 XML，請將 alt 查詢參數設定為 XML。

將 HTTP GET 要求傳送至產生的 URL。 回應包含 Status 物件，其中包含過去 30 天內通過或失敗檢閱程式的供應專案數目。 如果供應專案未通過檢閱，資源會 Status 包含一個 URL，您可以用來下載描述供應專案失敗原因的報告。

下列顯示範例 Status 物件。

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

報表會識別失敗的供應專案，但不提供您可用來識別報表所參考之更新的時間戳記或版本控制資訊。 例如，如果您在 2 天前上傳供應專案，然後于昨天更新，您將不知道問題與 2 天前上傳的版本或昨天上傳的版本有關。 不過，您可以在報表的 [供應專案程式碼片段] 資料行中使用專案的屬性，以推斷要報告的專案版本。

因為報表檔案已壓縮，所以您必須將檔案解壓縮以讀取報表。 系統可以儲存的報表數目沒有限制;不過，報表的儲存時間長度是未定義的。 如需報表內容的相關資訊，請參閱 報表格式。

根據與目錄相關聯的活動，報表可能會很大。 您不應再比必要頻率更頻繁地要求報表。 建議的間隔不超過每小時一次。

如需示範如何取得目錄狀態和下載報表的程式碼範例，請參閱 下載目錄狀態報表。

下列顯示範例報表。

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"