Szybki start: wywoływanie punktu końcowego wyszukiwania niestandardowego Bing przy użyciu Node.js

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest dostarczana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pomocą Azure Marketplace.

Skorzystaj z tego przewodnika Szybki start, aby dowiedzieć się, jak żądać wyników wyszukiwania z wystąpienia wyszukiwania niestandardowego Bing. Mimo że ta aplikacja jest napisana w języku JavaScript, interfejs API wyszukiwania niestandardowego Bing jest usługą internetową RESTful zgodną z większością języków programowania. Kod źródłowy dla tego przykładu jest dostępny w witrynie GitHub.

Wymagania wstępne

Tworzenie zasobu platformy Azure

Zacznij korzystać z interfejsu API wyszukiwania niestandardowego Bing, tworząc jeden z następujących zasobów platformy Azure.

Zasób wyszukiwania niestandardowego Bing

  • Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
  • Użyj warstwy cenowej Bezpłatna, aby wypróbować usługę, a następnie uaktualnić ją do warstwy płatnej dla środowiska produkcyjnego.

Zasób z wieloma usługami

  • Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
  • Użyj tego samego klucza i punktu końcowego dla aplikacji w wielu usługach azure AI.

Tworzenie i inicjowanie aplikacji

  • Utwórz nowy plik JavaScript w swoim ulubionym środowisku IDE lub edytorze i dodaj instrukcję require() dla biblioteki żądań. Utwórz zmienne dla klucza subskrypcji, niestandardowego identyfikatora konfiguracji i terminu wyszukiwania.

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

Wysyłanie i odbieranie żądania wyszukiwania

  1. Utwórz zmienną do przechowywania informacji wysyłanych w żądaniu. Skonstruuj adres URL żądania, dołączając termin wyszukiwania do parametru q= zapytania, a identyfikator konfiguracji niestandardowej wystąpienia wyszukiwania do parametru customconfig= . Rozdziel parametry znakiem ampersand (&). Możesz użyć globalnego punktu końcowego w poniższym kodzie lub użyć niestandardowego punktu końcowego poddomeny wyświetlanego w Azure Portal dla zasobu.

    var info = {
        url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 
            'q=' + searchTerm + "&" +
            'customconfig=' + customConfigId,
        headers: {
            'Ocp-Apim-Subscription-Key' : subscriptionKey
        }
    }
    
  2. Użyj biblioteki żądań Języka JavaScript, aby wysłać żądanie wyszukiwania do wystąpienia wyszukiwania niestandardowego Bing i wydrukować informacje o wynikach, w tym jego nazwę, adres URL i datę ostatniego przeszukania strony internetowej.

    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();
            }
    

Następne kroki