建議查詢字詞
警告
2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至Bing 搜尋服務。 本文件僅供參考之用。 如需更新的文件，請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
一般來說，您會在每次使用者於應用程式的搜尋方塊中鍵入新字元時，呼叫 Bing 自動建議 API。 查詢字串的完整性會影響 API 傳回之建議查詢字詞的相關性。 查詢字串越完整，建議之查詢字詞的相關性就越大。 例如，API 為 s 可能傳回的建議也許比查詢為 sailing dinghies 傳回的建議相關性較小。
範例要求
下列範例顯示針對 sail 傳回建議查詢字串的要求。 請記得在設定 q 查詢參數時，對使用者的部分查詢字詞進行 URL 編碼。 例如，如果使用者輸入「sailing les」q，請將 設定為 sailing+les 或 sailing%20les。
GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
下列回應會包含一份 SearchAction 物件清單，其中包含建議的查詢字詞。
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
使用建議的查詢字詞
每個建議都包含 displayText、query 及 url 欄位。 displayText 欄位包含建議的查詢，您可以用來填入搜尋方塊的下拉式清單。 您必須依提供的順序顯示回應包含的所有建議。
下列範例顯示下拉式搜尋方塊與來自 Bing 自動建議 API 的建議查詢字詞。
如果使用者從下拉式清單選取建議的查詢，您可以使用 query 欄位中的查詢字詞呼叫 Bing Web 搜尋 API，並自行顯示結果。 或者，您也可以改為使用 url 欄位中的 URL，將使用者傳送至 Bing 搜尋結果頁面。