Настройка размещенного пользовательского интерфейса

Статья
02/12/2019

Предупреждение

30 октября 2020 г. API-интерфейсы Поиск Bing перемещены из служб ИИ Azure в службы Поиск Bing. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска MS Bing см. в статье о том, как создать ресурс для Поиска MS Bing с помощью Azure Marketplace.

Пользовательский поиск Bing предоставляет размещенный пользовательский интерфейс, который можно легко интегрировать в веб-страницы и веб-приложения как фрагмент кода JavaScript. С помощью портала пользовательского поиска Bing можно настроить макет, цвет и параметры поиска для пользовательского интерфейса.

Настройка размещенного интерфейса пользовательского поиска

Чтобы настроить размещенный пользовательский интерфейс для веб-приложений, выполните следующие действия. В области просмотра справа вы можете просматривать изменения, вносимые в пользовательский интерфейс. Отображаемые здесь результаты поиска не соответствуют фактическим данным вашего экземпляра.

Войдите на портал Пользовательского поиска Bing.
Выберите экземпляр пользовательского поиска Bing.
Щелкните вкладку Hosted UI (Размещенный пользовательский интерфейс).
Выберите макет.
- Панель поиска и результаты (этот макет выбирается по умолчанию): содержит поле поиска с результатами поиска под ним.
- Только результаты: отображаются только результаты поиска без поля поиска. При использовании этого макета необходимо указать поисковый запрос (&q=<query string>). Добавьте параметр запроса в URL-адрес запроса во фрагменте кода JavaScript или ссылку на конечную точку HTML.
- Всплывающее окно: содержит поле поиска и отображает результаты поиска во всплывающем окне.
Выберите цветовую тему. Щелкнув Настройка темы, можно настроить цвета в соответствии с оформлением своего приложения. Чтобы изменить цвет, введите шестнадцатеричное значение цвета RGB (например, #366eb8) или щелкните поле просмотра цветов.

Изменения можно просмотреть в правой части портала. Щелкнув Восстановить значения по умолчанию, вы вернетесь к цветам по умолчанию для выбранной темы.

Примечание

Учитывайте специальные возможности при выборе цветов.
В разделе Additional Configurations (Дополнительные конфигурации) укажите значения, которые нужны для вашего приложения. Эти параметры не являются обязательными. В области предварительного просмотра справа можно наблюдать, как влияет на результат добавление или удаление этих параметров. Доступны следующие параметры конфигурации.
Введите ключ подписки на службу поиска или выберите его из раскрывающегося списка. Раскрывающийся список заполняется ключами из подписок в вашей учетной записи Azure. См . раздел Учетная запись API служб ИИ Azure.
Если вы включили автозаполнение, введите ключ подписки на службу автозаполнения или выберите его из раскрывающегося списка. Раскрывающийся список заполняется ключами из подписок в вашей учетной записи Azure. Пользовательское автозаполнение требует наличия определенного уровня подписки, как описано на страниц цен.

Публикация или отмена

Изменения, которые вы вносите в экземпляр службы пользовательского поиска, выполняются на вкладке Конфигурация, поэтому вы можете проверить свои изменения. Когда вы уже внесли изменения и готовы к публикации, нажмите кнопку Опубликовать. Изменения не отражаются на рабочих конечных точках, пока не выполнена публикация.

Перед публикацией, если вы не хотите сохранять внесенные изменения, нажмите кнопку Отменить изменения. В случае отмены изменений активная конфигурация не меняется, а изменения на вкладке Конфигурация отменяются, чтобы значения соответствовали активному состоянию.

Использование настраиваемого пользовательского интерфейса

Чтобы использовать размещенный пользовательский интерфейс, выполните любое из следующих действий.

Включите скрипт в код веб-страницы.

<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>

Можно также использовать следующий URL-адрес в веб-браузере.

https://ui.customsearch.ai/hosted?customConfig=YOUR-CUSTOM-CONFIG-ID
Примечание

При необходимости добавьте следующие параметры запроса в URL-адрес. Дополнительные сведения об этих параметрах см. в справочнике по API пользовательского поиска.
- q
- mkt
- safesearch
- setlang
Важно!

На этой странице не будут отображаться заявление о конфиденциальности или другие уведомления и условия. Этот вариант подходит не для всех случаев.

Дополнительные сведения, включая пользовательский идентификатор конфигурации, вы найдете в разделе Конечные точки на вкладке Рабочая среда.

Варианты настройки

Можно настроить поведение размещенного пользовательского интерфейса, щелкнув Дополнительные конфигурации и указав значения. Эти параметры не являются обязательными. В области предварительного просмотра справа можно наблюдать, как влияет на результат добавление или удаление этих параметров.

Конфигурации поиска в Интернете

Результаты поиска в Интернете: определяет, включен ли веб-поиск (вы увидите вкладку "Интернет" в верхней части страницы)
Включить автозаполнение: определяет, используется ли пользовательское автозаполнение (ознакомьтесь с ценами, чтобы узнать о дополнительных затратах).
Число результатов поиска в Интернете на страницу: количество одновременно отображаемых результатов поиска в Интернете (до 50 результатов на страницу).
Подпись изображения: определяет, отображаются ли изображения в результатах поиска.

Если щелкнуть Show advanced configurations (Показать дополнительные конфигурации), отобразятся следующие конфигурации.

Выделение слов: определяет, нужно ли в результатах выделять искомые термины полужирным шрифтом.
Связывание цели: определяет, откроется ли веб-страница на новой (пустой) вкладке или на той же вкладке браузера, когда пользователь щелкнет результат поиска.

Конфигурации поиска изображений

Результаты поиска изображений: определяет, включен ли поиск изображений (вы увидите вкладку "Изображения" в верхней части страницы).
Число результатов поиска изображений на страницу: количество одновременно отображаемых результатов поиска изображений (до 150 результатов на страницу).

Если щелкнуть Show advanced configurations (Показать дополнительные конфигурации), отобразится следующая конфигурация.

Включение фильтров: добавляет фильтры, которые пользователь может использовать для фильтрации изображений, возвращаемых Bing. Например, пользователь может отфильтровать результаты для получения только анимационных GIF.

Конфигурации поиска видео

Результаты поиска видео: определяет, включен ли поиск видео (вы увидите вкладку "Видео" в верхней части страницы).
Число результатов поиска видео на страницу: количество одновременно отображаемых результатов поиска видео (до 150 результатов на страницу).