Web Search API v7 – dokumentációWeb Search API v7 reference

Figyelmeztetés

Bing Search API-k átkerülnek a Cognitive Servicesról Bing Search szolgáltatásokra.Bing Search APIs are moving from Cognitive Services to Bing Search Services. 2020. október 30-ig a Bing Search új példányait az ittismertetett eljárás követésével kell kiépíteni.Starting October 30, 2020 , any new instances of Bing Search need to be provisioned following the process documented here. A Cognitive Services használatával kiépített Bing Search API-k a következő három évben vagy a Nagyvállalati Szerződés végéig lesz támogatva, attól függően, hogy melyik történik először.Bing Search APIs provisioned using Cognitive Services will be supported for the next three years or until the end of your Enterprise Agreement, whichever happens first. Az áttelepítési utasításokért lásd: Bing Search Services.For migration instructions, see Bing Search Services.

A Web Search API lehetővé teszi, hogy keresési lekérdezést küldjön a Bingnek, és olyan keresési eredményeket kapjon, amelyek a weboldalakra, képekre és egyebekre mutató hivatkozásokat tartalmaznak.The Web Search API lets you send a search query to Bing and get back search results that include links to webpages, images, and more. Ez a szakasz a weblapok, a kapcsolódó keresések és a rangsorolás eredményeinek technikai részleteit tartalmazza a keresési eredményeket érintő lekérdezési paraméterek mellett.This section provides technical details about the webpages, related searches, and ranking results in addition to the query parameters that affect the search results. A kérések elvégzését bemutató Példákért lásd: Keresés a weben.For examples that show how to make requests, see Search the web.

További információ a kérelmeket tartalmazó fejlécekről: kérések fejlécei.For information about headers that requests should include, see Request Headers.

További információ a kérelmeket tartalmazó lekérdezési paraméterekről: lekérdezési paraméterek.For information about query parameters that requests should include, see Query Parameters.

A válasz által felvehető JSON-objektumokkal kapcsolatos információkért lásd a válasz törzsét.For information about the JSON objects that the response may include, see Response Body. Ez a hivatkozás a webes válaszokra jellemző JSON-objektumot tartalmaz.This reference contains JSON object specific to web answers. A keresési eredmények által esetlegesen felvehető más válaszok JSON-objektumaival kapcsolatos részletekért tekintse meg az API-specifikus referenciák dokumentációját.For details about the JSON objects for other answer types that the search results may include, see the API-specific reference documentation. Ha például a találatok között szerepel a képek és a hírek válasza, tekintse meg a Image Search API és a News Search API-t.For example, if the search result contains the images and news answers, see the Image Search API and News Search API.

További információ a megengedett használatáról és az eredmények megjelenítéséről: BING Search API-használati és megjelenítési követelmények.For information about permitted use and display of results, see Bing Search API Use and Display requirements.

Megjegyzés

Mivel az URL-formátumok és a paraméterek előzetes értesítés nélkül változhatnak, használja az összes URL-címet.Because URL formats and parameters are subject to change without notice, use all URLs as-is. Ne vegyen fel függőségeket az URL-formátumra vagy a paraméterekre, kivéve, ha ez nincs feltüntetve.You should not take dependencies on the URL format or parameters except where noted.

VégpontokEndpoints

A webes keresési eredmények kéréséhez küldjön egy GET kérelmet a következőre:To request web search results, send a GET request to:

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

A több szolgáltatásra szóló előfizetések esetében a régiót az URL-címben kell megadni.For multi-service subscriptions, you must include the region in the URL. Például: westus.api.cognitive.microsoft.com.For example: westus.api.cognitive.microsoft.com. Lásd: támogatott régiók.See Supported Regions.

A kérelemnek a HTTPS protokollt kell használnia.The request must use the HTTPS protocol.

Megjegyzés

Az URL-cím maximális hossza 2 048 karakter.The maximum URL length is 2,048 characters. Annak érdekében, hogy az URL-cím hossza ne haladja meg a korlátot, a lekérdezési paraméterek maximális hosszának 1 500 karakternél rövidebbnek kell lennie.To ensure that your URL length does not exceed the limit, the maximum length of your query parameters should be less than 1,500 characters. Ha az URL-cím meghaladja az 2 048 karaktert, a kiszolgáló a 404 értéket adja vissza.If the URL exceeds 2,048 characters, the server returns 404 Not found.

FejlécekHeaders

A következő fejlécek lehetnek a kérések és válaszok.The following are the headers that a request and response may include.

FejlécHeader LeírásDescription
ElfogadásAccept Választható kérelemfejléc.Optional request header.

Az alapértelmezett adathordozó-típus az Application/JSON.The default media type is application/json. Annak megadásához, hogy a válasz JSON-ld-t használ, állítsa az elfogadás fejlécet Application/ld + JSON értékre.To specify that the response use JSON-LD, set the Accept header to application/ld+json.
Accept-LanguageAccept-Language Választható kérelemfejléc.Optional request header.

Nyelvek vesszővel elválasztott listája a felhasználói felület sztringjeihez.A comma-delimited list of languages to use for user interface strings. A lista prioritás szerinti csökkenő sorrendben jelenik meg.The list is in decreasing order of preference. További információért, például a várt formátummal kapcsolatos részletekért lásd: RFC2616.For more information, including expected format, see RFC2616.

Ez a fejléc és a setLang— lekérdezési paraméter kölcsönösen kizárják egymást, ne adja meg mindkettőt.This header and the setLang query parameter are mutually exclusive—do not specify both.

Ha beállítja ezt a fejlécet, akkor a cc lekérdezési paramétert is meg kell adnia.If you set this header, you must also specify the cc query parameter. A megfelelő piac meghatározásához a Bing a listában talált első támogatott nyelvet használja, és kombinálja azt a cc paraméter értékével.To determine the market to return results for, Bing uses the first supported language it finds from the list and combines it with the cc parameter value. Ha a lista nem tartalmaz támogatott nyelvet, a Bing megkeresi a kérelmet támogató legközelebbi nyelvet és piacot, vagy másik lehetőségként egy összesített vagy alapértelmezett piacot használ az eredmények beszerzéséhez.If the list does not include a supported language, Bing finds the closest language and market that supports the request or it uses an aggregated or default market for the results. A Bing által használt piac meghatározásához tekintse meg a BingAPIs-Market fejlécet.To determine the market that Bing used, see the BingAPIs-Market header.

Csak akkor használja ezt a fejlécet és a cc lekérdezési paramétert, ha több nyelvet ad meg.Use this header and the cc query parameter only if you specify multiple languages. Ellenkező esetben használja az mkt és a setLang lekérdezési paramétereket.Otherwise, use the mkt and setLang query parameters.

A felhasználóifelület-sztring egy olyan sztring, amelyet feliratként használnak a felhasználói felületen.A user interface string is a string that's used as a label in a user interface. A JSON-válaszobjektumok tartalmaznak néhány felhasználóifelület-sztringet.There are few user interface strings in the JSON response objects. A válaszobjektumokban található, a Bing.com tulajdonságaira mutató hivatkozások a megadott nyelvet alkalmazzák.Any links to Bing.com properties in the response objects apply the specified language.
BingAPIs-MarketBingAPIs-Market Válaszfejléc.Response header.

A kérelem által használt piac.The market used by the request. Az űrlap: <languageCode> - <countryCode> .The form is <languageCode>-<countryCode>. Például: en-US.For example, en-US.

Ha olyan piacot ad meg, amely nem szerepel a piaci kódoklistáján, akkor ez az érték különbözhet a MKT lekérdezési paraméterben megadott piactól.If you specify a market that is not listed in Market Codes, this value may differ from the market you specified in the mkt query parameter. Ugyanez igaz, ha olyan értéket ad meg a CC és az Accept-Language értékhez, amelyet nem lehet egyeztetni.The same is true if you specify values for cc and Accept-Language that can't be reconciled.
BingAPIs-TraceIdBingAPIs-TraceId Válaszfejléc.Response header.

A kérelem részleteit tartalmazó naplóbejegyzés azonosítója.The ID of the log entry that contains the details of the request. Ha hiba történik, rögzítse ezt az azonosítót.When an error occurs, capture this ID. Ha nem tudja meghatározni és megoldani a problémát, foglalja bele a kérelembe ezt az azonosítót is a támogatási csoportnak megadott többi információval együtt.If you are not able to determine and resolve the issue, include this ID along with the other information that you provide the Support team.
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key Kötelező kérelemfejléc.Required request header.

Az előfizetési kulcs, amelyet akkor kapott, amikor feliratkozott a szolgáltatásra a Cognitive Servicesben.The subscription key that you received when you signed up for this service in Cognitive Services.
PragmaPragma Választható kérelemfejlécOptional request header

Alapértelmezés szerint a Bing gyorsítótárazott tartalmat ad vissza, ha van ilyen.By default, Bing returns cached content, if available. Ha nem szeretné, hogy a Bing gyorsítótárazott tartalmat adjon vissza, állítsa a Pragma fejlécet no-cache értékre (például Pragma: no-cache).To prevent Bing from returning cached content, set the Pragma header to no-cache (for example, Pragma: no-cache).
Újrapróbálkozás ennyivelRetry-After Válaszfejléc.Response header.

A válasz tartalmazza ezt a fejlécet, ha túllépi a másodpercenként engedélyezett lekérdezések számát (QPS) vagy havonta (QPM).The response includes this header if you exceed the number of queries allowed per second (QPS) or per month (QPM). A fejlécben a másodpercek számát kell megvárnia, mielőtt egy másik kérést küldene.The header contains the number of seconds that you must wait before sending another request.
User-AgentUser-Agent Választható kérelemfejléc.Optional request header.

A kérelmet küldő felhasználói ügynök.The user agent originating the request. A Bing arra használja a felhasználói ügynököt, hogy optimalizált élményt nyújtson a mobilfelhasználóknak.Bing uses the user agent to provide mobile users with an optimized experience. Bár nem kötelező, javasoljuk, hogy mindig adja meg ezt a fejlécet.Although optional, you are encouraged to always specify this header.

A felhasználói ügynöknek a gyakran használt böngészők által küldött sztringgel megegyezőnek kell lennie.The user-agent should be the same string that any commonly used browser sends. A felhasználói ügynökökkel kapcsolatos információért lásd: RFC 2616.For information about user agents, see RFC 2616.

Az alábbiakban példákat láthat a felhasználóiügynök-sztringekre.The following are examples of user-agent strings.
  • Windows Phone – Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)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.1Android—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.20120423iPhone—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 GeckoPC—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.53iPad—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-ClientIDX-MSEdge-ClientID Választható kérelem- és válaszfejléc.Optional request and response header.

A Bing ezt a fejlécet használja ahhoz, hogy következetes viselkedést biztosítson a felhasználók számára a Bing API-hívásaiban.Bing uses this header to provide users with consistent behavior across Bing API calls. A Bing gyakran tesztel új funkciókat és fejlesztéseket, és az ügyfél-azonosítót használja kulcsként ahhoz, hogy a tesztcsomagokhoz rendelje a forgalmat.Bing often flights new features and improvements, and it uses the client ID as a key for assigning traffic on different flights. Ha a kérelmekben nem ugyanazt az ügyfél-azonosítót használja egy adott felhasználóhoz, előfordulhat, hogy a Bing több ütköző tesztcsomaghoz rendeli hozzá a felhasználót.If you do not use the same client ID for a user across multiple requests, then Bing may assign the user to multiple conflicting flights. Az ütköző tesztcsomagok hozzárendelése inkonzisztens felhasználói élményhez vezethet.Being assigned to multiple conflicting flights can lead to an inconsistent user experience. Például ha a második kérelemhez más tesztcsomag van hozzárendelve, mint az elsőhöz, az váratlan működést eredményezhet.For example, if the second request has a different flight assignment than the first, the experience may be unexpected. A Bing az ügyfél-azonosítót is használhatja a webes eredmények az ügyfél-azonosító keresési előzményeihez való személyre szabásához, így a felhasználó számára sokoldalú felhasználói élményt biztosíthat.Also, Bing can use the client ID to tailor web results to that client ID's search history, providing a richer experience for the user.

A Bing továbbá az ügyfél-azonosító által létrehozott tevékenységek elemzésével az eredmények rangsorolásának javítására is használja a fejlécet.Bing also uses this header to help improve result rankings by analyzing the activity generated by a client ID. A relevancia javítása segít abban, hogy a Bing API-k jobb minőségű eredményeket biztosítsanak, ami pedig lehetővé teszi a magasabb átkattintási arányt az API fogyasztója számára.The relevance improvements help with better quality of results delivered by Bing APIs and in turn enables higher click-through rates for the API consumer.

