Reference k V7 rozhraní API pro Vyhledávání na webu

Upozornění

Rozhraní API pro vyhledávání Bingu přesouváte z Cognitive Services na Vyhledávání Bingu služby. Od 30. října 2020 musí být všechny nové instance vyhledávání Bingu zřízené podle popsaného procesu. Rozhraní API pro vyhledávání Bingu zřízené pomocí Cognitive Services budou podporované v následujících třech letech nebo na konci smlouva Enterprise, podle toho, co nastane dřív. Pokyny k migraci najdete v tématu vyhledávání Bingu Services.

Rozhraní Vyhledávání na webu API umožňuje odeslat vyhledávací dotaz do Bingu a vrátit výsledky hledání, které obsahují odkazy na webové stránky, obrázky a další. V této části najdete technické podrobnosti o webových stránkách, souvisejících hledáních a o výsledcích hodnocení, které mají vliv na výsledky hledání. Příklady, které ukazují, jak vytvářet požadavky, najdete v tématu hledání na webu.

Informace o hlavičkách, které by měly požadavky zahrnovat, najdete v tématu hlavičky požadavků.

Informace o parametrech dotazu, které by měly požadavky zahrnovat, najdete v tématu parametry dotazu.

Informace o objektech JSON, které může odpověď zahrnovat, najdete v části tělo 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í zahrnovat, naleznete v referenční dokumentaci specifické pro rozhraní API. Pokud například výsledek hledání obsahuje odpovědi na obrázky a zprávy, přečtěte si téma rozhraní API pro vyhledávání obrázků a vyhledávání zpráv.

Informace o povoleném použití a zobrazení výsledků najdete v tématu vyhledávání Bingu používání rozhraní API a požadavky na zobrazení.

Poznámka

Vzhledem k tomu, že se formáty a parametry adresy URL mohou změnit bez předchozího upozornění, použijte všechny adresy URL tak, jak jsou. Nemusíte přebírat závislosti na formátu nebo parametrech adresy URL s výjimkou případů uvedených v popsaných.

Koncové body

Chcete-li vyžádat 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 pro více služeb musíte zahrnout oblast do adresy URL. 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ů. Aby se zajistilo, že délka vaší adresy URL nepřekračuje limit, maximální délka parametrů dotazu by měla být kratší než 1 500 znaků. Pokud adresa URL překračuje 2 048 znaků, server nenajde hodnotu 404.

Hlavičky

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

Záhlaví Description
Přijmout Nepovinná hlavička požadavku.

Výchozí typ média je Application/JSON. Chcete-li 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 trhů, 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é nejde sjednotit.
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 – za Hlavička odpovědi.

Odpověď zahrnuje tuto hlavičku, pokud překročíte počet dotazů povolených za sekundu (QPS) nebo měsíčně (QPM). Hlavička obsahuje počet sekund, po které je nutné počkat před odesláním další žádosti.
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 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; 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) Version/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 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like Gecko

  • iPad—Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/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 taky může použít ID klienta k přizpůsobení výsledků hledání na webu s historií hledání ID klienta, které uživateli nabízí bohatší možnosti.

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. Zadejte dvojici klíč/hodnota jako <key> : <value> . 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 — Nepovinné. Č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.)

  • head — 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 — Nepovinné. Nadmořská výška klientského zařízení v metrech.

  • are — Nepovinné. Poloměr v metrech, který určuje svislou přesnost souřadnic. Tento klíč zadejte jenom tehdy, když zadáte klíč alt.

  • vyřazení — volitelné. Zeměpisné umístění uživatele ve formuláři, DISP: <City, State>. Například DISP: Seattle, Washington. Toto je verze zobrazovaného textu umístění uživatele, které jste zadali pomocí klíčů pro zobrazení lat/Long. Pokud je tato hodnota v konfliktu s souřadnicemi v tabulce LAT/Long, Bing použije jako umístění uživatele hodnotu disp.

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 v Seattlu, Washington.

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 dosažení optimálních výsledků byste měli zahrnout tuto hlavičku a hlavičku X-Search-IP adresa klienta, ale aspoň tuto hlavičku zahrnout.

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ěď zahrnovat. Odpovědi, které Bing vrací, jsou založené na hodnocení. Pokud například Bing vrátí pro požadavek webové stránky, obrázky, videa a relatedSearches, a nastavíte tento parametr na dvě (2), bude odpověď zahrnovat webové stránky a image.

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

Informace o povýšení zodpovězených odpovědí na odpověď 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 trhů.

Pokud tento parametr nastavíte, musíte zadat také hlavičku Accept-Language. Bing používá první podporovaný jazyk, který najde ve specifikovaných jazycích, a kombinuje ho s kódem země, aby bylo možné zjistit, na jaký trh mají vracet výsledky. 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 použijte Accept-Language pouze v případě, že zadáte více jazyků. V opačném případě byste měli mkt použít setLang parametry dotazu a.

