Chiamare l'istanza di Ricerca personalizzata Bing dal portale
Avviso
Il 30 ottobre 2020 le API di Ricerca Bing spostate dai servizi di intelligenza artificiale di Azure ai servizi Ricerca Bing. Questa documentazione viene fornita solo per informazioni di riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API di ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite la Azure Marketplace.
Dopo aver configurato l'esperienza di ricerca personalizzata, è possibile testarla dall'interno del portale di Ricerca personalizzata Bing.
Creare una query di ricerca
Dopo aver eseguito l'accesso al portale di Ricerca personalizzata Bing, selezionare l'istanza di ricerca e fare clic sulla scheda Produzione . In Endpoint selezionare un endpoint API (ad esempio, API Web). La sottoscrizione determina quali endpoint vengono visualizzati.
Per creare una query di ricerca, immettere i valori dei parametri per l'endpoint. Si noti che i parametri visualizzati nel portale possono cambiare a seconda dell'endpoint scelto. Per altre informazioni, vedere informazioni di riferimento sull'API ricerca personalizzata . Per modificare la sottoscrizione usata dall'istanza di ricerca, aggiungere la chiave di sottoscrizione appropriata e aggiornare i parametri di mercato e/o lingua appropriati.
Alcuni parametri importanti sono i seguenti:
| Parametro | Descrizione |
|---|---|
| Query | Il termine da cercare. Disponibile solo per gli endpoint Web, Image e Autosuggest |
| ID di configurazione personalizzato | L'ID di configurazione dell'istanza di Ricerca personalizzata selezionata. Questo campo è di sola lettura. |
| Mercato | Il mercato da cui deriveranno i risultati. Disponibile solo per gli endpoint Web, Image, Video e Hosted UI. |
| Chiave di sottoscrizione | La chiave di sottoscrizione con cui eseguire il test. È possibile selezionare una chiave nell'elenco a discesa o immetterla manualmente. |
Facendo clic su Parametri aggiuntivi vengono visualizzati i parametri seguenti:
| Parametro | Descrizione |
|---|---|
| Ricerca sicura | Un filtro utilizzato per filtrare le pagine Web per il contenuto per adulti. Disponibile solo per gli endpoint Web, Image, Video e Hosted UI. Si noti che Ricerca video personalizzata Bing supporta solo due valori: moderate e strict. |
| Lingua dell'interfaccia utente | La lingua utilizzata per le stringhe dell'interfaccia utente. Ad esempio, se si abilitano immagini e video nell'Hosted UI, le schedeImage e Video usano la lingua specificata. |
| Conteggio | Il numero di risultati della ricerca da restituire nella risposta. Disponibile solo per gli endpoint Web, Image e Video. |
| Offset | Il numero di risultati della ricerca da ignorare prima di restituire i risultati. Disponibile solo per gli endpoint Web, Image e Video. |
Dopo aver specificato tutte le opzioni necessarie, fare clic su Call per visualizzare la risposta JSON nel riquadro di destra. Se si seleziona l'endpoint Hosted UI, è possibile provare l'esperienza di ricerca nel riquadro inferiore.
Modificare la sottoscrizione di Ricerca personalizzata Bing
È possibile modificare la sottoscrizione associata all'istanza di Ricerca personalizzata Bing senza creare una nuova istanza. Per avere chiamate API inviate e addebitate a una nuova sottoscrizione, creare una nuova risorsa Ricerca personalizzata Bing nella portale di Azure. Usare la nuova chiave di sottoscrizione nelle richieste API, insieme all'ID di configurazione personalizzato dell'istanza.