篩選搜尋回應所包含的答案

發行項
07/08/2019

警告

在 2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋服務。本文件僅供參考之用。如需更新的文件，請參閱 Bing 搜尋 API 文件。如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。

當您查詢 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 未在前一個回應中傳回影片和新聞結果，但不表示影片和新聞內容不存在。這只是表示此頁面未包含它們。不過，如果您翻閱更多結果，後續的頁面可能就會包含它們。此外，如果您直接呼叫影片搜尋 API 和新聞搜尋 API 端點，回應很可能就會包含結果。

不建議您使用 responseFilter 來從單一 API 取得結果。如果您想要來自單一 Bing API 的內容，請直接呼叫該 API。例如，如果只要接收影像，將要求傳送到影像搜尋 API 端點 https://api.cognitive.microsoft.com/bing/v7.0/images/search 或其他影像端點之一。呼叫單一 API 非常重要，不只是出於效能考量，而且還因為內容特定的 API 會提供更豐富的結果。例如，您可以使用不適用 Web 搜尋 API 的篩選來篩選結果。

網站

若要取得特定網域中的搜尋結果，請在查詢字串中包括 site: 查詢參數。

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

注意

視查詢而定，如果您使用 site: 查詢運算子，不論 safeSearch 設定為何，回應都有可能包含成人內容。只有在您了解網站上的內容，而且您的案例支援成人內容的可能性時，才得以使用 site:。

時效性

若要將 web 答案結果限制為在特定期間內 Bing 探索到的網頁，請將 freshness 查詢參數設定為下列其中一個不區分大小寫的值：

Day — 傳回 Bing 在過去 24 小時內探索到的網頁
Week — 傳回 Bing 在過去 7 天內探索到的網頁
Month — 傳回在過去 30 天內探索到的網頁

您也可以將此參數設定為表單中的自訂日期範圍，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 符合您篩選準則的網頁數目小於您所要求的網頁數目 (或 Bing 傳回的預設數目)，則結果可能會包含落在指定期間之外的網頁。

限制回應中的答案數目

Bing 可以在 JSON 回應中傳回多個答案類型。例如，如果您查詢 sailing+dinghies，則 Bing 可能會傳回 webpages、images、videos 及 relatedSearches。

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

若要將 Bing 傳回的答案數目限制為前兩個答案 (webpages 和 images)，請將 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 查詢參數新增到前一個查詢，並將它設為 webpages 和 news，回應就只會包含 webpages，因為不會將 news 設為順位。

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

提升未設為順位的答案

如果 Bing 針對查詢所傳回的前幾個順位的答案為 webpages、images、videos 及 relatedSearches，則回應會包含那些答案。如果您將 answerCount \(英文\) 設為二 (2)，Bing 就會傳回前兩個順位的答案：webpages 和 images。如果您想要 Bing 在回應中包含 images 和 videos，請指定 promote \(英文\) 查詢參數，並將它設為 images 和 videos。

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 會傳回前兩個答案 webpages 和 images，並將 videos 提升到答案中。

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

如果您將 promote 設為 news，回應就不會包含 news 答案，因為其並非已設為順位的答案；您只能提升已設為順位的答案。

您想要提升的答案不會計入 answerCount 限制。例如，如果已設為順位的答案為 news、images 及 videos，而且您將 answerCount 設為 1 並將 promote 設為 news，回應就會包含 news 和 images。或者，如果已設為順位的答案為 videos、images 及 news，則回應會包含 videos 和 news。

只有當您指定 answerCount 查詢參數時，才能使用 promote。

Share via

篩選搜尋回應所包含的答案

查詢參數

ResponseFilter

網站

時效性

限制回應中的答案數目

提升未設為順位的答案

其他資源