Tento parametr a parametr dotazu mkt se vzájemně vylučují — nezadávejte oba.
Řetězec No
výpočtu 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ý počet dodaných hodnot může být menší, než je požadováno.

Použijte tento parametr spolu s offset parametrem na stránku výsledků. Další informace najdete v tématu stránkování webových stránek.

Pokud například vaše uživatelské rozhraní zobrazuje 10 výsledků hledání na stránce, nastavte count na hodnotu 10 a offset na 0, abyste získali první stránku výsledků. Pro každou následnou stránku zvyšte na offset 10 (například 0, 10, 20). Je možné, že více stránek zahrne některé překryvy do výsledků.
UnsignedShort No
aktuálnosti Filtrovat výsledky hledání podle následujících věkových hodnot nerozlišujících velká a malá písmena:
  • —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ů.

  • —Vrátí webové stránky, které se zjistily během posledních 30 dnů.

Pokud chcete získat články zjištěné bingem v určitém časovém období, zadejte rozsah kalendářních dat ve formátu YYYY-MM-DD. RRRR-MM-DD. Například, &freshness=2019-02-01..2019-05-30. Chcete-li výsledky omezit 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 mkt je to země, ze které uživatel požadavek provádí. Může se ale jednat o jinou zemi, pokud se uživatel nenachází v zemi, kde Bing poskytuje výsledky. Trh musí být ve tvaru <language code> - <country code> . Například cs-CZ. V řetězci se nerozlišují malá a velká písmena. Seznam možných hodnot trhu najdete v tématu kódy trhů.

Poznámka: Pokud je to známo, doporučujeme, abyste vždy zadali 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 trhů, Bing použije nejvhodnější kód na 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 oba.
Řetězec No
polohy 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 ).

Použijte tento parametr spolu s count parametrem na stránku výsledků. Pokud například vaše uživatelské rozhraní zobrazuje 10 výsledků hledání na stránce, nastavte count na hodnotu 10 a offset na 0, abyste získali první stránku výsledků. Pro každou následnou stránku zvyšte na offset 10 (například 0, 10, 20). je možné, že více stránek zahrne některé překryvy do výsledků.
Krátký unsigned No
výší Seznam odpovědí, které má odpověď zahrnovat bez ohledu na jejich hodnocení, je oddělený čárkami. Například pokud nastavíte answerCount) na dvě (2), Bing vrátí horní dvě seřazené odpovědi, ale také chcete, aby odpověď zahrnovala zprávy, měli byste nastavit promote příspěvky. Pokud jsou horní seřazené odpovědi webové stránky, obrázky, videa a relatedSearches, obsahuje odpověď webové stránky a obrázky, protože zprávy nejsou zařazené odpovědi. Pokud ale nastavíte promote video, Bing by povýší odpověď videa na odpověď a vracel webové stránky, obrázky a videa.

Odpovědi, které chcete zvýšit, se nepočítají na základě answerCount limitu. Například pokud jsou seřazené odpovědi zprávy, obrázky a videa a nastavíte hodnotu answerCount 1 a promote na zprávy, odpověď obsahuje zprávy a obrázky. Nebo, pokud jsou seřazené odpovědi videa, obrázky a novinky, odpověď obsahuje videa a novinky.

Níže jsou uvedené možné hodnoty.
  • Běhu
  • Image
  • Novinky
  • RelatedSearches
  • SpellSuggestions
  • TimeZone
  • Videa
  • Webových stránkách

Poznámka: Použijte pouze v případě, že zadáte answerCount.
Řetězec No
č Termín vyhledávacího dotazu uživatele Podmínka nesmí být prázdná.

Termín může obsahovat pokročilé operátory Bingu. Chcete-li například omezit výsledky na konkrétní doménu, použijte operátor Web: .
Řetězec Yes
responseFilter Seznam odpovědí, které mají být zahrnuty do odpovědi, oddělený čárkami. Pokud tento parametr nezadáte, odpověď zahrnuje všechny odpovědi na hledání, pro které existují relevantní data.

Zde jsou možné hodnoty filtru.
  • Běhu
  • Entity
  • Image
  • Novinky
  • RelatedSearches
  • SpellSuggestions
  • TimeZone
  • Videa
  • Webových stránkách

Pokud chcete z odpovědi vyloučit konkrétní typy obsahu, jako jsou například obrázky, můžete je vyloučit s předponou spojovníku (minus) na hodnotu responseFilter. Vyloučené typy oddělte čárkou: &responseFilter =-images,-video

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ěď, aby bylo možné získat rozsáhlejší výsledky. Například pro příjem pouze imagí odešlete požadavek do jednoho z koncových bodů rozhraní vyhledávání obrázků API .

Odpovědi RelatedSearches a SpellSuggestions nepodporují samostatný koncový bod, jako je Vyhledávání obrázků rozhraní API (pouze rozhraní API Vyhledávání na webu je vrací).

