WebSearchOptionalParams interface

Balíček:

@azure/cognitiveservices-websearch

Volitelné parametry.

Extends

RequestOptionsBase

Vlastnosti

acceptLanguage	Čárkami oddělený seznam jednoho nebo více jazyků, které se mají použít pro řetězce uživatelského rozhraní. Seznam je v sestupném pořadí předvoleb. Další informace, včetně očekávaného formátu, naleznete v RFC2616. Tato hlavička a parametr dotazu setLang se vzájemně vylučují; nezadávejte obojí. Pokud nastavíte tuto hlavičku, musíte také zadat parametr dotazu cc. Bing použije první podporovaný jazyk, který najde ze seznamu, a zkombinuje tento jazyk s hodnotou parametru cc a určí trh, aby vrátil výsledky. Pokud seznam neobsahuje podporovaný jazyk, Bing najde nejbližší jazyk a trh, který požadavek podporuje, a místo zadaného výsledku může použít agregovaný nebo výchozí trh. Tuto hlavičku a parametr dotazu cc byste měli použít pouze v případě, že zadáte více jazyků; jinak byste měli použít parametry dotazu mkt a setLang. Řetězec uživatelského rozhraní je řetězec, který se používá jako popisek v uživatelském rozhraní. Objekty odpovědi JSON mají velmi málo řetězců uživatelského rozhraní. Všechny odkazy v objektech odpovědi na Bing.com vlastnosti budou používat zadaný jazyk.
answerCount	Počet odpovědí,kteréch Odpovědi, které Bing vrátí, jsou založené na pořadí. Pokud Například Bing vrátí webové stránky, obrázky, videa a související hledání požadavku a nastavíte tento parametr na dvě (2), bude odpověď obsahovat webové stránky a obrázky. Pokud jste do stejného požadavku zahrnuli parametr dotazu responseFilter a nastavili ho na webové stránky a zprávy, odpověď bude obsahovat jenom webové stránky.
clientId	Bing používá tuto hlavičku k zajištění konzistentního chování uživatelů napříč voláními rozhraní API Bingu. Bing často letí nové funkce a vylepšení a používá ID klienta jako klíč pro přiřazování provozu v různých letech. Pokud nepoužíváte stejné ID klienta pro uživatele ve více žádostech, může Bing přiřadit uživatele k několika konfliktními lety. Přiřazení k několika konfliktním letům může vést k nekonzistentnímu uživatelskému prostředí. Pokud má například druhý požadavek jiné přiřazení letu než první, může být prostředí neočekávané. Bing může také použít ID klienta k přizpůsobení výsledků vyhledávání v historii vyhledávání daného ID klienta, což poskytuje pro uživatele bohatší prostředí. Bing také používá tuto hlavičku k vylepšení hodnocení výsledků analýzou aktivity vygenerované ID klienta. Vylepšení relevance pomáhají zlepšit kvalitu výsledků poskytovaných rozhraními API Bingu a zase umožňují vyšší míru proklikání pro příjemce rozhraní API. DŮLEŽITÉ: I když je tato hlavička nepovinná, měli byste zvážit tuto hlavičku. Zachování ID klienta napříč několika požadavky na stejnou kombinaci koncových uživatelů a zařízení umožňuje 1) příjemci rozhraní API přijímat konzistentní uživatelské prostředí a 2) vyšší míru proklikání prostřednictvím lepší kvality výsledků z rozhraní API Bingu. Každý uživatel, který používá vaši aplikaci na zařízení, musí mít jedinečné ID klienta vygenerovaného Bingem. Pokud tuto hlavičku do požadavku nezahrnete, Bing vygeneruje ID a vrátí ho v hlavičce odpovědi X-MSEdge-ClientID. Jedinou dobou, kterou byste neměli do požadavku zahrnout, je čas, kdy uživatel na tomto zařízení poprvé použije vaši aplikaci. Použijte ID klienta pro každou žádost rozhraní API Bingu, kterou vaše aplikace pro tohoto uživatele na zařízení dělá. Zachovají ID klienta. Pokud chcete ID zachovat v aplikaci prohlížeče, použijte trvalý soubor cookie HTTP, abyste zajistili, že se ID použije ve všech relacích. Nepoužívejte soubor cookie relace. Pro jiné aplikace, jako jsou mobilní aplikace, použijte trvalé úložiště zařízení k zachování ID. Při příštím použití aplikace na daném zařízení získejte ID klienta, které jste si zachovali. Odpovědi Bingu můžou nebo nemusí obsahovat tuto hlavičku. Pokud odpověď obsahuje tuto hlavičku, zachyťte ID klienta a použijte ho pro všechny následné žádosti Bingu pro uživatele na tomto zařízení. Pokud zahrnete X-MSEdge-ClientID, nesmíte do požadavku zahrnout soubory cookie.
clientIp	Adresa IPv4 nebo IPv6 klientského zařízení. IP adresa se používá ke zjištění polohy uživatele. Bing používá informace o poloze k určení bezpečného chování vyhledávání. I když je volitelné, doporučujeme vždy zadat tuto hlavičku a hlavičkuSearch-Location X. Nezaměňujte adresu (například změnou posledního oktetu na 0). Obfuscování adresy vede k tomu, že umístění není nikde blízko skutečného umístění zařízení, což může vést k tomu, že Bing obsluhuje chybné výsledky.
count	Počet výsledků hledání, které se mají vrátit v odpovědi. Výchozí hodnota je 10 a maximální hodnota je 50. Skutečné číslo doručené může být menší než požadováno. Tento parametr použijte spolu s parametrem posunu k výsledkům stránky. Pokud například vaše uživatelské rozhraní zobrazí 10 výsledků hledání na stránku, nastavte počet na 10 a posun na 0, abyste získali první stránku výsledků. Pro každou další stránku zvýší posun o 10 (například 0, 10, 20). Ve výsledcích je možné zahrnout několik stránek, které se překrývají.
countryCode	Kód země se 2 znaky země, ze které pocházejí výsledky. Toto rozhraní API podporuje pouze trh USA. Pokud zadáte tento parametr dotazu, musí být nastavený na nás. Pokud nastavíte tento parametr, musíte také zadat hlavičku Accept-Language. Bing používá první podporovaný jazyk, který najde ze seznamu jazyků, a zkombinuje tento jazyk s kódem země, který určíte, a určí trh, aby vrátil výsledky. Pokud seznam jazyků neobsahuje podporovaný jazyk, Bing najde nejbližší jazyk a trh, který požadavek podporuje, nebo může místo zadaného výsledku použít agregovaný nebo výchozí trh. Tento parametr dotazu a parametr dotazu Accept-Language byste měli použít pouze v případě, že zadáte více jazyků; jinak byste měli použít parametry dotazu mkt a setLang. Tento parametr a parametr dotazu mkt se vzájemně vylučují – nezadávejte obojí.
freshness	Výsledky hledání můžete filtrovat podle následujících věkových hodnot: Den – vrátí webové stránky, které Bing zjistil během posledních 24 hodin. Týden – vrátí webové stránky, které Bing zjistil během posledních 7 dnů. Měsíc – vrátí webové stránky, které se zjistily za posledních 30 dnů. Tento filtr se vztahuje pouze na výsledky webové stránky, nikoli na ostatní výsledky, jako jsou zprávy a obrázky. Mezi možné hodnoty patří: "Den", "Týden", "Měsíc"
location	Seznam párů klíč/hodnota oddělených středníkem, které popisují zeměpisné umístění klienta. Bing používá informace o poloze k určení bezpečného chování vyhledávání a k vrácení relevantního místního obsahu. Zadejte dvojici klíč/hodnota jako <klíč>:<hodnota>. Následují klíče, které použijete k určení umístění uživatele. lat (povinné): Zeměpisná šířka umístění klienta ve stupních. Zeměpisná šířka musí být větší nebo rovna -90,0 a menší nebo rovna +90,0. Záporné hodnoty označují jižní šířky a kladné hodnoty označují severní šířky. long (required): Délka umístění klienta ve stupních. Zeměpisná délka musí být větší nebo rovna -180,0 a menší nebo rovna +180,0. Záporné hodnoty označují západní délky a kladné hodnoty označují východní délky. re (povinné): Poloměr v metrech, který určuje vodorovnou přesnost souřadnic. Předejte hodnotu vrácenou službou zjišťování polohy zařízení. Typické hodnoty můžou být 22 m pro GPS/Wi-Fi, 380m pro triangulaci mobilní věže a 18 000 m pro zpětné vyhledávání IP adres. ts (volitelné): Časové razítko UTC UNIX, kdy byl klient v umístění. (Časové razítko systému UNIX je počet sekund od 1. ledna 1970.) hlava (volitelné): Relativní nadpis nebo směr cesty klienta. Určete směr cesty ve stupních od 0 do 360, počítá se ve směru hodinových ručiček vzhledem ke skutečnému severu. Tento klíč zadejte pouze v případě, že klíč sp není nenulový. sp (volitelné): Vodorovná rychlost (rychlost) v metrech za sekundu, kterou klientské zařízení cestuje. alt (volitelné): Výška klientského zařízení v metrech. jsou (volitelné): Poloměr v metrech, který určuje svislou přesnost souřadnic. Tento klíč zadejte pouze v případě, že zadáte klávesu Alt. I když je mnoho klíčů volitelné, tím více informací zadáte, tím přesnější jsou výsledky umístění. I když volitelné, doporučujeme vždy zadat zeměpisné umístění uživatele. Poskytnutí umístění je zvlášť důležité, pokud IP adresa klienta přesně neodráží fyzické umístění uživatele (například pokud klient používá vpn). Pro dosažení optimálních výsledků byste měli zahrnout tuto hlavičku a hlavičkuMSEdge-ClientIP X, ale alespoň byste měli zahrnout tuto hlavičku.
market	Trh, ze kterého pocházejí výsledky. Mkt je obvykle země, ze které uživatel provádí žádost. Pokud se ale uživatel nenachází v zemi, kde Bing výsledky poskytuje, může to být jiná země. Trh musí být ve tvaru <kód jazyka-kód>< země>. Například en-US. Řetězec nerozlišuje velká a malá písmena. Pokud je to známo, doporučujeme vždy určit trh. Určení trhu pomáhá Bingu směrovat požadavek a vrátit odpovídající a optimální odpověď. Pokud zadáte trh, který není uvedený v kódech trhu, Bing použije nejlepší kód trhu na základě interního mapování, které se může změnit. Tento parametr a parametr dotazu cc se vzájemně vylučují – nezadávejte obojí. Výchozí hodnota: 'en-us'.
offset	Posun založený na nule, který označuje počet výsledků hledání, které se mají přeskočit před vrácením výsledků. Výchozí hodnota je 0. Posun by měl být menší než (totalEstimatedMatches – count). Tento parametr použijte spolu s parametrem count k výsledkům stránky. Pokud například vaše uživatelské rozhraní zobrazí 10 výsledků hledání na stránku, nastavte počet na 10 a posun na 0, abyste získali první stránku výsledků. Pro každou další stránku zvýší posun o 10 (například 0, 10, 20). Je možné, aby více stránek zahrnovalo určité překrývající se výsledky.
pragma	Bing ve výchozím nastavení vrátí obsah uložený v mezipaměti, pokud je k dispozici. Pokud chcete, aby Bing nevrátil obsah uložený v mezipaměti, nastavte hlavičku Pragma na no-cache (například Pragma: no-cache).
promote	Čárkami oddělený seznam odpovědí, které chcete, aby odpověď zahrnovala bez ohledu na jejich pořadí. Pokud například nastavíte answerCount) na dvě (2), aby Bing vrátil nejlepší dvě seřazené odpovědi, ale chcete, aby odpověď obsahovala zprávy, nastavíte zvýšení úrovně na zprávy. Pokud jsou nejlépe seřazené odpovědi webové stránky, obrázky, videa a související hledání, odpověď obsahuje webové stránky a obrázky, protože zprávy nejsou seřazené odpovědi. Pokud ale nastavíte zvýšení úrovně na video, Bing zvýší odpověď na video do odpovědi a vrátí webové stránky, obrázky a videa. Odpovědi, které chcete zvýšit, se nezapočítávají do limitu answerCount. Pokud jsou například seřazené odpovědi zprávy, obrázky a videa a nastavíte odpověďCount na hodnotu 1 a zvýšíte úroveň na zprávy, bude odpověď obsahovat zprávy a obrázky. Nebo pokud jsou seřazené odpovědi videa, obrázky a zprávy, odpověď obsahuje videa a zprávy. Možné hodnoty jsou Výpočty, Obrázky, Zprávy, Související hledání, SpellSuggestions, TimeZone, Videa, Webové stránky. Použijte pouze v případě, že zadáte parametr answerCount.
responseFilter	Čárkami oddělený seznam odpovědí, které se mají zahrnout do odpovědi. Pokud tento parametr nezadáte, bude odpověď obsahovat všechny odpovědi hledání, pro které jsou relevantní data. Možné hodnoty filtru jsou Výpočty, Obrázky, Zprávy, Související hledání, SpellSuggestions, TimeZone, Videa, Webové stránky. I když tento filtr můžete použít k získání jediné odpovědi, měli byste místo toho použít koncový bod specifický pro odpověď, abyste získali bohatší výsledky. Pokud například chcete přijímat pouze obrázky, odešlete požadavek na jeden z koncových bodů rozhraní API pro vyhledávání obrázků. Odpovědi RelatedSearches a SpellSuggestions nepodporují samostatný koncový bod, jako je rozhraní API pro vyhledávání obrázků (vrátí je pouze rozhraní API pro vyhledávání na webu). Pokud chcete zahrnout odpovědi, které by jinak byly vyloučeny z důvodu řazení, podívejte se na parametr dotazu na zvýšení úrovně.
safeSearch	Filtr použitý k filtrování obsahu pro dospělé. Vypnuto: Vrátí webové stránky s textem, obrázky nebo videi pro dospělé. Moderování: Vrátí webové stránky s textem pro dospělé, ale ne obrázky nebo videa pro dospělé. Striktní: Nevracejte webové stránky s textem pro dospělé, obrázky nebo videi. Výchozí hodnota je Střední. Pokud požadavek pochází z trhu, který zásady Pro dospělé Bingu vyžadují, aby bezpečné hledání bylo nastaveno na Striktní, Bing ignoruje hodnotu bezpečného hledání a používá Strict. Pokud používáte web: operátor dotazu, existuje šance, že odpověď může obsahovat obsah pro dospělé bez ohledu na to, na co je parametr dotazu safeSearch nastavený. Použít web: Pouze pokud víte o obsahu na webu a váš scénář podporuje možnost obsahu pro dospělé. Mezi možné hodnoty patří: Off(Vypnuto), Moderate (Střední), Strict (Striktní).
setLang	Jazyk, který se má použít pro řetězce uživatelského rozhraní. Zadejte jazyk pomocí kódu jazyka ISO 639-1 2 písmen. Například kód jazyka pro angličtinu je EN. Výchozí hodnota je EN (angličtina). I když je volitelný, měli byste vždy zadat jazyk. Obvykle nastavíte jazyk setLang na stejný jazyk určený mkt, pokud uživatel nechce řetězce uživatelského rozhraní zobrazované v jiném jazyce. Tento parametr a hlavička Accept-Language se vzájemně vylučují; nezadávejte obojí. Řetězec uživatelského rozhraní je řetězec, který se používá jako popisek v uživatelském rozhraní. Objekty odpovědi JSON mají několik řetězců uživatelského rozhraní. Také všechny odkazy na Bing.com vlastnosti v objektech odpovědi použijí zadaný jazyk.
textDecorations	Logická hodnota, která určuje, zda by zobrazované řetězce měly obsahovat dekorační značky, jako je zvýraznění znaků. Pokud je hodnota true, mohou řetězce obsahovat značky. Výchozí hodnota je false. Pokud chcete určit, jestli se mají jako značky používat znaky Unicode nebo značky HTML, podívejte se na parametr dotazu textFormat.
textFormat	Typ značek, které se mají použít pro textové dekorace (viz parametr dotazu textDecorations). Možné hodnoty jsou Raw – Pomocí znaků Unicode označte obsah, který potřebuje speciální formátování. Znaky Unicode jsou v rozsahu E000 až E019. Bing například používá pro zvýraznění začátku a konce termínů dotazu E000 a E001. HTML – pomocí značek HTML označte obsah, který potřebuje speciální formátování. Pomocí značek můžete například zvýraznit termíny dotazu v zobrazovaných řetězcích. Výchozí hodnota je Raw. U zobrazovaných řetězců, které obsahují čitelné znaky HTML, jako jsou <, >a &, pokud je textFormat nastavený na HTML, Bing znaky podle potřeby uvozí (například < je uvozováno na <). Mezi možné hodnoty patří: Raw, Html.
userAgent	Uživatelský agent pocházející z požadavku. Bing pomocí uživatelského agenta poskytuje mobilním uživatelům optimalizované prostředí. I když je tato hlavička nepovinná, důrazně doporučujeme, abyste tuto hlavičku vždy zadali. Uživatelský agent by měl být stejný řetězec, který by odeslal jakýkoli běžně používaný prohlížeč. Informace o uživatelských agentech naleznete v tématu RFC 2616.

