Konfigurowanie środowiska hostowanego interfejsu użytkownika

Artykuł
02/12/2019

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 udostępniana 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 pośrednictwem Azure Marketplace.

Wyszukiwanie niestandardowe Bing udostępnia hostowany interfejs użytkownika, który można łatwo zintegrować ze stronami internetowymi i aplikacjami internetowymi jako fragment kodu JavaScript. Za pomocą portalu wyszukiwania niestandardowego Bing można skonfigurować opcje układu, koloru i wyszukiwania interfejsu użytkownika.

Konfigurowanie niestandardowego hostowanego interfejsu użytkownika

Aby skonfigurować hostowany interfejs użytkownika dla aplikacji internetowych, wykonaj następujące kroki. Po wprowadzeniu zmian okienko po prawej stronie wyświetli podgląd interfejsu użytkownika. Wyświetlane wyniki wyszukiwania nie są rzeczywistymi wynikami twojego wystąpienia.

Zaloguj się do portalu wyszukiwania niestandardowego Bing.
Wybierz wystąpienie wyszukiwania niestandardowego Bing.
Kliknij kartę Hosted UI (Hostowany interfejs użytkownika).
Wybierz układ.
- Pasek wyszukiwania i wyniki (ustawienie domyślne): wyświetla pole wyszukiwania z wynikami wyszukiwania poniżej.
- Tylko wyniki: wyświetla tylko wyniki wyszukiwania bez pola wyszukiwania. W przypadku korzystania z tego układu należy podać zapytanie wyszukiwania (&q=<query string>). Dodaj parametr zapytania do adresu URL żądania w fragmencie kodu JavaScript lub linku punktu końcowego HTML.
- Wyskakujące okienko: udostępnia pole wyszukiwania i wyświetla wyniki wyszukiwania w przesuwanej nakładce.
Wybierz motyw kolorów. Kolory można dostosować tak, aby pasowały do aplikacji, klikając pozycję Dostosuj motyw. Aby zmienić kolor, wprowadź wartość szesnastkową RGB koloru (na przykład #366eb8), lub kliknij podgląd kolorów.

Możesz wyświetlić podgląd zmian po prawej stronie portalu. Kliknięcie przycisku Resetuj do wartości domyślnej spowoduje przywrócenie zmian domyślnych kolorów dla wybranego motywu.

Uwaga

Podczas wybierania kolorów należy wziąć pod uwagę ułatwienia dostępu.
W obszarze Dodatkowe konfiguracje podaj wartości odpowiednie dla aplikacji. Te ustawienia są opcjonalne. Aby zobaczyć efekt ich stosowania lub usuwania, zobacz okienko podglądu po prawej stronie. Dostępne opcje konfiguracji to:
Wprowadź klucz subskrypcji wyszukiwania lub wybierz jeden z listy rozwijanej. Lista rozwijana jest wypełniana kluczami z subskrypcji konta platformy Azure. Zobacz Konto interfejsu API usług AI platformy Azure.
Jeśli włączono automatyczne sugerowanie, wprowadź klucz subskrypcji automatycznego sugerowania lub wybierz go z listy rozwijanej. Lista rozwijana jest wypełniana kluczami z subskrypcji konta platformy Azure. Funkcja automatycznego sugerowania niestandardowego wymaga określonej warstwy subskrypcji. Zobacz cennik.

Publikowanie lub przywracanie

Zmiany wprowadzone w wystąpieniu wyszukiwania niestandardowego są wprowadzane na karcie Konfiguracja , aby można było zweryfikować zmiany. Po zakończeniu wprowadzania zmian i przystąpieniu do publikowania kliknij pozycję Publikuj. Zmiany nie są odzwierciedlane względem punktów końcowych produkcyjnych do momentu opublikowania.

Jeśli przed opublikowaniem zdecydujesz, że nie chcesz zachować wprowadzonych zmian, kliknij przycisk Przywróć. Po wycofaniu zmian konfiguracja stanu na żywo pozostaje niezmieniona, a karta Konfiguracja zostanie przywrócona tak, aby odpowiadała stanowi aktywnemu.

Korzystanie z niestandardowego interfejsu użytkownika

Aby korzystać z hostowanego interfejsu użytkownika, wykonaj następujące czynności:

Uwzględnij skrypt na stronie internetowej

<html>
    <body>
        <script type="text/javascript" 
            id="bcs_js_snippet"
            src="https://ui.customsearch.ai /api/ux/rendering-js?customConfig=<YOUR-CUSTOM-CONFIG-ID>&market=en-US&safeSearch=Moderate&version=latest&q=">
        </script>
    </body>    
</html>

Możesz też użyć następującego adresu URL w przeglądarce sieci Web.

https://ui.customsearch.ai/hosted?customConfig=YOUR-CUSTOM-CONFIG-ID
Uwaga

Dodaj następujące parametry zapytania do adresu URL zgodnie z potrzebami. Aby uzyskać informacje o tych parametrach, zobacz Dokumentacja interfejsu API wyszukiwania niestandardowego .
- q
- mkt
- Safesearch
- setlang
Ważne

Strona nie może wyświetlić oświadczenia o ochronie prywatności ani innych powiadomień i postanowień. Przydatność do użycia może się różnić.

Aby uzyskać dodatkowe informacje, w tym identyfikator konfiguracji niestandardowej, przejdź do pozycji Punkty końcowe na karcie Produkcja .

Opcje konfiguracji

Zachowanie hostowanego interfejsu użytkownika można skonfigurować, klikając pozycję Dodatkowe konfiguracje i podając wartości. Te ustawienia są opcjonalne. Aby zobaczyć efekt ich stosowania lub usuwania, zobacz okienko podglądu po prawej stronie.

Konfiguracje wyszukiwania w Sieci Web

Włączone wyniki sieci Web: określa, czy wyszukiwanie w Internecie jest włączone (w górnej części strony zostanie wyświetlona karta Sieć Web)
Włącz automatyczne sugerowanie: określa, czy jest włączona funkcja automatycznego sugerowania niestandardowego (zobacz cennik dodatkowych kosztów).
Wyniki sieci Web na stronę: liczba wyników wyszukiwania w Sieci Web do wyświetlenia naraz (maksymalna liczba to 50 wyników na stronę).
Podpis obrazu: określa, czy obrazy są wyświetlane z wynikami wyszukiwania.

Jeśli klikniesz pozycję Pokaż konfiguracje zaawansowane, zostaną wyświetlone następujące konfiguracje:

Wyrazy wyróżnienia: określa, czy wyniki są wyświetlane przy użyciu terminów wyszukiwania pogrubionych.
Element docelowy łącza: określa, czy strona internetowa zostanie otwarta na nowej karcie przeglądarki (Puste) lub na tej samej karcie przeglądarki (samodzielnie), gdy użytkownik kliknie wynik wyszukiwania.

Konfiguracje wyszukiwania obrazów

Włączone wyniki obrazów: określa, czy wyszukiwanie obrazów jest włączone (w górnej części strony zostanie wyświetlona karta Obrazy).
Wyniki obrazów na stronę: liczba wyników wyszukiwania obrazów do wyświetlenia naraz (maksymalna liczba to 150 wyników na stronę).

Poniższa konfiguracja jest wyświetlana, jeśli klikniesz pozycję Pokaż konfiguracje zaawansowane.

Włącz filtry: dodaje filtry, których użytkownik może użyć do filtrowania obrazów zwracanych przez usługę Bing. Na przykład użytkownik może filtrować wyniki tylko dla animowanych plików GIF.

Konfiguracje wyszukiwania wideo

Włączone wyniki wideo: określa, czy wyszukiwanie wideo jest włączone (w górnej części strony zostanie wyświetlona karta Filmy wideo).
Wyniki wideo na stronę: liczba wyników wyszukiwania wideo do wyświetlenia naraz (maksymalna liczba to 150 wyników na stronę).

Poniższa konfiguracja jest wyświetlana, jeśli klikniesz pozycję Pokaż konfiguracje zaawansowane.

Włącz filtry: dodaje filtry, których użytkownik może użyć do filtrowania filmów wideo zwracanych przez usługę Bing. Na przykład użytkownik może filtrować wyniki filmów wideo za pomocą określonej rozdzielczości lub filmów wideo odnalezionych w ciągu ostatnich 24 godzin.

Różne konfiguracje

Tytuł strony: tekst wyświetlany w obszarze tytułu strony wyników wyszukiwania (nie w przypadku układu wyskakującego okienka).
Motyw paska narzędzi: określa kolor tła obszaru tytułu strony wyników wyszukiwania.

Jeśli klikniesz pozycję Pokaż konfiguracje zaawansowane, zostaną wyświetlone następujące konfiguracje.

Column1	Kolumna2
Symbol zastępczy tekstowy pola wyszukiwania	Tekst wyświetlany w polu wyszukiwania przed wprowadzeniem.
Adres URL linku tytułu	Element docelowy dla linku tytułu.
Logo URL	Obraz wyświetlany obok tytułu.
Favicon	Ikona wyświetlana na pasku tytułu przeglądarki.

Poniższe konfiguracje mają zastosowanie tylko wtedy, gdy korzystasz z hostowanego interfejsu użytkownika za pośrednictwem punktu końcowego HTML (nie mają zastosowania, jeśli używasz fragmentu kodu JavaScript).

Tytuł strony
Motyw paska narzędzi
Adres URL linku tytułu
Logo URL
Faviicon URL

Udostępnij za pośrednictwem