Pokud chcete zahrnout odpovědi, které by jinak byly vyloučené z důvodu hodnocení, přečtěte si část povýšení parametru dotazu.
Řetězec No
safeSearch filtruje webové stránky pro obsah určený pro dospělé. Zde jsou možné hodnoty filtru.
  • Vypínejte — webové stránky s textem a obrázky pro dospělé.
  • Mírné — vrácení webových stránek s textem pro dospělé, ale ne pro dospělé obrázky nebo videa.
  • Strict — nevrací webové stránky s použitím textu, obrázků a videí pro dospělé.
Výchozí hodnota je Moderate.

Poznámka: Pokud je u výsledků videa safeSearch nastavené na vypnuto, Bing ho ignoruje a použije střední.

Poznámka: Pokud žádost pochází z trhu, ve kterém zásada pro dospělé Bingu vyžaduje, aby safeSearch byla nastavená na Strict, Bing ignoruje tuto safeSearch hodnotu a použije 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, nebo 4 písmenového kódu. Upřednostňuje se použití kódů se čtyřmi písmeny.

Seznam podporovaných kódů jazyků najdete v tématu podporované jazyky Bingu.

Bing načte lokalizované řetězce, pokud setlang obsahuje platný 2-písmeno neutrální kód kultury ( fr ) nebo platný kód jazykové verze o 4-písmenech ( fr-CA ). Například pro fr-CA načte Bing řetězce kódu neutrální jazykové verze fr .

Pokud setlang není platný (například zh ) nebo Bing nepodporuje jazyk (například AF , AF-na ), Bing použije výchozí hodnotu EN (angličtina).

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

Chcete-li zadat kód 4, použijte <země nebo oblast>, kde je kód jazyka ISO 639-1 (neutrální jazyková verze) a <země/oblast> je kód země/oblasti ISO 3166 (konkrétní jazyková verze). Použijte například en-US pro USA angličtinu.

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 Accept-Language záhlaví 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 určující, zda mají zobrazované řetězce obsahovat značky dekorace, jako jsou například znaky zvýrazňování přístupů. Pokud má hodnotu true , řetězce můžou obsahovat značky. Výchozí hodnota je false .

Chcete-li určit, zda používat jako značky znaky Unicode nebo značky HTML, přečtěte si parametr dotazu TextFormat .

Informace o zvýrazňování přístupů najdete v tématu zvýrazňování přístupů.
Logická hodnota No
textFormat Typ značek, který má být použit pro dekorace textu (viz textDecorations parametr dotazu).

Níže jsou uvedené možné hodnoty.
  • Nezpracované — použití znaků Unicode k označení obsahu, 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 podmínek dotazu pro zvýrazňování přístupů.

  • HTML — pomocí značek HTML označuje obsah, který potřebuje speciální formátování. Například pomocí <b> značek zvýrazněte výrazy dotazu v zobrazených řetězcích.

Výchozí hodnota je RAW.

Seznam značek najdete v tématu zvýrazňování přístupů.

Pro zobrazované řetězce, které obsahují uvozovací znaky HTML, například <, > a &, pokud textFormat je nastavena na HTML, Bing řídí znaky podle potřeby (například < je uvozena na & lt;).

Informace o zpracování řetězců pomocí vložených znaků Unicode naleznete v tématu zvýrazňování přístupů.
Řetězec No

Objekty Response

Poznámka

Aby bylo možné dodržovat novou směrnici o autorských právech pro EU ve Francii, musí web Bingu, novinky, video, image a všechna vlastní rozhraní pro vyhledávání vynechat nějaký obsah z některých zdrojů zpráv EU pro francouzské uživatele. Odebraný obsah může obsahovat miniatury obrázků a videí, 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 Bingu poskytovat méně výsledků s miniaturami obrázků a videí, náhledy videa a fragmenty kódu pro francouzské uživatele.

Níže jsou uvedené objekty odpovědi JSON, které může odpověď zahrnovat. Pokud je požadavek úspěšný, objekt nejvyšší úrovně v odpovědi je objekt SearchResponse . Pokud se požadavek nezdařil, objekt nejvyšší úrovně je objekt ErrorResponse .

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í zahrnovat, naleznete v referenční dokumentaci specifické pro rozhraní API. Pokud například výsledek hledání obsahuje odpovědi na obrázky a zprávy, přečtěte si téma rozhraní API pro Image a rozhraní News API.