FONTOS: Bár nem kötelező, javasoljuk, hogy tekintse annak ezt a fejlécet.IMPORTANT: Although optional, you should consider this header required. Ha ugyanahhoz a végfelhasználóhoz és eszközkombinációhoz több kérelemben is megőrzi az ügyfél-azonosítót, azzal lehetővé teszi, 1) hogy az API fogyasztójának egységes felhasználói élményben legyen része, és 2) magasabb legyen az átkattintási arány a Bing API-k jobb minőségű eredményeinek köszönhetően.Persisting the client ID across multiple requests for the same end user and device combination enables 1) the API consumer to receive a consistent user experience, and 2) higher click-through rates via better quality of results from the Bing APIs.

A fejlécre az alábbi alapvető használati szabályok vonatkoznak.The following are the basic usage rules that apply to this header.
  • Minden felhasználónak, aki használja az eszközön lévő alkalmazást, rendelkeznie kell egy egyedi, Bing által létrehozott ügyfél-azonosítóval.Each user that uses your application on the device must have a unique, Bing generated client ID.

    Ha nem foglalja bele ezt a fejlécet a kérelembe, a Bing létrehoz egy azonosítót, és visszaküldi azt az X-MSEdge-ClientID válaszfejlécben.If you do not include this header in the request, Bing generates an ID and returns it in the X-MSEdge-ClientID response header. Ezt a fejlécet csak akkor NEM szabad belefoglalni a kérelembe, amikor a felhasználó először használja az alkalmazást azon az eszközön.The only time that you should NOT include this header in a request is the first time the user uses your app on that device.

  • FIGYELEM: Gondoskodnia kell róla, hogy ezt az ügyfél-azonosítót ne lehessen összekapcsolni a hitelesített felhasználói fiókok adataival.ATTENTION: You must ensure that this Client ID is not linkable to any authenticated user account information.

  • Használja az ügyfél-azonosítót minden olyan Bing API-kéréshez, amelyet az alkalmazás intéz a felhasználó kapcsán az eszközön.Use the client ID for each Bing API request that your app makes for this user on the device.

  • Őrizze meg az ügyfél-azonosítót.Persist the client ID. Az azonosító böngészőalkalmazásban való megőrzéséhez használjon egy állandó HTTP-cookie-t, amely biztosítja, hogy minden munkamenetben ez az azonosító legyen használva.To persist the ID in a browser app, use a persistent HTTP cookie to ensure the ID is used across all sessions. Ne használjon munkamenet-cookie-t.Do not use a session cookie. Más alkalmazások, például a mobilalkalmazások esetében az azonosító megőrzéséhez használja az eszköz állandó tárolóját.For other apps such as mobile apps, use the device's persistent storage to persist the ID.

    Kérje le a megőrzött ügyfél-azonosítót, amikor a felhasználó ismét használja az alkalmazást az eszközön.The next time the user uses your app on that device, get the client ID that you persisted.

MEGJEGYZÉS: A Bing-válaszok nem mindig tartalmazzák ezt a fejlécet.NOTE: Bing responses may or may not include this header. Ha a válasz tartalmazza ezt a fejlécet, rögzítse az ügyfél-azonosítót, és használja azt a felhasználó összes további Bing-kérelméhez az adott eszközön.If the response includes this header, capture the client ID and use it for all subsequent Bing requests for the user on that device.

MEGJEGYZÉS: Ha belefoglalja a kérelembe az X-MSEdge-ClientID fejlécet, akkor ne foglaljon bele cookie-kat.NOTE: If you include the X-MSEdge-ClientID, you must not include cookies in the request.
X-MSEdge-ClientIPX-MSEdge-ClientIP Választható kérelemfejléc.Optional request header.

Az ügyféleszköz IPv4- vagy IPv6-címe.The IPv4 or IPv6 address of the client device. Az IP-cím a felhasználó tartózkodási helyének felderítésére szolgál.The IP address is used to discover the user's location. A Bing arra használja a helyadatokat, hogy meghatározza a biztonságos keresés viselkedését.Bing uses the location information to determine safe search behavior.

MEGJEGYZÉS: Bár nem kötelező, javasoljuk, hogy mindig adja meg ezt a fejlécet és az X-Search-Location fejlécet.NOTE: Although optional, you are encouraged to always specify this header and the X-Search-Location header.

Ne rejtse el a címet (például úgy, hogy 0-ra módosítja az utolsó oktettet).Do not obfuscate the address (for example, by changing the last octet to 0). Ha elrejti a címet, a tartózkodási hely távol fog esni az eszköz tényleges helyétől, amely ahhoz vezethet, hogy a Bing téves eredményeket fog megadni.Obfuscating the address results in the location not being anywhere near the device's actual location, which may result in Bing serving erroneous results.
X-Search-LocationX-Search-Location Választható kérelemfejléc.Optional request header.

Kulcs/érték párok pontosvesszővel elválasztott listája, amely leírja az ügyfél földrajzi helyét.A semicolon-delimited list of key/value pairs that describe the client's geographical location. A Bing arra használja a helyadatokat, hogy meghatározza a biztonságos keresés viselkedését, illetve releváns helyi tartalmakat adjon vissza.Bing uses the location information to determine safe search behavior and to return relevant local content. A kulcs/érték párokat a következőképpen adhatja meg <key> : <value> .Specify the key/value pair as <key>:<value>. Az alábbiakban láthatja a felhasználó tartózkodási helyének megadására használt kulcsokat.The following are the keys that you use to specify the user's location.

  • lat – Kötelező.lat—Required. Az ügyfél tartózkodási helyének földrajzi szélessége, fokban megadva.The latitude of the client's location, in degrees. A földrajzi szélesség nem lehet -90,0 foknál kisebb és +90,0 foknál nagyobb.The latitude must be greater than or equal to -90.0 and less than or equal to +90.0. A negatív értékek a déli szélességeket, a pozitív értékek pedig az északi szélességeket jelölik.Negative values indicate southern latitudes and positive values indicate northern latitudes.

  • long – Kötelező.long—Required. Az ügyfél tartózkodási helyének földrajzi hosszúsága, fokban megadva.The longitude of the client's location, in degrees. A földrajzi hosszúság nem lehet -180,0 foknál kisebb és +180,0 foknál nagyobb.The longitude must be greater than or equal to -180.0 and less than or equal to +180.0. A negatív értékek a nyugati hosszúságokat, a pozitív értékek pedig a keleti hosszúságokat jelölik.Negative values indicate western longitudes and positive values indicate eastern longitudes.

  • re – Kötelező.re—Required. A méterben megadott sugár, amely meghatározza a koordináták vízszintes pontosságát.The radius, in meters, which specifies the horizontal accuracy of the coordinates. Adja át az eszköz helymeghatározási szolgáltatása által visszaadott értéket.Pass the value returned by the device's location service. A tipikus érték GPS/Wi-Fi esetén 22 m, telefontoronnyal végzett háromszögelés esetén 380 m, fordított IP-keresés esetén pedig 18 000 m.Typical values might be 22m for GPS/Wi-Fi, 380m for cell tower triangulation, and 18,000m for reverse IP lookup.

  • ts – Választható.ts—Optional. Az UTC UNIX-időbélyeg arról, hogy mikor tartózkodott az ügyfél az adott helyen.The UTC UNIX timestamp of when the client was at the location. (Az UNIX-időbélyeg az 1970. január 1. óta eltelt másodpercek száma).(The UNIX timestamp is the number of seconds since January 1, 1970.)

  • head – Választható.head—Optional. Az ügyfél relatív haladási vagy utazási iránya.The client's relative heading or direction of travel. Az utazás irányt fokban adja meg 0 és 360 között, a tényleges északhoz képest az óramutató járásával megegyező irányban számítva.Specify the direction of travel as degrees from 0 through 360, counting clockwise relative to true north. Csak akkor adja meg ezt a kulcsot, ha az sp kulcs értéke nem nulla.Specify this key only if the sp key is nonzero.

  • sp – Választható.sp—Optional. A méter per másodpercben megadott horizontális sebesség, amellyel az ügyféleszköz halad.The horizontal velocity (speed), in meters per second, that the client device is traveling.

  • alt – Választható.alt—Optional. Az ügyféleszköz tengerszint feletti magassága, méterben megadva.The altitude of the client device, in meters.

  • are – Választható.are—Optional. A méterben megadott sugár, amely meghatározza a koordináták függőleges pontosságát.The radius, in meters, that specifies the vertical accuracy of the coordinates. Csak akkor adja meg ezt a kulcsot, ha az alt kulcsot is megadja.Specify this key only if you specify the alt key.

  • a DISP nem — kötelező.disp—Optional. A felhasználó földrajzi helye az űrlapon, DISP: <város, állapot>.The user's geographic location in the form, disp:<City, State>. Például DISP: Seattle, Washington.For example, disp:Seattle, Washington. Ez a felhasználó azon helyének szöveges verziója, amelyet a lat/hosszú kulcsok használatával adott meg.This is the display text version of the user's location that you specified using the lat/long keys. Ha ez az érték ütközik a lat/hosszú koordinátákkal, a Bing a DISP értéket használja a felhasználó helyeként.If this value conflicts with the lat/long coordinates, Bing uses the disp value as the user's location.

Megjegyzés: A Bing figyelmen kívül hagyja ezt a fejlécet, ha a lekérdezés tartalmaz egy helyet.NOTE: Bing ignores this header if the query includes a location. Ha például ez a fejléc a felhasználó tartózkodási helyét mutatja San Francisco-ként, de a lekérdezés a Seattle -i Restaurants, a Bing a Washington állambeli Seattle-ben található éttermeket adja vissza.For example, if this header reflects the user's location as San Francisco, but the query is restaurants seattle , Bing returns restaurants located in Seattle, Washington.

MEGJEGYZÉS: Bár sok kulcs használata nem kötelező, minél több információt ad meg, annál pontosabbak lesznek a helymeghatározás eredményei.NOTE: Although many of the keys are optional, the more information that you provide, the more accurate the location results are.

MEGJEGYZÉS: Bár nem kötelező, javasoljuk, hogy mindig adja meg a felhasználó földrajzi helyét.NOTE: Although optional, you are encouraged to always specify the user's geographical location. Különösen fontos megadni a helyet, ha az ügyfél IP-címe nem tükrözi pontosan a felhasználó fizikai helyét (például ha az ügyfél VPN-t használ).Providing the location is especially important if the client's IP address does not accurately reflect the user's physical location (for example, if the client uses VPN). Az optimális eredmény érdekében vegye fel ezt a fejlécet és az X-Search-Ügyfélip fejlécet, de legalább ezt a fejlécet kell tartalmaznia.For optimal results, you should include this header and the X-Search-ClientIP header, but at a minimum, you should include this header.

Megjegyzés

Ne feledje, hogy a Használati feltételek a fejlécek használatával kapcsolatban is előírják a vonatkozó törvények betartását.Remember that the Terms of Use require compliance with all applicable laws, including regarding use of these headers. Egyes joghatóságokban, például Európában vannak olyan követelmények, amelyek előírják a felhasználói hozzájárulás megszerzését a nyomkövető eszközök felhasználói eszközökön való elhelyezése előtt.For example, in certain jurisdictions, such as Europe, there are requirements to obtain user consent before placing certain tracking devices on user devices.

Lekérdezési paraméterekQuery parameters

A kérelem az alábbi lekérdezési paramétereket tartalmazhatja.The following are the query parameters that the request may include. A Kötelező oszlop azt jelzi, hogy mindenképp meg kell-e adnia a paramétert.The Required column indicates whether you must specify the parameter. A lekérdezési paraméterek értékeit URL-kódolással kell megadni.You must URL encode the query parameter values.

NameName ÉrtékValue TípusType KötelezőRequired
answerCountanswerCount Azoknak a válaszoknak a száma, amelyeket a válasznak tartalmaznia kell.The number of answers that you want the response to include. A Bing által visszaadott válaszok rangsoroláson alapulnak.The answers that Bing returns are based on ranking. Ha például a Bing egy kérelemhez weblapokat, képeket, videókat és relatedSearches ad vissza, és ezt a paramétert két (2) értékre állítja be, a válasz weblapokat és képeket is tartalmaz.For example, if Bing returns webpages, images, videos, and relatedSearches for a request and you set this parameter to two (2), the response includes webpages and images.

Ha a responseFilter lekérdezési paramétert ugyanabban a kérésben tartalmazza, és a weblapokra és hírekre állítja be, a válasz csak weblapokat tartalmazhat.If you included the responseFilter query parameter in the same request and set it to webpages and news, the response would include only webpages.

További információ a rangsorolt válaszok támogatásáról: előléptetés.For information about promoting a ranked answer into the response, see promote.
Előjel nélküli egész számUnsigned Integer NemNo
cccc Annak az országnak a két karakterből álló országkódja, ahonnan az eredmények származnak.A 2-character country code of the country where the results come from. A lehetséges értékek listáját a piaci kódokrészben tekintheti meg.For a list of possible values, see Market Codes.

