Web Search API v7 リファレンス
警告
Bing Search API は、Cognitive Services から Bing Search Services に移行されます。 2020 年 10 月 30 日以降、Bing Search の新しいインスタンスは、こちらに記載されているプロセスに従ってプロビジョニングする必要があります。 Cognitive Services を使用してプロビジョニングされた Bing Search API は、次の 3 年間、または Enterprise Agreement の終わり (どちらか先に発生した方) までサポートされます。 移行手順については、Bing Search Services に関する記事を参照してください。
Web Search API を使用すると、検索クエリを Bingに送信し、Web ページ、画像などのリンクを含む検索結果を取得できます。 このセクションでは、検索結果に影響を与えるクエリ パラメーターに加えて、Web ページ、関連する検索、およびランク付け結果に関する技術的な詳細について説明します。 要求の作成方法を示す例については、「 Web を検索する」を参照してください。
要求に含める必要があるヘッダーの詳細については、「 要求ヘッダー」を参照してください。
要求に含める必要があるクエリ パラメーターの詳細については、「 クエリ パラメーター」を参照してください。
応答に含まれる JSON オブジェクトの詳細については、「 応答本文」を参照してください。 このリファレンスには、Web 回答に固有の JSON オブジェクトが含まれています。 検索結果に含まれる可能性がある他の回答の種類の JSON オブジェクトの詳細については、API 固有のリファレンス ドキュメントを参照してください。 たとえば、検索結果に画像とニュースの回答が含まれている場合は、 Image Search API と News Search API を参照してください。
許可された結果の使用と表示の詳細については、「 Search API の使用と表示の要件Bing」を参照してください。
Note
URL の書式とパラメーターは、予告なしで変更されることがあるため、すべての URL をそのまま使用してください。 明記されている場合を除いて、URL の書式またはパラメーターに依存しないでください。
エンドポイント
Web 検索結果を要求するには、GET 要求を次のように送信します。
https://api.cognitive.microsoft.com/bing/v7.0/search
マルチサービス サブスクリプションの場合は、URL にリージョンを含める必要があります。 例: westus.api.cognitive.microsoft.com。 「サポートされているリージョン」を参照してください。
要求では、HTTPS プロトコルを使う必要があります。
注意
URL の最大長は 2,048 文字です。 URL の長さが上限を超えないよう、クエリ パラメーターの最大長は 1,500 文字未満にする必要があります。 URL が 2,048 文字を超えた場合、サーバーが 404 Not found を返します。
ヘッダー
要求と応答に含まれる可能性があるヘッダーを次に示します。
| ヘッダー | 説明 |
|---|---|
| Accept | 省略可能な要求ヘッダー。 既定のメディアの種類は application/json です。 応答で JSON-LD が使用されるよう指定するには、Accept ヘッダーを application/ld+json に設定します。 |
| Accept-Language | 省略可能な要求ヘッダー。 ユーザー インターフェイス文字列に使用する言語のコンマ区切りリストです。 リストでは優先度の高いものから順に指定します。 有効な形式など、詳細については RFC2616 を参照してください。 このヘッダーと setLang クエリ パラメーターは相互に排他的なので、両方は指定しないでください。 このヘッダーを設定する場合は、cc クエリ パラメーターも指定する必要があります。 結果が返される市場を特定するために、Bing によってリストから検出された最初のサポート対象言語が使用され、それが cc パラメーター値と組み合わされます。 サポート対象言語がリストに含まれていない場合、要求がサポートされる最も近い言語と市場が Bing によって検出されるか、集計された市場または既定の市場が結果に使用されます。 Bing によって使用された市場を確認するには、BingAPIs-Market ヘッダーを調べます。このヘッダーと cc クエリ パラメーターは、複数の言語を指定する場合にのみ使用します。 それ以外の場合は、mkt クエリ パラメーターおよび setLang クエリ パラメーターを使用します。ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。 |
| BingAPIs-Market | 応答ヘッダー。 要求で使用された市場。 形式は <languageCode>-<countryCode> です。 たとえば、en-US などです。 マーケット コードに記載されていない市場を指定した場合、この値は mkt クエリ パラメーターで指定した市場と異なる場合があります。 cc とAccept-Language に、調整できない値を指定した場合も同様です。 |
| BingAPIs-TraceId | 応答ヘッダー。 要求の詳細が含まれたログ エントリの ID。 エラーが発生した場合、この ID をキャプチャします。 問題を特定して解決できない場合は、その他の情報と共にこの ID をサポート チームに提供します。 |
| Ocp-Apim-Subscription-Key | 必須の要求ヘッダー。 Cognitive Services でこのサービスにサインアップしたときに受け取ったサブスクリプション キーです。 |
| Pragma | 省略可能な要求ヘッダー 既定では、Bing はキャッシュされたコンテンツがある場合にそれを返します。 キャッシュされたコンテンツを Bing が返さないようにするには、Pragma ヘッダーを no-cache に設定します (例: Pragma: no-cache)。 |
| Retry-After | 応答ヘッダー。 1 秒あたりのクエリ数 (QPS) または 1 か月あたりのクエリ数 (QPM) を超えた場合、応答にはこのヘッダーが含まれます。 ヘッダーには、別の要求を送信する前に待機する必要がある秒数が含まれています。 |
| User-Agent | 省略可能な要求ヘッダー。 要求送信元のユーザー エージェント。 Bing では、モバイル ユーザーに最適なエクスペリエンスを提供するためにユーザー エージェントが使用されます。 省略可能ですが、このヘッダーは常に指定することをお勧めします。 ユーザーエージェントは、よく使用されるブラウザーによって送信されるのと同じ文字列にする必要があります。 ユーザー エージェントについては、RFC 2616 を参照してください。 ユーザーエージェント文字列の例を次に示します。
|
| X-MSEdge-ClientID | 省略可能な要求および応答ヘッダー。 このヘッダーは、Bing API の呼び出し間で一貫性のある動作をユーザーに提供するために Bing によって使用されます。 Bing によって、新しい機能と改善点が頻繁にフライト化されます。そして、トラフィックを異なるフライトに割り当てるためのキーとして、クライアント ID が使用されます。 複数の要求に対してユーザーの同じクライアント ID を使用しないと、ユーザーが複数の競合するフライトに割り当てられる可能性があります。 複数の競合するフライトに割り当てられると、ユーザー エクスペリエンスの一貫性がなくなる場合があります。 たとえば、2 番目の要求に 1 番目とは異なるフライトが割り当てられていると、エクスペリエンスが予期しないものになる可能性があります。 また、Bingはクライアント ID を使用して、そのクライアント ID の検索履歴に合わせて Web 結果を調整し、ユーザーに豊富なエクスペリエンスを提供できます。 このヘッダーは、クライアント ID で生成されたアクティビティを分析して結果の順位付けを向上させるために Bing によって使用されることもあります。 関連性の向上は、Bing API によって提供される結果の品質向上に役立ち、API コンシューマーのクリックスルー率の向上を実現します。 重要: このヘッダーは省略可能ですが、必須であると考える必要があります。 同じエンド ユーザーとデバイスの組み合わせによる複数の要求に対してクライアント ID を保持することで、1) API コンシューマーが一貫性のあるユーザー エクスペリエンスを受け取ることができ、2) Bing API からの結果の品質向上を通じてクリックスルー率の向上が実現します。 このヘッダーに適用される基本的な使用規則を次に示します。
注: Bing の応答には、このヘッダーが含まれる場合と含まれない場合があります。 このヘッダーが応答に含まれる場合、クライアント ID をキャプチャして、ユーザーのためにそのデバイスで実行される後続のすべての Bing 要求でそれを使用します。 注: X-MSEdge-ClientID を含める場合、要求には Cookie を含めないようにしてください。 |
| X-MSEdge-ClientIP | 省略可能な要求ヘッダー。 クライアント デバイスの IPv4 アドレスまたは IPv6 アドレス。 IP アドレスは、ユーザーの位置情報の検出に使用されます。 位置情報は、安全な検索動作を決定するために Bing によって使用されます。 注: 省略可能ですが、このヘッダーと X-Search-Location ヘッダーは常に指定することをお勧めします。 (最後のオクテットを 0 に変更するなど) アドレスを難読化しないようにしてください。 アドレスを難読化すると、デバイスの実際の場所から離れた場所が検出され、Bing から誤った結果が提供される可能性があります。 |
| X-Search-Location | 省略可能な要求ヘッダー。 クライアントの地理的な場所を示す、キーと値のペアのセミコロン区切りリストです。 位置情報は、安全な検索動作を決定して関連するローカル コンテンツを返すために、Bing によって使用されます。 キーと値のペアは、<キー>:<値> の形式で指定します。 ユーザーの場所の指定に使用するキーは次のとおりです。
注: 多くのキーは省略可能ですが、提供する情報が多いほど、場所の結果の正確さが増します。 注: 省略可能ですが、ユーザーの地理的な場所は常に指定することをお勧めします。 位置情報を提供することは、クライアントの IP アドレスがユーザーの物理的な場所を正確に反映していない場合 (たとえば、クライアントによって VPN が使用されている場合) に特に重要です。 最適な結果を得るには、このヘッダーと X-Search-ClientIP ヘッダーを含める必要がありますが、少なくともこのヘッダーを含める必要があります。 |
注意
利用規約ですべての該当法規 (これらのヘッダーの使用に関するものなど) への準拠が要求されていることに注意してください。 たとえば、ヨーロッパなどの特定の地域では、特定の追跡デバイスをユーザー デバイスに組み込む前に、ユーザーの同意を得る必要があります。
クエリ パラメーター
要求に含めることができるクエリ パラメーターを次に示します。 必須列は、パラメーターを指定する必要があるかどうかを示します。 クエリ パラメーターの値を URL エンコードする必要があります。
| Name | 値 | Type | 必須 |
|---|---|---|---|
| answerCount | 応答に含める回答の数。 Bing返される回答は、ランク付けに基づいています。 たとえば、Bingが要求の Web ページ、画像、ビデオ、および relatedSearches を返し、このパラメーターを 2 に設定した場合、応答には Web ページと画像が含まれます。 クエリ パラメーターを responseFilter 同じ要求に含めて Web ページとニュースに設定した場合、応答には Web ページのみが含まれます。ランク付けされた回答を応答に昇格させる方法については、「 昇格」を参照してください。 |
符号なし整数 | いいえ |
| cc | 結果を取得する国の 2 文字の国番号です。 使用可能な値の一覧については、「 市場コード」を参照してください。 このパラメーターを設定する場合は、Accept-Language ヘッダーも指定する必要があります。 Bingは、指定した言語で最初にサポートされている言語を使用し、それを国コードと組み合わせて、結果を返す市場を決定します。 言語一覧にサポートされている言語が含まれない場合、Bing は要求をサポートする最も近い言語と市場を検索します。 または、Bing結果に集計または既定の市場を使用できます。 複数の言語を指定する場合にのみ、 Accept-Language このクエリ パラメーターと ヘッダーを使用します。 それ以外の場合は、 パラメーターと setLang クエリ パラメーターを使用するmkt必要があります。このパラメーターと mkt クエリ パラメーターは相互に排他的なので、両方指定することはできません。 |
String | いいえ |
| count | 応答で返される検索結果の数。 既定値は 10 で、最大値は 50 です。 配信される実際の数は、要求した数よりも少ない可能性があります。 このパラメーターを パラメーターと共に offset 使用して、結果をページングします。 詳細については、「 Web ページのページング」を参照してください。たとえば、ユーザー インターフェイスに 1 ページあたり 10 件の検索結果が表示される場合は、10 と offset 0 に設定countして、結果の最初のページを取得します。 後続のページごとに、10 ずつインクリメントします offset (0、10、20 など)。 複数のページで結果に重複を含めることができます。 |
UnsignedShort | いいえ |
| 鮮度 | 次の大文字と小文字を区別しない年齢値で検索結果をフィルター処理します。
特定の期間にBingによって検出されたアーティクルを取得するには、YYYY-MM-DD という形式で日付範囲を指定します。YYYY-MM-DD. たとえば、「 &freshness=2019-02-01..2019-05-30 」のように入力します。 結果を 1 つの日付に制限するには、このパラメーターを特定の日付に設定します。 たとえば、「 &freshness=2019-02-04 」のように入力します。 |
String | いいえ |
| mkt | 結果の取得元の市場。 通常、 は、 mkt ユーザーが要求を行っている国です。 ただし、ユーザーが結果を提供する国にユーザーがいない場合は、別の国Bing可能性があります。 市場は、言語コード国コード><>の形式<である必要があります。 たとえば、en-US などです。 文字列では大文字と小文字が区別されません。 使用可能な市場価値の一覧については、「 市場コード」を参照してください。メモ： 既知の場合は、常に市場を指定することをお勧めします。 市場を指定すると、Bing が要求をルーティングして最適な応答を返すのに役立ちます。 市場コードに記載されていない市場を指定した場合、Bingは、変更される可能性のある内部マッピングに基づいて最適な市場コードを使用します。 このパラメーターと cc クエリ パラメーターは相互に排他的なので、両方指定することはできません。 |
String | いいえ |
| offset | 結果を返す前にスキップする検索結果の数を示す 0 から始まるオフセット。 既定値は 0 です。 オフセットは (totalEstimatedMatches - count) より小さくする必要があります。このパラメーターを パラメーターと共に count 使用して、結果をページングします。 たとえば、ユーザー インターフェイスに 1 ページあたり 10 件の検索結果が表示される場合は、10 と offset 0 に設定countして、結果の最初のページを取得します。 後続のページごとに、10 ずつインクリメントします offset (0、10、20 など)。 複数のページで結果にいくつかの重複を含めることができます。 |
Unsigned Short | いいえ |
| 促進 | 順位付けに関係なく、応答に含める回答のコンマ区切りのリスト。 たとえば、 answerCount) を 2 (2) に設定して、上位 2 つのランク付けされた回答を返Bing、応答にニュースを含める場合は、ニュースに設定 promote します。 上位の回答が Web ページ、画像、ビデオ、および関連する検索である場合、ニュースはランク付けされた回答ではないので、応答には Web ページと画像が含まれます。 ただし、ビデオに設定 promote すると、Bingはビデオの回答を応答に昇格させ、Web ページ、画像、ビデオを返します。昇格させる回答は、 answerCount の制限にはカウントされません。 たとえば、ランク付けされた回答がニュース、画像、およびビデオで、answerCount を 1、promote をニュースに設定した場合、応答にはニュースと画像が含まれます。 または、ランク付けされた回答がビデオ、画像、およびニュースである場合、応答にはビデオとニュースが含まれます。使用できる値を次に示します。
メモ：answerCount を指定する場合にのみ使用します。 |
String | いいえ |
| q | ユーザーの検索クエリ用語。 用語が空ではない可能性があります。 この用語には 、高度な演算子Bing含まれる場合があります。 たとえば、結果を特定のドメインに制限するには、 site: 演算子を使用します。 |
String | はい |
| responseFilter | 応答に含める回答のコンマ区切りの一覧。 このパラメーターを指定しない場合、応答には、関連するデータがあるすべての検索回答が含まれます。 使用可能なフィルター値を次に示します。
応答から特定の種類のコンテンツ (画像など) を除外したい場合は、responseFilter 値にハイフン (マイナス) プレフィックスを付けて除外できます。 除外された型をコンマで区切ります: &responseFilter=-images,-videos このフィルターを使用して 1 つの回答を取得することもできますが、より豊富な結果を得るには、代わりに回答固有のエンドポイントを使用する必要があります。 たとえば、イメージのみを受信するには、 Image Search API エンドポイントのいずれかに要求を送信します。 RelatedSearches と SpellSuggestions の回答では、Image Search API のように個別のエンドポイントはサポートされていません (Web Search API のみが返します)。 ランク付けのために除外される回答を含めるには、 昇格 クエリ パラメーターを参照してください。 |
String | いいえ |
| safeSearch | は、成人向けコンテンツの Web ページをフィルター処理します。 使用可能なフィルター値を次に示します。
メモ： ビデオの結果の場合、 が [オフ] に設定されている場合 safeSearch 、Bingは無視し、Moderate を使用します。注: safeSearch が Strict に設定されるよう Bing の成人向けコンテンツ ポリシーによって強制される市場が要求元の場合、Bing によって safeSearch の値が無視され、Strict が使用されます。注: site: クエリ演算子を使用している場合、safeSearch クエリ パラメーターの設定にかかわらず、成人向けのコンテンツが応答に含まれることがあります。 site: は、そのサイト上のコンテンツがわかっていて、成人向けコンテンツが含まれていても問題のないシナリオの場合にのみ使用してください。 |
String | いいえ |
| setLang | ユーザー インターフェイス文字列に使用する言語。 言語は、2 文字または 4 文字のコードを使用して指定できます。 4 文字のコードを使用することをお勧めします。 サポートされている言語コードの一覧については、「Bing サポートされている言語」を参照してください。 Bing、有効な 2 文字のニュートラル カルチャ コード (fr) または有効な 4 文字の特定のカルチャ コード (fr-ca) が含まれている場合 setlangは、ローカライズされた文字列を読み込みます。 たとえば、 fr-ca の場合、Bing は fr ニュートラル カルチャ コード文字列を読み込みます。が無効な場合 (zh など)、またはBingで言語がサポートされていない場合 setlang (af、af-na など)、Bingの既定値は en (英語) です。2 文字のコードを指定するには、このパラメーターを ISO 639-1 言語コードに設定します。 4 文字のコードを指定するには、language> が ISO 639-1< 言語>コード (ニュートラル カルチャ) であり、国/地域が <ISO 3166 国/地域> (特定のカルチャ) <コードである言語/国/地域>の形式<を使用します。 たとえば、英語の場合は en-US 米国使用します。 省略可能ですが、常に言語を指定することをお勧めします。 ユーザー インターフェイス文字列が別の言語で表示されることをユーザーが望まない限り、通常、 setLang は mkt で指定されるのと同じ言語に設定します。このパラメーターと Accept-Language ヘッダーは相互に排他的なので、両方は指定しないでください。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 また、応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。 |
String | いいえ |
| textDecorations | 表示文字列に、ヒット強調表示文字などの装飾マーカーを含めるかどうかを決定するブール値。 true の場合、文字列にマーカーを含めることができます。 既定値は false です。 マーカーとして Unicode 文字または HTML タグを使用するかどうかを指定するには、 textFormat クエリ パラメーターを参照してください。 ヒット強調表示の詳細については、「 ヒット強調表示」を参照してください。 |
ブール型 | いいえ |
| textFormat | テキスト装飾に使用するマーカーの種類 (クエリ パラメーターを textDecorations 参照)。使用できる値を次に示します。
既定値は Raw です。 マーカーの一覧については、「 ヒット強調表示」を参照してください。 、 などの<>&エスケープ可能な HTML 文字を含む表示文字列の場合、 が HTML に設定されている場合 textFormat、Bingは文字を適切にエスケープします (たとえば、 < lt;に&エスケープされます)。Unicode 文字が埋め込まれた文字列の処理については、「 ヒット強調表示」を参照してください。 |
String | いいえ |
応答オブジェクト
注意
フランスの新しい EU 著作権指令に準拠するには、Bing Web、ニュース、ビデオ、画像、およびすべてのカスタム検索 API で、フランス語ユーザー向けの特定の EU ニュース ソースの一部のコンテンツを省略する必要があります。 削除されたコンテンツには、サムネイル画像とビデオ、ビデオプレビュー、およびこれらのソースからの検索結果に付随するスニペットが含まれる場合があります。 その結果、Bing API は、サムネイル画像とビデオ、ビデオ プレビュー、スニペットを使用してフランス語のユーザーに提供される結果が少なくなる可能性があります。
次に、応答に含まれる可能性がある JSON 応答オブジェクトを示します。 要求が成功した場合、応答内の最上位レベルのオブジェクトは SearchResponse オブジェクトです。 要求が失敗した場合、最上位レベルのオブジェクトは ErrorResponse オブジェクトになります。
このリストには、Web 回答に固有の JSON オブジェクトが含まれています。 検索結果に含まれる可能性がある他の回答の種類の JSON オブジェクトの詳細については、API 固有のリファレンス ドキュメントを参照してください。 たとえば、検索結果に画像とニュースの回答が含まれている場合は、 Image API と News API を参照してください。
| Object | 説明 |
|---|---|
| 計算 | 式とその回答を定義します。 |
| エンティティ | 人、場所、物などのエンティティを定義します。 |
| エラー | 発生したエラーを定義します。 |
| ErrorResponse | 要求が失敗したときの応答に含まれている最上位レベルのオブジェクト。 |
| Identifiable | リソース ID を定義します。 |
| LicenseAttribution | ライセンス属性の契約規則を定義します。 |
| LinkAttribution | リンク属性の契約規則を定義します。 |
| MediaAttribution | メディア属性の契約規則を定義します。 |
| クエリ | クエリ文字列を定義します。 |
| QueryContext | 指定したクエリ文字列にスペル ミスが含まれている場合に、要求に使用Bingクエリ コンテキストを定義します。 |
| RankingGroup | 検索結果グループ (メインラインなど) を定義します。 |
| RankingItem | 表示するランク付けグループ 項目を定義します。 |
| RankingResponse | 検索結果ページでコンテンツが配置される場所と順序を定義します。 |
| RelatedSearchAnswer | 他のユーザーが行った関連クエリの一覧を定義します。 |
| SearchResponse | 要求が成功したときに応答に含まれる最上位のオブジェクト。 |
| SpellSuggestions | ユーザーの意図を表す可能性が高い推奨クエリ文字列を定義します。 |
| TextAttribution | プレーンテキスト属性の契約規則を定義します。 |
| TimeZone | 1 つ以上の地理的な場所の日付と時刻を定義します。 |
| TimeZoneInformation | 地理的な場所に関するタイム ゾーン情報を定義します。 |
| WebAnswer | 関連する Web ページ リンクの一覧を定義します。 |
| Web ページ | クエリに関連する Web ページを定義します。 |
Entity
人、場所、物などのエンティティを定義します。
| 名前 | 値 | Type |
|---|---|---|
| bingId | このエンティティを一意に識別する ID。 | String |
| 契約ルール | エンティティを表示する場合に従う必要があるルールの一覧。 たとえば、エンティティの説明に帰属するルールが管理される場合があります。 次の契約規則が適用される場合があります。 すべてのエンティティにルールが含まれているわけではありません。 エンティティが契約規則を提供する場合は、それらに従う必要があります。 契約規則の使用の詳細については、「 データの帰属」を参照してください。 |
Object[] |
| description | エンティティの簡単な説明。 | String |
| entityPresentationInfo | エンティティの種類を特定するために使用できるヒントなどの、エンティティに関する追加情報。 エンティティの型を確認するには、 フィールドと entityTypeHint フィールドをentityScenario使用します。 たとえば、フィールドは、エンティティが主要なエンティティかあいまいさのないエンティティか、およびエンティティが人物か映画かを判断するのに役立ちます。 Bingが要求を満たすエンティティが 1 つだけであると考える場合、エンティティは主要なエンティティです。 複数のエンティティが要求を満たす可能性がある場合、エンティティはあいまいさの解消エンティティであり、ユーザーは関心のあるエンティティを選択する必要があります。 |
EntityPresentationInfo |
| image | エンティティの画像。 | Image |
| name | エンティティの名前。 | String |
| webSearchUrl | このエンティティのBing検索結果ページにユーザーを移動する URL。 | String |
EntityAnswer
エンティティの回答を定義します。
| 名前 | 値 | Type |
|---|---|---|
| queryScenario | サポートされているクエリ シナリオ。 このフィールドは、DominantEntity または DisambiguationItem に設定されます。 1 つのエンティティのみが要求を満たすと判断Bing場合、フィールドは DominantEntity に設定されます。 たとえば、書籍、映画、人物、アトラクションなどです。 複数のエンティティが要求を満たす可能性がある場合、フィールドは DisambiguationItem に設定されます。 たとえば、要求で映画のフランチャイズの一般的なタイトルを使用する場合、エンティティの型は DisambiguationItem である可能性があります。 ただし、要求でフランチャイズからの特定のタイトルが指定されている場合、エンティティの型は DominantEntity である可能性があります。 | String |
| value | エンティティの一覧。 | Entity[] |
EntityPresentationInfo
型ヒントなどのエンティティに関する追加情報を定義します。
| 名前 | 値 | Type |
|---|---|---|
| entityScenario | サポートされているシナリオ。 | String |
| entityTypeDisplayHint | エンティティ ヒントの表示バージョン。 たとえば、 が Artist の場合 entityTypeHints 、このフィールドは American Singer に設定できます。 |
String |
| entityTypeHint | エンティティの型を示すヒントの一覧。 リストには、ムービーなどの 1 つのヒントや、Place、LocalBusiness、Restaurant などのヒントのリストを含めることができます。 配列内の連続する各ヒントにより、エンティティの型が絞り込まれます。 使用可能な型の一覧については、「 エンティティ型」を参照してください。 オブジェクトにこのフィールドが含まれていない場合は、Generic と見なされます。 |
String[] |
計算
式とその回答を定義します。
| 要素 | 説明 | Type |
|---|---|---|
| 式 | 数式または変換式。 クエリに測定単位 (メートルからフィートなど) を変換する要求が含まれている場合、このフィールドには from 単位と valueto 単位が含まれます。クエリに 2 +2 などの数式が含まれている場合、このフィールドには式が含まれており、 value 回答が含まれます。数式は正規化される場合があることに注意してください。 たとえば、クエリが sqrt(4^2+8^2) の場合、正規化された式は sqrt(((4^2)+(8^2)) になります。 ユーザーのクエリが数学の質問であり、 textDecorations クエリ パラメーターが true に設定されている場合、式文字列に書式設定マーカーが含まれる場合があります。 たとえば、ユーザーのクエリが log(2)の場合、正規化された式には添字マーカーが含まれます。 詳細については、「 ヒット強調表示」を参照してください。 |
String |
| value | 式の答え。 | String |
エラー
発生したエラーを定義します。
| 要素 | 説明 | Type |
|---|---|---|
| code | エラーのカテゴリを特定するエラー コード。 考えられるコードの一覧については、「エラー コード」を参照してください。 | String |
| message | エラーの説明。 | String |
| moreDetails | エラーに関する追加情報を提供する説明。 | String |
| parameter | エラーを引き起こした要求内のクエリ パラメーター。 | String |
| subCode | エラーを特定するエラー コード。 たとえば、code が InvalidRequest の場合、subCode は ParameterInvalid か ParameterInvalidValue の場合があります。 |
String |
| value | 有効でなかったクエリ パラメーター値。 | String |
ErrorResponse
要求が失敗したときの応答に含まれている最上位レベルのオブジェクト。
| 名前 | 値 | Type |
|---|---|---|
| _type | 種類のヒント。 | String |
| errors | 要求が失敗した理由を示すエラーの一覧。 | Error[] |
Identifiable
リソースの ID を定義します。
| 名前 | 値 | Type |
|---|---|---|
| id | 識別子です。 | String |
Image
イメージを定義します。
注意
URL の形式とパラメーターは予告なく変更される可能性があるため、すべての画像 URL をそのまま使用する必要があります。URL の形式またはパラメーターに依存関係を設定しないでください。 例外は、 サムネイル 画像のサイズ変更とトリミングに関するページで説明されているパラメーターと値です。
| 名前 | 値 | Type |
|---|---|---|
| height | ソース イメージの高さ (ピクセル単位)。 | Unsigned Short |
| hostPageUrl | 画像を含む Web ページの URL。 この URL と contentUrl は同じ URL である場合があります。 |
String |
| name | 画像に関するランダムな情報を含む省略可能なテキスト文字列。 | String |
| provider | イメージのソース。 配列には 1 つの項目が含まれます。 イメージをプロバイダーに属性付けする必要があります。 たとえば、カーソルが画像の上に置かれたときにプロバイダーの名前を表示したり、イメージが見つかったプロバイダーの Web サイトへのクリックスルー リンクをイメージにしたりできます。 |
Organization[] |
| thumbnailUrl | 画像のサムネイルへの URL。 画像のサイズ変更の詳細については、「 縮小版画像のサイズ変更とトリミング」を参照してください。 | String |
| width | ソース イメージの幅 (ピクセル単位)。 | Unsigned Short |
LicenseAttribution
ライセンス属性の契約規則を定義します。
| 名前 | 値 | Type |
|---|---|---|
| _type | 種類のヒント。これは LicenseAttribution に設定されます。 | String |
| license | コンテンツの使用が許可されるライセンス。 | ライセンス |
| licenseNotice | ターゲットのフィールドの横に表示されるライセンス。 たとえば、"Text under CC-BY-SA license" などです。license フィールドのライセンスの名前と URL を使用して、ライセンスの詳細が説明されている Web サイトへのハイパーリンクを作成します。 次に、licenseNotice 文字列のライセンス名 (例: CC-BY-SA) を、作成したハイパーリンクに置き換えます。 |
String |
| mustBeCloseToContent | 規則の内容が、その規則の適用されるフィールドのすぐ近くに配置される必要があるかどうかを決定するブール値。 true の場合、内容はすぐ近くに配置される必要があります。 false の場合、またはこのフィールドが存在しない場合、内容は呼び出し元の裁量で配置できます。 | Boolean |
| targetPropertyName | 規則が適用されるフィールドの名前。 | String |
LinkAttribution
リンク属性の契約規則を定義します。
| 名前 | 値 | Type |
|---|---|---|
| _type | 種類のヒント。これは LinkAttribution に設定されます。 | String |
| mustBeCloseToContent | 規則の内容が、その規則の適用されるフィールドのすぐ近くに配置される必要があるかどうかを決定するブール値。 true の場合、内容はすぐ近くに配置される必要があります。 false の場合、またはこのフィールドが存在しない場合、内容は呼び出し元の裁量で配置できます。 | Boolean |
| targetPropertyName | 規則が適用されるフィールドの名前。 ターゲットが指定されていない場合、属性はエンティティ全体に適用されます。また、エンティティの表示のすぐ後に表示される必要があります。 ターゲットが指定されていないテキスト属性とリンク属性の規則が複数ある場合、"Data from: " ラベルを使ってそれらを連結して表示する必要があります。 たとえば、"プロバイダー名 1> のデータ <| <provider name2>" |
String |
| text | 属性のテキスト。 | String |
| url | プロバイダーの Web サイトへの URL。 text と URL を使用してハイパーリンクを作成します。 |
String |
MediaAttribution
メディア属性の契約規則を定義します。
| 名前 | 値 | Type |
|---|---|---|
| _type | 種類のヒント。これは MediaAttribution に設定されます。 | String |
| mustBeCloseToContent | 規則の内容が、その規則の適用されるフィールドのすぐ近くに配置される必要があるかどうかを決定するブール値。 true の場合、内容はすぐ近くに配置される必要があります。 false の場合、またはこのフィールドが存在しない場合、内容は呼び出し元の裁量で配置できます。 | Boolean |
| targetPropertyName | 規則が適用されるフィールドの名前。 | String |
| url | メディア コンテンツのハイパーリンクの作成に使用する URL。 たとえば、ターゲットが画像の場合、URL を使用して画像をクリックできるようにします。 | String |
メタタグ
Web ページのメタデータを定義します。
| 名前 | 値 | Type |
|---|---|---|
| コンテンツ | メタデータ。 | String |
| name | メタデータの名前。 | String |
Organization
公開元を定義します。
公開元は、名前、Web サイト、またはその両方を提供する場合があることに注意してください。
| 名前 | 値 | Type |
|---|---|---|
| name | 公開元の名前。 | String |
| url | 公開元の Web サイトへの URL。 公開元が Web サイトを提供しない場合があることに注意してください。 |
String |
クエリ
検索クエリを定義します。
SpellSuggestions オブジェクトは、このオブジェクトを使用して、ユーザーの意図を表す可能性が高いクエリ文字列を提案します。 RelatedSearchAnswer は、他のユーザーが行った関連クエリを返すためにも使用されます。
| 名前 | 値 | Type |
|---|---|---|
| displayText | クエリ用語の表示バージョン。 このバージョンのクエリ用語には、クエリ文字列内の検索用語を強調表示する特殊文字が含まれている場合があります。 文字列には、クエリが強調表示を有効にした場合にのみ強調表示文字が含まれます ( textDecorations クエリ パラメーターを参照してください)。 ヒット強調表示の詳細については、「ヒット 強調表示」を参照してください。 | String |
| テキスト | クエリ文字列。 この文字列は、新しい検索要求のクエリ用語として使用します。 | String |
| webSearchUrl | ユーザーをクエリのBing検索結果ページに移動する URL。 このフィールドには、関連する検索結果のみが含まれます。 |
String |
QueryContext
要求に使用Bingクエリ文字列を定義します。
| 要素 | 説明 | Type |
|---|---|---|
| adultIntent | 指定されたクエリに成人の意図が含まれているかどうかを示すブール値。 クエリに成人の意図がある場合、値は true です 。 true の場合、要求の safeSearch クエリ パラメーターが Strict に設定されている場合、応答にはニュース結果のみが含まれます (該当する場合)。 |
Boolean |
| alterationOverrideQuery | Bing による元の文字列の使用を強制するために使用するクエリ文字列。 たとえば、クエリ文字列が downwind の場合、オーバーライド クエリ文字列は +saling downwind です。 必ずクエリ文字列をエンコードします。その結果、 %2Bsaling+ downwind になります。 オブジェクトには、元のクエリ文字列にスペル ミスが含まれている場合にのみ、このフィールドが含まれます。 |
String |
| alteredQuery | クエリの実行に使用Bingクエリ文字列。 元のクエリ文字列にスペル ミスがあった場合、変更されたクエリ文字列が Bing によって使用されます。 たとえば、クエリ文字列が の場合、 saling downwind変更されたクエリ文字列は です sailing downwind。オブジェクトには、元のクエリ文字列にスペル ミスが含まれている場合にのみ、このフィールドが含まれます。 |
String |
| askUserForLocation | 正確な結果の提供を目的として、Bing からユーザーの位置情報が要求されているかどうかを示すブール値。 X-MSEdge-ClientIP ヘッダーと X-Search-Location ヘッダーを使用してユーザーの位置情報を指定した場合、このフィールドは無視できます。 正確な結果を得るためにユーザーの位置情報が必要な位置情報対応クエリ ("today's weather" や "restaurants near me" など) では、このフィールドは true に設定されます。 位置情報が含まれている位置情報対応クエリ ("Seattle weather" など) では、このフィールドは false に設定されます。 このフィールドは、"ベスト セラー" など、場所に対応していないクエリの 場合も false に設定されます。 |
Boolean |
| originalQuery | 要求で指定されたとおりのクエリ文字列。 | String |
RankingGroup
検索結果グループ (メインラインなど) を定義します。
| 名前 | 値 | Type |
|---|---|---|
| items | グループに表示する検索結果アイテムの一覧。 | RankingItem[] |
RankingItem
表示される検索結果項目を定義します。 ID の使用方法の詳細については、「 ランキングを使用して結果を表示する」を参照してください。
| 名前 | 値 | Type |
|---|---|---|
| answerType | 表示される項目が含まれている回答。 たとえば、News などです。 型を使用して、 SearchResponse オブジェクトで回答を見つけます。 型はフィールドの名前です SearchResponse 。 |
String |
| resultIndex | 回答内の項目の 0 から始まるインデックス。 このフィールドが項目に含まれていない場合、回答のすべての項目が表示されます。 たとえば、News 回答ではすべてのニュース記事が表示されます。 |
Integer |
| value | 表示される回答と表示される回答の項目のいずれかを特定する ID。 ID によって回答が特定される場合、回答の項目がすべて表示されます。 | Identifiable |
RankingResponse
検索結果ページでコンテンツが配置される場所と順序を定義します。
| 名前 | 値 | Type |
|---|---|---|
| mainline | メインラインに表示される検索結果。 | RankingGroup |
| pole | 最も目立つ処理を受ける検索結果 (たとえば、メインラインとサイドバーの上に表示されます)。 | RankingGroup |
| sidebar | サイドバーに表示される検索結果。 | RankingGroup |
RelatedSearchAnswer
他のユーザーが行った関連クエリの一覧を定義します。
| 名前 | 値 | Type |
|---|---|---|
| id | 関連する検索応答を一意に識別する ID。 オブジェクトにこのフィールドが含まれるのは、関連するすべての検索をグループに表示することをランキング回答で指定している場合のみです。 ID の使用方法の詳細については、「 ランク付けを使用して結果を表示する」を参照してください。 |
String |
| value | 他のユーザーによって行われた関連クエリの一覧。 | Query[] |
SearchResponse
検索要求の応答の最上位オブジェクト。
既定では、次の場合を除き、Search API にはすべての回答が含まれます。
クエリは、応答を制限する responseFilter クエリ パラメーターを指定します
1 つ以上の検索コンポーネントが結果を返しません (たとえば、クエリに関連するニュース結果はありません)
サブスクリプション キーは、検索コンポーネントにアクセスできません。
サービスがサービス拒否攻撃の疑いがある場合、要求は成功します (HTTP 状態コードは 200 OK です)、応答の本文は空です。
| 名前 | 値 | Type |
|---|---|---|
| _type | 種類のヒント。 | String |
| 計算 | 数式または単位変換式に対する答え。 | 計算 |
| エンティティ | 検索クエリに関連するエンティティの一覧。 | EntityAnswer |
| 画像 | 検索クエリに関連する画像の一覧。 | イメージ |
| ニュース | 検索クエリに関連するニュース記事の一覧。 | ニュース |
| queryContext | 要求に使用Bingクエリ文字列。 クエリ文字列にスペル ミスが含まれているか、成人向けの意図がある場合にのみ、応答にコンテキストが含まれます。 |
QueryContext |
| rankingResponse | 検索結果の表示を提案Bing順序。 | RankingResponse |
| relatedSearches | 他のユーザーによって行われた関連クエリの一覧。 | RelatedSearchAnswer |
| spellSuggestions | ユーザーの意図を表す可能性が高いクエリ文字列。 | SpellSuggestions |
| タイムゾーン | 1 つ以上の地理的な場所の日付と時刻。 | TimeZone |
| ビデオ | 検索クエリに関連するビデオの一覧。 | ビデオ |
| ウェブページ | 検索クエリに関連する Web ページの一覧。 | WebAnswer |
SpellSuggestions
ユーザーの意図を表す可能性が高い推奨クエリ文字列を定義します。
ユーザーが別の検索を意図している可能性があると判断Bing場合、検索結果にはこの応答が含まれます。 たとえば、ユーザーが alon brown を検索した場合、Bingは、ユーザーが代わりに Alton Brown を検索する可能性が高いと判断する場合があります (Alon Brown の他のユーザーによる過去の検索に基づく)。
| 名前 | 値 | Type |
|---|---|---|
| id | スペル 修正候補の回答を一意に識別する ID。 このフィールドは、 ランキング応答 を使用してスペルの候補を表示するときに使用します。 ID の使用方法の詳細については、「 ランキングを使用して結果を表示する」を参照してください。 |
String |
| value | ユーザーの意図を表す可能性があるクエリ文字列の候補の一覧。 リストに含まれるオブジェクトは 1 つだけ Query です。 |
Query[] |
TextAttribution
プレーンテキスト属性の契約規則を定義します。
| 名前 | 値 | Type |
|---|---|---|
| _type | 種類のヒント。これは TextAttribution に設定されます。 | String |
| text | 属性のテキスト。 テキスト属性はエンティティ全体に適用されます。また、エンティティの表示のすぐ後に表示される必要があります。 ターゲットが指定されていないテキスト属性またはリンク属性の規則が複数ある場合、"Data from: " ラベルを使ってそれらを連結して表示する必要があります。 |
String |
TimeZone
1 つ以上の地理的な場所のデータと時刻を定義します。
| 名前 | 値 | Type |
|---|---|---|
| otherCityTimes | 近くのタイム ゾーンの日付と時刻の一覧。 | TimeZoneInformation[] |
| primaryCityTime | クエリで指定された地理的な場所のデータと時刻 (UTC)。 クエリで特定の地理的な場所 (市区町村など) を指定した場合、このオブジェクトには、地理的な場所の名前と場所の現在の日付と時刻が UTC で格納されます。 クエリで州や国などの一般的な地理的な場所が指定されている場合、このオブジェクトには、指定した州または国で見つかった主要な都市または州の日付と時刻が含まれます。 場所に追加のタイム ゾーンが含まれている場合、 otherCityTimes フィールドには他のタイム ゾーンにある都市または州のデータと時刻が含まれます。 |
TimeZoneInformation |
TimeZoneInformation
地理的な場所の日付と時刻を定義します。
| 名前 | 値 | Type |
|---|---|---|
| 場所 | 地理的な場所の名前。 たとえば、郡。都市;市区町村、州;市区町村, 州, 国;またはタイム ゾーン。 |
String |
| 時間 | YYYY-MM-DDThh;mm:ss.sssssZ という形式で指定されたデータと時刻。 | String |
| utcOffset | UTC からのオフセット。 たとえば、UTC-7 です。 | String |
WebAnswer
関連する Web ページ リンクの一覧を定義します。
| 名前 | 値 | Type |
|---|---|---|
| id | Web 回答を一意に識別する ID。 オブジェクトにこのフィールドが含まれるのは、ランキングの回答で、すべての Web 結果をグループに表示することを提案した場合のみです。 ID の使用方法の詳細については、「 ランキングを使用して結果を表示する」を参照してください。 |
String |
| someResultsRemoved | 応答が回答から一部の結果を除外したかどうかを示すブール値。 一部の結果Bing除外された場合、値は true になります。 | Boolean |
| totalEstimatedMatches | クエリに関連する Web ページの推定数。 この数値を count および offset クエリ パラメーターと共に使用して、結果をページングします。 | Long |
| value | クエリに関連する Web ページの一覧。 | WebPage[] |
| webSearchUrl | 要求された Web ページのBing検索結果の URL。 | String |
Web ページ
クエリに関連する Web ページを定義します。
| 名前 | 値 | Type |
|---|---|---|
| about | 内部使用専用です。 | Object |
| dateLastCrawled | Bingが最後に Web ページをクロールした時刻。 日付は、YYYY-MM-DDTHH:MM:SS の形式です。 たとえば、2015-04-13T05:23:39 などです。 | String |
| deepLinks | この Web ページを含む Web サイトでBing関連するコンテンツへのリンクの一覧。Webpageこのコンテキストの オブジェクトには、、url、urlPingSuffix、および snippet フィールドのみがname含まれます。 |
Web ページ[] |
| displayUrl | Web ページの表示 URL。 URL は表示のみを目的としており、適切な形式ではありません。 | String |
| id | Web 結果の一覧でこの Web ページを一意に識別する ID。 オブジェクトにこのフィールドが含まれるのは、ランキングの回答で Web ページと他の検索結果の組み合わせが指定されている場合のみです。 各 Web ページには、ランキング回答の ID と一致する ID が含まれています。 詳細については、「 ランク付けを使用して結果を表示する」を参照してください。 |
String |
| 名前 | Web ページの名前。 この名前を と url 共に使用して、クリックするとユーザーが Web ページに移動するハイパーリンクを作成します。 |
String |
| 言及 | 内部使用専用です。 | Object |
| searchTags | Web ページの所有者が Web ページで指定した検索タグの一覧。 API は、インデックス付き検索タグのみを返します。nameオブジェクトの フィールドには、MetaTagインデックス付き検索タグが含まれています。 検索タグは search.* で始まります (search.assetId など)。 フィールドには content タグの値が含まれます。 |
MetaTag[] |
| スニペット | その内容を説明する Web ページからのテキストのスニペット。 | String |
| url | Web ページの URL。 この URL を と name 共に使用して、クリックするとユーザーが Web ページに移動するハイパーリンクを作成します。 |
String |
エンティティ型
このセクションには、考えられるエンティティ ヒントが含まれています。 ヒントはエンティティのカテゴリ別にグループ化されます。
基本エンティティの種類を次に示します。
- ジェネリック
- Person
- 場所
- メディア
- Organization
Place 基本型に該当するエンティティ ヒントを次に示します。
- Attraction
- City
- Continent
- 国
- Hotel
- 自社
- LocalBusiness
- 局所性
- MinorRegion
- "近隣"
- その他
- PointOfInterest
- PostalCode
- RadioStation
- リージョン
- レストラン
- State
- StreetAddress
- SubRegion
- TouristAttraction
- トラベル
Media 基本型に該当するエンティティ ヒントを次に示します。
- Book
- 映画
- TelevisionSeason
- テレビショー
- ビデオゲーム
イベント関連のエンティティ ヒントを次に示します。
- イベント
職業関連のエンティティ ヒントを次に示します。
- Actor
- Artist
- 弁護士
教育関連のエンティティ ヒントを次に示します。
- CollegeOrUniversity
- 学校
- 専門
関連のないエンティティ ヒントを次に示します。
- 動物
- Car
- 薬物
- 食品
- Product
- SportsTeam
エラー コード
要求によって返される可能性のある HTTP 状態コードを次に示します。
| 状態コード | 説明 |
|---|---|
| 200 | 正常終了しました。 |
| 400 | クエリ パラメーターの 1 つが欠落しているか無効です。 |
| 401 | サブスクリプション キーが見つからないか、無効です。 |
| 403 | (たとえば、有効なサブスクリプション キーを使用して) ユーザーは認証されたものの、要求されたリソースへのアクセス許可がありません。 また、呼び出し元が 1 か月あたりのクエリ数のクォータを超えた場合にも、Bing はこの状態を返します。 |
| 410 | HTTPS プロトコルではなく HTTP プロトコルが使用された要求。 サポートされるプロトコルは HTTPS のみです。 |
| 429 | 呼び出し元が 1 秒あたりのクエリ数のクォータを超えました。 |
| 500 | 予期しないサーバー エラー。 |
要求が失敗すると、応答に ErrorResponse オブジェクトが含まれます。このオブジェクトには、エラーの原因を示す Error オブジェクトの一覧が含まれています。 エラーがパラメーターに関連している場合、parameter フィールドで、問題であるパラメーターが特定されます。 エラーがパラメーター値に関連している場合、value フィールドで、無効な値が特定されます。
{
"_type": "ErrorResponse",
"errors": [
{
"code": "InvalidRequest",
"subCode": "ParameterMissing",
"message": "Required parameter is missing.",
"parameter": "q"
}
]
}
{
"_type": "ErrorResponse",
"errors": [
{
"code": "InvalidAuthorization",
"subCode": "AuthorizationMissing",
"message": "Authorization is required.",
"moreDetails": "Subscription key is not recognized."
}
]
}
考えられるエラー コードとサブエラー コードの値を次に示します。
| コード | サブコード | 説明 |
|---|---|---|
| ServerError | UnexpectedError ResourceError NotImplemented |
HTTP 状態コードは 500 です。 |
| InvalidRequest | ParameterMissing ParameterInvalidValue HttpNotAllowed Blocked |
要求の一部が有効でない場合に Bing は InvalidRequest を返します。 たとえば、必要なパラメーターが不足している場合や、パラメーター値が無効な場合です。 エラーが ParameterMissing または ParameterInvalidValue の場合、HTTP 状態コードは 400 です。 HTTPS プロトコルではなく HTTP プロトコルを使用すると、Bing は HttpNotAllowed を返し、HTTP 状態コードは 410 になります。 |
| RateLimitExceeded | No sub-codes | 1 秒あたりのクエリ数 (QPS) または 1 か月あたりのクエリ数 (QPM) のクォータを超えると、Bing は RateLimitExceeded を返します。 QPS を超えた場合、Bing は HTTP 状態コード 429 を返します。また、QPM を超えた場合、Bing は 403 を返します。 |
| InvalidAuthorization | AuthorizationMissing AuthorizationRedundancy |
Bing は、呼び出し元を認証できない場合に InvalidAuthorization を返します。 たとえば、Ocp-Apim-Subscription-Key ヘッダーがない場合や、サブスクリプション キーが無効な場合です。冗長性は、複数の認証方法を指定した場合に発生します。 エラーが InvalidAuthorization の場合、HTTP 状態コードは 401 です。 |
| InsufficientAuthorization | AuthorizationDisabled AuthorizationExpired |
呼び出し元がリソースに対するアクセス許可を備えていない場合、Bing は InsufficientAuthorization を返します。 これは、サブスクリプション キーが無効になっているか、期限が切れている場合に発生することがあります。 エラーが InsufficientAuthorization の場合、HTTP 状態コードは 403 です。 |
市場コード
次の表に、クエリ パラメーターの指定に使用できる市場コード値を mkt 示します。 Bing はこれらの市場に対してのみコンテンツを返します。 一覧は変更されることがあります。
クエリ パラメーターで cc 指定できる国コードの一覧については、「 国コード」を参照してください。
| 国/地域 | Language | 市場コード |
|---|---|---|
| アルゼンチン | スペイン語 | es-AR |
| オーストラリア | 英語 | en-AU |
| オーストリア | ドイツ語 | de-AT |
| ベルギー | オランダ語 | nl-BE |
| ベルギー | フランス語 | fr-BE |
| ブラジル | Portuguese | pt-BR |
| Canada | 英語 | en-CA |
| Canada | フランス語 | fr-CA |
| チリ | スペイン語 | es-CL |
| デンマーク | デンマーク語 | da-DK |
| フィンランド | フィンランド語 | fi-FI |
| フランス | フランス語 | fr-FR |
| ドイツ | ドイツ語 | de-DE |
| 香港特別行政区 | Traditional Chinese | zh-HK |
| インド | 英語 | en-IN |
| インドネシア | 英語 | en-ID |
| イタリア | イタリア語 | it-IT |
| 日本 | 日本語 | ja-JP |
| 韓国 | 韓国語 | ko-KR |
| マレーシア | 英語 | en-MY |
| メキシコ | スペイン語 | es-MX |
| オランダ | オランダ語 | nl-NL |
| ニュージーランド | 英語 | en-NZ |
| ノルウェー | ノルウェー語 | no-NO |
| 中華人民共和国 | Chinese | zh-CN |
| ポーランド | ポーランド語 | pl-PL |
| フィリピン共和国 | 英語 | en-PH |
| ロシア | ロシア語 | ru-RU |
| 南アフリカ | 英語 | en-ZA |
| スペイン | スペイン語 | es-ES |
| スウェーデン | スウェーデン語 | sv-SE |
| スイス | フランス語 | fr-CH |
| スイス | ドイツ語 | de-CH |
| 台湾 | Traditional Chinese | zh-TW |
| トルコ | トルコ語 | tr-TR |
| イギリス | 英語 | en-GB |
| United States | 英語 | ja-JP |
| United States | スペイン語 | es-US |
国コード
cc クエリ パラメーターで指定できる国番号を次に示します。 一覧は変更されることがあります。
| 国/リージョン | 国番号 |
|---|---|
| アルゼンチン | AR |
| オーストラリア | AU |
| オーストリア | AT |
| ベルギー | BE |
| ブラジル | BR |
| Canada | CA |
| チリ | CL |
| デンマーク | DK |
| フィンランド | FI |
| フランス | FR |
| ドイツ | DE |
| 香港特別行政区 | HK |
| インド | IN |
| インドネシア | id |
| イタリア | IT |
| 日本 | JP |
| 韓国 | KR |
| マレーシア | MY |
| メキシコ | MX |
| オランダ | NL |
| ニュージーランド | NZ |
| ノルウェー | NO |
| 中華人民共和国 | CN |
| ポーランド | PL |
| ポルトガル | PT |
| フィリピン共和国 | PH |
| ロシア | RU |
| サウジアラビア | SA |
| 南アフリカ | ZA |
| スペイン | ES |
| スウェーデン | SE |
| スイス | CH |
| 台湾 | TW |
| トルコ | TR |
| イギリス | GB |
| United States | US |
サポートされている言語をBingする
クエリ パラメーターで指定できるBingサポートされている言語を次に setLang 示します。 一覧は変更されることがあります。
| サポートされている言語 | 言語コード |
|---|---|
| アラビア語 | ar |
| バスク語 | eu |
| ベンガル語 | bn |
| ブルガリア語 | bg |
| カタロニア語 | ca |
| 簡体中国語 | zh-hans |
| 繁体中国語 | zh-hant |
| クロアチア語 | hr |
| チェコ語 | cs |
| デンマーク語 | da |
| オランダ語 | nl |
| 英語 | en |
| English-United 王国 | en-gb |
| エストニア語 | et |
| フィンランド語 | fi |
| フランス語 | fr |
| ガリシア語 | gl |
| ドイツ語 | de |
| グジャラート語 | gu |
| ヘブライ語 | he |
| ヒンディー語 | hi |
| ハンガリー語 | hu |
| アイスランド語 | : |
| イタリア語 | it |
| 日本語 | Jp |
| カンナダ語 | kn |
| 韓国語 | ko |
| ラトビア語 | lv |
| リトアニア語 | lt |
| マレー語 | ms |
| マラヤーラム語 | ml |
| マラーティー語 | mr |
| ノルウェー語 - ブークモール | nb |
| ポーランド語 | pl |
| ポルトガル語 (ブラジル) | pt-br |
| ポルトガル語 (ポルトガル) | pt-pt |
| パンジャブ語 | pa |
| ルーマニア語 | ro |
| ロシア語 | ru |
| セルビア語 (Cyrylic) | sr |
| スロバキア語 | sk |
| スロベニア語 | sl |
| スペイン語 | es |
| スウェーデン語 | sv |
| タミール語 | ta |
| テルグ語 | te |
| タイ語 | th |
| トルコ語 | tr |
| ウクライナ語 | uk |
| ベトナム語 | vi |