検索応答に含まれる回答をフィルタリングする

  • [アーティクル]

警告

2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。

Web のクエリを実行すると、Bing はその検索で見つけたすべての関連コンテンツを返します。 たとえば、検索クエリが "sailing+dinghies" の場合、応答に次のような回答が含まれる可能性があります。

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43C...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    },
    "images" : {
        "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
        "readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA5CA6464E5D...",
        "isFamilyFriendly" : true,
        "value" : [...]
    },
    "rankingResponse" : {
        "mainline" : {
            "items" : [...]
        }
    }
}

クエリ パラメーター

Bing から返される応答をフィルター処理するには、API を呼び出すときに以下のクエリ パラメーターを使用します。

responseFilter

回答のコンマ区切りリストである responseFilter クエリ パラメーターを使用すれば、Bing が応答に取り込む回答の種類 (たとえば、画像、ビデオ、ニュースなど) をフィルター処理することができます。 Bing によって回答に関連するコンテンツが検出された場合、その回答は応答に含められます。

応答から画像などの特定の回答を除外するには、回答の種類の先頭に - 文字を追加します。 次に例を示します。

&responseFilter=-images,-videos

次の例は、responseFilter を使用して「sailing dinghies」の画像、ビデオ、ニュースを要求する方法を示しています。 クエリ文字列をエンコードすると、コンマは %2C になります。

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&responseFilter=images%2Cvideos%2Cnews&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

前のクエリに対する応答を次に示します。 Bing では、関連するビデオやニュースの結果が見つかっていないため、それらは応答に含まれません。

{
    "_type" : "SearchResponse",
    "images" : {
        "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
        "readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3AD78B183C56456C...",
        "isFamilyFriendly" : true,
        "value" : [...]
    },
    "rankingResponse" : {
        "mainline" : {
            "items" : [{
                "answerType" : "Images",
                "value" : {
                    "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images"
                }
            }]
        }
    }
}

前の応答では、Bing はビデオやニュースの結果を返しませんでしたが、ビデオやニュースのコンテンツが存在しないということではありません。 単に、それらがページに含まれていなかったことを意味します。 ただし、ページを移動して他の結果を表示すれば、後続のページには含まれている可能性があります。 また、直接 Video Search API や News Search API のエンドポイントを呼び出すと、結果が応答に含まれる可能性があります。

単一の API から結果を取得するために responseFilter を使うことはお勧めできません。 単一の Bing API からコンテンツを取得する場合は、その API を直接呼び出します。 たとえば、イメージのみを受信するには、Image Search API のエンドポイントである https://api.cognitive.microsoft.com/bing/v7.0/images/search、またはその他のイメージ エンドポイントのいずれかに要求を送信します。 単一の API を呼び出すことが重要なのは、パフォーマンスが向上するためだけでなく、コンテンツに固有の API の方がより詳細な結果を提供するためです。 たとえば、Web Search API では使用できないフィルターを使用して結果をフィルタリングすることができます。

サイト

特定のドメインから検索結果を得るには、クエリ文字列に site: クエリ パラメーターを含めます。

https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us

Note

クエリによっては、site: クエリ演算子を使用した場合、safeSearch 設定にかかわらず、成人向けのコンテンツが応答に含まれることがあります。 site: の使用は、そのサイト上のコンテンツを承知していて、なおかつ成人向けのコンテンツが含まれていても問題がないシナリオに限定してください。

鮮度

Web 回答の結果を、特定の期間中に Bing が検出した Web ページに限定するには、freshness クエリ パラメーターを、大文字と小文字が区別されない次の値のいずれかに設定します。

  • Day — 過去 24 時間の間に Bing が検出した Web ページを返します
  • Week — 過去 7 日の間に Bing が検出した Web ページを返します
  • Month — 過去 30 日の間に検出された Web ページを返します

また、このパラメーターは、YYYY-MM-DD..YYYY-MM-DD という形式でカスタム日付範囲に設定することもできます。

https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-01..2019-05-30

結果を単一の日付に限定するには、freshness パラメーターを次のように特定の日付に設定します。

https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-04

ご利用のフィルター基準に対して Bing が一致した Web ページの数が、要求した Web ページの数 (または Bing が返す既定の数) より少ない場合、結果には指定した期間外の Web ページが含まれることがあります。

応答の回答数を制限する

Bing では、複数の回答の種類を JSON 応答で返すことができます。 たとえば、sailing+dinghies クエリを実行すると、Bing からは webpages、images、videos、および relatedSearches が返されます。

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "relatedSearches" : {...},
    "videos" : {...},
    "rankingResponse" : {...}
}

Bing が返す回答数を上位 2 つの回答 (Web ページと画像) に制限するには、answerCount クエリ パラメーターを 2 に設定します。

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

応答には、webPages と images のみが含まれます。

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "rankingResponse" : {...}
}

上のクエリに responseFilter クエリ パラメーターを追加して Web ページとニュースを設定すると、ニュースがランク付けされなくなり、応答には Web ページのみが含まれます。

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "rankingResponse" : {...}
}

ランク付けされない回答を昇格する

クエリに対して Bing から返される上位ランクの回答が Web ページ、画像、ビデオ、および relatedSearches である場合、応答にはこれらの回答が含まれます。 answerCount を 2 に設定した場合、Bing はランク付けされた上位の 2 つの回答である Web ページと画像を返します。 Bing の応答に画像とビデオを含めたい場合は、promote クエリ パラメーターを指定し、画像とビデオを設定します。

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&promote=images%2Cvideos&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

上の要求への応答は次のようになります。 Bing は、上位 2 つの回答である Web ページと画像を返し、ビデオを昇格させて回答に含めます。

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailiing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "videos" : {...},
    "rankingResponse" : {...}
}

promote にニュースを設定しても、ニュースの回答はランク付けされていないので、応答にニュースの回答は含まれません。昇格できるのは、ランク付けされている回答のみです。

昇格させる回答は、answerCount の制限にはカウントされません。 たとえば、ランク付けされた回答がニュース、画像、およびビデオで、answerCount を 1、promote をニュースに設定した場合、応答にはニュースと画像が含まれます。 または、ランク付けされた回答がビデオ、画像、およびニュースである場合、応答にはビデオとニュースが含まれます。

promote は、answerCount クエリ パラメーターを指定する場合のみ使用できます。