Ha beállítja ezt a paramétert, az Accept-Language fejlécet is meg kell adnia.If you set this parameter, you must also specify the Accept-Language header. A Bing az első támogatott nyelvet használja a megadott nyelveken, és az országkód alapján határozza meg, hogy a piac Hogyan adja vissza az eredményeket.Bing uses the first supported language it finds in the specified languages and combines it with the country code to determine the market to return results for. Ha a nyelvek listája nem tartalmaz támogatott nyelvet, a Bing megkeresi a kérelmet támogató legközelebbi nyelvet és piacot.If the languages list does not include a supported language, Bing finds the closest language and market that supports the request. Vagy a Bing az eredmények összesített vagy alapértelmezett piacát is használhatja.Or, Bing may use an aggregated or default market for the results.

Ezt a lekérdezési paramétert és a Accept-Language fejlécet csak akkor használja, ha több nyelvet ad meg.Use this query parameter and the Accept-Language header only if you specify multiple languages. Ellenkező esetben használja a és a mkt setLang lekérdezés paramétereit.Otherwise, you should use the mkt and setLang query parameters.

Ez a paraméter és az mkt— lekérdezési paraméter kölcsönösen kizárják egymást, ne adja meg mindkettőt.This parameter and the mkt query parameter are mutually exclusive—do not specify both.
SztringString NemNo
számacount A válaszban visszaadni kívánt keresési eredmények száma.The number of search results to return in the response. Az alapértelmezett érték 10, a maximális érték 50.The default is 10 and the maximum value is 50. A ténylegesen leszállított szám a kértnél kevesebb lehet.The actual number delivered may be less than requested.

Használja ezt a paramétert a offset paraméterrel együtt a Page Results értékhez.Use this parameter along with the offset parameter to page results. További információ: lapozási weblapok.For more information, see Paging Webpages.

Ha például a felhasználói felület 10 keresési eredményt jelenít meg oldalanként, akkor az count offset eredmények első oldalának beszerzéséhez állítsa a 10 és a 0 értéket.For example, if your user interface displays 10 search results per page, set count to 10 and offset to 0 to get the first page of results. Minden további oldal esetében a növekmény offset 10 (például: 0, 10, 20).For each subsequent page, increment offset by 10 (for example, 0, 10, 20). Több oldal is lehetséges, hogy az eredmények átfedésben legyenek.It is possible for multiple pages to include some overlap in results.
UnsignedShortUnsignedShort NemNo
frissességfreshness Keresési eredmények szűrése a következő kis-és nagybetűk megkülönböztetésével:Filter search results by the following case-insensitive age values:
  • —A Bing által az elmúlt 24 órában észlelt napDay—Return webpages that Bing discovered within the last 24 hours

  • —Az elmúlt 7 napban a Bing által felderített hétWeek—Return webpages that Bing discovered within the last 7 days

  • —Az elmúlt 30 napban felderített hónapokat visszaküldő weblapokMonth—Return webpages that discovered within the last 30 days

Ha egy adott időkereten belül a Bing által felderített cikkeket szeretné lekérni, a dátumtartományt a következő formátumban kell megadni: éééé-hh-nn.. ÉÉÉÉ-HH-NN.To get articles discovered by Bing during a specific timeframe, specify a date range in the form, YYYY-MM-DD..YYYY-MM-DD. Például: &freshness=2019-02-01..2019-05-30.For example, &freshness=2019-02-01..2019-05-30. Ha az eredményeket egyetlen dátumra szeretné korlátozni, állítsa ezt a paramétert egy adott dátumra.To limit the results to a single date, set this parameter to a specific date. Például: &freshness=2019-02-04.For example, &freshness=2019-02-04.
SztringString NemNo
mktmkt A piac, ahonnan az eredmények származnak.The market where the results come from. Általában mkt az az ország, ahol a felhasználó kéri a kérést.Typically, mkt is the country where the user is making the request from. Azonban lehet más ország is, ha a felhasználó nem olyan országban található, ahol a Bing eredményeket eredményez.However, it could be a different country if the user is not located in a country where Bing delivers results. A piacnak formában kell lennie <language code> - <country code> .The market must be in the form <language code>-<country code>. Például: en-US.For example, en-US. A karakterlánc nem megkülönbözteti a kis-és nagybetűket.The string is case insensitive. A lehetséges piaci értékek listáját a piaci kódokrészben tekintheti meg.For a list of possible market values, see Market Codes.

Megjegyzés: Ha ismert, javasoljuk, hogy mindig határozza meg a piacot.NOTE: If known, you are encouraged to always specify the market. Ha megadja a piacot, azzal elősegíti, hogy a Bing a kérelmet továbbítva megfelelő, optimális választ adjon vissza.Specifying the market helps Bing route the request and return an appropriate and optimal response. Ha olyan piacot ad meg, amely nem szerepel a piaci kódoklistáján, akkor a Bing egy olyan belső leképezés alapján használja a legjobb illeszkedési kódot, amely változhat.If you specify a market that is not listed in Market Codes, Bing uses a best fit market code based on an internal mapping that is subject to change.

Ez a paraméter és a cc— lekérdezési paraméter kölcsönösen kizárják egymást, ne adja meg mindkettőt.This parameter and the cc query parameter are mutually exclusive—do not specify both.
SztringString NemNo
eltolásoffset A nulla alapú eltolás, amely az eredmények visszaadása előtt kihagyható keresési eredmények számát jelzi.The zero-based offset that indicates the number of search results to skip before returning results. Az alapértelmezett érték a 0.The default is 0. Az eltolásnak kisebbnek kell lennie, mint (totalEstimatedMatches - count ).The offset should be less than (totalEstimatedMatches - count).

Használja ezt a paramétert a count paraméterrel együtt a Page Results értékhez.Use this parameter along with the count parameter to page results. Ha például a felhasználói felület 10 keresési eredményt jelenít meg oldalanként, akkor az count offset eredmények első oldalának beszerzéséhez állítsa a 10 és a 0 értéket.For example, if your user interface displays 10 search results per page, set count to 10 and offset to 0 to get the first page of results. Minden további oldal esetében a növekmény offset 10 (például: 0, 10, 20).For each subsequent page, increment offset by 10 (for example, 0, 10, 20). több oldal is lehetséges, hogy az eredmények átfedésben legyenek.it is possible for multiple pages to include some overlap in results.
Előjel nélküli rövidUnsigned Short NemNo
előmozdításapromote Azoknak a válaszoknak a vesszővel tagolt listája, amelyeket a válasznak tartalmaznia kell, függetlenül a rangsorolástól.A comma-delimited list of answers that you want the response to include regardless of their ranking. Ha például a answerCountbeállítása két (2) értékre van állítva, így a Bing az első két rangsorolt választ adja vissza, de azt is szeretné, hogy a válasz híreket is tartalmazzon, ha híreket szeretne megadni promote .For example, if you set answerCount) to two (2) so Bing returns the top two ranked answers, but you also want the response to include news, you'd set promote to news. Ha a legfelső szintű válaszok weblapok, képek, videók és relatedSearches, a válasz weblapokat és képeket is tartalmaz, mivel a hírek nem rangsorolt válasz.If the top ranked answers are webpages, images, videos, and relatedSearches, the response includes webpages and images because news is not a ranked answer. Ha azonban a promote videóra van beállítva, a Bing előlépteti a választ, és visszaküldi a weblapokat, a képeket és a videókat.But if you set promote to video, Bing would promote the video answer into the response and return webpages, images, and videos.

Az előléptetni kívánt válaszok nem számítanak bele a answerCount korlátba.The answers that you want to promote do not count against the answerCount limit. Ha például a rangsorolt válaszok a hírek, a képek és a videók, és az 1. és a hírek lehetőségre van állítva, answerCount promote a válasz híreket és képeket tartalmaz.For example, if the ranked answers are news, images, and videos, and you set answerCount to 1 and promote to news, the response contains news and images. Vagy ha a rangsorolt válaszok videók, képek és hírek, a válasz videókat és híreket tartalmaz.Or, if the ranked answers are videos, images, and news, the response contains videos and news.

A lehetséges értékek a következők:The following are the possible values.
  • SzámításiComputation
  • KépekImages
  • HírekNews
  • RelatedSearchesRelatedSearches
  • SpellSuggestionsSpellSuggestions
  • TimeZoneTimeZone
  • VideókVideos
  • WeblapokWebpages

Megjegyzés: Csak akkor használja, ha answerCountad meg.NOTE: Use only if you specify answerCount.
SztringString NemNo
qq A felhasználó keresési lekérdezési kifejezése.The user's search query term. A kifejezés nem lehet üres.The term may not be empty.

A kifejezés a Bing speciális operátoraitis tartalmazhatja.The term may contain Bing Advanced Operators. Ha például az eredményeket egy adott tartományra szeretné korlátozni, használja a site: operátort.For example, to limit results to a specific domain, use the site: operator.
SztringString IgenYes
responseFilterresponseFilter A válaszban szerepeltetni kívánt válaszok vesszővel tagolt listája.A comma-delimited list of answers to include in the response. Ha nem határozza meg ezt a paramétert, a válasz tartalmazza az összes olyan keresési választ, amelyre vonatkozó adatokat tartalmaz.If you do not specify this parameter, the response includes all search answers for which there's relevant data.

A lehetséges szűrési értékek a következők:The following are the possible filter values.
  • SzámításiComputation
  • EntitásokEntities
  • KépekImages
  • HírekNews
  • RelatedSearchesRelatedSearches
  • SpellSuggestionsSpellSuggestions
  • TimeZoneTimeZone
  • VideókVideos
  • WeblapokWebpages

Ha bizonyos típusú tartalmakat, például képeket szeretne kizárni a válaszból, kizárhatja azokat a kötőjel (mínusz) előtaggal a responseFilter értékre.If you want to exclude specific types of content, such as images, from the response, you can exclude them with the hyphen (minus) prefix to the responseFilter value. Különálló kizárt típusok vesszővel: &responseFilter =-images,-videosSeparate excluded types with a comma: &responseFilter=-images,-videos

Bár ezt a szűrőt egyetlen válasz beszerzésére is használhatja, Ehelyett használja a válasz-specifikus végpontot, hogy gazdagabb eredményeket kapjon.Although you may use this filter to get a single answer, you should instead use the answer-specific endpoint in order to get richer results. Ha például csak képeket szeretne kapni, küldje el a kérelmet az Image Search API -végpontok egyikének.For example, to receive only images, send the request to one of the Image Search API endpoints.

A RelatedSearches és a SpellSuggestions válaszai nem támogatják a különálló végpontot (például a Image Search API-t) (csak a Web Search API adja vissza őket).The RelatedSearches and SpellSuggestions answers do not support a separate endpoint like the Image Search API does (only the Web Search API returns them).

Ha olyan válaszokat szeretne szerepeltetni, amelyeket a rangsorolás miatt egyébként ki lehetne zárni, tekintse meg az előléptetés lekérdezési paramétert.To include answers that would otherwise be excluded because of ranking, see the promote query parameter.
SztringString NemNo
safeSearchsafeSearch a felnőtt tartalmak weblapjainak szűrése.filters webpages for adult content. A lehetséges szűrési értékek a következők:The following are the possible filter values.
  • —A weblapok visszaküldése felnőtt szöveggel és képekkel.Off—Return webpages with adult text and images.
  • Közepes — hozamú weblapok felnőtt szöveggel, de nem felnőtt képekkel vagy videókkal.Moderate—Return webpages with adult text, but not adult images or videos.
  • A szigorú nem — ad vissza weblapokat felnőtt szöveggel, képpel vagy videókkal.Strict—Do not return webpages with adult text, images, or videos.
Az alapértelmezett érték a Moderate.The default is Moderate.

Megjegyzés: A videó eredményeinél, ha a safeSearch be van kapcsolva, a Bing figyelmen kívül hagyja, és mérsékelt értéket használ.NOTE: For video results, if safeSearch is set to Off, Bing ignores it and uses Moderate.

Megjegyzés: Ha a kérés olyan piacról származik, amelyet a Bing felnőtt házirendje szigorú értékre van safeSearch állítva, a Bing figyelmen kívül hagyja az safeSearch értéket, és szigorú értéket használ.NOTE: If the request comes from a market that Bing's adult policy requires that safeSearch is set to Strict, Bing ignores the safeSearch value and uses Strict.

MEGJEGYZÉS: Ha a site: lekérdezési operátort használja, előfordulhat, hogy a válasz a safeSearch lekérdezési paraméter beállításától függetlenül felnőtteknek szóló tartalmakat fog tartalmazni.NOTE: If you use the site: query operator, there is the chance that the response may contain adult content regardless of what the safeSearch query parameter is set to. Csak akkor használja a site: operátort, ha ismeri a webhely tartalmát, és a felnőtteknek szóló tartalmak megjelenítése nem okoz problémát.Use site: only if you are aware of the content on the site and your scenario supports the possibility of adult content.
SztringString NemNo
setLangsetLang A felhasználói felület sztringjeihez használni kívánt nyelv.The language to use for user interface strings. A nyelvet kétbetűs vagy 4 betűs kóddal is megadhatja.You may specify the language using either a 2-letter or 4-letter code. A 4 betűs kódok használata javasolt.Using 4-letter codes is preferred.

