WebSearchOptionalParams interface

ユーザー インターフェイス文字列に使用する 1 つ以上の言語のコンマ区切りのリスト。 リストでは優先度の高いものから順に指定します。 必要な形式など、その他の情報については、「 RFC2616」を参照してください。 このヘッダーと setLang クエリ パラメーターは相互に排他的です。両方を指定しないでください。 このヘッダーを設定する場合は、cc クエリ パラメーターも指定する必要があります。 Bingは、リストから検索した最初のサポートされている言語を使用し、その言語と cc パラメーター値を組み合わせて、結果を返す市場を決定します。 一覧にサポートされている言語が含まれていない場合、Bingは要求をサポートする最も近い言語と市場を検索し、指定された言語ではなく集計または既定の市場を結果に使用できます。 このヘッダーと cc クエリ パラメーターは、複数の言語を指定する場合にのみ使用する必要があります。それ以外の場合は、mkt クエリ パラメーターと setLang クエリ パラメーターを使用する必要があります。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、ユーザー インターフェイス文字列はほとんどありません。 応答オブジェクト内の Bing.com プロパティへのリンクは、指定された言語を適用します。

acceptLanguage?: string

プロパティ値

応答に含める回答の数。 Bing返される回答は、ランキングに基づいています。 たとえば、Bingが要求の Web ページ、画像、ビデオ、および関連検索を返し、このパラメーターを 2 (2) に設定した場合、応答には Web ページと画像が含まれます。同じ要求に responseFilter クエリ パラメーターを含めて Web ページとニュースに設定した場合、応答には Web ページのみが含まれます。

answerCount?: number

プロパティ値

このヘッダーは、Bing API の呼び出し間で一貫性のある動作をユーザーに提供するために Bing によって使用されます。 Bing によって、新しい機能と改善点が頻繁にフライト化されます。そして、トラフィックを異なるフライトに割り当てるためのキーとして、クライアント ID が使用されます。 複数の要求に対してユーザーの同じクライアント ID を使用しないと、ユーザーが複数の競合するフライトに割り当てられる可能性があります。 複数の競合するフライトに割り当てられると、ユーザー エクスペリエンスの一貫性がなくなる場合があります。 たとえば、2 番目の要求に 1 番目とは異なるフライトが割り当てられていると、エクスペリエンスが予期しないものになる可能性があります。 また、クライアント ID は、そのクライアント ID の検索履歴に合わせて Web の結果を調整し、ユーザーにリッチなエクスペリエンスを提供するために Bing によって使用される場合があります。 このヘッダーは、クライアント ID で生成されたアクティビティを分析して結果の順位付けを向上させるために Bing によって使用されることもあります。 関連性の向上は、Bing API によって提供される結果の品質向上に役立ち、API コンシューマーのクリックスルー率の向上を実現します。 重要: このヘッダーは省略可能ですが、必須であると考える必要があります。 同じエンド ユーザーとデバイスの組み合わせによる複数の要求に対してクライアント ID を保持することで、1) API コンシューマーが一貫性のあるユーザー エクスペリエンスを受け取ることができ、2) Bing API からの結果の品質向上を通じてクリックスルー率の向上が実現します。 デバイスでアプリケーションを使用する各ユーザーは、Bing によって生成された一意のクライアント ID を持っている必要があります。 このヘッダーを要求に含めない場合、Bing によって ID が生成され、それが X-MSEdge-ClientID 応答ヘッダーで返されます。 このヘッダーを要求に含めるべきでない唯一の場合は、ユーザーがそのデバイスでアプリを初めて使用するときです。 そのユーザーのためにアプリによってデバイスで実行される各 Bing API 要求で、クライアント ID を使用します。 クライアント ID を保持します。 ブラウザー アプリで ID を永続化するには、永続的な HTTP Cookie を使用して ID がすべてのセッションで確実に使用されるようにします。 セッション Cookie は使用しないようにしてください。 モバイル アプリなど、他のアプリの場合は、デバイスの永続的ストレージを使用して ID を保持します。 次にそのデバイスでユーザーがアプリを使用するときに、保持したクライアント ID を取得します。 Bing の応答には、このヘッダーが含まれる場合と含まれない場合があります。 このヘッダーが応答に含まれる場合、クライアント ID をキャプチャして、ユーザーのためにそのデバイスで実行される後続のすべての Bing 要求でそれを使用します。 X-MSEdge-ClientID を含める場合、要求には Cookie を含めないようにしてください。

