共用方式為

錯誤碼和訊息

  • 發行項

當您將價格摘要傳送至 Bing 進行處理時，Bing 可能會傳回下列其中一個 HTTP 狀態代碼：

狀態代碼 描述
200 成功。 Bing 已成功將要處理的訊息排入佇列。
401 未經授權。 使用者未獲授權使用 API，或訊息是從 Bing 未知或未與使用者相關聯的 IP 位址傳送。 若要判斷原因，請參閱錯誤訊息。
413 要求實體太大。 價格摘要不得超過 100 MB 或壓縮 10 MB。
429 太多要求。 您最多可以有五個要求排入佇列或同時處理。 如果您目前傳送第六個要求，Bing 會傳回此錯誤。
500 內部伺服器錯誤。 這通常是暫時性錯誤。 以 1、5 和 20 分鐘的間隔重試要求。 如果第三次嘗試之後要求失敗，請使用下列資訊連絡您的 TAM：

  • 客戶識別碼
  • 發生錯誤的日期和時間。
  • WebRequestActivityId 回應標頭中的標識碼。

回應主體

如果發生 HTTP 錯誤，響應主體會包含包含錯誤描述的 XML 檔。

<ArrayOfApiError xmlns="http://schemas.datacontract.org/2004/07/Microsoft.BingAds.BHAC.HotelAdsAPIs.Models" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ApiError>
    <Code>IPAddressNotAllowed</Code>
    <Message>Customer 4 is not authorized to use IP address 167.220.24.77.</Message>
    <Property i:nil="true"/>
  </ApiError>
</ArrayOfApiError>

下表描述在錯誤回應中找到的專案。

錯誤回應

定義錯誤回應的最上層專案。

元素 描述 子女
ArrayOfApiError 錯誤回應的最上層專案。 此元素包含所發生的錯誤清單。 ApiError 的陣列

ApiError

定義發生的錯誤。

元素 描述 子女
代碼 識別所發生錯誤的程序代碼。 例如，IPAddressNotAllowed。 無
郵件 描述所發生錯誤的訊息。 無
Property 造成錯誤的屬性名稱。 如果錯誤與屬性無關，元素的 nil 屬性會設定為 true。 無

程式代碼和訊息

下列列出 API 傳回的錯誤碼和訊息。

代碼 郵件
AuthenticationFailure 驗證因為未知的原因而失敗。
InternalError 內部伺服器錯誤。

這通常是暫時性錯誤。 以 1、5 和 20 分鐘的間隔重試要求。 如果第三次嘗試之後要求失敗，請使用下列資訊連絡您的 TAM：

  • 客戶識別碼
  • 發生錯誤的日期和時間。
  • WebRequestActivityId 回應標頭中的標識碼。
IPAddressNotAllowed 客戶 {custId} 未獲授權使用 IP 地址 {clientIp}。

客戶未獲授權從IP位址傳送價格摘要。 您必須從授權的伺服器 IP 位址傳送要求。 請連絡您的 TAM 以更新授權的伺服器 IP 位址清單。
NotAuthorized 您將 Authorization 標頭設定為 的 OAuth 令牌無效。
RequestThrottled 客戶 {customerId} 超過允許的要求數目。

客戶最多可以有五個要求排入佇列或正在處理。 在此情況下傳送第六個要求將會失敗。
RequestTooLarge 要求大小 ({requestSizeBytes} 個字節) 超過 ({maxAllowed} 位元組) 允許的最大值。

價格摘要不能超過 100 MB 或壓縮 10 MB。 減少價格摘要的大小，以符合限制。