A támogatott nyelvi kódok listáját a Bing által támogatott nyelvekcímű részben tekintheti meg.For a list of supported language codes, see Bing supported languages.

A Bing betölti a honosított karakterláncokat setlang , ha érvényes 2 betűs semleges kulturális programkódot ( fr ) vagy egy érvényes, 4 betűs specifikus kulturális kódot ( fr-CA ) tartalmaz.Bing loads the localized strings if setlang contains a valid 2-letter neutral culture code ( fr ) or a valid 4-letter specific culture code ( fr-ca ). A fr-CA esetében például a Bing betölti a fr semleges kulturális kód karakterláncait.For example, for fr-ca , Bing loads the fr neutral culture code strings.

Ha a setlang nem érvényes (például zh ) vagy a Bing nem támogatja a nyelvet (például AF , AF-na ), a Bing alapértelmezett értéke az en (angol).If setlang is not valid (for example, zh ) or Bing doesn't support the language (for example, af , af-na ), Bing defaults to en (English).

A kétbetűs kód megadásához állítsa ezt a paramétert ISO 639-1 nyelvi kódra.To specify the 2-letter code, set this parameter to an ISO 639-1 language code.

A 4 betűs kód megadásához használja a Form -<országot/régiót> ahol az egy ISO 639-1 nyelvi kód (semleges kulturális környezet) és <ország/régió> egy ISO 3166 ország/régió (adott kulturális) kód.To specify the 4-letter code, use the form -<country/region> where is an ISO 639-1 language code (neutral culture) and <country/region> is an ISO 3166 country/region (specific culture) code. Például Egyesült Államok angol nyelven használhatja az en-us nyelvet.For example, use en-US for United States English.

Bár nem kötelező, javasoljuk, hogy mindig adja meg a nyelvet.Although optional, you should always specify the language. A setLang paramétert általában az mkt által meghatározott nyelvre kell állítani, hacsak a felhasználó nem szeretné más nyelven megjeleníteni a felhasználói felület sztringjeit.Typically, you set setLang to the same language specified by mkt unless the user wants the user interface strings displayed in a different language.

Ez a paraméter és a Accept-Language fejléc kölcsönösen kizárják egymást – ne határozza meg mindkettőt.This parameter and the Accept-Language header are mutually exclusive—do not specify both.

A felhasználóifelület-sztring egy olyan sztring, amelyet feliratként használnak a felhasználói felületen.A user interface string is a string that's used as a label in a user interface. A JSON-válaszobjektumok tartalmaznak néhány felhasználóifelület-sztringet.There are few user interface strings in the JSON response objects. A válaszobjektumokban található, a Bing.com tulajdonságaira mutató hivatkozások is a megadott nyelvet alkalmazzák.Also, any links to Bing.com properties in the response objects apply the specified language.
SztringString NemNo
textDecorationstextDecorations Logikai érték, amely meghatározza, hogy megjelenjenek-e a megjelenítési karakterláncok, például a találatok kiemelését jelző karakterek.A Boolean value that determines whether display strings should contain decoration markers such as hit highlighting characters. Ha az értéke igaz , a karakterláncok tartalmazhatnak jelölőket.If true , the strings may include markers. Az alapértelmezett érték a false .The default is false .

A Szövegformátum lekérdezési paraméterrel megadhatja, hogy a Unicode-karakterek vagy HTML-címkék legyenek-e megjelölve.To specify whether to use Unicode characters or HTML tags as the markers, see the textFormat query parameter.

A találatok kiemelésével kapcsolatos információkért lásd: találatok kiemelése.For information about hit highlighting, see Hit Highlighting.
LogikaiBoolean NemNo
SzövegformátumtextFormat A szöveg-kitüntetésekhez használandó jelölők típusa (lásd a textDecorations lekérdezési paramétert).The type of markers to use for text decorations (see the textDecorations query parameter).

A lehetséges értékek a következők:The following are the possible values.
  • —A nyers Unicode-karakterek használata a speciális formázást igénylő tartalmak megjelöléséhez.Raw—Use Unicode characters to mark content that needs special formatting. A Unicode-karakterek a E000 tartományon keresztül, a E019-n keresztül jelennek meg.The Unicode characters are in the range E000 through E019. A Bing például a E000 és a E001 használatával jelöli meg a lekérdezési feltételek kezdetét és végét a találatok kiemeléséhez.For example, Bing uses E000 and E001 to mark the beginning and end of query terms for hit highlighting.

  • HTML — -címkék használata a speciális formázást igénylő tartalmak megjelöléséhez.HTML—Use HTML tags to mark content that needs special formatting. A címkék használatával például <b> kiemelheti a lekérdezési kifejezéseket a megjelenítési karakterláncokban.For example, use <b> tags to highlight query terms in display strings.

Az alapértelmezett érték a RAW.The default is Raw.

A jelölők listájáért lásd: találatok kiemelése.For a list of markers, see Hit Highlighting.

A megjelenő HTML-karaktereket (például <, > és &) tartalmazó megjelenített karakterláncok esetén a textFormat Bing a megfelelő módon Escape-karaktereket (például <, & lt;).For display strings that contain escapable HTML characters such as <, >, and &, if textFormat is set to HTML, Bing escapes the characters as appropriate (for example, < is escaped to &lt;).

A karakterláncok beágyazott Unicode-karakterekkel való feldolgozásával kapcsolatos további információkért lásd: találatok kiemelése.For information about processing strings with the embedded Unicode characters, see Hit Highlighting.
SztringString NemNo

Válasz objektumokResponse objects

Megjegyzés

Ahhoz, hogy betartsák a franciaországi új szerzői jogi irányelvet, a Bing web, a News, a video, a képek és az egyéni keresési API-k bizonyos tartalmakat el kell hagyniuk a francia felhasználók egyes EU-hírforrások számára.To comply with the new EU Copyright Directive in France, the Bing Web, News, Video, Image and all Custom Search APIs must omit some content from certain EU News sources for French users. Az eltávolított tartalom tartalmazhat miniatűr képeket és videókat, videó-előnézeteket és kódrészleteket, amelyek ezekből a forrásokból származó keresési eredményeket kísérik.The removed content may include thumbnail images and videos, video previews, and snippets which accompany search results from these sources. Ennek következményeként a Bing API-k kevesebb eredményt tudnak kiszolgálni miniatűr képekkel és videókkal, videós előzetes verziókkal és kódrészletekkel francia felhasználóknak.As a consequence, the Bing APIs may serve fewer results with thumbnail images and videos, video previews, and snippets to French users.

Az alábbi JSON-válaszok objektumai lehetnek a válaszban.The following are the JSON response objects that the response may include. Ha a kérelem sikeres, a válasz legfelső szintű objektuma a SearchResponse objektum.If the request succeeds, the top-level object in the response is the SearchResponse object. Ha a kérelem meghiúsul, a legfelső szintű objektum a ErrorResponse objektum.If the request fails, the top-level object is the ErrorResponse object.

Ez a lista a webes válaszokra jellemző JSON-objektumokat tartalmaz.This list contains JSON objects that are specific to web answers. A keresési eredmények által esetlegesen felvehető más válaszok JSON-objektumaival kapcsolatos részletekért tekintse meg az API-specifikus referenciák dokumentációját.For details about the JSON objects for other answer types that the search results may include, see the API-specific reference documentation. Ha például a keresési eredmény tartalmazza a képeket és a híreket, tekintse meg a kép API és Hírek API-t.For example, if the search result contains the images and news answers, see the Image API and News API.

ObjektumObject LeírásDescription
SzámításiComputation Definiál egy kifejezést és a hozzá tartozó választ.Defines an expression and its answer.
EntitásEntity Definiál egy entitást, például személyt, helyet vagy dolgot.Defines an entity such as a person, place, or thing.
HibaError Egy hiba előfordulását határozza meg.Defines an error that occurred.
ErrorResponseErrorResponse Az a legfelső szintű objektum, amelyre a válasz vonatkozik, ha a kérelem meghiúsul.The top-level object that the response includes when the request fails.
AzonosíthatóIdentifiable Meghatározza az erőforrás-azonosítót.Defines a resource ID.
LicenseAttributionLicenseAttribution Meghatároz egy szerződéses szabályt a licencek hozzárendeléséhez.Defines a contractual rule for license attribution.
LinkAttributionLinkAttribution Egy szerződéses szabályt határoz meg a hivatkozás-hozzárendeléshez.Defines a contractual rule for link attribution.
MediaAttributionMediaAttribution Meghatároz egy szerződéses szabályt a média-hozzárendeléshez.Defines a contractual rule for media attribution.
LekérdezésQuery Definiál egy lekérdezési karakterláncot.Defines a query string.
QueryContextQueryContext Meghatározza a kérelemhez használt Bing-lekérdezési környezetet, ha a megadott lekérdezési karakterlánc helyesírási hibát tartalmaz.Defines the query context that Bing used for the request, if the specified query string contains a spelling error.
RankingGroupRankingGroup Meghatározza a keresési eredmények csoportot, például a fővonalat.Defines a search results group, such as mainline.
RankingItemRankingItem Meghatározza a megjeleníteni kívánt rangsorolási csoport tételét.Defines a ranking group item to display.
RankingResponseRankingResponse Meghatározza, hogy a keresési eredmények oldalának hol kell lennie, és milyen sorrendben kell elhelyezni a tartalmat.Defines where on the search results page content should be placed and in what order.
RelatedSearchAnswerRelatedSearchAnswer Meghatározza a mások által készített kapcsolódó lekérdezések listáját.Defines a list of related queries made by others.
SearchResponseSearchResponse Az a legfelső szintű objektum, amelyre a válasz vonatkozik, amikor a kérelem sikeres.The top-level object that the response includes when the request succeeds.
SpellSuggestionsSpellSuggestions Egy javasolt lekérdezési karakterláncot határoz meg, amely valószínűleg a felhasználó szándékát jelöli.Defines a suggested query string that likely represents the user's intent.
TextAttributionTextAttribution Meghatároz egy egyszerű szöveges hozzárendelésre vonatkozó szerződési szabályt.Defines a contractual rule for plain text attribution.
TimeZoneTimeZone Meghatározza egy vagy több földrajzi hely dátumát és időpontját.Defines the date and time of one or more geographic locations.
TimeZoneInformationTimeZoneInformation Meghatározza az időzóna-információkat egy földrajzi helyről.Defines the time zone information about a geographical location.
WebanswerWebAnswer Meghatározza a kapcsolódó weblap hivatkozásainak listáját.Defines a list of relevant webpage links.
WeblapWebpage A lekérdezéshez kapcsolódó weblap meghatározása.Defines a webpage that is relevant to the query.

EntitásEntity

Definiál egy entitást, például személyt, helyet vagy dolgot.Defines an entity such as a person, place, or thing.

NameName ÉrtékValue TípusType
bingIdbingId Egy azonosító, amely egyedileg azonosítja ezt az entitást.An ID that uniquely identifies this entity. SztringString
contractualRulescontractualRules Azon szabályok listája, amelyeket be kell tartania, ha megjeleníti az entitást.A list of rules that you must adhere to if you display the entity. Például a szabályok szabályozzák az entitás leírását.For example, the rules may govern attributing the entity's description.

A következő szerződéses szabályok vonatkozhatnak.The following contractual rules may apply.


Nem minden entitás tartalmaz szabályokat.Not all entities include rules. Ha az entitás szerződéses szabályokat biztosít, akkor azokat meg kell felelniük.If the entity provides contractual rules, you must abide by them. A szerződéses szabályok használatáról további információt az adatokkiosztása című témakörben talál.For more information about using contractual rules, see Attributing Data.
Objektum []Object[]
leírásdescription Az entitás rövid leírása.A short description of the entity. SztringString
entityPresentationInfoentityPresentationInfo További információ az entitás típusának meghatározásához használható entitásról (például a célzásokról).Additional information about the entity such as hints that you can use to determine the entity's type. Az entitás típusának meghatározásához használja a entityScenario és a entityTypeHint mezőket.To determine the entity's type, use the entityScenario and entityTypeHint fields. A mezők például segítenek megállapítani, hogy az entitás domináns vagy jelentős entitás-e, és hogy az adott személy vagy film-e.For example, the fields help you determine whether the entity is a dominant or disambiguation entity and whether it's a person or movie. Az entitás egy domináns entitás, ha a Bing úgy véli, hogy csak egy entitás teljesíti a kérelmet.The entity is a dominant entity if Bing believes that only one entity satisfies the request. Ha több entitás is kielégítheti a kérést, az entitás egy rendszerszintű entitás, és a felhasználónak ki kell választania azt az entitást, amelyre kíváncsiak.If multiple entities could satisfy the request, the entity is a disambiguation entity and the user needs to select the entity they're interested in. EntityPresentationInfoEntityPresentationInfo
imageimage Az entitás képe.An image of the entity. RendszerképImage
namename Az entitás neve.The entity's name. SztringString
webSearchUrlwebSearchUrl Az az URL-cím, amely a felhasználót az entitás Bing keresési eredmények lapjára viszi.The URL that takes the user to the Bing search results page for this entity. SztringString

