通过

错误代码和消息

  • 项目

向必应发送价格源进行处理时，必应可能会返回以下 HTTP 状态代码之一：

状态代码 说明
200 成功。 必应已成功将要处理的消息排队。
401 未经授权。 用户无权使用 API，或者该消息是从必应未知或未与用户关联的 IP 地址发送的。 若要确定原因，请参阅错误消息。
413 请求实体太大。 价格源不能超过 100 MB 或压缩的 10 MB。
429 请求过多。 最多可以有五个请求排队或同时处理。 如果此时发送第六个请求，必应将返回此错误。
500 内部服务器错误。 这通常是暂时性错误。 每隔 1、5 和 20 分钟重试请求。 如果在第三次尝试后请求失败，请与 TAM 联系，提供以下信息：

  • CustomerID
  • 错误的发生日期和时间。
  • WebRequestActivityId 响应标头中的 ID。

响应正文

如果发生 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>

下表描述了在错误响应中找到的元素。

错误响应

定义错误响应的顶级元素。

元素 说明 Children
ArrayOfApiError 错误响应的顶级元素。 此元素包含发生的错误列表。 ApiError 数组

ApiError

定义发生的错误。

元素 说明 Children
代码 一个代码，用于标识发生的错误。 例如 IPAddressNotAllowed。 None
邮件 描述所发生错误的消息。 None
属性 导致错误的属性的名称。 如果错误与属性无关，则元素的 nil 属性将设置为 true。 None

代码和消息

下面列出了 API 返回的错误代码和消息。

代码 消息
AuthenticationFailure 身份验证因未知原因失败。
InternalError 内部服务器错误。

这通常是暂时性错误。 每隔 1、5 和 20 分钟重试请求。 如果在第三次尝试后请求失败，请与 TAM 联系，提供以下信息：

  • CustomerID
  • 错误的发生日期和时间。
  • WebRequestActivityId 响应标头中的 ID。
IPAddressNotAllowed 客户 {custId} 无权使用 IP 地址 {clientIp}。

客户无权从 IP 地址发送价格源。 必须从授权的服务器 IP 地址发送请求。 请联系 TAM 更新授权服务器 IP 地址列表。
NotAuthorized 将 Authorization 标头设置为 的 OAuth 令牌无效。
RequestThrottled 客户 {customerId} 超出了允许的请求数。

客户最多可以有五个排队或正在处理的请求。 在这种情况下，发送第六个请求将失败。
RequestTooLarge 请求大小 ({requestSizeBytes} 字节) 超出了) 允许的最大 ({maxAllowed} 字节数。

价格源不能超过 100 MB 或压缩的 10 MB。 减小价格源的大小，使其符合限制。