Objekt Description
Běhu 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 v případě, že se požadavek nezdařil.
Identifikovatelné údaje Definuje ID prostředku.
LicenseAttribution Definuje smluvní pravidlo pro přidělení licence.
LinkAttribution Definuje smluvní pravidlo pro přidělení odkazu.
MediaAttribution Definuje smluvní pravidlo pro přidělení médií.
Dotaz Definuje řetězec dotazu.
QueryContext Definuje kontext dotazu, který Bing použil pro požadavek, pokud zadaný řetězec dotazu obsahuje pravopisnou chybu.
Klasifikace Definuje skupinu výsledků hledání, jako je například hlavní.
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ů provedených ostatními.
SearchResponse Objekt nejvyšší úrovně, který odpověď zahrnuje v případě úspěchu žádosti.
SpellSuggestions Definuje navrhovaný řetězec dotazu, který nejspíš představuje záměr uživatele.
TextAttribution Definuje smluvní pravidlo pro přidělení prostého textu.
Údaj Definuje datum a čas jednoho nebo více zeměpisných míst.
TimeZoneInformation Definuje informace o časovém pásmu zeměpisného umístění.
Webanswer Definuje seznam relevantních odkazů na webové stránce.
Stránku Definuje webovou stránku, která je pro dotaz relevantní.

Entita

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

Name Hodnota Typ
bingId ID, které jedinečně identifikuje tuto entitu. Řetězec
contractualRules Seznam pravidel, která je nutné dodržovat, pokud chcete entitu zobrazit. Pravidla se například mohou řídit zadáním popisu entity.

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


Ne všechny entity obsahují pravidla. Pokud entita poskytuje smluvní pravidla, musíte je dodržovat. Další informace o použití smluvních pravidel najdete v tématu popisujícím data.
Objekt []
description Krátký popis entity Řetězec
entityPresentationInfo Další informace o entitě, jako jsou například tipy, které můžete použít k určení typu entity. Chcete-li určit typ entity, použijte entityScenario pole a entityTypeHint . Například pole vám pomůžou určit, zda je entita dominantní nebo nejednoznačná entita a zda se jedná o osobu nebo film. Entita je dominantní entita, pokud se Bingu domnívá, že žádost splňuje jenom jedna entita. Pokud může požadavek splnit více entit, je entita entitou nejednoznačnosti a uživatel musí vybrat entitu, které vás zajímá. EntityPresentationInfo
image Obrázek entity Image
name Název entity Řetězec
webSearchUrl Adresa URL, která uživateli převezme stránku výsledků hledání Bingu pro tuto entitu. Řetězec

EntityAnswer

Definuje odpověď entity.

Name Hodnota Typ
queryScenario Scénář podporovaného dotazu. Toto pole je nastavené na DominantEntity nebo DisambiguationItem. Pole je nastavené na DominantEntity, pokud Bing určí, že požadavek bude splňovat jenom jedna entita. Například kniha, film, osoba nebo přitažlivosti. Pokud může požadavek splnit více entit, pole je nastaveno na DisambiguationItem. Pokud například požadavek používá obecný název nepoužitého filmu, typ entity by pravděpodobně byl DisambiguationItem. Pokud ale požadavek určuje konkrétní nadpis z pracovníku, bude pravděpodobně DominantEntity typ entity. Řetězec
hodnota Seznam entit Entita []

EntityPresentationInfo

Definuje další informace o entitě, jako jsou například parametry typu.

Name Hodnota Typ
entityScenario Podporovaný scénář. Řetězec
entityTypeDisplayHint Zobrazovaná verze nápovědy k entitě Například pokud entityTypeHints je interpret, může být toto pole nastaveno na American Singer . Řetězec
entityTypeHint Seznam pomocných parametrů, které označují typ entity Seznam může obsahovat jeden pomocný parametr, jako je například video nebo seznam pomocných parametrů, jako je například umístění, LocalBusiness, restaurace. Každý další použitý pomocný parametr zužuje možnosti typu entity.

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

Běhu

Definuje výraz a jeho odpověď.

Element Popis Typ
vyjádření Matematický nebo převodní výraz.

Pokud dotaz obsahuje požadavek na převod měrných jednotek (například měřiče na nohy), obsahuje toto pole jednotky z a value obsahuje jednotky .

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

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

Pokud je dotaz uživatele matematickou otázkou a parametr dotazu textDecorations je nastaven na hodnotu true , řetězec výrazu může obsahovat formátovací značky. Například pokud je dotaz uživatele log (2) , normalizovaný výraz obsahuje značky dolního indexu. Další informace najdete v tématu zvýrazňování přístupů.
Řetězec
osa Odpověď výrazu. Řetězec

Chybová

Definuje chybu, ke které došlo.

Element Popis Typ
znakovou Kód chyby, který identifikuje kategorii chyby. Seznam možných kódů naleznete v tématu kódy chyb. Řetězec
Zpráva Popis chyby. Řetězec
moreDetails Popis, který poskytuje další informace o chybě. Řetězec
ukazatele Parametr dotazu v žádosti, která způsobila chybu. Řetězec
Podřízeného kódu Kód chyby, který identifikuje chybu. Například pokud code je InvalidRequest, subCode může být ParameterInvalid nebo ParameterInvalidValue. Řetězec
osa Hodnota parametru dotazu, která není platná. Řetězec

ErrorResponse