EntityAnswerEntityAnswer

Az entitások válaszának meghatározása.Defines an entity answer.

NameName ÉrtékValue TípusType
queryScenarioqueryScenario A támogatott lekérdezési forgatókönyv.The supported query scenario. Ez a mező DominantEntity vagy DisambiguationItem értékre van beállítva.This field is set to DominantEntity or DisambiguationItem. A mező értéke DominantEntity, ha a Bing megállapítja, hogy csak egyetlen entitás teljesíti a kérelmet.The field is set to DominantEntity if Bing determines that only a single entity satisfies the request. Például egy könyv, film, személy vagy attrakció.For example, a book, movie, person, or attraction. Ha több entitás is kielégítheti a kérelmet, a mező értéke DisambiguationItem.If multiple entities could satisfy the request, the field is set to DisambiguationItem. Ha például a kérelem egy film-franchise általános címét használja, akkor az entitás típusa valószínűleg DisambiguationItem lesz.For example, if the request uses the generic title of a movie franchise, the entity's type would likely be DisambiguationItem. Ha azonban a kérelem egy adott címet ad meg a franchise-ból, az entitás típusa valószínűleg DominantEntity lesz.But, if the request specifies a specific title from the franchise, the entity's type would likely be DominantEntity. SztringString
valuevalue Az entitások listája.A list of entities. Entitás []Entity[]

EntityPresentationInfoEntityPresentationInfo

További információkat határoz meg az entitásokról, például a típusokra vonatkozó tippeket.Defines additional information about an entity such as type hints.

NameName ÉrtékValue TípusType
entityScenarioentityScenario A támogatott forgatókönyv.The supported scenario. SztringString
entityTypeDisplayHintentityTypeDisplayHint Az entitás-emlékeztető megjelenítési verziója.A display version of the entity hint. Ha például entityTypeHints az előadó, akkor ez a mező az amerikai énekesre állítható be.For example, if entityTypeHints is Artist, this field may be set to American Singer . SztringString
entityTypeHintentityTypeHint Az entitás típusát jelző célzások listája.A list of hints that indicate the entity's type. A lista tartalmazhat egy olyan emlékeztetőt, mint például a mozgókép vagy a tippek listája, például a Place, a LocalBusiness, az Restaurant.The list could contain a single hint such as Movie or a list of hints such as Place, LocalBusiness, Restaurant. Az egymást követő mutatók leszűkítik az entitás típusát.Each successive hint in the array narrows the entity's type.

A lehetséges típusok listáját lásd: entitások típusai.For a list of possible types, see Entity Types. Ha az objektum nem tartalmazza ezt a mezőt, a rendszer az általános feltételezést veszi figyelembe.If the object does not include this field, Generic is assumed.
Karakterlánc []String[]

SzámításiComputation

Definiál egy kifejezést és a hozzá tartozó választ.Defines an expression and its answer.

ElemElement LeírásDescription TípusType
kifejezésexpression A matematikai vagy átalakítási kifejezés.The math or conversion expression.

Ha a lekérdezés tartalmazza a mértékegységek átalakítására irányuló kérelmet (például a mérőórákat), ez a mező a from egységeket tartalmazza, és value tartalmazza a egységeket.If the query contains a request to convert units of measure (for example, meters to feet), this field contains the from units and value contains the to units.

Ha a lekérdezés matematikai kifejezést tartalmaz, például 2 + 2, ez a mező tartalmazza a kifejezést, és value tartalmazza a választ.If the query contains a mathematical expression such as 2+2, this field contains the expression and value contains the answer.

Vegye figyelembe, hogy a matematikai kifejezések normalizálása is lehetséges.Note that mathematical expressions may be normalized. Ha például a lekérdezés SQRT (4 ^ 2 + 8 ^ 2), a normalizált kifejezés lehet SQRT ((4 ^ 2) + (8 ^ 2)).For example, if the query was sqrt(4^2+8^2), the normalized expression may be sqrt((4^2)+(8^2)).

Ha a felhasználó lekérdezése matematikai kérdés, és a textDecorations lekérdezési paraméter értéke TRUE ( igaz ), a kifejezés karakterlánca tartalmazhat formázási jelölőket.If the user's query is a math question and the textDecorations query parameter is set to true , the expression string may include formatting markers. Ha például a felhasználó lekérdezése a log (2) , a normalizált kifejezés tartalmazza az alparancsfájl-jelölőket.For example, if the user's query is log(2) , the normalized expression includes the subscript markers. További információ: találatok kiemelése.For more information, see Hit Highlighting.
SztringString
értékvalue A kifejezés válasza.The expression's answer. SztringString

HibaError

Meghatározza a hiba előfordulását.Defines the error that occurred.

ElemElement LeírásDescription TípusType
kódcode A hiba kategóriáját azonosító hibakód.The error code that identifies the category of error. A lehetséges kódok listáját lásd: hibakódok.For a list of possible codes, see Error Codes. SztringString
üzenetetmessage A hiba leírása.A description of the error. SztringString
moreDetailsmoreDetails A hibával kapcsolatos további információkat biztosító leírás.A description that provides additional information about the error. SztringString
paraméterparameter A hibát okozó kérelem lekérdezési paramétere.The query parameter in the request that caused the error. SztringString
AlkódsubCode A hibát azonosító hibakód.The error code that identifies the error. Ha például code a InvalidRequest, subCode ParameterInvalid vagy ParameterInvalidValue lehet.For example, if code is InvalidRequest, subCode may be ParameterInvalid or ParameterInvalidValue. SztringString
értékvalue A lekérdezési paraméter értéke érvénytelen.The query parameter's value that was not valid. SztringString

ErrorResponseErrorResponse

Az a legfelső szintű objektum, amelyre a válasz vonatkozik, ha a kérelem meghiúsul.The top-level object that the response includes when the request fails.

NameName ÉrtékValue TípusType
_type_type Írja be a következőt: hint.Type hint. SztringString
hibákerrors Azon hibák listája, amelyek leírják, miért nem sikerült a kérelem végrehajtása.A list of errors that describe the reasons why the request failed. Hiba[]Error[]

AzonosíthatóIdentifiable

Meghatározza egy erőforrás identitását.Defines the identity of a resource.

NameName ÉrtékValue TípusType
idid Egy azonosító.An identifier. SztringString

KépImage

Definiál egy rendszerképet.Defines an image.

Megjegyzés

Mivel az URL-formátum és a paraméterek a figyelmeztetés nélkül változhatnak, az összes képurl-címet a következőként kell használni: az URL-formátumot vagy a paramétereket ne használja.Because the URL format and parameters are subject to change without notice, all image URLs should be used as-is; you should not take dependencies on the URL format or parameters. Ez alól kivételt képeznek a miniatűr képek átméretezése és körülvágásaáltal tárgyalt paraméterek és értékek.The exception is those parameters and values discussed by Resize and crop thumbnail images.

NameName ÉrtékValue TípusType
magasságheight A forrás képének magassága képpontban megadvaThe height of the source image, in pixels. Előjel nélküli rövidUnsigned Short
hostPageUrlhostPageUrl A képet tartalmazó weblap URL-címe.The URL of the webpage that includes the image.

Ez az URL-cím és lehet contentUrl ugyanaz az URL-cím.This URL and contentUrl may be the same URL.
SztringString
namename Egy nem kötelező szöveges karakterlánc, amely véletlenszerű adatokat tartalmaz a rendszerképről.An optional text string that contains random information about the image. SztringString
Szolgáltatóprovider A rendszerkép forrása.The source of the image. A tömb egyetlen elemmel fog szerepelni.The array will contain a single item.

A rendszerképet a szolgáltatóhoz kell rendelnie.You must attribute the image to the provider. Előfordulhat például, hogy a szolgáltató nevét jeleníti meg, amikor a kurzor a képen látható fölé viszi, vagy egy kattintásra mutató hivatkozást hoz a szolgáltató webhelyére, ahol a rendszerkép található.For example, you may display the provider's name as the cursor hovers over the image or make the image a click-through link to the provider's website where the image is found.
Szervezet[]Organization[]
thumbnailUrlthumbnailUrl A rendszerkép bélyegképének URL-címeThe URL to a thumbnail of the image. További információ a lemezkép átméretezéséről: miniatűr képek átméretezése és körülvágása.For information about resizing the image, see Resize and crop thumbnail images. SztringString
szélességwidth A forrás képének szélessége képpontban megadvaThe width of the source image, in pixels. Előjel nélküli rövidUnsigned Short

LicenseAttributionLicenseAttribution

Meghatároz egy szerződéses szabályt a licencek hozzárendeléséhez.Defines a contractual rule for license attribution.

NameName ÉrtékValue TípusType
_type_type Egy Type mutató, amely a LicenseAttribution értékre van állítva.A type hint, which is set to LicenseAttribution. SztringString
licenclicense A licenc, amely alatt a tartalom használható.The license under which the content may be used. LicencLicense
licenseNoticelicenseNotice A célként megadott mező mellett megjelenítendő licenc.The license to display next to the targeted field. Például: "szöveg a CC-BY-SA licenc alapján".For example, "Text under CC-BY-SA license".

A mezőben a licenc nevét és URL-címét használva license hozzon létre egy hiperhivatkozást a webhelyre, amely leírja a licenc részleteit.Use the license's name and URL in the license field to create a hyperlink to the website that describes the details of the license. Ezután cserélje le a licenc nevét a licenseNotice karakterláncban (például cc-by-SA) az imént létrehozott hiperhivatkozásra.Then, replace the license name in the licenseNotice string (for example, CC-BY-SA) with the hyperlink you just created.
SztringString
mustBeCloseToContentmustBeCloseToContent Logikai érték, amely meghatározza, hogy a szabály tartalmát a szabály hatálya alá eső mező közelében kell-e elhelyezni.A Boolean value that determines whether the contents of the rule must be placed in close proximity to the field that the rule applies to. Ha az értéke igaz , a tartalmat a közeli közelségbe kell helyezni.If true , the contents must be placed in close proximity. Ha false (hamis ) vagy ez a mező nem létezik, akkor a tartalom a hívó saját belátása szerint helyezhető el.If false , or this field does not exist, the contents may be placed at the caller's discretion. LogikaiBoolean
targetPropertyNametargetPropertyName Annak a mezőnek a neve, amelyre a szabály vonatkozik.The name of the field that the rule applies to. SztringString

LinkAttributionLinkAttribution

Egy szerződéses szabályt határoz meg a hivatkozás-hozzárendeléshez.Defines a contractual rule for link attribution.

NameName ÉrtékValue TípusType
_type_type Egy Type mutató, amely a LinkAttribution értékre van állítva.A type hint, which is set to LinkAttribution. SztringString
mustBeCloseToContentmustBeCloseToContent Logikai érték, amely meghatározza, hogy a szabály tartalmát a szabály hatálya alá eső mező közelében kell-e elhelyezni.A Boolean value that determines whether the contents of the rule must be placed in close proximity to the field that the rule applies to. Ha az értéke igaz , a tartalmat a közeli közelségbe kell helyezni.If true , the contents must be placed in close proximity. Ha false (hamis ) vagy ez a mező nem létezik, akkor a tartalom a hívó saját belátása szerint helyezhető el.If false , or this field does not exist, the contents may be placed at the caller's discretion. LogikaiBoolean
targetPropertyNametargetPropertyName Annak a mezőnek a neve, amelyre a szabály vonatkozik.The name of the field that the rule applies to.

Ha a cél nincs megadva, a hozzárendelés az entitás egészére vonatkozik, és az entitás megjelenítését közvetlenül követően kell megjeleníteni.If a target is not specified, the attribution applies to the entity as a whole and should be displayed immediately following the entity presentation. Ha több szöveges és csatolási hozzárendelési szabály is van, amelyek nem határoznak meg célt, fűzze össze őket, és jelenítse meg azokat a "adatok forrása:" címke használatával.If there are multiple text and link attribution rules that do not specify a target, you should concatenate them and display them using a "Data from: " label. Például: "a <szolgáltató name1 > | <Provider name2 származó adatok > ".For example, "Data from <provider name1> | <provider name2>".
SztringString
szövegtext A jóváírás szövege.The attribution text. SztringString
urlurl A szolgáltató webhelyének URL-címe.The URL to the provider's website. textHiperhivatkozás létrehozásához használja a és az URL-címet.Use text and URL to create of hyperlink. SztringString

MediaAttributionMediaAttribution

Meghatároz egy szerződéses szabályt a média-hozzárendeléshez.Defines a contractual rule for media attribution.

