Föreslå frågeord
Varning
Den 30 oktober 2020 flyttade Bing-sökning API:er från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.
Vanligtvis anropar du API:et för automatiska förslag i Bing varje gång en användare matar in ett nytt tecken i programmets sökruta. Frågesträngens fullständighet påverkar relevansen för de föreslagna frågetermer som API:et returnerar. Ju mer fullständig frågesträngen är, desto mer relevant blir listan över föreslagna frågetermer. Till exempel är de förslag som API:et kan returnera för s förmodligen mindre relevanta än de frågor det returnerar för sailing dinghies.
Exempelbegäran
I följande exempel visas en begäran som returnerar de föreslagna frågesträngarna för sail (segla). Kom ihåg att URL-koda användarens partiella frågeterm när du anger frågeparametern q. Om användaren till exempel anger sailing les ställer du in q till sailing+les eller 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
Följande svar innehåller en lista över SearchAction-objekt som innehåller de föreslagna frågetermerna.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Använda föreslagna söktermer
Varje förslag innehåller fälten displayText, query och url. Fältet displayText innehåller den föreslagna fråga som du använder för att fylla i sökrutans listruta. Du måste visa alla förslag som svaret innehåller, och i den angivna ordningen.
I följande exempel visas en nedrullningsbar sökruta med föreslagna sökord från API för automatiska förslag för Bing.
Om användaren väljer en föreslagen fråga från listrutan använder du frågetermen i fältet query för att anropa API för webbsökning i Bing och visa resultaten själv. Alternativt kan du använda URL:en i fältet url för att dirigera användaren till sidan för Bing-sökresultat i stället.