Objekt nejvyšší úrovně, který odpověď zahrnuje v případě, že se požadavek nezdařil.

Name Hodnota Typ
_type Zadejte pomocný parametr. Řetězec
vyskytl Seznam chyb popisujících důvody, proč se žádost nezdařila. Chyba[]

Identifikovatelné údaje

Definuje identitu prostředku.

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

Image

Definuje obrázek.

Poznámka

Vzhledem k tomu, že se formát a parametry adresy URL mohou změnit bez předchozího upozornění, měly by se všechny adresy URL obrázků používat tak, jak jsou. nemusíte mít závislosti na formátu nebo parametrech adresy URL. Výjimkou jsou tyto parametry a hodnoty, které jsou popsány při změně velikosti a oříznutí obrázků miniatur.

Name Hodnota Typ
výška Výška zdrojového obrázku (v pixelech) Krátký unsigned
hostPageUrl Adresa URL webové stránky, která obsahuje obrázek.

Tato adresa URL contentUrl může být stejná jako adresa URL.
Ř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.

Je nutné, aby se tento obrázek naatributoval na poskytovatele. Název poskytovatele můžete například zobrazit tak, jak se ukazatel myši nachází na obrázku, nebo vytvořit obrázek pomocí odkazu na web poskytovatele, kde se image najde.
Organizace[]
thumbnailUrl Adresa URL miniatury obrázku Informace o změně velikosti obrázku najdete v tématu Změna velikosti a oříznutí obrázků miniatur. Řetězec
šířka Šířka zdrojového obrázku (v pixelech). Krátký unsigned

LicenseAttribution

Definuje smluvní pravidlo pro přidělení licence.

Name Hodnota Typ
_type Pomocný parametr typu, který je nastaven na LicenseAttribution. Řetězec
license Licence, za kterou je možné obsah použít. Licence
licenseNotice Licence, která se má zobrazit vedle cíleného pole Například "text v rámci licence CC-BY-SA".

Pomocí názvu a adresy URL licence v poli můžete license vytvořit hypertextový odkaz na web, který popisuje podrobnosti licence. Potom nahraďte název licence v licenseNotice řetězci (například CC-by-SA) hypertextovým odkazem, který jste právě vytvořili.
Řetězec
mustBeCloseToContent Logická hodnota určující, zda obsah pravidla musí být umístěn v blízkosti pole, na které se pravidlo vztahuje. V případě hodnoty true musí být obsah umístěn v blízkosti. Pokud je hodnota false nebo toto pole neexistuje, může být obsah umístěn na základě rozhodnutí volajícího. Logická hodnota
targetPropertyName Název pole, na které se pravidlo vztahuje. Řetězec

LinkAttribution

Definuje smluvní pravidlo pro přidělení odkazu.

Name Hodnota Typ
_type Pomocný parametr typu, který je nastaven na LinkAttribution. Řetězec
mustBeCloseToContent Logická hodnota určující, zda obsah pravidla musí být umístěn v blízkosti pole, na které se pravidlo vztahuje. V případě hodnoty true musí být obsah umístěn v blízkosti. Pokud je hodnota false nebo toto pole neexistuje, může být obsah umístěn na základě rozhodnutí volajícího. Logická hodnota
targetPropertyName Název pole, na které se pravidlo vztahuje.

Pokud není zadán cíl, vztahuje se k entitě jako celek a měl by se zobrazovat hned za prezentací entity. Pokud je k dispozici více pravidel textu a propojení, která neurčují cíl, je třeba je zřetězit a zobrazit pomocí popisku "data z:". Například "data od <Provider název1 > | <Provider název2 > ".
Řetězec
text Text přidělení. Řetězec
url Adresa URL webu poskytovatele. Pomocí text adresy URL můžete vytvořit hypertextový odkaz. Řetězec

MediaAttribution

Definuje smluvní pravidlo pro přidělení médií.

Name Hodnota Typ
_type Pomocný parametr typu, který je nastaven na MediaAttribution. Řetězec
mustBeCloseToContent Logická hodnota určující, zda obsah pravidla musí být umístěn v blízkosti pole, na které se pravidlo vztahuje. V případě hodnoty true musí být obsah umístěn v blízkosti. Pokud je hodnota false nebo toto pole neexistuje, může být obsah umístěn na základě rozhodnutí volajícího. Logická hodnota
targetPropertyName Název pole, na které se pravidlo vztahuje. Řetězec
url Adresa URL, kterou použijete k vytvoření hypertextového odkazu na multimediální obsah. Pokud je cílem například obrázek, měli byste použít adresu URL, aby bylo možné obrázek kliknout. Řetězec

MetaTag

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 poskytnout svůj název nebo web nebo obojí.

Name Hodnota Typ
name Název vydavatele Řetězec
url Adresa URL webu vydavatele

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

Dotaz

Definuje vyhledávací dotaz.

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

Name Hodnota Typ
zobrazenýtext Zobrazovaná verze termínu dotazu Tato verze termínu dotazu může obsahovat speciální znaky, které zvýrazní hledaný termín v řetězci dotazu. Řetězec obsahuje zvýrazněné znaky pouze v případě, že je u dotazu povoleno zvýrazňování přístupů (viz parametr dotazu textDecorations ). Podrobnosti o zvýrazňování přístupů najdete v tématu zvýrazňování přístupů. Řetězec
textové Řetězec dotazu. Použijte tento řetězec jako termín dotazu v nové žádosti o vyhledávání. Řetězec
webSearchUrl Adresa URL, která převezme uživatele na stránku výsledků hledání Bingu pro dotaz.

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

QueryContext

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

Element Popis Typ
adultIntent Logická hodnota, která označuje, zda má zadaný dotaz záměr k dospělému. Hodnota je true , pokud má dotaz záměr k dospělému.

Pokud je hodnota true a parametr dotazu bezpečné hledání požadavku je nastaven na hodnotu Strict, odpověď obsahuje pouze výsledky novinek (Pokud je k dispozici).
Logická hodnota
alterationOverrideQuery Řetězec dotazu, který se má použít k vynucení použití původního řetězce v Bingu. Například pokud je řetězec dotazu Saling downwind , řetězec přepisu řetězce dotazu je + Saling downwind . Nezapomeňte zakódovat řetězec dotazu, který má za následek % 2Bsaling + 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žil k provedení dotazu. Bing používá změněný řetězec dotazu, pokud původní řetězec dotazu obsahoval pravopisné chyby. Například pokud je řetězec dotazu saling downwind , 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, která určuje, zda Bing vyžaduje umístění uživatele, aby poskytovalo přesné výsledky. Pokud jste zadali umístění uživatele pomocí hlaviček x-MSEdge-IP adresa klienta a x-Search-Location , můžete toto pole ignorovat.

Pro dotazy na umístění, jako je "dnešní počasí" nebo "Restaurace v mém okolí", které potřebují umístění uživatele, aby poskytovaly přesné výsledky, je toto pole nastaveno na hodnotu true .

Pro dotazy na umístění, které zahrnují umístění (například "povětrnostní počasí"), je toto pole nastaveno na hodnotu NEPRAVDA . Toto pole je také nastaveno na hodnotu NEPRAVDA u dotazů, které neznají umístění, například "nejlepší prodejci".
Logická hodnota
originalQuery Řetězec dotazu, jak je uveden v požadavku. Řetězec

Klasifikace

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

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

RankingItem

Definuje položku výsledku hledání, která se má zobrazit. Další informace o používání identifikátorů najdete v tématu použití hodnocení k zobrazení výsledků.

Name 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 tato položka neobsahuje toto pole, zobrazí všechny položky v odpovědi. Můžete například zobrazit všechny články v odpovědi na zprávy.
Integer
osa ID, které identifikuje odpověď pro zobrazení nebo položku odpovědi, která se má zobrazit Pokud ID identifikuje odpověď, zobrazí všechny položky odpovědi. Identifikovatelné údaje

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
hlavní Výsledky hledání, které se mají zobrazit v hlavní Klasifikace
prut Výsledky hledání, které by měly být uváděny jako nejužitečnější způsob zpracování (například zobrazené nad hlavní a postranní panel). Klasifikace
stín Výsledky hledání, které se mají zobrazit na bočním panelu Klasifikace

RelatedSearchAnswer

Definuje seznam souvisejících dotazů provedených ostatními.

Name Hodnota Typ
id ID, které jedinečně identifikuje související odpověď vyhledávání.

Objekt obsahuje toto pole pouze v případě, že odpověď na hodnocení určuje, že se ve skupině zobrazí všechna související hledání. Další informace o tom, jak používat ID, najdete v tématu použití hodnocení k zobrazení výsledků.
Řetězec
osa Seznam souvisejících dotazů, které udělali jiní uživatelé Dotaz[]

SearchResponse

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

Rozhraní API pro vyhledávání ve výchozím nastavení zahrnuje všechny odpovědi, pokud:

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

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

  • Klíč předplatného nemá přístup k součásti vyhledávání.

Pokud služba vychází z útoků DOS (Denial of Service), je požadavek úspěšný (Stavový kód HTTP je 200 OK), ale tělo odpovědi je prázdné.

Name Hodnota Typ
_type Zadejte pomocný parametr. Řetězec
běhu Odpověď na výraz převodu matematického výrazu nebo jednotky Běhu
podnikům Seznam entit, které jsou relevantní pro vyhledávací dotaz. EntityAnswer
fotografií Seznam obrázků, které jsou relevantní pro vyhledávací dotaz. Image
news Seznam článků s novinkami, které jsou relevantní pro vyhledávací dotaz. Diskuz
queryContext Řetězec dotazu, který Bing použil pro požadavek.

Odpověď obsahuje kontext pouze v případě, že řetězec dotazu obsahuje pravopisnou chybu nebo má záměr na dospělé.
QueryContext
rankingResponse Pořadí, ve kterém Bing navrhne zobrazení výsledků hledání v. RankingResponse
relatedSearches Seznam souvisejících dotazů, které udělali jiní uživatelé RelatedSearchAnswer
spellSuggestions Řetězec dotazu, který nejspíš představuje záměr uživatele. SpellSuggestions
Údaj Datum a čas jednoho nebo více zeměpisných míst. Údaj
videa Seznam videí, která jsou relevantní pro vyhledávací dotaz. Videa
Webových stránkách Seznam webových stránek, které jsou relevantní pro vyhledávací dotaz. Webanswer

SpellSuggestions

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

Výsledky hledání zahrnují tuto odpověď, pokud je v Bingu určeno, že uživatel bude chtít hledat něco jiného. Pokud uživatel například vyhledá Alon Brown , Bing může určit, že uživatel pravděpodobně zamýšlel vyhledat Alton Brown (na základě dřívějšího hledání jinými uživateli Alon Brown).

Name Hodnota Typ
id ID, které jedinečně identifikuje odpověď na návrh pravopisu.

Toto pole použijete při použití odpovědi na hodnocení k zobrazení návrhů kontroly pravopisu. Další informace o tom, jak používat ID, najdete v tématu použití hodnocení k zobrazení výsledků.
Řetězec
osa 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řidělení prostého textu.

Name Hodnota Typ
_type Pomocný parametr typu, který je nastaven na TextAttribution. Řetězec
text Text přidělení.

Označení textu se vztahuje na entitu jako celek a mělo by se zobrazovat hned za prezentací entity. Pokud je k dispozici více pravidel textu nebo propojení, která neurčují cíl, je třeba je zřetězit a zobrazit pomocí popisku "data z:".
Řetězec

TimeZone

Definuje data a čas jednoho nebo více zeměpisných umístění.

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

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

Pokud dotaz zadal obecné geografické umístění, jako je například stát nebo země, tento objekt obsahuje datum a čas primárního města nebo státu nalezeného v zadaném stavu nebo zemi. Pokud umístění obsahuje další časová pásma, otherCityTimes pole obsahuje data a čas měst nebo států nacházejících se v jiných časových pásmech.
TimeZoneInformation

TimeZoneInformation

Definuje datum a čas pro zeměpisnou polohu.

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

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

Webanswer

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

Name Hodnota Typ
id ID, které jedinečně identifikuje webovou odpověď

Objekt obsahuje toto pole pouze v případě, že odpověď na hodnocení navrhuje zobrazení všech webových výsledků ve skupině. Další informace o tom, jak používat ID, najdete v tématu použití hodnocení k zobrazení výsledků.
Řetězec
someResultsRemoved Logická hodnota, která označuje, zda odpověď vyloučila některé výsledky z odpovědi. Pokud Bing vyloučí nějaké výsledky, hodnota se vyhodnotí jako true . Logická hodnota
totalEstimatedMatches Odhadovaný počet webových stránek, které jsou relevantní pro dotaz. Použijte toto číslo společně s parametry dotazu Count a offset na stránku výsledků. Dlouhou
osa Seznam webových stránek, které jsou pro dotaz relevantní. Webová stránka[]
webSearchUrl Adresa URL výsledků hledání Bingu pro požadované webové stránky Řetězec

Stránku

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

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

WebpageObjekt v tomto kontextu zahrnuje pouze name url pole,, a urlPingSuffix snippet .
Webová stránka[]
displayUrl Zobrazovaná adresa URL webové stránky Adresa URL je určena pouze pro účely zobrazení a není správně vytvořena. Řetězec
id ID, které jedinečně identifikuje tuto webovou stránku v seznamu webových výsledků.

Objekt obsahuje toto pole pouze v případě, že odpověď na hodnocení určuje, že tyto webové stránky lze kombinovat s ostatními výsledky hledání. Každá webová stránka obsahuje ID, které odpovídá ID v odpovědi na klasifikaci. Další informace najdete v tématu použití hodnocení k zobrazení výsledků.
Řetězec
name Název webové stránky

Pomocí tohoto názvu společně s nástrojem url můžete vytvořit hypertextový odkaz, který po kliknutí převezme uživatele na webovou stránku.
Řetězec
zmínky 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.

namePole MetaTag objektu obsahuje indexovanou vyhledávací značku. Hledané značky začínají na Search. * (například Search. assetId). contentPole obsahuje hodnotu značky.
MetaTag[]
zlomk Fragment textu z webové stránky, který popisuje jeho obsah. Řetězec
Adresa URL Adresa URL webové stránky

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

Typy entit

Tato část obsahuje možná doporučení entit. Pomocné parametry jsou seskupené podle kategorií entit.

Níže jsou uvedené základní typy entit.

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

Níže jsou uvedené pomocné parametry entit, které spadají pod základní typ umístění.

  • Attraction
  • City (Město)
  • Kontinent
  • Země
  • Hotel
  • Doma
  • LocalBusiness
  • Lokalita
  • MinorRegion
  • Včetně
  • Jiné
  • PointOfInterest
  • PostalCode
  • RadioStation
  • Oblast
  • Restaurací
  • Stav
  • StreetAddress
  • Podoblast
  • TouristAttraction
  • Cestování

Níže jsou uvedené pomocné parametry entit, které spadají do základního typu média.

  • Book
  • Pohyblivý
  • TelevisionSeason
  • TelevisionShow
  • VideoGame

Níže jsou uvedené pomocné parametry entit souvisejících s událostmi.

  • Událost

Níže jsou uvedené doporučení k entitám souvisejícím s profesí.

  • Actor (Herec/herečka)
  • Autor
  • Okresních

Níže jsou uvedené pomocné parametry entit týkajících se vzdělávání.

  • CollegeOrUniversity
  • Docházk
  • Zvláštnost

Níže jsou uvedené nesouvisející tipy entit.

  • Plyšák
  • Kabin
  • Léků
  • Simulant
  • Produkt
  • SportsTeam

Kódy chyb

Níže jsou uvedená možná zobrazení stavových kódů 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 je ověřený (například použil platný klíč předplatného), ale nemá oprávnění k požadovanému prostředku.

Bing tento stav může vrátit také v případě, že volající překročil kvótu svých dotazů za měsíc.
410 Požadavek použil místo protokolu HTTPS protokol HTTP. Jediným podporovaným protokolem je HTTPS.
429 Volající překročil kvótu svých 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í, co způsobilo chybu. Pokud chyba souvisí s parametrem, parameter pole identifikuje parametr, u kterém dochází k problému. A pokud chyba souvisí s hodnotou parametru, pole value identifikuje hodnotu, 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íže jsou uvedené možné hodnoty kódu chyby a dílčího kódu chyby.

Kód Dílčí kód Description
Chyba serveru Neočekávaná chyba
Chyba prostředku
NotImplemented (Zjednodušené)
Stavový kód HTTP je 500.
InvalidRequest ParametrMissing
ParameterInvalidValue
HttpNotAllowed
Blokované
Bing vrátí InvalidRequest, kdykoli jakákoli část požadavku není platná. Chybí například požadovaný parametr nebo hodnota parametru není platná.

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

Pokud místo protokolu HTTPS použijete protokol HTTP, Bing httpnotallowed a stavový kód HTTP je 410.
RateLimitExceeded Bez pod kódů Bing ratelimitExceeded vždy, když překročíte kvótu dotazů za sekundu (QPS) nebo dotazů za měsíc (QPM).

Pokud překročíte QPS, Bing stavový kód HTTP 429, a pokud překročíte QPM, Bing 403.
InvalidAuthorization AutorizaceMissing
AuthorizationRedundancy
Bing vrátí InvalidAuthorization, Bing nemůže ověřit volajícího. Chybí například Ocp-Apim-Subscription-Key hlavička nebo klíč předplatného není platný.

Redundance nastane, pokud zadáte více než jednu metodu ověřování.

Pokud je chyba InvalidAuthorization, stavový kód HTTP je 401.
InsufficientAuthorization AuthorizationDisabled
AuthorizationExpired
Bing vrátí InsufficientAuthorization, 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 InsufficientAuthorization, 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í mkt parametru dotazu. Bing vrací obsah pouze pro tyto trhy. Seznam se může změnit.

Seznam kódů zemí, které můžete zadat v cc parametru 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 ne–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íže jsou uvedené kódy zemí, které můžete zadat v cc parametru dotazu. V seznamu 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 Bingu

níže jsou uvedené podporované jazyky Bing, které můžete zadat v setLang parametru dotazu. V seznamu se může změnit.

Podporované jazyky Kód jazyka
Arabština snížen
Baskičtina Balijšitna
Bengálština bn
Bulharština BG
Katalánština určen
Čínština (zjednodušená) zh – Hans
Čínština (tradiční) zh – Hant
Chorvatština hod
Čeština cs
Dánština &
Nizozemština belgick
angličtina en
English-United království en-GB
Estonština et
Finština WiFi
Francouzština FR
Galicijština GL
Němčina &
Gudžarátština Gu
Hebrejština uvede
Hindština dobrý den
Maďarština hu
Islandština is
Italština její
Japonština JP
Kannadština KN
Korejština Ko
Lotyština Lotyšsko
Litevština lt
Malajština Arial
Malajalámština ml
Maráthština Vážený
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 loď
Ruština ru
Srbština (Cyrylic) uvedeno
Slovenština SM
Slovinština SSL
španělština es
Švédština činí
Tamilština Ta
Telugština te
Thajština Kolik
Turečtina recenzent
Ukrajinština Velká Británie
Vietnamština InterDev