NameName ÉrtékValue TípusType
_type_type Egy Type mutató, amely a MediaAttribution értékre van állítva.A type hint, which is set to MediaAttribution. SztringString
mustBeCloseToContentmustBeCloseToContent Logikai érték, amely meghatározza, hogy a szabály tartalmát a szabály hatálya alá eső mező közelében kell-e elhelyezni.A Boolean value that determines whether the contents of the rule must be placed in close proximity to the field that the rule applies to. Ha az értéke igaz , a tartalmat a közeli közelségbe kell helyezni.If true , the contents must be placed in close proximity. Ha false (hamis ) vagy ez a mező nem létezik, akkor a tartalom a hívó saját belátása szerint helyezhető el.If false , or this field does not exist, the contents may be placed at the caller's discretion. LogikaiBoolean
targetPropertyNametargetPropertyName Annak a mezőnek a neve, amelyre a szabály vonatkozik.The name of the field that the rule applies to. SztringString
urlurl A médiatartalom hiperhivatkozásának létrehozásához használt URL-cím.The URL that you use to create of hyperlink of the media content. Ha például a cél egy rendszerkép, az URL-cím használatával kijelölheti a képet.For example, if the target is an image, you would use the URL to make the image clickable. SztringString

MetaTagMetaTag

Meghatározza a weblap metaadatait.Defines a webpage's metadata.

NameName ÉrtékValue TípusType
tartalomcontent A metaadatokat.The metadata. SztringString
namename A metaadatok neve.The name of the metadata. SztringString

SzervezetOrganization

Meghatározza a közzétevőt.Defines a publisher.

Vegye figyelembe, hogy a közzétevő megadhatja a nevét vagy a webhelyét, vagy mindkettőt.Note that a publisher may provide their name or their website or both.

NameName ÉrtékValue TípusType
namename A közzétevő neve.The publisher's name. SztringString
urlurl A közzétevő webhelyének URL-címe.The URL to the publisher's website.

Vegye figyelembe, hogy a közzétevő nem rendelkezhet webhellyel.Note that the publisher may not provide a website.
SztringString

LekérdezésQuery

Definiál egy keresési lekérdezést.Defines a search query.

A SpellSuggestions objektum ezt az objektumot használja arra, hogy egy lekérdezési karakterláncot javasoljon, amely valószínűleg a felhasználó szándékát jelöli.The SpellSuggestions object uses this object to suggest a query string that likely represents the user's intent. A RelatedSearchAnswer azt is felhasználja, hogy egy kapcsolódó lekérdezést ad vissza, amelyet más felhasználók tettek.It's also used by RelatedSearchAnswer to return a related query that other users have made.

NameName ÉrtékValue TípusType
SzövegdisplayText A lekérdezési kifejezés megjelenítési verziója.The display version of the query term. A lekérdezési kifejezés ezen verziója olyan speciális karaktereket tartalmazhat, amelyek kiemelik a lekérdezési karakterláncban található keresési kifejezést.This version of the query term may contain special characters that highlight the search term found in the query string. A karakterlánc csak akkor tartalmazza a kiemelési karaktereket, ha a lekérdezés engedélyezte a kiemelést (lásd a textDecorations lekérdezési paramétert).The string contains the highlighting characters only if the query enabled hit highlighting (see the textDecorations query parameter). A találatok kiemelésével kapcsolatos részletekért lásd: találatok kiemelése.For details about hit highlighting, see Hit Highlighting. SztringString
szövegtext A lekérdezési karakterlánc.The query string. Ezt a karakterláncot használja a lekérdezési kifejezésként egy új keresési kérelemben.Use this string as the query term in a new search request. SztringString
webSearchUrlwebSearchUrl Az URL-cím, amely a felhasználót a lekérdezés Bing keresési eredmények lapjára viszi.The URL that takes the user to the Bing search results page for the query.

Ebben a mezőben csak a kapcsolódó keresési eredmények szerepelnek.Only related search results include this field.
SztringString

QueryContextQueryContext

Meghatározza azt a lekérdezési karakterláncot, amelyet a Bing a kérelemhez használt.Defines the query string that Bing used for the request.

ElemElement LeírásDescription TípusType
adultIntentadultIntent Logikai érték, amely jelzi, hogy a megadott lekérdezésnek van-e felnőtt szándéka.A Boolean value that indicates whether the specified query has adult intent. Az érték igaz , ha a lekérdezés felnőtt szándékkal rendelkezik.The value is true if the query has adult intent.

Ha az értéke igaz , és a kérelem safeSearch lekérdezési paramétere szigorú értékre van állítva, a válasz csak a hírek eredményeit tartalmazza, ha van ilyen.If true , and the request's safeSearch query parameter is set to Strict, the response contain only news results, if applicable.
LogikaiBoolean
alterationOverrideQueryalterationOverrideQuery A lekérdezési karakterlánc, amely az eredeti sztring használatára kényszeríti a Bing használatát.The query string to use to force Bing to use the original string. Ha például a lekérdezési karakterlánc saling hátszél , a felülbírálás lekérdezési karakterlánca a + saling hátszél .For example, if the query string is saling downwind , the override query string is +saling downwind . Ne felejtse el kódolni a lekérdezési karakterláncot, amely a következőt eredményezi: % 2Bsaling + hátszél .Remember to encode the query string, which results in %2Bsaling+downwind .

az objektum csak akkor tartalmazza ezt a mezőt, ha az eredeti lekérdezési karakterlánc helyesírási hibát tartalmaz.the object includes this field only if the original query string contains a spelling mistake.
SztringString
alteredQueryalteredQuery Az a lekérdezési karakterlánc, amelyet a Bing a lekérdezés végrehajtásához használt.The query string that Bing used to perform the query. A Bing a megváltoztatott lekérdezési karakterláncot használja, ha az eredeti lekérdezési karakterlánc helyesírási hibákat foglalt le.Bing uses the altered query string if the original query string contained spelling mistakes. Ha például a lekérdezési karakterlánc saling downwind , a megváltoztatott lekérdezési karakterlánc sailing downwind .For example, if the query string is saling downwind, the altered query string is sailing downwind.

Az objektum csak akkor tartalmazza ezt a mezőt, ha az eredeti lekérdezési karakterlánc helyesírási hibát tartalmaz.The object includes this field only if the original query string contains a spelling mistake.
SztringString
askUserForLocationaskUserForLocation Logikai érték, amely azt jelzi, hogy a Bing megköveteli-e a felhasználó tartózkodási helyének pontos eredményének megadását.A Boolean value that indicates whether Bing requires the user's location to provide accurate results. Ha a felhasználó helyét az x-MSEdge-ügyfélip és az x-Search-Location fejlécek segítségével adta meg, akkor figyelmen kívül hagyhatja ezt a mezőt.If you specified the user's location by using the X-MSEdge-ClientIP and X-Search-Location headers, you can ignore this field.

A helyhez kapcsolódó lekérdezések, például a "mai időjárási viszonyok" vagy a "közeli éttermek", amelyeknek szükségük van a felhasználó tartózkodási helyének pontos eredményeinek megadására, ez a mező igaz értékre van állítva.For location aware queries, such as "today's weather" or "restaurants near me" that need the user's location to provide accurate results, this field is set to true .

A helyet (például "Seattle Weather") tartalmazó helyhez kapcsolódó lekérdezések esetén ez a mező hamis értékre van állítva.For location aware queries that include the location (for example, "Seattle weather"), this field is set to false . Ez a mező hamis értékre van állítva olyan lekérdezések esetén is, amelyek nem ismerik fel a helyeket, például a "legjobb eladók".This field is also set to false for queries that are not location aware, such as "best sellers."
LogikaiBoolean
originalQueryoriginalQuery A kérelemben megadott lekérdezési karakterlánc.The query string as specified in the request. SztringString

RankingGroupRankingGroup

Meghatározza a keresési eredmények csoportot, például a fővonalat.Defines a search results group, such as mainline.

NameName ÉrtékValue TípusType
elemekitems A csoportban megjelenítendő találati elemek listája.A list of search result items to display in the group. RankingItem[]RankingItem[]

RankingItemRankingItem

Meghatározza a megjelenítendő keresési eredmény-elemeket.Defines a search result item to display. További információ az azonosítók használatáról: a rangsorolás használata az eredmények megjelenítéséhez.For more information about how to use the IDs, see Using Ranking to Display Results.

NameName ÉrtékValue TípusType
answerTypeanswerType A megjelenítendő tételt tartalmazó válasz.The answer that contains the item to display. Például: Hírek.For example, News.

A típus használatával keresse meg a választ a SearchResponse objektumban.Use the type to find the answer in the SearchResponse object. A típus a SearchResponse mező neve.The type is the name of a SearchResponse field.
SztringString
resultIndexresultIndex A válaszban szereplő elem nulla alapú indexe.A zero-based index of the item in the answer.

Ha az elem nem tartalmazza ezt a mezőt, a válasz összes elemét megjeleníti.If the item does not include this field, display all items in the answer. Például megjelenítheti a hírek válaszában szereplő összes újságcikket.For example, display all news articles in the News answer.
Egész számInteger
értékvalue Az az azonosító, amely a megjelenítendő választ vagy egy válasz elemét azonosítja.The ID that identifies either an answer to display or an item of an answer to display. Ha az azonosító egy választ azonosít, a válasz összes elemét megjeleníti.If the ID identifies an answer, display all items of the answer. AzonosíthatóIdentifiable

RankingResponseRankingResponse

Meghatározza, hogy a keresési eredmények oldalának hol kell lennie, és milyen sorrendben kell elhelyezni a tartalmat.Defines where on the search results page content should be placed and in what order.

NameName ÉrtékValue TípusType
Mainlinemainline A keresési eredmények megjelennek a fővonalon.The search results to display in the mainline. RankingGroupRankingGroup
sarkpole A keresési eredményeknek meg kell adni a legjobban látható kezelést (például a fővonalon és az oldalsávon).The search results that should be afforded the most visible treatment (for example, displayed above the mainline and sidebar). RankingGroupRankingGroup
oldalsávsidebar Az oldalsávon megjelenítendő keresési eredmények.The search results to display in the sidebar. RankingGroupRankingGroup

RelatedSearchAnswerRelatedSearchAnswer

Meghatározza a mások által készített kapcsolódó lekérdezések listáját.Defines a list of related queries made by others.

NameName ÉrtékValue TípusType
idid Egy azonosító, amely egyedileg azonosítja a kapcsolódó keresési választ.An ID that uniquely identifies the related search answer.

Az objektum csak akkor tartalmazza ezt a mezőt, ha a rangsorolási válasz azt adja meg, hogy egy csoportban minden kapcsolódó keresés megjelenjen.The object includes this field only if the Ranking answer specifies that you display all related searches in a group. További információ az azonosító használatáról: rangsorolás használata az eredmények megjelenítéséhez.For more information about how to use the ID, see Using Ranking to Display Results.
SztringString
értékvalue A mások által készített kapcsolódó lekérdezések listája.A list of related queries that were made by others. Lekérdezés[]Query[]

SearchResponseSearchResponse

A válasz legfelső szintű objektuma a keresési kérelmekhez.The response's top-level object for search requests.

Alapértelmezés szerint a Search API minden választ tartalmaz, kivéve ha:By default, the Search API includes all answers unless:

  • A lekérdezés a responseFilter lekérdezési paramétert adja meg a válaszok korlátozásához.The query specifies the responseFilter query parameter to limit the answers

  • A keresési összetevők közül egy vagy több nem ad vissza eredményeket (például a lekérdezésre nem vonatkozik a hírek eredményei)One or more of the search components does not return results (for example, no news results are relevant to the query)

  • Az előfizetési kulcs nem fér hozzá a keresési összetevőhöz.The subscription key does not have access to the search component.

Ha a szolgáltatás feltételezi a szolgáltatás szolgáltatásmegtagadási támadását, a kérelem sikeres lesz (a HTTP-állapotkód 200 OK), de a válasz törzse üres.If the service suspects a denial of service attack, the request succeeds (HTTP status code is 200 OK), but the body of the response is empty.

NameName ÉrtékValue TípusType
_type_type Írja be a következőt: hint.Type hint. SztringString
számításicomputation A matematikai kifejezésekre vagy mértékegység-átalakítási kifejezésre adott válasz.The answer to a math expression or units conversion expression. SzámításiComputation
szervezetekentities A keresési lekérdezéshez kapcsolódó entitások listája.A list of entities that are relevant to the search query. EntityAnswerEntityAnswer
képekimages A keresési lekérdezéshez kapcsolódó rendszerképek listája.A list of images that are relevant to the search query. KépekImages
Híreknews A keresési lekérdezéshez kapcsolódó újságcikkek listája.A list of news articles that are relevant to the search query. HírekNews
queryContextqueryContext A kérelemhez használt Bing lekérdezési karakterlánca.The query string that Bing used for the request.

