Gehoste UI-ervaring configureren

Artikel
02/12/2019

Waarschuwing

Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Zie Een Zoeken in Bing resource maken via de Azure Marketplace voor instructies voor het maken van nieuwe Azure-resources voor Bing Search.

Bing Custom Search biedt een gehoste gebruikersinterface die u eenvoudig kunt integreren in uw webpagina's en webtoepassingen als een JavaScript-codefragment. Met de Bing Custom Search-portal kunt u de indeling, kleur en zoekopties van de gebruikersinterface configureren.

De aangepaste gehoste gebruikersinterface configureren

Volg deze stappen om een gehoste gebruikersinterface voor uw webtoepassingen te configureren. Wanneer u wijzigingen aanbrengt, ziet u in het deelvenster aan de rechterkant een voorbeeld van uw gebruikersinterface. De weergegeven zoekresultaten zijn geen werkelijke resultaten voor uw exemplaar.

Meld u aan bij de Bing Custom Search-portal.
Selecteer uw Bing Custom Search-exemplaar.
Klik op het tabblad Hosted UI.
Selecteer een lay-out.
- Zoekbalk en resultaten (standaard): geeft een zoekvak weer met zoekresultaten eronder.
- Alleen resultaten: alleen zoekresultaten worden weergegeven, zonder een zoekvak. Wanneer u deze indeling gebruikt, moet u de zoekquery (&q=<query string>) opgeven. Voeg de queryparameter toe aan de aanvraag-URL in het JavaScript-fragment of de koppeling naar het HTML-eindpunt.
- Pop-over: biedt een zoekvak en geeft de zoekresultaten weer in een glijdende overlay.
Selecteer een kleurenthema. U kunt de kleuren aanpassen aan uw toepassing door op Thema aanpassen te klikken. Als u een kleur wilt wijzigen, voert u de RGB HEX-waarde van de kleur in (bijvoorbeeld #366eb8) of klikt u op het kleurvoorbeeld.

U kunt een voorbeeld van uw wijzigingen bekijken aan de rechterkant van de portal. Als u op Standaardinstelling herstellen klikt, worden de standaardkleuren voor het geselecteerde thema hersteld.

Notitie

Houd rekening met toegankelijkheid bij het kiezen van kleuren.
Geef onder Aanvullende configuraties waarden op die geschikt zijn voor uw app. Deze instellingen zijn optioneel. Als u het effect van het toepassen of verwijderen ervan wilt zien, raadpleegt u het voorbeeldvenster aan de rechterkant. Beschikbare configuratieopties zijn:
Voer de zoekabonnementssleutel in of kies er een in de vervolgkeuzelijst. De vervolgkeuzelijst is gevuld met sleutels uit de abonnementen van uw Azure-account. Zie Api-account voor Azure AI-services.
Als u automatische suggesties hebt ingeschakeld, voert u de abonnementssleutel voor automatische suggesties in of kiest u een abonnementssleutel in de vervolgkeuzelijst. De vervolgkeuzelijst is gevuld met sleutels uit de abonnementen van uw Azure-account. Voor aangepaste automatische suggesties is een specifieke abonnementslaag vereist. Zie de prijzen.

Publiceren of terugkeren

Wijzigingen die u in een Custom Search-exemplaar aanbrengt, worden gemaakt op het tabblad Configuratie, zodat u uw wijzigingen kunt valideren. Wanneer u klaar bent met het maken van wijzigingen en wilt publiceren, klikt u op Publiceren. Wijzigingen worden pas na publicatie op uw productie-eindpunten weergegeven.

Als u alvorens te publiceren besluit dat u de wijzigingen die u hebt aangebracht niet wilt behouden, klikt u op Terugkeren. Wanneer u de wijzigingen ongedaan maakt, blijft de configuratie van de live status ongewijzigd en wordt het tabblad Configuratie teruggezet zodat dit overeenkomt met de live status.

Aangepaste gebruikersinterface gebruiken

Als u de gehoste gebruikersinterface wilt gebruiken, gaat u als volgende te werk:

Het script opnemen in uw webpagina

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

Of gebruik de volgende URL in een webbrowser.

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

Voeg indien nodig de volgende queryparameters toe aan de URL. Zie Naslaginformatie over de Custom Search-API voor meer informatie over deze parameters.
- q
- mkt
- Safesearch
- setlang
Belangrijk

Op de pagina kan uw privacyverklaring of andere kennisgevingen en voorwaarden niet worden weergegeven. De geschiktheid voor uw gebruik kan variëren.

Ga naar Eindpunten op het tabblad Productie voor meer informatie, waaronder uw aangepaste configuratie-id.

Configuratie-opties

U kunt het gedrag van uw gehoste gebruikersinterface configureren door op Aanvullende configuraties te klikken en waarden op te geven. Deze instellingen zijn optioneel. Als u het effect van het toepassen of verwijderen ervan wilt zien, raadpleegt u het voorbeeldvenster aan de rechterkant.

Configuraties voor zoeken op internet

Webresultaten ingeschakeld: bepaalt of zoeken op internet is ingeschakeld (u ziet een tabblad Web boven aan de pagina)
Automatische suggesties inschakelen: bepaalt of aangepaste automatische suggesties zijn ingeschakeld (zie prijzen voor extra kosten).
Webresultaten per pagina: het aantal webzoekresultaten dat tegelijk moet worden weergegeven (het maximum is 50 resultaten per pagina).
Afbeeldings onderschrift: bepaalt of afbeeldingen worden weergegeven met zoekresultaten.

De volgende configuraties worden weergegeven als u op Geavanceerde configuraties weergeven klikt:

Woorden markeren: bepaalt of resultaten worden weergegeven met zoektermen vet.
Koppelingsdoel: bepaalt of de webpagina wordt geopend in een nieuw browsertabblad (Leeg) of hetzelfde browsertabblad (zelf) wanneer de gebruiker op een zoekresultaat klikt.

Configuraties voor zoeken naar afbeeldingen

Afbeeldingsresultaten ingeschakeld: bepaalt of zoeken naar afbeeldingen is ingeschakeld (u ziet het tabblad Afbeeldingen boven aan de pagina).
Afbeeldingsresultaten per pagina: het aantal zoekresultaten voor afbeeldingen dat tegelijk moet worden weergegeven (het maximum is 150 resultaten per pagina).

De volgende configuratie wordt weergegeven als u klikt op Geavanceerde configuraties weergeven.

Filters inschakelen: hiermee voegt u filters toe die de gebruiker kan gebruiken om de afbeeldingen te filteren die Bing retourneert. De gebruiker kan de resultaten bijvoorbeeld alleen filteren op GIF-animaties.

Configuraties voor video's zoeken

Ingeschakelde videoresultaten: bepaalt of het zoeken naar video's is ingeschakeld (u ziet het tabblad Video's boven aan de pagina).
Videoresultaten per pagina: het aantal zoekresultaten voor video's dat tegelijk moet worden weergegeven (het maximum is 150 resultaten per pagina).

De volgende configuratie wordt weergegeven als u klikt op Geavanceerde configuraties weergeven.

Filters inschakelen: hiermee worden filters toegevoegd die de gebruiker kan gebruiken om de video's te filteren die Bing retourneert. De gebruiker kan bijvoorbeeld de resultaten filteren op video's met een specifieke resolutie of video's die in de afgelopen 24 uur zijn gedetecteerd.

Diverse configuraties

Paginatitel: tekst die wordt weergegeven in het titelgebied van de pagina met zoekresultaten (niet voor pop-over-indeling).
Werkbalkthema: Bepaalt de achtergrondkleur van het titelgebied van de pagina met zoekresultaten.

De volgende configuraties worden weergegeven als u klikt op Geavanceerde configuraties weergeven.

Kolom 1	Kolom 2
Tijdelijke aanduiding voor tekst van zoekvak	Tekst die wordt weergegeven in het zoekvak vóór invoer.
URL van titelkoppeling	Doel voor de titelkoppeling.
Logo-URL	Afbeelding weergegeven naast de titel.
Favicon	Pictogram weergegeven in de titelbalk van de browser.

De volgende configuraties zijn alleen van toepassing als u de gehoste gebruikersinterface gebruikt via het HTML-eindpunt (ze zijn niet van toepassing als u het JavaScript-fragment gebruikt).

Paginatitel
Werkbalkthema
URL van titelkoppeling
Logo-URL
Faviicon-URL

Delen via