Price フィードBingを処理に送信すると、Bingは次のいずれかの HTTP 状態コードを返す場合があります。
| 状態コード | 説明 |
|---|---|
| 200 | 成功 Bing処理するメッセージが正常にキューに入れられます。 |
| 401 | 権限がありません。 ユーザーが API の使用を許可されていないか、Bingに不明な IP アドレスから送信された、またはユーザーに関連付けられていない IP アドレスからメッセージが送信されました。 原因を特定するには、エラー メッセージを参照してください。 |
| 413 | 要求エンティティが大きすぎます。 Price フィードは、圧縮された 100 MB または 10 MB を超えてはなりません。 |
| 429 | 要求数が多すぎます。 最大 5 つの要求がキューに入れられているか、同時に処理される場合があります。 この時点で 6 番目の要求を送信すると、Bingはこのエラーを返します。 |
| 500 | 内部サーバー エラー。 これは通常、一時的なエラーです。 1、5、20 分間隔で要求を再試行します。 3 回目の試行後に要求が失敗した場合は、次の情報を TAM に問い合わせてください。
|
応答本文
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 に問い合わせてください。
|
| IPAddressNotAllowed | 顧客 {custId} は、IP アドレス {clientIp} を使用する権限がありません。 顧客は、IP アドレスから価格フィードを送信する権限がありません。 承認されたサーバー IP アドレスから要求を送信する必要があります。 承認されたサーバー IP アドレスの一覧を更新するには、TAM に問い合わせてください。 |
| NotAuthorized | Authorization ヘッダーを に設定した OAuth トークンが無効です。 |
| RequestThrottled | 顧客 {customerId} が許可された要求の数を超えました。 お客様は、最大 5 つの要求をキューに入れたり処理したりできます。 この場合、6 番目の要求の送信は失敗します。 |
| RequestTooLarge | 要求サイズ ({requestSizeBytes} バイト) が、許可される最大 ({maxAllowed} バイト) を超えています。 Price フィードは、圧縮された 100 MB または 10 MB を超えることはできません。 制限内に収まるように、価格フィードのサイズを小さくします。 |