A válasz csak akkor tartalmazza a kontextust, ha a lekérdezési karakterlánc helyesírási hibát tartalmaz, vagy felnőtt szándékkal rendelkezik.The response includes the context only if the query string contains a spelling mistake or has adult intent.
QueryContextQueryContext
rankingResponserankingResponse A Bing azt sugallja, hogy a keresési eredményeket jeleníti meg a alkalmazásban.The order that Bing suggests that you display the search results in. RankingResponseRankingResponse
relatedSearchesrelatedSearches A mások által készített kapcsolódó lekérdezések listája.A list of related queries made by others. RelatedSearchAnswerRelatedSearchAnswer
spellSuggestionsspellSuggestions A felhasználó szándékát valószínűleg jelölő lekérdezési karakterlánc.The query string that likely represents the user's intent. SpellSuggestionsSpellSuggestions
timeZonetimeZone Egy vagy több földrajzi hely dátumát és időpontját.The date and time of one or more geographic locations. TimeZoneTimeZone
videókvideos A keresési lekérdezéshez kapcsolódó videók listája.A list of videos that are relevant to the search query. VideókVideos
WeblapokwebPages A keresési lekérdezéshez kapcsolódó weblapok listája.A list of webpages that are relevant to the search query. WebanswerWebAnswer

SpellSuggestionsSpellSuggestions

Egy javasolt lekérdezési karakterláncot határoz meg, amely valószínűleg a felhasználó szándékát jelöli.Defines a suggested query string that likely represents the user's intent.

A keresési eredmények közé tartozik ez a válasz, ha a Bing megállapítja, hogy a felhasználó egy másikat keres.The search results include this response if Bing determines that the user may have intended to search for something different. Ha például a felhasználó az Alon Brown kifejezésre keres rá, akkor a Bing azt is meghatározhatja, hogy a felhasználó valószínűleg Alton Brown-t keres, hanem az Alon Brown által végzett korábbi keresések alapján.For example, if the user searches for alon brown , Bing may determine that the user likely intended to search for Alton Brown instead (based on past searches by others of Alon Brown).

NameName ÉrtékValue TípusType
idid Egy azonosító, amely egyedileg azonosítja a helyesírási javaslat válaszát.An ID that uniquely identifies the spelling suggestion answer.

Ezt a mezőt akkor használja, ha a rangsorolási választ használja a helyesírási javaslatok megjelenítéséhez.You use this field when you use the ranking response to display the spelling suggestions. További információ az azonosító használatáról: rangsorolás használata az eredmények megjelenítéséhez.For more information about how to use the ID, see Using Ranking to Display Results.
SztringString
értékvalue Azon javasolt lekérdezési karakterláncok listája, amelyek a felhasználó szándékát jelezhetik.A list of suggested query strings that may represent the user's intention.

A lista csak egy Query objektumot tartalmaz.The list contains only one Query object.
Lekérdezés[]Query[]

TextAttributionTextAttribution

Meghatároz egy egyszerű szöveges hozzárendelésre vonatkozó szerződési szabályt.Defines a contractual rule for plain text attribution.

NameName ÉrtékValue TípusType
_type_type Egy Type mutató, amely a TextAttribution értékre van állítva.A type hint, which is set to TextAttribution. SztringString
szövegtext A jóváírás szövege.The attribution text.

A szöveges hozzárendelés az entitás egészére vonatkozik, és az entitások megjelenítését követően azonnal megjelenik.Text attribution applies to the entity as a whole and should be displayed immediately following the entity presentation. Ha több szöveges vagy hivatkozáshoz tartozó olyan szabály van, amely nem határoz meg célt, fűzze össze őket, és jelenítse meg őket "adatok forrása:" címkével.If there are multiple text or link attribution rules that do not specify a target, you should concatenate them and display them using a "Data from: " label.
SztringString

TimeZoneTimeZone

Meghatározza egy vagy több földrajzi hely mennyiségét és időpontját.Defines the data and time of one or more geographic locations.

NameName ÉrtékValue TípusType
otherCityTimesotherCityTimes A közeli időzónákhoz tartozó dátumok és időpontok listája.A list of dates and times of nearby time zones. TimeZoneInformation[]TimeZoneInformation[]
primaryCityTimeprimaryCityTime A lekérdezésben megadott földrajzi hely (UTC) szerinti érték és idő.The data and time, in UTC, of the geographic location specified in the query.

Ha a lekérdezés adott földrajzi helyet (például várost) adott meg, akkor ez az objektum tartalmazza a földrajzi hely nevét és a hely aktuális dátumát és időpontját (UTC).If the query specified a specific geographic location (for example, a city), this object contains the name of the geographic location and the current date and time of the location, in UTC.

Ha a lekérdezés általános földrajzi helyet (például államot vagy országot) adott meg, akkor ez az objektum tartalmazza a megadott államban vagy országban található elsődleges város vagy állam dátumát és időpontját.If the query specified a general geographic location, such as a state or country, this object contains the date and time of the primary city or state found in the specified state or country. Ha a hely további időzónákat tartalmaz, a otherCityTimes mező a többi időzónában található városok vagy Államok mennyiségét és időpontját tartalmazza.If the location contains additional time zones, the otherCityTimes field contains the data and time of cities or states located in the other time zones.
TimeZoneInformationTimeZoneInformation

TimeZoneInformationTimeZoneInformation

Meghatározza a földrajzi hely dátumát és időpontját.Defines a date and time for a geographical location.

NameName ÉrtékValue TípusType
helyenlocation A földrajzi hely neve.The name of the geographical location.

Például: megye; Város Város, állam; Város, állam, ország; vagy időzóna.For example, County; City; City, State; City, State, Country; or Time Zone.
SztringString
timetime Az űrlapon megadott idő, éééé-hh-NNTóó; PP: mm. ssssssZ.The data and time specified in the form, YYYY-MM-DDThh;mm:ss.ssssssZ. SztringString
utcOffsetutcOffset Az UTC szerinti eltolásThe offset from UTC. Például: UTC-7.For example, UTC-7. SztringString

WebanswerWebAnswer

Meghatározza a kapcsolódó weblap hivatkozásainak listáját.Defines a list of relevant webpage links.

NameName ÉrtékValue TípusType
idid Egy azonosító, amely egyedileg azonosítja a webes választ.An ID that uniquely identifies the web answer.

Az objektum csak akkor tartalmazza ezt a mezőt, ha a rangsorolási válasz azt javasolja, hogy az összes webes eredmény megjelenjen egy csoportban.The object includes this field only if the Ranking answer suggests that you display all web results in a group. További információ az azonosító használatáról: rangsorolás használata az eredmények megjelenítéséhez.For more information about how to use the ID, see Using Ranking to Display Results.
SztringString
someResultsRemovedsomeResultsRemoved Logikai érték, amely jelzi, hogy a válasz kizárta-e a válasz eredményét.A Boolean value that indicates whether the response excluded some results from the answer. Ha a Bing kizárta az eredményeket, az érték true (igaz ).If Bing excluded some results, the value is true . LogikaiBoolean
totalEstimatedMatchestotalEstimatedMatches A lekérdezéshez kapcsolódó weblapok becsült száma.The estimated number of webpages that are relevant to the query. Használja ezt a számot a Count és az eltolás lekérdezési paraméterekkel együtt a találatok oldalára.Use this number along with the count and offset query parameters to page the results. HosszúLong
értékvalue A lekérdezéshez kapcsolódó weblapok listája.A list of webpages that are relevant to the query. Weblap[]WebPage[]
webSearchUrlwebSearchUrl A kért weblapok Bing keresési eredményeinek URL-címe.The URL to the Bing search results for the requested webpages. SztringString

WeblapWebpage

A lekérdezéshez kapcsolódó weblap meghatározása.Defines a webpage that is relevant to the query.

NameName ÉrtékValue TípusType
névjegyabout Csak belső használatra.For internal use only. ObjektumObject
dateLastCrawleddateLastCrawled Az a legutóbb, amikor a Bing bejárta a weblapot.The last time that Bing crawled the webpage. A dátum a (z), éééé-hh-NNTÓÓ: PP: MM formátumú.The date is in the form, YYYY-MM-DDTHH:MM:SS. Például 2015-04-13T05:23:39.For example, 2015-04-13T05:23:39. SztringString
deepLinksdeepLinks Azon kapcsolódó tartalomra mutató hivatkozásokat tartalmazó lista, amelyek a weboldalt tartalmazó webhelyen találhatók.A list of links to related content that Bing found in the website that contains this webpage.

Az Webpage ebben a kontextusban található objektum csak a name ,, url urlPingSuffix és snippet mezőket tartalmazza.The Webpage object in this context includes only the name, url, urlPingSuffix, and snippet fields.
Weblap[]Webpage[]
displayUrldisplayUrl A weblap megjelenítésének URL-címeThe display URL of the webpage. Az URL-cím csak megjelenítési célokat szolgál, és nem megfelelően formázott.The URL is meant for display purposes only and is not well formed. SztringString
idid Egy azonosító, amely egyedileg azonosítja ezt a weblapot a webes találatok listájában.An ID that uniquely identifies this webpage in the list of web results.

Az objektum csak akkor tartalmazza ezt a mezőt, ha a rangsorolási válasz azt adja meg, hogy a weblapokat a többi keresési eredménnyel együtt kell összekeverni.The object includes this field only if the Ranking answer specifies that you mix the webpages with the other search results. Minden weblap tartalmaz egy azonosítót, amely megfelel a rangsorolási válaszban szereplő AZONOSÍTÓnak.Each webpage contains an ID that matches an ID in the Ranking answer. További információ: rangsorolás használata az eredmények megjelenítéséhez.For more information, see Using Ranking to Display Results.
SztringString
névname A weblap neve.The name of the webpage.

Ezt a nevet együtt használva url hozzon létre egy hiperhivatkozást, amely a kattintáskor a felhasználót a weblapra viszi.Use this name along with url to create a hyperlink that when clicked takes the user to the webpage.
SztringString
megemlítimentions Csak belső használatra.For internal use only. ObjektumObject
searchTagssearchTags Azon keresési címkék listája, amelyeknek a weblap tulajdonosa a weblapon szerepel.A list of search tags that the webpage owner specified on the webpage. Az API csak indexelt keresési címkéket ad vissza.The API returns only indexed search tags.

Az name objektum mezője MetaTag tartalmazza az indexelt keresési címkét.The name field of the MetaTag object contains the indexed search tag. A Címkék keresése a Search. * kifejezéssel kezdődik (például Search. assetId).Search tags begin with search.* (for example, search.assetId). A content mező tartalmazza a címke értékét.The content field contains the tag's value.
MetaTag[]MetaTag[]
részletsnippet A weboldalról származó szöveg, amely leírja annak tartalmát.A snippet of text from the webpage that describes its contents. SztringString
URLurl A weblap URL-címe.The URL to the webpage.

Használja ezt az URL-címet, és name hozzon létre egy hiperhivatkozást, amely a kattintáskor a felhasználót a weblapra viszi.Use this URL along with name to create a hyperlink that when clicked takes the user to the webpage.
SztringString

Entitások típusaiEntity Types

Ez a szakasz a lehetséges entitásokra mutató javaslatokat tartalmazza.This section contains the possible entity hints. A javaslatok az entitások kategóriája szerint vannak csoportosítva.The hints are grouped by category of entities.

Az alapentitások típusai a következők:The following are the base entity types.

  • ÁltalánosGeneric
  • SzemélyPerson
  • HelyPlace
  • MédiaMedia
  • SzervezetOrganization

A következőkben a hely alaptípusa alá eső entitás-útmutatók láthatók.The following are the entity hints that fall under the Place base type.

  • LátványosságAttraction
  • CityCity
  • KontinensContinent
  • OrszágCountry
  • SzállodaHotel
  • HázonHouse
  • LocalBusinessLocalBusiness
  • ElhelyezésLocality
  • MinorRegionMinorRegion
  • KörnyékénNeighborhood
  • EgyébOther
  • PointOfInterestPointOfInterest
  • IrányítószámPostalCode
  • RadioStationRadioStation
  • RegionRegion
  • ÉttermiRestaurant
  • ÁllamState
  • StreetAddressStreetAddress
  • RégióSubRegion
  • TouristAttractionTouristAttraction
  • UtazásTravel

A következőkben a média alaptípusa alá eső entitás-útmutatók láthatók.The following are the entity hints that fall under the Media base type.

  • KönyvBook
  • FilmMovie
  • TelevisionSeasonTelevisionSeason
  • TelevisionShowTelevisionShow
  • VideoGameVideoGame

Az eseményekkel kapcsolatos entitásokra vonatkozó útmutatók a következők.The following are the event-related entity hints.

  • EseményEvent

A szakmával kapcsolatos entitásokra vonatkozó útmutatók a következők.The following are the profession-related entity hints.

  • SzínészActor
  • Grafikusok módosítjákArtist
  • FőügyésziAttorney