Zděděné vlastnosti

abortSignal	Signál, který lze použít k přerušení požadavků.
customHeaders	Uživatelsky definované hlavičky vlastních požadavků, které se použijí před odesláním požadavku.
onDownloadProgress	Zpětné volání, které se aktivuje při průběhu stahování.
onUploadProgress	Zpětné volání, které se aktivuje při nahrávání průběhu.
timeout	Počet milisekund, které může požadavek trvat, než se automaticky ukončí.

Podrobnosti vlastnosti

acceptLanguage

Čárkami oddělený seznam jednoho nebo více jazyků, které se mají použít pro řetězce uživatelského rozhraní. Seznam je v sestupném pořadí předvoleb. Další informace, včetně očekávaného formátu, naleznete v RFC2616. Tato hlavička a parametr dotazu setLang se vzájemně vylučují; nezadávejte obojí. Pokud nastavíte tuto hlavičku, musíte také zadat parametr dotazu cc. Bing použije první podporovaný jazyk, který najde ze seznamu, a zkombinuje tento jazyk s hodnotou parametru cc a určí trh, aby vrátil výsledky. Pokud seznam neobsahuje podporovaný jazyk, Bing najde nejbližší jazyk a trh, který požadavek podporuje, a místo zadaného výsledku může použít agregovaný nebo výchozí trh. Tuto hlavičku a parametr dotazu cc byste měli použít pouze v případě, že zadáte více jazyků; jinak byste měli použít parametry dotazu mkt a setLang. Řetězec uživatelského rozhraní je řetězec, který se používá jako popisek v uživatelském rozhraní. Objekty odpovědi JSON mají velmi málo řetězců uživatelského rozhraní. Všechny odkazy v objektech odpovědi na Bing.com vlastnosti budou používat zadaný jazyk.

acceptLanguage?: string

Hodnota vlastnosti

string

answerCount

Počet odpovědí,kteréch Odpovědi, které Bing vrátí, jsou založené na pořadí. Pokud Například Bing vrátí webové stránky, obrázky, videa a související hledání požadavku a nastavíte tento parametr na dvě (2), bude odpověď obsahovat webové stránky a obrázky. Pokud jste do stejného požadavku zahrnuli parametr dotazu responseFilter a nastavili ho na webové stránky a zprávy, odpověď bude obsahovat jenom webové stránky.

answerCount?: number

Hodnota vlastnosti

number

clientId

Bing používá tuto hlavičku k zajištění konzistentního chování uživatelů napříč voláními rozhraní API Bingu. Bing často letí nové funkce a vylepšení a používá ID klienta jako klíč pro přiřazování provozu v různých letech. Pokud nepoužíváte stejné ID klienta pro uživatele ve více žádostech, může Bing přiřadit uživatele k několika konfliktními lety. Přiřazení k několika konfliktním letům může vést k nekonzistentnímu uživatelskému prostředí. Pokud má například druhý požadavek jiné přiřazení letu než první, může být prostředí neočekávané. Bing může také použít ID klienta k přizpůsobení výsledků vyhledávání v historii vyhledávání daného ID klienta, což poskytuje pro uživatele bohatší prostředí. Bing také používá tuto hlavičku k vylepšení hodnocení výsledků analýzou aktivity vygenerované ID klienta. Vylepšení relevance pomáhají zlepšit kvalitu výsledků poskytovaných rozhraními API Bingu a zase umožňují vyšší míru proklikání pro příjemce rozhraní API. DŮLEŽITÉ: I když je tato hlavička nepovinná, měli byste zvážit tuto hlavičku. Zachování ID klienta napříč několika požadavky na stejnou kombinaci koncových uživatelů a zařízení umožňuje 1) příjemci rozhraní API přijímat konzistentní uživatelské prostředí a 2) vyšší míru proklikání prostřednictvím lepší kvality výsledků z rozhraní API Bingu. Každý uživatel, který používá vaši aplikaci na zařízení, musí mít jedinečné ID klienta vygenerovaného Bingem. Pokud tuto hlavičku do požadavku nezahrnete, Bing vygeneruje ID a vrátí ho v hlavičce odpovědi X-MSEdge-ClientID. Jedinou dobou, kterou byste neměli do požadavku zahrnout, je čas, kdy uživatel na tomto zařízení poprvé použije vaši aplikaci. Použijte ID klienta pro každou žádost rozhraní API Bingu, kterou vaše aplikace pro tohoto uživatele na zařízení dělá. Zachovají ID klienta. Pokud chcete ID zachovat v aplikaci prohlížeče, použijte trvalý soubor cookie HTTP, abyste zajistili, že se ID použije ve všech relacích. Nepoužívejte soubor cookie relace. Pro jiné aplikace, jako jsou mobilní aplikace, použijte trvalé úložiště zařízení k zachování ID. Při příštím použití aplikace na daném zařízení získejte ID klienta, které jste si zachovali. Odpovědi Bingu můžou nebo nemusí obsahovat tuto hlavičku. Pokud odpověď obsahuje tuto hlavičku, zachyťte ID klienta a použijte ho pro všechny následné žádosti Bingu pro uživatele na tomto zařízení. Pokud zahrnete X-MSEdge-ClientID, nesmíte do požadavku zahrnout soubory cookie.

clientId?: string

Hodnota vlastnosti

string

clientIp

Adresa IPv4 nebo IPv6 klientského zařízení. IP adresa se používá ke zjištění polohy uživatele. Bing používá informace o poloze k určení bezpečného chování vyhledávání. I když je volitelné, doporučujeme vždy zadat tuto hlavičku a hlavičkuSearch-Location X. Nezaměňujte adresu (například změnou posledního oktetu na 0). Obfuscování adresy vede k tomu, že umístění není nikde blízko skutečného umístění zařízení, což může vést k tomu, že Bing obsluhuje chybné výsledky.

clientIp?: string

Hodnota vlastnosti

string

count

Počet výsledků hledání, které se mají vrátit v odpovědi. Výchozí hodnota je 10 a maximální hodnota je 50. Skutečné číslo doručené může být menší než požadováno. Tento parametr použijte spolu s parametrem posunu k výsledkům stránky. Pokud například vaše uživatelské rozhraní zobrazí 10 výsledků hledání na stránku, nastavte počet na 10 a posun na 0, abyste získali první stránku výsledků. Pro každou další stránku zvýší posun o 10 (například 0, 10, 20). Ve výsledcích je možné zahrnout několik stránek, které se překrývají.

count?: number

Hodnota vlastnosti

number

countryCode

Kód země se 2 znaky země, ze které pocházejí výsledky. Toto rozhraní API podporuje pouze trh USA. Pokud zadáte tento parametr dotazu, musí být nastavený na nás. Pokud nastavíte tento parametr, musíte také zadat hlavičku Accept-Language. Bing používá první podporovaný jazyk, který najde ze seznamu jazyků, a zkombinuje tento jazyk s kódem země, který určíte, a určí trh, aby vrátil výsledky. Pokud seznam jazyků neobsahuje podporovaný jazyk, Bing najde nejbližší jazyk a trh, který požadavek podporuje, nebo může místo zadaného výsledku použít agregovaný nebo výchozí trh. Tento parametr dotazu a parametr dotazu Accept-Language byste měli použít pouze v případě, že zadáte více jazyků; jinak byste měli použít parametry dotazu mkt a setLang. Tento parametr a parametr dotazu mkt se vzájemně vylučují – nezadávejte obojí.

countryCode?: string

Hodnota vlastnosti

string

freshness

Výsledky hledání můžete filtrovat podle následujících věkových hodnot: Den – vrátí webové stránky, které Bing zjistil během posledních 24 hodin. Týden – vrátí webové stránky, které Bing zjistil během posledních 7 dnů. Měsíc – vrátí webové stránky, které se zjistily za posledních 30 dnů. Tento filtr se vztahuje pouze na výsledky webové stránky, nikoli na ostatní výsledky, jako jsou zprávy a obrázky. Mezi možné hodnoty patří: "Den", "Týden", "Měsíc"

freshness?: Freshness

Hodnota vlastnosti

Freshness

location

Seznam párů klíč/hodnota oddělených středníkem, které popisují zeměpisné umístění klienta. Bing používá informace o poloze k určení bezpečného chování vyhledávání a k vrácení relevantního místního obsahu. Zadejte dvojici klíč/hodnota jako <klíč>:<hodnota>. Následují klíče, které použijete k určení umístění uživatele. lat (povinné): Zeměpisná šířka umístění klienta ve stupních. Zeměpisná šířka musí být větší nebo rovna -90,0 a menší nebo rovna +90,0. Záporné hodnoty označují jižní šířky a kladné hodnoty označují severní šířky. long (required): Délka umístění klienta ve stupních. Zeměpisná délka musí být větší nebo rovna -180,0 a menší nebo rovna +180,0. Záporné hodnoty označují západní délky a kladné hodnoty označují východní délky. re (povinné): Poloměr v metrech, který určuje vodorovnou přesnost souřadnic. Předejte hodnotu vrácenou službou zjišťování polohy zařízení. Typické hodnoty můžou být 22 m pro GPS/Wi-Fi, 380m pro triangulaci mobilní věže a 18 000 m pro zpětné vyhledávání IP adres. ts (volitelné): Časové razítko UTC UNIX, kdy byl klient v umístění. (Časové razítko systému UNIX je počet sekund od 1. ledna 1970.) hlava (volitelné): Relativní nadpis nebo směr cesty klienta. Určete směr cesty ve stupních od 0 do 360, počítá se ve směru hodinových ručiček vzhledem ke skutečnému severu. Tento klíč zadejte pouze v případě, že klíč sp není nenulový. sp (volitelné): Vodorovná rychlost (rychlost) v metrech za sekundu, kterou klientské zařízení cestuje. alt (volitelné): Výška klientského zařízení v metrech. jsou (volitelné): Poloměr v metrech, který určuje svislou přesnost souřadnic. Tento klíč zadejte pouze v případě, že zadáte klávesu Alt. I když je mnoho klíčů volitelné, tím více informací zadáte, tím přesnější jsou výsledky umístění. I když volitelné, doporučujeme vždy zadat zeměpisné umístění uživatele. Poskytnutí umístění je zvlášť důležité, pokud IP adresa klienta přesně neodráží fyzické umístění uživatele (například pokud klient používá vpn). Pro dosažení optimálních výsledků byste měli zahrnout tuto hlavičku a hlavičkuMSEdge-ClientIP X, ale alespoň byste měli zahrnout tuto hlavičku.

location?: string

Hodnota vlastnosti

string

market

Trh, ze kterého pocházejí výsledky. Mkt je obvykle země, ze které uživatel provádí žádost. Pokud se ale uživatel nenachází v zemi, kde Bing výsledky poskytuje, může to být jiná země. Trh musí být ve tvaru <kód jazyka-kód>< země>. Například en-US. Řetězec nerozlišuje velká a malá písmena. Pokud je to známo, doporučujeme vždy určit trh. Určení trhu pomáhá Bingu směrovat požadavek a vrátit odpovídající a optimální odpověď. Pokud zadáte trh, který není uvedený v kódech trhu, Bing použije nejlepší kód trhu na základě interního mapování, které se může změnit. Tento parametr a parametr dotazu cc se vzájemně vylučují – nezadávejte obojí. Výchozí hodnota: 'en-us'.

market?: string

Hodnota vlastnosti

string

offset

Posun založený na nule, který označuje počet výsledků hledání, které se mají přeskočit před vrácením výsledků. Výchozí hodnota je 0. Posun by měl být menší než (totalEstimatedMatches – count). Tento parametr použijte spolu s parametrem count k výsledkům stránky. Pokud například vaše uživatelské rozhraní zobrazí 10 výsledků hledání na stránku, nastavte počet na 10 a posun na 0, abyste získali první stránku výsledků. Pro každou další stránku zvýší posun o 10 (například 0, 10, 20). Je možné, aby více stránek zahrnovalo určité překrývající se výsledky.

offset?: number

Hodnota vlastnosti

number

pragma

Bing ve výchozím nastavení vrátí obsah uložený v mezipaměti, pokud je k dispozici. Pokud chcete, aby Bing nevrátil obsah uložený v mezipaměti, nastavte hlavičku Pragma na no-cache (například Pragma: no-cache).

pragma?: string

Hodnota vlastnosti

string

promote

Čárkami oddělený seznam odpovědí, které chcete, aby odpověď zahrnovala bez ohledu na jejich pořadí. Pokud například nastavíte answerCount) na dvě (2), aby Bing vrátil nejlepší dvě seřazené odpovědi, ale chcete, aby odpověď obsahovala zprávy, nastavíte zvýšení úrovně na zprávy. Pokud jsou nejlépe seřazené odpovědi webové stránky, obrázky, videa a související hledání, odpověď obsahuje webové stránky a obrázky, protože zprávy nejsou seřazené odpovědi. Pokud ale nastavíte zvýšení úrovně na video, Bing zvýší odpověď na video do odpovědi a vrátí webové stránky, obrázky a videa. Odpovědi, které chcete zvýšit, se nezapočítávají do limitu answerCount. Pokud jsou například seřazené odpovědi zprávy, obrázky a videa a nastavíte odpověďCount na hodnotu 1 a zvýšíte úroveň na zprávy, bude odpověď obsahovat zprávy a obrázky. Nebo pokud jsou seřazené odpovědi videa, obrázky a zprávy, odpověď obsahuje videa a zprávy. Možné hodnoty jsou Výpočty, Obrázky, Zprávy, Související hledání, SpellSuggestions, TimeZone, Videa, Webové stránky. Použijte pouze v případě, že zadáte parametr answerCount.

promote?: AnswerType[]

Hodnota vlastnosti

AnswerType[]

responseFilter

Čárkami oddělený seznam odpovědí, které se mají zahrnout do odpovědi. Pokud tento parametr nezadáte, bude odpověď obsahovat všechny odpovědi hledání, pro které jsou relevantní data. Možné hodnoty filtru jsou Výpočty, Obrázky, Zprávy, Související hledání, SpellSuggestions, TimeZone, Videa, Webové stránky. I když tento filtr můžete použít k získání jediné odpovědi, měli byste místo toho použít koncový bod specifický pro odpověď, abyste získali bohatší výsledky. Pokud například chcete přijímat pouze obrázky, odešlete požadavek na jeden z koncových bodů rozhraní API pro vyhledávání obrázků. Odpovědi RelatedSearches a SpellSuggestions nepodporují samostatný koncový bod, jako je rozhraní API pro vyhledávání obrázků (vrátí je pouze rozhraní API pro vyhledávání na webu). Pokud chcete zahrnout odpovědi, které by jinak byly vyloučeny z důvodu řazení, podívejte se na parametr dotazu na zvýšení úrovně.

responseFilter?: AnswerType[]

Hodnota vlastnosti

AnswerType[]

safeSearch

Filtr použitý k filtrování obsahu pro dospělé. Vypnuto: Vrátí webové stránky s textem, obrázky nebo videi pro dospělé. Moderování: Vrátí webové stránky s textem pro dospělé, ale ne obrázky nebo videa pro dospělé. Striktní: Nevracejte webové stránky s textem pro dospělé, obrázky nebo videi. Výchozí hodnota je Střední. Pokud požadavek pochází z trhu, který zásady Pro dospělé Bingu vyžadují, aby bezpečné hledání bylo nastaveno na Striktní, Bing ignoruje hodnotu bezpečného hledání a používá Strict. Pokud používáte web: operátor dotazu, existuje šance, že odpověď může obsahovat obsah pro dospělé bez ohledu na to, na co je parametr dotazu safeSearch nastavený. Použít web: Pouze pokud víte o obsahu na webu a váš scénář podporuje možnost obsahu pro dospělé. Mezi možné hodnoty patří: Off(Vypnuto), Moderate (Střední), Strict (Striktní).

safeSearch?: SafeSearch

Hodnota vlastnosti

SafeSearch

setLang

Jazyk, který se má použít pro řetězce uživatelského rozhraní. Zadejte jazyk pomocí kódu jazyka ISO 639-1 2 písmen. Například kód jazyka pro angličtinu je EN. Výchozí hodnota je EN (angličtina). I když je volitelný, měli byste vždy zadat jazyk. Obvykle nastavíte jazyk setLang na stejný jazyk určený mkt, pokud uživatel nechce řetězce uživatelského rozhraní zobrazované v jiném jazyce. Tento parametr a hlavička Accept-Language se vzájemně vylučují; nezadávejte obojí. Řetězec uživatelského rozhraní je řetězec, který se používá jako popisek v uživatelském rozhraní. Objekty odpovědi JSON mají několik řetězců uživatelského rozhraní. Také všechny odkazy na Bing.com vlastnosti v objektech odpovědi použijí zadaný jazyk.

setLang?: string

Hodnota vlastnosti

string

textDecorations

Logická hodnota, která určuje, zda by zobrazované řetězce měly obsahovat dekorační značky, jako je zvýraznění znaků. Pokud je hodnota true, mohou řetězce obsahovat značky. Výchozí hodnota je false. Pokud chcete určit, jestli se mají jako značky používat znaky Unicode nebo značky HTML, podívejte se na parametr dotazu textFormat.

textDecorations?: boolean

Hodnota vlastnosti

boolean

textFormat

Typ značek, které se mají použít pro textové dekorace (viz parametr dotazu textDecorations). Možné hodnoty jsou Raw – Pomocí znaků Unicode označte obsah, který potřebuje speciální formátování. Znaky Unicode jsou v rozsahu E000 až E019. Bing například používá pro zvýraznění začátku a konce termínů dotazu E000 a E001. HTML – pomocí značek HTML označte obsah, který potřebuje speciální formátování. Pomocí značek můžete například zvýraznit termíny dotazu v zobrazovaných řetězcích. Výchozí hodnota je Raw. U zobrazovaných řetězců, které obsahují čitelné znaky HTML, jako jsou <, >a &, pokud je textFormat nastavený na HTML, Bing znaky podle potřeby uvozí (například < je uvozováno na <). Mezi možné hodnoty patří: Raw, Html.

textFormat?: TextFormat

Hodnota vlastnosti

TextFormat

userAgent

Uživatelský agent pocházející z požadavku. Bing pomocí uživatelského agenta poskytuje mobilním uživatelům optimalizované prostředí. I když je tato hlavička nepovinná, důrazně doporučujeme, abyste tuto hlavičku vždy zadali. Uživatelský agent by měl být stejný řetězec, který by odeslal jakýkoli běžně používaný prohlížeč. Informace o uživatelských agentech naleznete v tématu RFC 2616.

userAgent?: string

Hodnota vlastnosti

string

Podrobnosti zděděných vlastností

abortSignal

Signál, který lze použít k přerušení požadavků.

abortSignal?: AbortSignalLike

Hodnota vlastnosti

AbortSignalLike

zděděno z msRest.RequestOptionsBase.abortSignal

customHeaders

Uživatelsky definované hlavičky vlastních požadavků, které se použijí před odesláním požadavku.

customHeaders?: {[key: string]: string}

Hodnota vlastnosti

{[key: string]: string}

zděděno z msRest.RequestOptionsBase.customHeaders

onDownloadProgress

Zpětné volání, které se aktivuje při průběhu stahování.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Hodnota vlastnosti

(progress: TransferProgressEvent) => void

zděděno z msRest.RequestOptionsBase.onDownloadProgress

onUploadProgress

Zpětné volání, které se aktivuje při nahrávání průběhu.

onUploadProgress?: (progress: TransferProgressEvent) => void

Hodnota vlastnosti

(progress: TransferProgressEvent) => void

zděděno z msRest.RequestOptionsBase.onUploadProgress

timeout

Počet milisekund, které může požadavek trvat, než se automaticky ukončí.

timeout?: number

Hodnota vlastnosti

number

zděděno z msRest.RequestOptionsBase.timeout