Appeler votre instance de Recherche personnalisée Bing à partir du portail
Avertissement
Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.
Une fois votre expérience de recherche personnalisée configurée, vous pouvez la tester à partir du portail Recherche personnalisée Bing.
Créer une requête de recherche
Une fois connecté au portail Recherche personnalisée Bing, sélectionnez votre instance de recherche et cliquez sur l'onglet Production. Sous Points de terminaison, sélectionnez le point de terminaison d'une API (par exemple, de l'API Web). Les points de terminaison affichés dépendent de votre abonnement.
Pour créer une requête de recherche, entrez les valeurs des paramètres de votre point de terminaison. Notez que les paramètres affichés sur le portail peuvent varier en fonction du point de terminaison choisi. Pour plus d’informations, consultez Référence sur l’API Recherche personnalisée. Pour modifier l’abonnement utilisée par votre instance de recherche, ajoutez la clé d’abonnement appropriée et mettez à jour les paramètres de mise sur le marché et/ou de langue appropriés.
Les paramètres suivants sont importants :
| Paramètre | Description |
|---|---|
| Requête | Terme à rechercher. Uniquement disponible pour les points de terminaison Web, Image, Vidéo et Suggestion automatique |
| ID de configuration personnalisée | L'ID de configuration de l'instance de Recherche personnalisée sélectionnée. Ce champ est en lecture seule. |
| Marché | Marché d'où proviendront les résultats. Uniquement disponible pour les points de terminaison Web, Image, Vidéo et Interface utilisateur hébergée. |
| Clé d'abonnement | Clé d'abonnement à utiliser pour le test. Vous pouvez sélectionner une clé dans la liste déroulante ou en entrer une manuellement. |
Si vous cliquez sur Paramètres supplémentaires, les paramètres suivants s’affichent :
| Paramètre | Description |
|---|---|
| Safe Search | Filtre servant à exclure le contenu pour adultes des pages web. Uniquement disponible pour les points de terminaison Web, Image, Vidéo et Interface utilisateur hébergée. Notez que Recherche de vidéos personnalisées Bing prend uniquement en charge deux valeurs : moderate et strict. |
| Langue de l'interface utilisateur | Langue utilisée pour les chaînes de l'interface utilisateur. Par exemple, si vous activez des images et des vidéos dans l’interface utilisateur hébergée, les onglets Image et Vidéo utilisent la langue spécifiée. |
| Count | Nombre de résultats de recherche à renvoyer dans la réponse. Disponible uniquement pour les points de terminaison Web, Image et vidéo. |
| Offset | Nombre de résultats de recherche à ignorer avant de renvoyer les résultats. Disponible uniquement pour les points de terminaison Web, Image et vidéo. |
Après avoir spécifié toutes les options nécessaires, cliquez sur Appeler pour voir la réponse JSON dans le volet droit. Si vous sélectionnez le point de terminaison Interface utilisateur hébergée, vous pouvez tester l’expérience de recherche dans le volet inférieur.
Modifier votre abonnement Recherche personnalisée Bing
Vous pouvez modifier l’abonnement associé à votre instance de Recherche personnalisée Bing sans créer de nouvelle instance. Pour que les appels d’API soient envoyés et facturés à un nouvel abonnement, créez une nouvelle ressource Recherche personnalisée Bing dans le portail Azure. Utilisez la nouvelle clé d’abonnement dans vos requêtes d’API, ainsi que l’ID de configuration personnalisée de votre instance.