A következők az oktatással kapcsolatos entitásokra vonatkozó útmutatók.The following are the education-related entity hints.

  • CollegeOrUniversityCollegeOrUniversity
  • IskolaiSchool
  • KülönlegesSpeciality

A következő nem kapcsolódó entitás-emlékeztetők.The following are unrelated entity hints.

  • ÁllatAnimal
  • AutóCar
  • FDADrug
  • ÉlelmiszerFood
  • TermékProduct
  • SportsTeamSportsTeam

HibakódokError codes

A kérelem által visszaadott lehetséges HTTP-állapotkódok a következők.The following are the possible HTTP status codes that a request returns.

ÁllapotkódStatus Code LeírásDescription
200200 Siker.Success.
400400 A lekérdezési paraméterek egyike hiányzik vagy érvénytelen.One of the query parameters is missing or not valid.
401401 Az előfizetési kulcs hiányzik vagy érvénytelen.The subscription key is missing or is not valid.
403403 A felhasználó hitelesítve van (például érvényes előfizetési kulcsot használtak), de nincs engedélye a kért erőforráshoz.The user is authenticated (for example, they used a valid subscription key) but they don’t have permission to the requested resource.

A Bing akkor is visszaadhatja ezt az állapotot, ha a hívó túllépte a havi kvótát.Bing may also return this status if the caller exceeded their queries per month quota.
410410 A kérelem HTTP protokollt használt a HTTPS protokoll helyett.The request used HTTP instead of the HTTPS protocol. A HTTPS az egyetlen támogatott protokoll.HTTPS is the only supported protocol.
429429 A hívó túllépte a másodpercenkénti lekérdezési kvótát.The caller exceeded their queries per second quota.
500500 Váratlan kiszolgálóhiba történt.Unexpected server error.

Ha a kérés sikertelen, a válasz egy ErrorResponse objektumot tartalmaz, amely a hibaobjektumok listáját tartalmazza, amelyek leírják, hogy mi okozta a hibát.If the request fails, the response contains an ErrorResponse object, which contains a list of Error objects that describe what caused of error. Ha a hiba egy paraméterhez parameter kapcsolódik, a mező azonosítja a problémát okozó paramétert.If the error is related to a parameter, the parameter field identifies the parameter that is the issue. És ha a hiba egy paraméterértékhez kapcsolódik, a value mező azonosítja az érvénytelen értéket.And if the error is related to a parameter value, the value field identifies the value that is not valid.

{
  "_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."
    }
  ]
}

A következőkben a lehetséges hibakód és alhibakód értékek találhatók.The following are the possible error code and sub-error code values.

KódCode AlkódSubCode LeírásDescription
KiszolgálóhibaServerError Váratlan hibaUnexpectedError
ErőforráshibaResourceError
Nincs megvalósítvaNotImplemented
A HTTP állapotkódja 500.HTTP status code is 500.
Érvénytelen kérelemInvalidRequest Paraméter hiányzikParameterMissing
ParameterInvalidValue értékParameterInvalidValue
HttpNem engedélyezettHttpNotAllowed
BlokkolvaBlocked
A Bing az InvalidRequest függvényt adja vissza, ha a kérés bármely része érvénytelen.Bing returns InvalidRequest whenever any part of the request is not valid. Például egy szükséges paraméter hiányzik, vagy egy paraméterérték érvénytelen.For example, a required parameter is missing or a parameter value is not valid.

Ha a hiba ParameterMissing vagy ParameterInvalidValue, a HTTP-állapotkód 400.If the error is ParameterMissing or ParameterInvalidValue, the HTTP status code is 400.

Ha https helyett a HTTP protokollt használja, a Bing a HttpNotAllowed értéket adja vissza, a HTTP-állapotkód pedig 410.If you use the HTTP protocol instead of HTTPS, Bing returns HttpNotAllowed, and the HTTP status code is 410.
RateLimitExceededRateLimitExceeded Nincsenek alkódokNo sub-codes A Bing visszaadja a RateLimitExceeded értéket, ha túllépi a lekérdezések másodpercenkénti (QPS) vagy lekérdezések havonta (QPM) kvótát.Bing returns RateLimitExceeded whenever you exceed your queries per second (QPS) or queries per month (QPM) quota.

Ha túllépi a QPS protokollt, a Bing a 429-es HTTP-állapotkódot adja vissza, és ha túllépi a QPM értéket, akkor a Bing 403 értéket ad vissza.If you exceed QPS, Bing returns HTTP status code 429, and if you exceed QPM, Bing returns 403.
InvalidAuthorization (Érvénytelen engedélyezés)InvalidAuthorization Engedély hiányzikAuthorizationMissing
EngedélyezésRedundancyAuthorizationRedundancy
A Bing invalidAuthorization értéket ad vissza, ha a Bing nem tudja hitelesíteni a hívót.Bing returns InvalidAuthorization when Bing cannot authenticate the caller. Például a Ocp-Apim-Subscription-Key fejléc hiányzik, vagy az előfizetési kulcs érvénytelen.For example, the Ocp-Apim-Subscription-Key header is missing or the subscription key is not valid.

A redundancia akkor következik be, ha egynél több hitelesítési módszert ad meg.Redundancy occurs if you specify more than one authentication method.

Ha a hiba InvalidAuthorization, a HTTP-állapotkód 401.If the error is InvalidAuthorization, the HTTP status code is 401.
Elégtelen engedélyezésInsufficientAuthorization EngedélyezésletiltvaAuthorizationDisabled
Engedélyezés LejártAuthorizationExpired
A Bing nem licencet ad vissza, ha a hívónak nincs engedélye az erőforrás eléréséhez.Bing returns InsufficientAuthorization when the caller does not have permissions to access the resource. Ez akkor fordulhat elő, ha az előfizetési kulcs le van tiltva, vagy lejárt.This can occur if the subscription key has been disabled or has expired.

Ha a hiba insufficientAuthorization, a HTTP-állapotkód 403.If the error is InsufficientAuthorization, the HTTP status code is 403.

Piaci kódokMarket codes

Az alábbi táblázat a mkt lekérdezési paraméter megadásához használható piaci kódértékeket sorolja fel.The following table lists the market code values that you may use to specify the mkt query parameter. A Bing csak ezekre a piacokra visszaküld idét.Bing returns content for only these markets. A lista változhat.The list is subject to change.

A lekérdezési paraméterben megadott országkódok cc listáját az Országkódok című témakörben találja.For a list of country codes that you may specify in the cc query parameter, see Country codes.

Ország/régióCountry/Region NyelvLanguage Piaci kódMarket code
ArgentínaArgentina SpanyolSpanish es-ARes-AR
AusztráliaAustralia AngolEnglish en-AUen-AU
AusztriaAustria NémetGerman de-ATde-AT
BelgiumBelgium HollandDutch nl-BEnl-BE
BelgiumBelgium FranciaFrench fr-BEfr-BE
BrazíliaBrazil PortugálPortuguese pt-BRpt-BR
KanadaCanada AngolEnglish en-CAen-CA
KanadaCanada FranciaFrench fr-CAfr-CA
ChileChile SpanyolSpanish es-CLes-CL
DániaDenmark DánDanish da-DKda-DK
FinnországFinland FinnFinnish fi-FIfi-FI
FranciaországFrance FranciaFrench fr-FRfr-FR
NémetországGermany NémetGerman de-DEde-DE
Hongkong (KKT)Hong Kong SAR Kínai (hagyományos)Traditional Chinese zh-HKzh-HK
IndiaIndia AngolEnglish en-INen-IN
IndonéziaIndonesia AngolEnglish en-IDen-ID
OlaszországItaly OlaszItalian it-ITit-IT
JapánJapan JapánJapanese ja-JPja-JP
Dél-KoreaKorea KoreaiKorean ko-KRko-KR
MalajziaMalaysia AngolEnglish hu-ÉNen-MY
MexikóMexico SpanyolSpanish es-MXes-MX
HollandiaNetherlands HollandDutch nl-NLnl-NL
Új-ZélandNew Zealand AngolEnglish en-NZen-NZ
NorvégiaNorway NorvégNorwegian no-NOno-NO
Kínai NépköztársaságPeople's republic of China KínaiChinese zh-CNzh-CN
LengyelországPoland LengyelPolish pl-PLpl-PL
Fülöp-szigeteki KöztársaságRepublic of the Philippines AngolEnglish en-PHen-PH
OroszországRussia OroszRussian ru-RUru-RU
Dél-afrikai KöztársaságSouth Africa AngolEnglish en-ZAen-ZA
SpanyolországSpain SpanyolSpanish es-ESes-ES
SvédországSweden SvédSwedish sv-SEsv-SE
SvájcSwitzerland FranciaFrench fr-CHfr-CH
SvájcSwitzerland NémetGerman de-CHde-CH
TajvanTaiwan Kínai (hagyományos)Traditional Chinese zh-TWzh-TW
TörökországTurkey TörökTurkish tr-TRtr-TR
Egyesült KirályságUnited Kingdom AngolEnglish hu-GBen-GB
Egyesült ÁllamokUnited States AngolEnglish en-USen-US
Egyesült ÁllamokUnited States SpanyolSpanish es-USes-US

OrszágkódokCountry codes

A cc lekérdezési paraméterben megadott országkódok az alábbiakban találhatók.The following are the country codes that you may specify in the cc query parameter. A lista változhat.The list is subject to change.

Ország/régióCountry/Region OrszágkódCountry Code
ArgentínaArgentina ARAR
AusztráliaAustralia AUAU
AusztriaAustria ATAT
BelgiumBelgium BEBE
BrazíliaBrazil BRBR
KanadaCanada CACA
ChileChile CLCL
DániaDenmark DKDK
FinnországFinland FIFI
FranciaországFrance JKFR
NémetországGermany DEDE
Hongkong (KKT)Hong Kong SAR HKHK
IndiaIndia ININ
IndonéziaIndonesia ID (Azonosító)ID
OlaszországItaly ITIT
JapánJapan JPJP
Dél-KoreaKorea KRKR
MalajziaMalaysia MYMY
MexikóMexico MXMX
HollandiaNetherlands NLNL
Új-ZélandNew Zealand NZNZ
NorvégiaNorway NONO
Kínai NépköztársaságPeople's Republic of China CNCN
LengyelországPoland PLPL
PortugáliaPortugal PTPT
Fülöp-szigeteki KöztársaságRepublic of the Philippines PHPH
OroszországRussia RURU
Szaúd-ArábiaSaudi Arabia SASA
Dél-afrikai KöztársaságSouth Africa ZAZA
SpanyolországSpain ESES
SvédországSweden SESE
SvájcSwitzerland CHCH
TajvanTaiwan TWTW
TörökországTurkey TRTR
Egyesült KirályságUnited Kingdom GBGB
Egyesült ÁllamokUnited States USAUS

Bing által támogatott nyelvekBing supported languages

A bing által támogatott nyelvek a setLang query paraméterben megadhatók.The following are the Bing supported languages that you may specify in the setLang query parameter. A lista változhat.The list is subject to change.

Támogatott nyelvekSupported Languages NyelvkódLanguage Code
ArabArabic Arar
BaszkBasque Eueu
bengáliBengali Bnbn
BolgárBulgarian Bgbg
KatalánCatalan Caca
Kínai (egyszerűsített)Chinese (Simplified) zh-hans közöttzh-hans
Kínai (hagyományos)Chinese (Traditional) zh-hant közöttzh-hant
HorvátCroatian hrhr
CsehCzech Cscs
DánDanish Dada
HollandDutch Nlnl
AngolEnglish huen
Angol-Egyesült KirályságEnglish-United Kingdom en-gben-gb
ÉsztEstonian etet
FinnFinnish Fifi
FranciaFrench Frfr
GallegoGalician Glgl
NémetGerman de dede
gudzsarátiGujarati Gugu
HéberHebrew Őhe
HindiHindi sziahi
MagyarHungarian huhu
IzlandiIcelandic egyenlőis
OlaszItalian ezit
JapánJapanese Jpjp
kannadaKannada knkn
KoreaiKorean Koko
LettLatvian Lvlv
LitvánLithuanian Hadnagylt
MalájMalay Msms
malajálamMalayalam  Mlml
marathiMarathi Mrmr
Norvég (bokmål)Norwegian (Bokmål) Nbnb
LengyelPolish Plpl
Portugál (Brazília)Portuguese (Brazil) pt-brpt-br
Portugál (Portugália)Portuguese (Portugal) pt-ptpt-pt
pandzsábiPunjabi Papa
RománRomanian Roro
OroszRussian Ruru
Szerb (ciklikus)Serbian (Cyrylic) Srsr
SzlovákSlovak Sksk
SzlovénSlovenian Slsl
SpanyolSpanish Igenes
SvédSwedish Svsv
tamilTamil Tata
teluguTelugu tete
ThaiThai Thth
TörökTurkish Trtr
UkránUkrainian ukuk
VietnamiVietnamese Vivi