Démarrage rapide : Appeler votre point de terminaison Recherche personnalisée Bing avec Node.js

Utilisez ce guide de démarrage rapide pour découvrir comment demander des résultats de recherche à partir de votre instance Recherche personnalisée Bing. Bien que cette application est écrite en JavaScript, l’API Recherche personnalisée Bing constitue un service web RESTful compatible avec la plupart des langages de programmation. Le code source de cet exemple est disponible sur GitHub.

Prérequis

• Une instance Recherche personnalisée Bing. Pour plus d’informations, consultez Démarrage rapide : Créer votre première instance de Recherche personnalisée Bing.

• Le runtime JavaScript Node.js.

• La bibliothèque de requêtes JavaScript.

Créer une ressource Azure

Commencez à utiliser l’API Recherche personnalisée Bing en créant une des ressources Azure suivantes.

Ressource Recherche personnalisée Bing

• Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
• Utilisez le niveau tarifaire Gratuit pour tester le service, puis effectuez par la suite une mise à niveau vers un niveau payant pour la production.

Ressource multiservice

• Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
• Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Créer et initialiser l’application

• Créez un fichier JavaScript dans votre éditeur ou IDE favori, puis ajoutez une instruction require() pour la bibliothèque de requêtes. Créez des variables pour votre clé d’abonnement, votre ID de configuration personnalisée et un terme de recherche.

  var request = require("request");
  
  var subscriptionKey = 'YOUR-SUBSCRIPTION-KEY';
  var customConfigId = 'YOUR-CUSTOM-CONFIG-ID';
  var searchTerm = 'microsoft';
  

Envoyer et recevoir une requête de recherche

1. Créez une variable pour stocker les informations qui sont envoyées dans votre requête. Construisez l’URL de requête en ajoutant votre terme de recherche au paramètre de requête q=, et l’ID de configuration personnalisée de votre instance de recherche au paramètre customconfig=. Séparez les paramètres par une esperluette (&). Vous pouvez utiliser le point de terminaison global dans le code suivant, ou le point de terminaison de sous-domaine personnalisé affiché dans le portail Azure pour votre ressource.

   var info = {
       url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 
           'q=' + searchTerm + "&" +
           'customconfig=' + customConfigId,
       headers: {
           'Ocp-Apim-Subscription-Key' : subscriptionKey
       }
   }
   

2. Utilisez la bibliothèque de requêtes JavaScript pour envoyer une requête de recherche à votre instance Recherche personnalisée Bing et afficher des informations sur les résultats, notamment son nom, l’URL et la date à laquelle la page web a été analysée pour la dernière fois.

   request(info, function(error, response, body){
           var searchResponse = JSON.parse(body);
           for(var i = 0; i < searchResponse.webPages.value.length; ++i){
               var webPage = searchResponse.webPages.value[i];
               console.log('name: ' + webPage.name);
               console.log('url: ' + webPage.url);
               console.log('displayUrl: ' + webPage.displayUrl);
               console.log('snippet: ' + webPage.snippet);
               console.log('dateLastCrawled: ' + webPage.dateLastCrawled);
               console.log();
           }
   

Étapes suivantes