clientId?: string

プロパティ値

クライアント デバイスの IPv4 アドレスまたは IPv6 アドレス。 IP アドレスは、ユーザーの位置情報の検出に使用されます。 位置情報は、安全な検索動作を決定するために Bing によって使用されます。 省略可能ですが、このヘッダーと X-Search-Location ヘッダーは常に指定することをお勧めします。 (最後のオクテットを 0 に変更するなど) アドレスを難読化しないようにしてください。 アドレスを難読化すると、デバイスの実際の場所から離れた場所が検出され、Bing から誤った結果が提供される可能性があります。

clientIp?: string

プロパティ値

応答で返される検索結果の数。 既定値は 10 で、最大値は 50 です。 実際に配信される数値は、要求された数より小さい場合があります。このパラメーターを offset パラメーターと共に使用して、結果をページングします。たとえば、ユーザー インターフェイスに 1 ページあたり 10 件の検索結果が表示される場合は、count を 10 に設定し、オフセットを 0 に設定して、結果の最初のページを取得します。 後続のページごとに、オフセットを 10 ずつインクリメントします (例: 0、10、20)。 複数のページで結果に重複を含めることができます。

count?: number

プロパティ値

結果を取得する国の 2 文字の国番号です。 この API では、米国市場のみがサポートされます。 このクエリ パラメーターを指定する場合は、 に設定する必要があります。 このパラメーターを設定する場合は、Accept-Language ヘッダーも指定する必要があります。 Bingでは、言語リストから最初にサポートされている言語を使用し、その言語と指定した国コードを組み合わせて、結果を返す市場を決定します。 言語リストにサポートされている言語が含まれていない場合は、Bingは要求をサポートする最も近い言語と市場を検索するか、指定された言語ではなく集計または既定の市場を結果に使用できます。 このクエリ パラメーターと Accept-Language クエリ パラメーターは、複数の言語を指定する場合にのみ使用する必要があります。それ以外の場合は、mkt クエリ パラメーターと setLang クエリ パラメーターを使用する必要があります。 このパラメーターと mkt クエリ パラメーターは相互に排他的なので、両方指定することはできません。

countryCode?: string

プロパティ値

次の期間の値で検索結果をフィルター処理します: Day — 過去 24 時間以内に検出Bing Web ページを返します。 週 — 過去 7 日以内に検出Bing Web ページを返します。 Month - 過去 30 日以内に検出された Web ページを返します。 このフィルターは Web ページの結果にのみ適用され、ニュースや画像などの他の結果には適用されません。 使用できる値は、'Day'、'Week'、'Month' です。

freshness?: Freshness

プロパティ値

クライアントの地理的な場所を示す、キーと値のペアのセミコロン区切りリストです。 位置情報は、安全な検索動作を決定して関連するローカル コンテンツを返すために、Bing によって使用されます。 キーと値のペアは、: の形式で指定します。 ユーザーの場所の指定に使用するキーは次のとおりです。 lat (必須): クライアントの場所の緯度 (度単位)。 緯度は、-90.0 以上、+90.0 以下である必要があります。 負の値は南半球の緯度を示し、正の値は北半球の緯度を示します。 long (必須): クライアントの場所の経度 (度単位)。 経度は、-180.0 以上、+180.0 以下である必要があります。 負の値は西半球の経度を示し、正の値は東半球の経度を示します。 re (必須): 座標の水平方向の精度を指定する半径 (メートル単位)。 デバイスの位置情報サービスによって返される値を渡します。 一般的な値は、GPS/Wi-Fi の 22 m、携帯電話基地局の三角測量の 380 m、IP 逆引き参照の 18,000 m などです。 ts (省略可能): クライアントが場所にあった時の UTC UNIX タイムスタンプ。 (UNIX タイムスタンプは、1970 年 1 月 1 日以降の秒数です)。head (省略可能): クライアントの相対見出しまたは移動方向。 移動方向は、真北を基準として時計回りに 0 から 360 度で指定します。 sp キーが 0 以外の場合にのみ、このキーを指定します。 sp (省略可能): クライアント デバイスが移動している水平方向の速度 (速度)(1 秒あたりのメートル単位)。 alt (省略可能): クライアント デバイスの高度 (メートル単位)。 are (省略可能): 座標の垂直方向の精度を指定する半径 (メートル単位)。 alt キーを指定する場合にのみ、このキーを指定します。 多くのキーは省略可能ですが、提供する情報が多いほど、場所の結果の正確さが増します。 省略可能ですが、ユーザーの地理的な場所は常に指定することをお勧めします。 位置情報を提供することは、クライアントの IP アドレスがユーザーの物理的な場所を正確に反映していない場合 (たとえば、クライアントによって VPN が使用されている場合) に特に重要です。 最適な結果を得るには、このヘッダーと X-MSEdge-ClientIP ヘッダーを含める必要がありますが、最低限、このヘッダーを含めることをお勧めします。

location?: string

プロパティ値

結果の取得元の市場。 通常、mkt はユーザーが要求を行っている国です。 ただし、ユーザーが結果を提供する国にいない場合は、別の国Bing可能性があります。 市場は、 形式である必要があります。 たとえば、en-US などです。 文字列では大文字と小文字が区別されません。 既知の場合は、常に市場を指定することをお勧めします。 市場を指定すると、Bing が要求をルーティングして最適な応答を返すのに役立ちます。 市場コードに記載されていない市場を指定した場合、Bingは、変更される可能性がある内部マッピングに基づいて最適な市場コードを使用します。 このパラメーターと cc クエリ パラメーターは相互に排他的なので、両方指定することはできません。 既定値は 'en-us' です。

market?: string

プロパティ値

結果を返す前にスキップする検索結果の数を示す 0 から始まるオフセット。 既定値は 0 です。 オフセットは (totalEstimatedMatches - count) 未満にする必要があります。 このパラメーターを count パラメーターと共に使用して、結果をページングします。 たとえば、ユーザー インターフェイスに 1 ページあたり 10 件の検索結果が表示される場合は、count を 10 に、オフセットを 0 に設定して結果の最初のページを取得します。 後続のページごとに、オフセットを 10 ずつ増やします (0、10、20 など)。 複数のページで結果に重複を含めることができます。

offset?: number

プロパティ値

既定では、Bing はキャッシュされたコンテンツがある場合にそれを返します。 キャッシュされたコンテンツを Bing が返さないようにするには、Pragma ヘッダーを no-cache に設定します (例: Pragma: no-cache)。

pragma?: string

プロパティ値

ランク付けに関係なく、応答に含める回答のコンマ区切りのリスト。 たとえば、answerCount) を 2 (2) に設定して、上位 2 つのランク付けされた回答を返Bing、応答にニュースを含める場合は、promote をニュースに設定します。 上位ランクの回答が Web ページ、画像、ビデオ、および関連する検索である場合、ニュースはランク付けされた回答ではないので、応答には Web ページと画像が含まれます。 ただし、[ビデオへの昇格] を設定すると、Bingはビデオの回答を応答に昇格させ、Web ページ、画像、ビデオを返します。 昇格する回答は、answerCount 制限に対してカウントされません。 たとえば、ランク付けされた回答がニュース、画像、ビデオで、answerCount を 1 に設定してニュースに昇格した場合、応答にはニュースと画像が含まれます。 または、ランク付けされた回答がビデオ、画像、およびニュースである場合、応答にはビデオとニュースが含まれます。 使用できる値は、コンピュテーション、画像、ニュース、RelatedSearches、SpellSuggestions、TimeZone、Videos、Web ページです。 answerCount を指定する場合にのみ使用します。

promote?: AnswerType[]

プロパティ値

応答に含める回答のコンマ区切りのリスト。 このパラメーターを指定しない場合、応答には、関連するデータがあるすべての検索回答が含まれます。 使用可能なフィルター値は、コンピュテーション、画像、ニュース、RelatedSearches、SpellSuggestions、TimeZone、Videos、Web ページです。 このフィルターを使用して 1 つの回答を取得することもできますが、より豊富な結果を得るには、代わりに回答固有のエンドポイントを使用する必要があります。 たとえば、イメージのみを受信するには、Image Search API エンドポイントのいずれかに要求を送信します。 RelatedSearches と SpellSuggestions の回答では、Image Search API のように個別のエンドポイントはサポートされていません (Web Search API のみがそれらを返します)。 ランク付けのために除外される回答を含めるには、昇格クエリ パラメーターを参照してください。

responseFilter?: AnswerType[]

プロパティ値

成人向けコンテンツのフィルター処理に使用されるフィルター。 オフ: 成人向けのテキスト、画像、またはビデオを含む Web ページを返します。 中: 成人向けテキストを含む Web ページを返しますが、成人向けの画像やビデオは返しません。 Strict: 成人向けテキスト、画像、またはビデオを含む Web ページは返さないでください。 既定値は Moderate です。 Bingの成人向けポリシーで safeSearch が Strict に設定されている必要がある市場からの要求の場合、Bingは safeSearch 値を無視し、Strict を使用します。 site: クエリ演算子を使用する場合、safeSearch クエリ パラメーターの設定に関係なく、応答に成人向けコンテンツが含まれる可能性があります。 サイトを使用する: サイト上のコンテンツを認識していて、シナリオが成人コンテンツの可能性をサポートしている場合にのみ使用します。 使用可能な値は、'Off'、'Moderate'、'Strict' です。

safeSearch?: SafeSearch

プロパティ値

ユーザー インターフェイス文字列に使用する言語。 ISO 639-1 の 2 文字言語コードを使って言語を指定します。 たとえば、英語の言語コードは EN です。 既定値は EN (英語) です。 省略可能ですが、常に言語を指定することをお勧めします。 通常、ユーザーがユーザー インターフェイス文字列を別の言語で表示する場合を除き、setLang を mkt で指定された言語に設定します。 このパラメーターと Accept-Language ヘッダーは相互に排他的です。両方を指定しないでください。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 また、応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。

setLang?: string

プロパティ値

表示文字列に、ヒット強調表示文字などの装飾マーカーを含めるかどうかを決定するブール値。 true の場合、文字列にマーカーを含めることができます。 既定値は false です。 マーカーとして Unicode 文字または HTML タグを使用するかどうかを指定するには、textFormat クエリ パラメーターを参照してください。

textDecorations?: boolean

プロパティ値

テキスト装飾に使用するマーカーの種類 (textDecorations クエリ パラメーターを参照)。 使用できる値は Raw です。Unicode 文字を使用して、特別な書式設定が必要なコンテンツをマークします。 Unicode 文字の範囲は E000 から E019 です。 たとえば、Bingでは、E000 と E001 を使用して、クエリ用語の先頭と末尾にヒット強調表示のマークを付けます。 HTML — HTML タグを使用して、特別な書式設定が必要なコンテンツをマークします。 たとえば、タグを使用して 、表示文字列内のクエリ用語を強調表示します。 既定値は Raw です。 、、& などの<>エスケープ可能な HTML 文字を含む表示文字列の場合、textFormat が HTML に設定されている場合、Bingは文字を適切にエスケープします (たとえば、 < は に<エスケープされます)。 使用可能な値は次のとおりです: 'Raw'、'Html'

textFormat?: TextFormat