エラー コードとメッセージ

価格フィードを処理のために Bing に送信すると、Bing は次のいずれかの HTTP 状態コードを返す場合があります:

状態コード 説明
200 成功 Bing は、処理するメッセージのキューに正常に登録されました。
401 権限がありません。 ユーザーには API の使用が許可されていないか、Bing に不明な IP アドレスまたはユーザーに関連付けられていない IP アドレスからメッセージが送信されました。 原因を特定するには、エラー メッセージを参照してください。
413 要求エンティティが大きすぎます。 価格フィードは、100 MB または圧縮 10 MB を超えてはなりません。
429 要求数が多すぎます。 最大 5 つの要求をキューに入れたり、同時に処理したりすることができます。 この時点で 6 番目の要求を送信すると、Bing はこのエラーを返します。
500 内部サーバー エラー。 通常、これは一時的なエラーです。 1 分、5 分、20 分間隔で要求を再試行します。 3 回目の試行で要求が失敗した場合は、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 などです。 なし
メッセージ 発生したエラーを説明するメッセージ。 なし
プロパティ エラーの原因となったプロパティの名前。 エラーがプロパティに関連しない場合、要素の nil 属性は true に設定されます。 なし

コードとメッセージ

API が返すエラー コードとメッセージの一覧を次に示します。

コード メッセージ
AuthenticationFailure 不明な理由で認証に失敗しました。
InternalError 内部サーバー エラー。

通常、これは一時的なエラーです。 1 分、5 分、20 分間隔で要求を再試行します。 3 回目の試行で要求が失敗した場合は、TAM に次の情報を問い合わせてください。

  • CustomerID
  • エラーが発生した日時。
  • WebRequestActivityId 応答ヘッダーの ID。
IPAddressNotAllowed 顧客 {custId} は IP アドレス {clientIp} を使用する権限がありません。

顧客には、IP アドレスから価格フィードを送信する権限がありません。 承認されたサーバーの IP アドレスから要求を送信する必要があります。 TAM に連絡して、承認済みサーバー IP アドレスのリストを更新します。
NotAuthorized Authorization ヘッダーを設定している OAuth トークンが無効です。
RequestThrottled 顧客 {customerId} が許可されたリクエスト数を超えました。

顧客には、最大 5 つの要求がキューに入れられているか、または処理されている場合があります。 この場合、6 番目の要求の送信は失敗します。
RequestTooLarge 要求のサイズ ({requestSizeBytes} バイト) が、許可されている最大値 ({maxAllowed} バイト) を超えています。

価格フィードは、100 MB または圧縮 10 MB を超えることはできません。 制限内に収まるように、価格フィードのサイズを小さくします。
  • 最終更新: