Referenční informace k rozhraní API pro vyhledávání na webu v7

Upozornění

Bing rozhraní API vyhledávání se přesouvají ze služeb Cognitive Services na Bing Search Services. Od 30. října 2020 musí být všechny nové instance vyhledávání Bing zřízeny podle zde popsaného procesu. Bing rozhraní API vyhledávání zřízená pomocí služeb Cognitive Services se budou podporovat po dobu následujících tří let nebo do konce vašeho smlouva Enterprise podle toho, co nastane dříve. Pokyny k migraci najdete v tématu Bing Vyhledávací služby.

Rozhraní API pro vyhledávání na webu umožňuje odeslat vyhledávací dotaz do Bing a získat zpět výsledky hledání, které obsahují odkazy na webové stránky, obrázky a další. Tato část obsahuje technické podrobnosti o webových stránkách, souvisejících vyhledáváních a výsledcích řazení kromě parametrů dotazu, které ovlivňují výsledky hledání. Příklady, které ukazují, jak provádět požadavky, najdete v tématu Hledání na webu.

Informace o hlavičkách, které mají požadavky obsahovat, najdete v tématu Hlavičky požadavku.

Informace o parametrech dotazu, které mají požadavky zahrnovat, najdete v tématu Parametry dotazu.

Informace o objektech JSON, které může odpověď obsahovat, naleznete v části Text odpovědi. Tento odkaz obsahuje objekt JSON specifický pro webové odpovědi. Podrobnosti o objektech JSON pro jiné typy odpovědí, které mohou výsledky hledání obsahovat, najdete v referenční dokumentaci specifické pro rozhraní API. Pokud například výsledek hledání obsahuje obrázky a odpovědi na zprávy, podívejte se na rozhraní API vyhledávání obrázků a rozhraní API pro vyhledávání zpráv.

Informace o povoleném použití a zobrazení výsledků najdete v tématu Bing Požadavky na použití a zobrazení rozhraní API služby Search.

Poznámka

Vzhledem k tomu, že formáty adres URL a parametry se můžou změnit bez předchozího upozornění, použijte všechny adresy URL tak, jak jsou. Neměli byste brát závislosti na formátu adresy URL nebo parametrech s výjimkou místa, kde je uvedeno.

Koncové body

Pokud chcete požádat o výsledky hledání na webu, odešlete požadavek GET na:

https://api.cognitive.microsoft.com/bing/v7.0/search

U předplatných s více službami musíte do adresy URL zahrnout oblast. Například: westus.api.cognitive.microsoft.com. Viz Podporované oblasti.

Tento požadavek musí používat protokol HTTPS.

Poznámka

Maximální délka adresy URL je 2 048 znaků. Pokud chcete zajistit, aby délka adresy URL nepřekročila limit, maximální délka parametrů dotazu by měla být menší než 1 500 znaků. Pokud adresa URL přesahuje 2 048 znaků, server vrátí hodnotu 404 Nenalezena.

Hlavičky

Následují hlavičky, které může obsahovat požadavek a odpověď.

Hlavička Description
Přijmout Nepovinná hlavička požadavku.

Výchozím typem média je application/json. Pokud chcete určit, že odpověď používá JSON-LD, nastavte hlavičku Accept na application/ld+json.
Accept-Language Nepovinná hlavička požadavku.

Čárkami oddělený seznam jazyků pro řetězce uživatelského rozhraní. Seznam je v sestupném pořadí podle priority. Další informace včetně očekávaného formátu najdete v RFC2616.

Tato hlavička a parametr dotazu setLang se vzájemně vylučují – nezadávejte obojí.

Pokud tuto hlavičku nastavíte, musíte zadat také parametr dotazu cc. K určení trhu, pro který se mají vracet výsledky, Bing použije první podporovaný jazyk, který najde v seznamu, a zkombinuje ho s hodnotou parametru cc. Pokud seznam jazyků podporovaný jazyk neobsahuje, Bing najde nejbližší jazyk a trh, který požadavek podporuje, nebo pro výsledky použije agregovaný nebo výchozí trh. Pokud chcete zjistit, který trh Bing použil, podívejte se do hlavičky BingAPIs-Market.

Tuto hlavičku a parametr dotazu cc použijte jenom v případě, že zadáte více jazyků. Jinak použijte 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í. V objektech odpovědí JSON je několik řetězců uživatelského rozhraní. Zadaný jazyk použijí všechny odkazy na vlastnosti Bing.com v objektech odpovědi.
BingAPIs-Market Hlavička odpovědi.

Trh používaný požadavkem. Formulář je <languageCode-countryCode<>>. Například cs-CZ.

Pokud zadáte trh, který není uveden v kódech trhu, tato hodnota se může lišit od trhu, který jste zadali v parametru dotazu mkt . Totéž platí, pokud zadáte hodnoty pro cc a Accept-Language , které nelze odsouhlasit.
BingAPIs-TraceId Hlavička odpovědi.

ID položky protokolu obsahující podrobnosti požadavku. Pokud dojde k chybě, toto ID zachyťte. Pokud problém nedokážete určit a vyřešit, uveďte toto ID spolu s dalšími informacemi, které poskytnete týmu podpory.
Ocp-Apim-Subscription-Key Povinná hlavička požadavku.

Klíč předplatného, který jste dostali při registraci k této službě v Cognitive Services.
Pragma Nepovinná hlavička požadavku

Ve výchozím nastavení Bing vrátí obsah uložený v mezipaměti, pokud je k dispozici. Abyste Bingu zabránili ve vrácení obsahu uloženého v mezipaměti, hlavičku Pragma nastavte na hodnotu no-cache (například Pragma: no-cache).
Opakovat po Hlavička odpovědi.

Odpověď obsahuje tuto hlavičku, pokud překročíte počet povolených dotazů za sekundu (QPS) nebo za měsíc (QPM). Hlavička obsahuje počet sekund, které musíte počkat před odesláním jiného požadavku.
User-Agent Nepovinná hlavička požadavku.

Uživatelský agent, ze kterého požadavek pochází. Bing používá uživatelského agenta k poskytnutí optimalizovaného prostředí pro mobilní uživatele. I když je tato hlavička nepovinná, doporučujeme ji vždy zadat.

Uživatelský agent by měl být stejný řetězec, který odesílá kterýkoli běžně používaný prohlížeč. Informace o uživatelských agentech najdete v RFC 2616.

Následují příklady řetězců uživatelského agenta.
  • Windows Phone – Mozilla/5.0 (kompatibilní; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Dotykové ovládání; NOKIA; Lumia 822)

  • Android – Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) verze/4.0 Mobile Safari/533.1

  • iPhone – Mozilla/5.0 (iPhone; Cpu iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC – Mozilla/5.0 (systém Windows NT 6.3; WOW64; Trident/7.0; Dotykové ovládání; rv:11.0) like Gecko

  • iPad – Mozilla/5.0 (iPad; Cpu OS 7_0 jako Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Verze/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID Nepovinná hlavička požadavku a odpovědi

Bing tuto hlavičku používá k tomu, aby uživatelům poskytoval konzistentní chování napříč voláními rozhraní API Bingu. Bing často testuje nové funkce a vylepšení a ID klienta používá jako klíč pro přiřazení provozu v různých testovacích verzích. Pokud nepoužíváte stejné ID klienta pro uživatele napříč více požadavky, pak může Bing uživatele přiřadit k více konfliktním testovacím verzím. Přiřazení k více konfliktním testovacím verzím může vést k nekonzistentnímu prostředí pro uživatele. Pokud třeba druhý požadavek má jiné přiřazení k testovací verzi než prví, může být prostředí neočekávané. Bing také může použít ID klienta k přizpůsobení webových výsledků pro historii hledání tohoto ID klienta, což uživateli poskytuje bohatší prostředí.

Bing také tuto hlavičku používá ke zlepšování hodnocení výsledků díky analýze aktivity generované tímto ID klienta. Zlepšení relevance pomáhá zlepšit kvalitu výsledků poskytovaných rozhraním API Bingu a stejně tak umožňuje vyšší míru prokliků uživatele rozhraní API.

DŮLEŽITÉ: I když je tato hlavička nepovinná, měli byste ji považovat za povinnou. Zachování ID klienta mezi více požadavky pro stejnou kombinaci koncového uživatele a zařízení umožňuje 1) aby uživatel rozhraní API získával konzistentní uživatelské prostředí a 2) vyšší míry prokliků díky kvalitnějším výsledkům z rozhraní API Bingu.

Následují základní pravidla používání, která se na tuto hlavičku vztahují.
  • Každý uživatel, který používá vaši aplikaci na zařízení, musí mít jedinečné ID klienta vygenerované Bingem.

    Pokud tuto hlavičku do požadavku nezahrnete, Bing vygeneruje ID a vrátí ho v hlavičce odpovědi X-MSEdge ClientID. Tuto hlavičku byste v požadavku zahrnout NEMĚLI jenom v případě, kdy uživatel aplikaci na zařízení používá poprvé.

  • POZOR: Musíte zajistit, aby toto ID klienta nebylo spojitelné s jakýmikoli informacemi účtu ověřeného uživatele.

  • Použijte ID klienta pro každý požadavek rozhraní API Bingu, který vaše aplikace provede pro tohoto uživatele na zařízení.

  • ID klienta zachovejte. Pokud chcete zachovat ID v aplikaci prohlížeče, použijte trvalý soubor cookie HTTP, aby se zaručilo, že se ID použije ve všech relacích. Nepoužívejte soubor cookie relace. Pro jiné aplikace, jako jsou mobilní aplikace, použijte k zachování ID trvalé úložiště zařízení.

    Když uživatel aplikaci na zařízení příště použije, získejte ID klienta, které jste zachovali.

POZNÁMKA: Odpovědi Bingu tuto hlavičku mohou nebo nemusí obsahovat. Pokud odpověď tuto hlavičku obsahuje, ID klienta zachyťte a použijte pro všechny následné požadavky Bingu pro uživatele na tomto zařízení.

POZNÁMKA: Pokud zahrnete X-MSEdge-ClientID, nesmíte do požadavku zahrnout soubory cookie.
X-MSEdge-ClientIP Nepovinná hlavička požadavku.

Adresa IPv4 nebo IPv6 klientského zařízení. IP adresa se používá ke zjištění polohy uživatele. Bing informace o poloze používá k určení chování bezpečného hledání.

POZNÁMKA: I když je tato hlavička nepovinná, doporučujeme ji vždy zadat, stejně jako hlavičku X-Search-Location.

Neprovádějte obfuskaci adresy (například změnou posledního oktetu na 0). Obfuskace adresy vede k tomu, že poloha nebude blízko skutečné polohy zařízení. Bing pak může dodávat chybné výsledky.
X-Search-Location Nepovinná hlavička požadavku.

Středníky oddělený seznam párů klíč/hodnota, které popisují zeměpisnou polohu klienta. Bing informace o poloze používá k určení chování bezpečného hledání a vracení relevantního místního obsahu. Pár klíč/hodnota zadejte jako <klíč>:<hodnota>. Následují klíče, které se používají k určení polohy uživatele.

  • lat – Povinné. Zeměpisná šířka polohy klienta ve stupních. Zeměpisná šířka musí být větší nebo rovná -90,0 a menší nebo rovná +90,0. Záporné hodnoty značí jižní šířku a kladné hodnoty značí severní šířku.

  • long – Povinné. Zeměpisná délka polohy klienta ve stupních. Zeměpisná délka musí být větší nebo rovná -180,0 a menší nebo rovná +180,0. Záporné hodnoty značí západní délku a kladné hodnoty značí východní délku.

  • 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, 380 m pro triangulaci mobilních vysílačů a 18 000 m pro reverzní vyhledávání IP adresy.

  • ts – volitelné. Časové razítko UTC UNIX, kdy se klient na daném místě nacházel. (Časové razítko UNIX je počet sekund od 1. ledna 1970.)

  • hlava – Nepovinný. Relativní směr pohybu klienta. Zadejte směr pohybu ve stupních od 0 do 360 ve směru hodinových ručiček vzhledem k severu. Tento klíč zadejte jenom tehdy, když je klíč sp nenulový.

  • sp – Nepovinný. Vodorovná rychlost v metrech za sekundu, kterou se klientské zařízení pohybuje.

  • alt – Volitelné. Nadmořská 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 jenom tehdy, když zadáte klíč alt.

  • disp – Volitelné. Zeměpisné umístění uživatele ve formuláři, disp:<City, State>. Například disp:Seattle, Washington. Jedná se o zobrazovanou textovou verzi umístění uživatele, kterou jste zadali pomocí kláves lat/long. Pokud je tato hodnota v konfliktu se souřadnicemi lat/long, Bing použije hodnotu disp jako umístění uživatele.

POZNÁMKA: Bing tuto hlavičku ignoruje, pokud dotaz obsahuje umístění. Pokud například tato hlavička odráží umístění uživatele jako San Francisco, ale dotaz je restaurace seattle, Bing vrátí restaurace umístěné v Seattlu, Washingtonu.

POZNÁMKA: I když jsou mnohé klíče nepovinné, čím více informací zadáte, tím přesnější budou výsledky určení polohy.

POZNÁMKA: I když je geografická poloha uživatele nepovinná, doporučujeme ji vždy zadat. Poskytnutí polohy je zvlášť důležité, pokud IP adresa klienta přesně neodráží fyzickou polohu uživatele (třeba pokud klient používá síť VPN). Pro optimální výsledky byste měli zahrnout toto záhlaví a hlavičku X-Search-ClientIP, ale minimálně byste měli zahrnout tuto hlavičku.

Poznámka

Nezapomínejte, že podmínky použití vyžadují dodržování příslušných zákonů, včetně těch týkajících se použití těchto hlaviček. Například v určitých jurisdikcích, třeba v Evropě, se před umístěním určitých sledovacích zařízení do zařízení uživatelů požaduje získání souhlasu uživatele.

Parametry dotazů

Níže jsou uvedené parametry dotazu, které tento požadavek může zahrnovat. Sloupec Vyžadováno určuje, jestli je příslušný parametr nutné zadat. Hodnoty parametrů dotazů musíte zakódovat s použitím kódování URL.

Name Hodnota Typ Vyžadováno
answerCount Počet odpovědí, které má odpověď obsahovat. 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), odpověď obsahuje webové stránky a obrázky.

Pokud jste do stejného požadavku zahrnuli responseFilter parametr dotazu a nastavili ho na webové stránky a zprávy, odpověď bude obsahovat jenom webové stránky.

Informace o propagaci seřazené odpovědi do odpovědi najdete v tématu zvýšení úrovně.
Celé číslo bez znaménka No
cc Dva znaky kódu země, odkud výsledky pochází. Seznam možných hodnot najdete v tématu Kódy trhu.

Pokud tento parametr nastavíte, musíte zadat také hlavičku Accept-Language. Bing používá první podporovaný jazyk, který najde v zadaných jazycích, a kombinuje ho s kódem země k určení trhu pro vrácení výsledků. Pokud seznam jazyků podporovaný jazyk neobsahuje, najde Bing nejbližší jazyk a trh, který požadavek podporuje. Nebo Bing může pro výsledky použít agregovaný nebo výchozí trh.

Tento parametr dotazu a hlavičku Accept-Language použijte pouze v případě, že zadáte více jazyků. V opačném případě byste měli použít mkt parametry dotazu a setLang dotaz.

Tento parametr a parametr dotazu mkt se vzájemně vylučují – nezadávejte obojí.
Řetězec No
Počet 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žadované.

Tento parametr použijte spolu s parametrem ke stránkovat offset výsledky. Další informace najdete v tématu Stránkování webových stránek.

Pokud například uživatelské rozhraní zobrazí na stránce 10 výsledků hledání, nastavte count na 10 a offset 0, abyste získali první stránku výsledků. Pro každou další stránku se zvýší offset o 10 (například 0, 10, 20). Je možné, aby více stránek obsahovalo několik překrývajících se výsledků.
Bez znaménka No
Čerstvost Výsledky hledání můžete filtrovat podle následujících hodnot věku nerozlišující malá a velká písmena:
  • Den – vrácení webových stránek, které Bing zjištěny během posledních 24 hodin

  • Týden – vrátí webové stránky, které Bing zjištěny během posledních 7 dnů.

  • Měsíc – vrácení webových stránek, které se zjistily během posledních 30 dnů

Pokud chcete získat články zjištěné Bing během určitého časového rámce, zadejte rozsah dat ve formuláři YYYY-MM-DD.. YYYY-MM-DD. Například, &freshness=2019-02-01..2019-05-30. Pokud chcete omezit výsledky na jedno datum, nastavte tento parametr na konkrétní datum. Například, &freshness=2019-02-04.
Řetězec No
mkt Trh, odkud pochází výsledky. Obvykle je země, mkt ze které uživatel provádí žádost. Pokud se ale uživatel nenachází v zemi, kde Bing výsledky, může to být jiná země. Trh musí být v kódu> země>< kódu ve formuláři<. Například cs-CZ. Řetězec nerozlišuje velká a velká písmena. Seznam možných tržních hodnot najdete v tématu Kódy trhu.

POZNÁMKA: Pokud je to známo, doporučujeme, abyste vždy určili 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á změnit.

Tento parametr a parametr dotazu cc se vzájemně vylučují – nezadávejte obojí.
Řetězec No
posun 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 ke stránkovat count výsledky. Pokud například uživatelské rozhraní zobrazí na stránce 10 výsledků hledání, nastavte count na 10 a offset 0, abyste získali první stránku výsledků. Pro každou další stránku se zvýší offset o 10 (například 0, 10, 20). Je možné, aby více stránek obsahovalo několik překrývajících se výsledků.
Nepodepsaný krátký No
Podporovat Seznam odpovědí oddělených čárkami, které chcete, aby odpověď obsahovala bez ohledu na jejich pořadí. Pokud například nastavíte answerCount) na dvě (2), takže Bing vrátí nejlepší dvě seřazené odpovědi, ale chcete, aby odpověď obsahovala zprávy, nastavili promote byste zprávy. Pokud jsou nejlepší 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 promote video, Bing by odpověď na video propagovala do odpovědi a vrátila 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 answerCount na 1 a promote na novinky, odpověď obsahuje zprávy a obrázky. Nebo pokud jsou seřazené odpovědi videa, obrázky a zprávy, odpověď obsahuje videa a zprávy.

Níže jsou uvedené možné hodnoty.
  • Výpočtu
  • Obrázky
  • Novinky
  • Související hledání
  • Pravopisné návrhy
  • TimeZone
  • Videa
  • Webové stránky

POZNÁMKA: Použijte pouze v případě, že zadáte answerCount.
Řetězec No
Q Hledaný termín uživatele. Termín nemusí být prázdný.

Termín může obsahovat Bing rozšířené operátory. Pokud chcete například omezit výsledky na konkrétní doménu, použijte operátor site: (
Řetězec Yes
responseFilter Seznam odpovědí oddělených čárkami, které se mají zahrnout do odpovědi. Pokud tento parametr nezadáte, odpověď obsahuje všechny odpovědi hledání, pro které jsou relevantní data.

Níže jsou uvedené možné hodnoty filtru.
  • Výpočtu
  • Entity
  • Obrázky
  • Novinky
  • Související hledání
  • Pravopisné návrhy
  • TimeZone
  • Videa
  • Webové stránky

Pokud chcete z odpovědi vyloučit konkrétní typy obsahu, jako jsou obrázky, můžete je vyloučit pomocí předpony spojovníku (minus) hodnoty responseFilter. Oddělené vyloučené typy čárkou: &responseFilter=-images,-videos

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 chcete například přijímat jenom obrázky, odešlete požadavek na jeden z koncových bodů rozhraní API pro vyhledávání obrázků .

Odpovědi souvisejícího vyhledávání a pravopisu 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 řazení, podívejte se na parametr dotazu pro zvýšení úrovně .
Řetězec No
safeSearch filtruje webové stránky pro obsah pro dospělé. Níže jsou uvedené možné hodnoty filtru.
  • Vypnuto – Vrátí webové stránky s textem a obrázky pro dospělé.
  • Moderování – Návrat webových stránek 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 videa.
Výchozí hodnota je Moderate.

POZNÁMKA: Pokud je výsledky safeSearch videa nastavené na Vypnuto, Bing ho ignoruje a používá Střední.

POZNÁMKA: Pokud žádost pochází z trhu, který Bing zásadu pro dospělé vyžaduje, aby safeSearch byla nastavena na Strict, Bing ignoruje safeSearch hodnotu a používá Strict.

POZNÁMKA: Pokud použijete operátor dotazu site:, je možné, že odpověď bude zahrnovat obsah pro dospělé bez ohledu na nastavení parametru dotazu safeSearch. site: použijte jenom v případě, že znáte obsah příslušného webu a váš scénář podporuje možnost zobrazení obsahu pro dospělé.
Řetězec No
setLang Jazyk, který se má použít pro řetězce uživatelského rozhraní. Jazyk můžete zadat buď pomocí 2 písmen, nebo 4 písmen. Upřednostňují se použití 4mísmenných kódů.

Seznam podporovaných jazykových kódů najdete v tématu Bing podporovaných jazyků.

Bing načte lokalizované řetězce, pokud setlang obsahuje platný 2mísmenný neutrální kód jazykové verze (fr) nebo platný kód jazykové verze specifické pro 4 písmena (fr-ca). Například pro fr-ca Bing načte řetězce kódu neutrální jazykové verze.

Pokud setlang není platný (například zh) nebo Bing nepodporuje jazyk (například af, af-na), Bing výchozí hodnoty en (angličtina).

Chcete-li zadat kód 2 písmen, nastavte tento parametr na kód jazyka ISO 639-1.

Pokud chcete zadat kód se 4 písmeny, použijte jazykovou zemi> nebo oblast> formuláře<, kde <jazyk> je kód jazyka ISO 639-1 (neutrální jazyková verze) a <země/oblast> je kód iso 3166 země/oblasti (specifická jazyková< verze). Například pro USA angličtinu použijte en-US.

I když je jazyk volitelný, měli byste ho vždy zadat. Obvykle se setLang nastavuje na stejný jazyk, jaký určuje parametr mkt, pokud uživatel nechce řetězce uživatelského rozhraní zobrazené 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í. V objektech odpovědí JSON je několik řetězců uživatelského rozhraní. Zadaný jazyk použijí také všechny odkazy na vlastnosti Bing.com v objektech odpovědi.
Řetězec No
TextDecorations Logická hodnota, která určuje, zda by zobrazované řetězce měly obsahovat značky dekorace, jako je zvýraznění znaků. Pokud je pravda, řetězce můžou 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 .

Informace o zvýraznění hitů najdete v tématu Zvýraznění hitů.
Logická hodnota No
Textformat Typ značek, které se mají použít pro textové dekorace (viz textDecorations parametr dotazu).

Níže jsou uvedené možné hodnoty.
  • Nezpracované – pomocí znaků Unicode označte obsah, který potřebuje speciální formátování. Znaky Unicode jsou v rozsahu E000 až E019. Například Bing používá E000 a E001 k označení začátku a konce termínů dotazu pro zvýraznění hitů.

  • HTML – Pomocí značek HTML označte obsah, který potřebuje speciální formátování. Pomocí <značek b> můžete například zvýraznit termíny dotazu v zobrazovaných řetězcích.

Výchozí hodnota je Raw.

Seznam značek najdete v tématu Zvýraznění hitů.

U zobrazovaných řetězců obsahujících znaky HTML, jako <jsou například , >a &, jsou-li textFormat nastaveny na HTML, Bing uvozuje znaky podle potřeby (například < se uvozuje na &lt;).

Informace o zpracování řetězců s vloženými znaky Unicode naleznete v tématu Zvýraznění stisknutím klávesy.
Řetězec No

Objekty odpovědi

Poznámka

Aby bylo dosaženo souladu s novou směrnicí o autorských právech EU ve Francii, musí Bing Web, News, Video, Image a všechna rozhraní API pro vlastní vyhledávání vynechat určitý obsah z určitých zdrojů zpráv EU pro francouzské uživatele. Odebraný obsah může obsahovat miniatury a videa, náhledy videa a fragmenty kódu, které doprovázejí výsledky hledání z těchto zdrojů. V důsledku toho může rozhraní API Bing poskytovat méně výsledků s miniaturami a videi, náhledy videí a fragmenty kódu pro francouzské uživatele.

Následuje objekty odpovědi JSON, které může odpověď obsahovat. Pokud je požadavek úspěšný, objekt nejvyšší úrovně v odpovědi je SearchResponse objekt. Pokud požadavek selže, objekt nejvyšší úrovně je ErrorResponse objekt.

Tento seznam obsahuje objekty JSON, které jsou specifické pro webové odpovědi. Podrobnosti o objektech JSON pro jiné typy odpovědí, které mohou výsledky hledání obsahovat, najdete v referenční dokumentaci specifické pro rozhraní API. Pokud například výsledek hledání obsahuje obrázky a odpovědi na zprávy, podívejte se na rozhraní API obrázku a rozhraní API pro zprávy.

Objekt Description
Výpočtu Definuje výraz a jeho odpověď.
Entita Definuje entitu, jako je osoba, místo nebo věc.
Chyba Definuje chybu, ke které došlo.
ErrorResponse Objekt nejvyšší úrovně, který odpověď zahrnuje, když požadavek selže.
Identifikovatelné Definuje ID prostředku.
LicenseAttribution Definuje smluvní pravidlo pro přiřazení licence.
LinkAttribution Definuje smluvní pravidlo pro přiřazení odkazu.
MediaAttribution Definuje smluvní pravidlo pro přidělování médií.
Dotaz Definuje řetězec dotazu.
QueryContext Definuje kontext dotazu, který Bing použitý pro požadavek, pokud zadaný řetězec dotazu obsahuje pravopisnou chybu.
RankingGroup Definuje skupinu výsledků hledání, například hlavní řádek.
RankingItem Definuje položku skupiny řazení, která se má zobrazit.
RankingResponse Definuje, kde má být obsah stránky výsledků hledání umístěn a v jakém pořadí.
RelatedSearchAnswer Definuje seznam souvisejících dotazů vytvořených jinými uživateli.
SearchResponse Objekt nejvyšší úrovně, který odpověď zahrnuje, když požadavek proběhne úspěšně.
SpellSuggestions Definuje navrhovaný řetězec dotazu, který pravděpodobně představuje záměr uživatele.
TextAttribution Definuje smluvní pravidlo pro přiřazení ve formátu prostého textu.
Timezone Definuje datum a čas jedné nebo více geografických lokalit.
TimeZoneInformation Definuje informace o časovém pásmu o zeměpisném umístění.
WebAnswer Definuje seznam relevantních odkazů na webové stránky.
Webové stránky Definuje webovou stránku, která je relevantní pro dotaz.

Entita

Definuje entitu, jako je osoba, místo nebo věc.

Název Hodnota Typ
bingId ID, které jedinečně identifikuje tuto entitu. Řetězec
smluvní pravidla Seznam pravidel, která musíte dodržovat, pokud entitu zobrazíte. Pravidla mohou například řídit přiřazení popisu entity.

Mohou platit následující smluvní pravidla.


Ne všechny entity zahrnují pravidla. Pokud entita poskytuje smluvní pravidla, musíte je dodržovat. Další informace o používání smluvních pravidel najdete v tématu Přiřazení dat.
Objekt[]
description Stručný popis entity. Řetězec
entityPresentationInfo Další informace o entitě, jako jsou nápovědy, které můžete použít k určení typu entity. K určení typu entity použijte entityScenario pole a entityTypeHint pole. Pole vám například pomůžou určit, jestli je entita dominantní nebo nejednoznačná entita a jestli se jedná o osobu nebo film. Entita je dominantní entitou, pokud Bing se domnívá, že požadavek splňuje pouze jedna entita. Pokud může požadavek splnit více entit, entita je nejednoznačná entita a uživatel musí vybrat entitu, kterou zajímá. EntityPresentationInfo
image Obrázek entity. Obrázek
name Název entity. Řetězec
webSearchUrl Adresa URL, která uživatele přenese na stránku výsledků hledání pro tuto entitu Bing. Řetězec

EntityAnswer

Definuje odpověď entity.

Název Hodnota Typ
queryScenario Podporovaný scénář dotazu. Toto pole je nastaveno na DominantEntity nebo DisambiguationItem. Pole je nastaveno na DominantEntity, pokud Bing určuje, že požadavek splňuje jenom jedna entita. Například kniha, film, osoba nebo atrakce. Pokud by požadavek mohl splnit více entit, je pole nastaveno na DisambiguationItem. Pokud například požadavek používá obecný název filmové série, bude typ entity pravděpodobně nejednoznačný. Pokud však žádost určuje konkrétní název z franšízy, bude typ entity pravděpodobně dominantní. Řetězec
hodnota Seznam entit. Entita[]

EntityPresentationInfo

Definuje další informace o entitě, například nápovědy k typu.

Name Hodnota Typ
entityScenario Podporovaný scénář. Řetězec
entityTypeDisplayHint Zobrazení verze nápovědy k entitě Pokud entityTypeHints je například Interpret, může být toto pole nastaveno na American Singer. Řetězec
entityTypeHint Seznam tipů, které označují typ entity. Seznam může obsahovat jednu nápovědu, například Film nebo seznam tipů, jako je Place, LocalBusiness, Restaurant. Každý další použitý pomocný parametr zužuje možnosti typu entity.

Seznam možných typů najdete v tématu Typy entit. Pokud objekt neobsahuje toto pole, předpokládá se obecné.
Řetězec[]

Výpočtu

Definuje výraz a jeho odpověď.

Element Popis Typ
Výraz Matematický nebo převodní výraz.

Pokud dotaz obsahuje požadavek na převod jednotek míry (například měřiče na stopy), toto pole obsahuje jednotky z jednotek a valueobsahuje jednotky.

Pokud dotaz obsahuje matematický výraz, například 2+2, toto pole obsahuje výraz a value obsahuje odpověď.

Všimněte si, že matematické výrazy mohou být normalizovány. Pokud byl dotaz například sqrt(4^2+8^2), normalizovaný výraz může být sqrt((4^2)+(8^2)).

Pokud je dotaz uživatele matematickým dotazem a parametr dotazu textDecorations je nastaven na true, řetězec výrazu může obsahovat značky formátování. Pokud je například dotaz uživatele log(2), normalizovaný výraz obsahuje značky dolního indexu. Další informace najdete v tématu Zvýraznění hitů.
Řetězec
Hodnotu Odpověď výrazu. Řetězec

Chyba

Definuje chybu, ke které došlo.

Element Popis Typ
Kód Kód chyby, který identifikuje kategorii chyby. Seznam možných kódů najdete v tématu Kódy chyb. Řetězec
Zprávu Popis chyby. Řetězec
MoreDetails Popis, který poskytuje další informace o chybě. Řetězec
Parametr Parametr dotazu v požadavku, který způsobil chybu. Řetězec
subCode Kód chyby, který chybu identifikuje. Pokud code je například InvalidRequest, subCode může být ParametrInvalid nebo ParameterInvalidValue. Řetězec
Hodnotu Hodnota parametru dotazu, která nebyla platná. Řetězec

ErrorResponse

Objekt nejvyšší úrovně, který odpověď zahrnuje, když požadavek selže.

Název Hodnota Typ
_type Nápověda k typu Řetězec
Chyby Seznam chyb, které popisují důvody, proč požadavek selhal. Chyba[]

Identifikovatelné

Definuje identitu prostředku.

Name Hodnota Typ
id Identifikátor. Řetězec

Image

Definuje obrázek.

Poznámka

Vzhledem k tomu, že formát adresy URL a parametry se můžou bez předchozího upozornění změnit, měly by se použít všechny adresy URL obrázků. Neměli byste brát závislosti na formátu nebo parametrech adresy URL. Výjimkou jsou tyto parametry a hodnoty probírané změnou velikosti a oříznutím miniatur.

Název Hodnota Typ
výška Výška zdrojového obrázku v pixelech Nepodepsaný krátký
hostPageUrl Adresa URL webové stránky, která obsahuje obrázek.

Tato adresa URL může contentUrl být stejná.
Řetězec
name Volitelný textový řetězec, který obsahuje náhodné informace o obrázku. Řetězec
Zprostředkovatel Zdroj obrázku. Pole bude obsahovat jednu položku.

Image musíte přiřadit poskytovateli. Můžete například zobrazit jméno zprostředkovatele, protože kurzor najede myší na obrázek nebo obrázek vytvoří odkaz na klikací odkaz na web poskytovatele, na kterém se obrázek nachází.
Organizace[]
thumbnailUrl Adresa URL miniatury obrázku. Informace o změně velikosti obrázku najdete v tématu Změna velikosti a oříznutí miniatur. Řetězec
šířka Šířka zdrojového obrázku v pixelech Nepodepsaný krátký

LicenseAttribution

Definuje smluvní pravidlo pro přiřazení licencí.

Název Hodnota Typ
_type Tip typu, který je nastavený na LicenseAttribution. Řetězec
license Licence, pod kterou se obsah může použít. Licence
licenseNotice Licence, která se má zobrazit vedle cílového pole. Například text pod licencí CC-BY-SA.

Pomocí názvu a adresy URL licence v license poli vytvořte hypertextový odkaz na web, který popisuje podrobnosti licence. Potom nahraďte název licence v řetězci licenseNotice (například CC-BY-SA) hypertextovým odkazem, který jste právě vytvořili.
Řetězec
mustBeCloseToContent Logická hodnota, která určuje, jestli se obsah pravidla musí umístit do těsné blízkosti pole, na které se pravidlo vztahuje. Pokud ano, obsah musí být umístěn v těsné blízkosti. Pokud nepravda nebo toto pole neexistuje, obsah se může umístit podle uvážení volajícího. Logická hodnota
targetPropertyName Název pole, na které se pravidlo vztahuje. Řetězec

LinkAttribution

Definuje smluvní pravidlo pro přiřazení odkazu.

Název Hodnota Typ
_type Tip typu, který je nastavený na LinkAttribution. Řetězec
mustBeCloseToContent Logická hodnota, která určuje, zda musí být obsah pravidla umístěn v těsné blízkosti pole, na které se pravidlo vztahuje. Pokud je hodnota true, musí být obsah umístěn v těsné blízkosti. Pokud nepravda nebo toto pole neexistuje, může být obsah umístěn podle uvážení volajícího. Logická hodnota
targetPropertyName Název pole, na které se pravidlo vztahuje.

Pokud není zadaný cíl, přiřazení se vztahuje na entitu jako celek a mělo by se zobrazit hned za prezentací entity. Pokud existuje více pravidel pro přiřazení textu a odkazů, která nezadávají cíl, měli byste je zřetězovat a zobrazit pomocí popisku Data z: Například "Data z <názvu zprostředkovatele1> | < název poskytovatele2>".
Řetězec
text Text přisuzování. Řetězec
url Adresa URL webu poskytovatele. Vytvoření hypertextového odkazu pomocí text adresy URL a jeho adresy URL Řetězec

MediaAttribution

Definuje smluvní pravidlo pro přidělování médií.

Název Hodnota Typ
_type Tip typu, který je nastavený na MediaAttribution. Řetězec
mustBeCloseToContent Logická hodnota, která určuje, zda musí být obsah pravidla umístěn v těsné blízkosti pole, na které se pravidlo vztahuje. Pokud je hodnota true, musí být obsah umístěn v těsné blízkosti. Pokud nepravda nebo toto pole neexistuje, může být obsah umístěn podle uvážení volajícího. Logická hodnota
targetPropertyName Název pole, na které se pravidlo vztahuje. Řetězec
url Adresa URL, kterou používáte k vytvoření hypertextového odkazu mediálního obsahu. Pokud je cílem například obrázek, použijte adresu URL k tomu, aby byl obrázek kliknutelný. Řetězec

Metaznak

Definuje metadata webové stránky.

Name Hodnota Typ
obsah Metadata. Řetězec
name Název metadat Řetězec

Organizace

Definuje vydavatele.

Všimněte si, že vydavatel může zadat své jméno nebo web nebo obojí.

Název Hodnota Typ
name Jméno vydavatele. Řetězec
url Adresa URL webu vydavatele.

Všimněte si, že vydavatel nemusí poskytnout web.
Řetězec

Dotaz

Definuje vyhledávací dotaz.

Objekt SpellSuggestions tento objekt používá k návrhu řetězce dotazu, který pravděpodobně představuje záměr uživatele. Používá ho také RelatedSearchAnswer k vrácení souvisejícího dotazu, který provedli jiní uživatelé.

Název Hodnota Typ
displayText Verze zobrazení termínu dotazu. Tato verze výrazu dotazu může obsahovat speciální znaky, které zvýrazňují hledaný termín nalezený v řetězci dotazu. Řetězec obsahuje zvýrazňující znaky pouze v případě, že dotaz povolil zvýraznění (viz parametr dotazu textDecorations ). Podrobnosti o zvýrazňování hitů najdete v tématu Zvýraznění hitů. Řetězec
Text Řetězec dotazu. Tento řetězec použijte jako výraz dotazu v nové žádosti o hledání. Řetězec
webSearchUrl Adresa URL, která uživatele přenese na stránku výsledků hledání Bing dotazu.

Toto pole zahrnují pouze související výsledky hledání.
Řetězec

QueryContext

Definuje řetězec dotazu, který Bing použitý pro požadavek.

Element Popis Typ
adultIntent Logická hodnota, která označuje, jestli zadaný dotaz má záměr pro dospělé. Hodnota je pravdivá , pokud má dotaz záměr pro dospělé.

Pokud je hodnota true a parametr dotazu safeSearch požadavku je nastavený na Strict, odpověď obsahuje pouze výsledky zpráv, pokud je to možné.
Logická hodnota
změnaOverrideQuery Řetězec dotazu, který se má použít k vynucení Bing použít původní řetězec. Pokud je například řetězec dotazu saling downwind, přepsat řetězec dotazu je +saling downwind. Nezapomeňte zakódovat řetězec dotazu, jehož výsledkem je %2Baling+downwind.

objekt obsahuje toto pole pouze v případě, že původní řetězec dotazu obsahuje pravopisnou chybu.
Řetězec
alteredQuery Řetězec dotazu, který Bing použitý k provedení dotazu. Bing používá změněný řetězec dotazu, pokud původní řetězec dotazu obsahoval pravopisné chyby. Pokud je saling downwindnapříklad řetězec dotazu , změněný řetězec dotazu je sailing downwind.

Objekt obsahuje toto pole pouze v případě, že původní řetězec dotazu obsahuje pravopisnou chybu.
Řetězec
askUserForLocation Logická hodnota označující, jestli Bing vyžaduje, aby umístění uživatele poskytovalo přesné výsledky. Pokud jste zadali umístění uživatele pomocí záhlaví X-MSEdge-ClientIP a X-Search-Location , můžete toto pole ignorovat.

Pro dotazy s informacemi o poloze, například "dnešní počasí" nebo "restaurace blízko mě", které potřebují umístění uživatele k poskytnutí přesných výsledků, je toto pole nastaveno na true.

Pro dotazy s informacemi o poloze, které obsahují umístění (například "Počasí v Seattlu" ), je toto pole nastavené na false. Toto pole je také nastaveno na false pro dotazy, které si nejsou vědomy umístění, například "nejlepší prodejci".
Logická hodnota
originalQuery Řetězec dotazu zadaný v požadavku. Řetězec

RankingGroup

Definuje skupinu výsledků hledání, například hlavní řádek.

Název Hodnota Typ
položky Seznam položek výsledků hledání, které se mají zobrazit ve skupině. RankingItem[]

RankingItem

Definuje položku výsledků hledání, která se má zobrazit. Další informace o tom, jak používat ID, naleznete v tématu Použití řazení k zobrazení výsledků.

Název Hodnota Typ
answerType Odpověď obsahující položku, která se má zobrazit. Například Zprávy.

Pomocí typu vyhledejte odpověď v objektu SearchResponse . Typ je název SearchResponse pole.
Řetězec
resultIndex Index položky v odpovědi založený na nule.

Pokud položka toto pole neobsahuje, zobrazte všechny položky v odpovědi. Můžete například zobrazit všechny příspěvky v odpovědi na příspěvky.
Integer
Hodnotu ID, které identifikuje odpověď k zobrazení, nebo položku odpovědi, která se má zobrazit. Pokud ID identifikuje odpověď, zobrazte všechny položky odpovědi. Identifikovatelné

RankingResponse

Definuje, kde má být obsah stránky výsledků hledání umístěn a v jakém pořadí.

Name Hodnota Typ
mainline Výsledky hledání, které se mají zobrazit v hlavním panelu. RankingGroup
Pól Výsledky hledání, které by si měly dovolit nejviditelnější léčbu (například zobrazená nad hlavní linkou a bočním panelem). RankingGroup
Sidebar Výsledky hledání, které se mají zobrazit na bočním panelu. RankingGroup

RelatedSearchAnswer

Definuje seznam souvisejících dotazů vytvořených jinými uživateli.

Name Hodnota Typ
id ID, které jednoznačně identifikuje související odpověď hledání.

Objekt obsahuje toto pole pouze v případě, že odpověď řazení určuje, že zobrazíte všechna související hledání ve skupině. Další informace o použití ID naleznete v tématu Použití řazení k zobrazení výsledků.
Řetězec
Hodnotu Seznam souvisejících dotazů, které vytvořili jiní uživatelé. Dotaz[]

SearchResponse

Objekt nejvyšší úrovně odpovědi pro žádosti o vyhledávání.

Ve výchozím nastavení obsahuje rozhraní API pro vyhledávání všechny odpovědi, pokud:

  • Dotaz určuje parametr dotazu responseFilter , který omezí odpovědi.

  • Jedna nebo více součástí hledání nevrací výsledky (například žádné výsledky zpráv nejsou pro dotaz relevantní).

  • Klíč předplatného nemá přístup ke komponentě vyhledávání.

Pokud má služba podezření na útok dosílání služby, požadavek bude úspěšný (stavový kód HTTP je 200 OK), ale text odpovědi je prázdný.

Název Hodnota Typ
_type Tip typu Řetězec
Výpočtu Odpověď na matematický výraz nebo konverzní výraz jednotek. Výpočtu
Entity Seznam entit, které jsou relevantní pro vyhledávací dotaz. EntityAnswer
Obrázky Seznam obrázků, které jsou relevantní pro vyhledávací dotaz. Image
Novinky Seznam článků s příspěvky, které jsou relevantní pro vyhledávací dotaz. Novinky
queryContext Řetězec dotazu, který Bing použit pro požadavek.

Odpověď obsahuje kontext pouze v případě, že řetězec dotazu obsahuje pravopisnou chybu nebo má záměr dospělého.
QueryContext
rankingResponse Pořadí, ve kterém Bing navrhuje zobrazit výsledky hledání. RankingResponse
související hledání Seznam souvisejících dotazů provedených jinými uživateli RelatedSearchAnswer
spellSuggestions Řetězec dotazu, který pravděpodobně představuje záměr uživatele. Pravopisné návrhy
Timezone Datum a čas jedné nebo více geografických umístění. Timezone
Videa Seznam videí, která jsou relevantní pro vyhledávací dotaz. Videa
Webové stránky Seznam webových stránek, které jsou relevantní pro vyhledávací dotaz. WebAnswer

Pravopisné návrhy

Definuje navrhovaný řetězec dotazu, který pravděpodobně představuje záměr uživatele.

Výsledky hledání zahrnují tuto odpověď, pokud Bing zjistí, že uživatel mohl hledat něco jiného. Pokud například uživatel hledá alon brown, Bing může určit, že uživatel pravděpodobně chtěl hledat Alton Brown místo toho (na základě předchozích hledání jinými uživateli Alon Brown).

Název Hodnota Typ
id ID, které jednoznačně identifikuje odpověď na návrh pravopisu.

Toto pole použijete při použití odpovědi na řazení k zobrazení návrhů pravopisu. Další informace o tom, jak používat ID, najdete v tématu Použití řazení k zobrazení výsledků.
Řetězec
Hodnotu Seznam navrhovaných řetězců dotazů, které mohou představovat záměr uživatele.

Seznam obsahuje pouze jeden Query objekt.
Dotaz[]

TextAttribution

Definuje smluvní pravidlo pro přiřazení prostého textu.

Name Hodnota Typ
_type Tip typu, který je nastavený na TextAttribution. Řetězec
text Text přiřazení

Přiřazení textu se vztahuje na entitu jako celek a mělo by se zobrazit hned za prezentací entity. Pokud existuje více pravidel přiřazení textu nebo odkazu, která nezadávají cíl, měli byste je zřetězením a zobrazit je pomocí popisku Data z:
Řetězec

TimeZone

Definuje data a čas jedné nebo více geografických umístění.

Name Hodnota Typ
otherCityTimes Seznam kalendářních dat a časů blízkých časových pásem TimeZoneInformation[]
primaryCityTime Data a čas v UTC zeměpisného umístění zadaného v dotazu.

Pokud dotaz zadal konkrétní geografické umístění (například město), tento objekt obsahuje název zeměpisného umístění a aktuální datum a čas umístění v UTC.

Pokud dotaz zadal obecné geografické umístění, například stát nebo zemi, tento objekt obsahuje datum a čas primárního města nebo státu nalezeného v zadaném státě nebo zemi. Pokud umístění obsahuje další časové zóny, otherCityTimes pole obsahuje data a čas měst nebo států umístěných v ostatních časových pásmech.
TimeZoneInformation

TimeZoneInformation

Definuje datum a čas pro zeměpisné umístění.

Název Hodnota Typ
Umístění Název zeměpisného umístění.

Například okres; Město; Město, stát; Město, stát, země; nebo časové pásmo.
Řetězec
Čas Data a čas zadaný ve formuláři YYYY-MM-DDThh;mm:ss.sssssZ. Řetězec
utcOffset Posun od UTC. Například UTC-7. Řetězec

WebAnswer

Definuje seznam relevantních odkazů na webové stránky.

Název Hodnota Typ
id ID, které jedinečně identifikuje webovou odpověď.

Objekt obsahuje toto pole pouze v případě, že odpověď řazení naznačuje, že zobrazíte všechny webové výsledky ve skupině. Další informace o tom, jak používat ID, najdete v tématu Použití řazení k zobrazení výsledků.
Řetězec
someResultsRemoved Logická hodnota, která označuje, jestli odpověď vyloučila některé výsledky z odpovědi. Pokud Bing některé výsledky vyloučit, hodnota je pravdivá. Logická hodnota
totalEstimatedMatches Odhadovaný počet webových stránek, které jsou relevantní pro dotaz. Toto číslo použijte spolu s parametry dotazu počtu a posunu pro stránku výsledků. Dlouhé
Hodnotu Seznam webových stránek, které jsou relevantní pro dotaz. WebPage[]
webSearchUrl Adresa URL Bing výsledků hledání požadovaných webových stránek. Řetězec

Webové stránky

Definuje webovou stránku, která je relevantní pro dotaz.

Název Hodnota Typ
o systému Pouze pro interní použití. Objekt
dateLastCrawled Čas posledního procházení webové stránky Bing Datum je ve formátu YYYY-MM-DDTHH:MM:SS. Například 2015-04-13T05:23:39. Řetězec
deepLinks Seznam odkazů na související obsah, který Bing nalezen na webu, který obsahuje tuto webovou stránku.

Objekt Webpage v tomto kontextu zahrnuje pouze namepole , , urlurlPingSuffixa snippet pole.
Webová stránka[]
displayUrl Adresa URL zobrazení webové stránky. Adresa URL je určena pouze pro účely zobrazení a není správně vytvořena. Řetězec
id ID, které jednoznačně identifikuje tuto webovou stránku v seznamu výsledků webu.

Objekt obsahuje toto pole pouze v případě, že odpověď řazení určuje, že webové stránky kombinujete s ostatními výsledky hledání. Každá webová stránka obsahuje ID, které odpovídá ID odpovědi Hodnocení. Další informace naleznete v tématu Použití řazení k zobrazení výsledků.
Řetězec
Jméno Název webové stránky.

Tento název použijte spolu s url ním k vytvoření hypertextového odkazu, který po kliknutí přenese uživatele na webovou stránku.
Řetězec
Zmiňuje Pouze pro interní použití. Objekt
searchTags Seznam značek hledání, které vlastník webové stránky zadal na webové stránce. Rozhraní API vrátí pouze indexované vyhledávací značky.

Pole name objektu MetaTag obsahuje indexovanou vyhledávací značku. Vyhledávací značky začínají hledáním.* (například search.assetId). Pole content obsahuje hodnotu značky.
MetaTag[]
Úryvek Fragment textu z webové stránky, který popisuje jeho obsah. Řetězec
Adresu url Adresa URL webové stránky.

Pomocí této adresy URL name můžete vytvořit hypertextový odkaz, který po kliknutí přenese uživatele na webovou stránku.
Řetězec

Typy entit

Tato část obsahuje možné nápovědy k entitám. Nápovědy jsou seskupené podle kategorie entit.

Následují základní typy entit.

  • Obecné
  • Person (Osoba)
  • Místo
  • Média
  • Organizace

Níže jsou uvedené tipy entity, které spadají pod základní typ Place.

  • Attraction
  • City (Město)
  • Kontinent
  • Země
  • Hotel
  • Dům
  • LocalBusiness
  • Lokalita
  • Vedlejší oblast
  • Okolí
  • Jiné
  • PointOfInterest
  • PostalCode
  • RadioStation
  • Oblast
  • Restaurace
  • Stav
  • Streetaddress
  • Podoblasti
  • TouristAttraction
  • Cestování

Níže jsou uvedené rady entity, které spadají pod základní typ média.

  • Book
  • Film
  • TelevizeSeason
  • Televizní pořady
  • Videoherní

Níže jsou uvedené nápovědy k entitám souvisejícím s událostmi.

  • Událost

Níže jsou uvedené nápovědy k entitám souvisejícím s povoláním.

  • Aktér
  • Umělec
  • Advokát

Níže jsou uvedené nápovědy k entitám souvisejícím se vzděláváním.

  • CollegeOrUniversity
  • Školy
  • Specialita

Následující informace nesouvisejí s entitami.

  • Zvířat
  • Auto
  • Drogové
  • Potravin
  • Produkt
  • SportsTeam

Kódy chyb

Následuje možné stavové kódy HTTP, které požadavek vrátí.

Stavový kód Description
200 Úspěch.
400 Jeden z parametrů dotazu chybí nebo je neplatný.
401 Klíč předplatného chybí nebo není platný.
403 Uživatel se ověřuje (například používá platný klíč předplatného), ale nemá oprávnění k požadovanému prostředku.

Bing může tento stav vrátit také v případě, že volající překročil kvótu dotazů za měsíc.
410 Požadavek používal protokol HTTP místo protokolu HTTPS. HTTPS je jediný podporovaný protokol.
429 Volající překročil svou kvótu dotazů za sekundu.
500 Neočekávaná chyba serveru.

Pokud požadavek selže, odpověď obsahuje objekt ErrorResponse, který obsahuje seznam objektů Error, které popisují příčinu chyby. Pokud chyba souvisí s parametrem, parameter pole identifikuje parametr, který se týká problému. A pokud chyba souvisí s hodnotou parametru, pole identifikuje hodnotu, value která není platná.

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidRequest", 
      "subCode": "ParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidAuthorization", 
      "subCode": "AuthorizationMissing", 
      "message": "Authorization is required.", 
      "moreDetails": "Subscription key is not recognized."
    }
  ]
}

Následuje možný kód chyby a hodnoty kódu dílčí chyby.

Kód Podkódování Description
ServerError Neočekávaná chyba
Chyba prostředku
NotImplementováno
Stavový kód HTTP je 500.
InvalidRequest ParametrMissing
ParameterInvalidValue
HttpNotAllowed
Blokované
Bing vrátí Funkci InvalidRequest vždy, když jakákoli část požadavku není platná. Například požadovaný parametr chybí nebo hodnota parametru není platná.

Pokud je chyba ParameterMissing nebo ParameterInvalidValue, stavový kód HTTP je 400.

Pokud používáte protokol HTTP místo protokolu HTTPS, Bing vrátí HttpNotAllowed a stavový kód HTTP je 410.
RateLimitExceeded Žádné dílčí kódy Bing vrátí hodnotu RateLimitExceeded pokaždé, když překročíte kvótu dotazů za sekundu (QPS) nebo dotazů za měsíc (QPM).

Pokud překročíte hodnotu QPS, Bing vrátí stavový kód HTTP 429 a pokud překročíte hodnotu QPM, Bing vrátí hodnotu 403.
Neplatná ověřování AutorizaceMissing
AuthorizationRedundancy
Bing vrátí invalidAuthorization, když Bing nemůže ověřit volajícího. Například Ocp-Apim-Subscription-Key záhlaví chybí nebo klíč předplatného není platný.

K redundanci dochází, pokud zadáte více než jednu metodu ověřování.

Pokud je chyba InvalidAuthorization, stavový kód HTTP je 401.
Nedostatečná autorizace AuthorizationDisabled
AuthorizationExpired
Bing vrátí nedostatekAuthorization, pokud volající nemá oprávnění pro přístup k prostředku. K tomu může dojít v případě, že je klíč předplatného zakázaný nebo vypršela jeho platnost.

Pokud je chyba NedostatečnáAuthorizace, stavový kód HTTP je 403.

Kódy trhu

Následující tabulka uvádí hodnoty kódu trhu, které můžete použít k zadání parametru mkt dotazu. Bing vrátí obsah pouze pro tyto trhy. Seznam se může změnit.

Seznam kódů zemí, které můžete zadat v parametru cc dotazu, najdete v tématu Kódy zemí.

Země/oblast Jazyk Kód trhu
Argentina Španělština es-AR
Austrálie Angličtina en-AU
Rakousko Němčina de-AT
Belgie Nizozemština nl-BE
Belgie Francouzština fr-BE
Brazílie Portugalština pt-BR
Kanada Angličtina en-CA
Kanada Francouzština fr-CA
Chile Španělština es-CL
Dánsko Dánština da-DK
Finsko Finština fi-FI
Francie Francouzština fr-FR
Německo Němčina de-DE
Hongkong – zvláštní administrativní oblast Tradiční čínština zh-HK
Indie Angličtina en-IN
Indonésie Angličtina en-ID
Itálie Italština it-IT
Japonsko Japonština ja-JP
Jižní Korea Korejština ko-KR
Malajsie Angličtina en-MY
Mexiko Španělština es-MX
Nizozemsko Nizozemština nl-NL
Nový Zéland Angličtina en-NZ
Norsko Norština no-NE
Čínská lidová republika Čínština zh-CN
Polsko Polština pl-PL
Filipínská republika Angličtina en-PH
Rusko Ruština ru-RU
Jižní Afrika Angličtina en-ZA
Španělsko Španělština es-ES
Švédsko Švédština sv-SE
Švýcarsko Francouzština fr-CH
Švýcarsko Němčina de-CH
Tchaj-wan Tradiční čínština zh-TW
Turecko Turečtina tr-TR
Spojené království Angličtina en-GB
USA Angličtina en-US
USA Španělština es-US

Kódy zemí

Následuje kód země, který můžete zadat v parametru cc dotazu. Seznam se může změnit.

Země/oblast Kód země
Argentina AR
Austrálie AU
Rakousko AT
Belgie BE
Brazílie BR
Kanada CA
Chile CL
Dánsko DK
Finsko FI
Francie FR
Německo DE
Hongkong – zvláštní administrativní oblast HK
Indie IN
Indonésie ID
Itálie IT
Japonsko JP
Jižní Korea KR
Malajsie MY
Mexiko MX
Nizozemsko NL
Nový Zéland NZ
Norsko NO
Čínská lidová republika CN
Polsko PL
Portugalsko PT
Filipínská republika PH
Rusko RU
Saúdská Arábie SA
Jižní Afrika ZA
Španělsko ES
Švédsko SE
Švýcarsko CH
Tchaj-wan TW
Turecko TR
Spojené království GB
USA USA

podporované jazyky Bing

Následuje Bing podporovaných jazyků, které můžete zadat v parametru setLang dotazu. Seznam se může změnit.

Podporované jazyky Kód jazyka
Arabština ar
Baskičtina Eu
Bengálština Bn
Bulharština Bg
Katalánština Ca
Čínština (zjednodušená) zh-hans
Čínština (tradiční) zh-hant
Chorvatština hod
Čeština Cs
Dánština Da
Holandština Nl
angličtina en
English-United Království en-gb
Estonština Et
Finština Fi
Francouzština Fr
Galicijština Gl
Němčina De
Gudžarátština Gu
Hebrejština on
Hindština dobrý den
Maďarština Hu
Islandština is
Italština it
Japonština Jp
Kannadština kn
Korejština Ko
Lotyština Lv
Litevština lt
Malajština Paní
Malajalámština ml
Maráthština Pan
Norština (Bokmål) Nb
Polština Pl
Portugalština (Brazílie) pt-br
Portugalština (Portugalsko) pt-pt
Paňdžábština Pa
Rumunština Ro
Ruština Ru
Srbština (Cyrylic) Sr
Slovenština Sk
Slovinština Sl
španělština es
Švédština sv
Tamilština ta
Telugština Te
Thajština Th
Turečtina Tr
Ukrajinština Uk
Vietnamština Vi