Images - Visual Search

  • Referencia
Service:
Cognitive Services
API Version:
1.0

A Visual Search API segítségével betekintést nyerhet egy képbe, például a vizuálisan hasonló képekbe, a vásárlási forrásokba és a kapcsolódó keresésekbe. Az API képes szövegfelismerésre, entitások (személyek, helyek, dolgok) azonosítására, a felhasználó által feltárandó egyéb aktuális tartalmak visszaadására és sok másra is. További információt a Visual Search áttekintésében talál.

POST {Endpoint}/bing/v7.0/images/visualsearch
With optional parameters: 
POST {Endpoint}/bing/v7.0/images/visualsearch?mkt={mkt}&safeSearch={safeSearch}&setLang={setLang}

URI-paraméterek

Name In Required Type Description
Endpoint
 path True
  • string

Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: "https://westus.api.cognitive.microsoft.com", "https://api.cognitive.microsoft.com").
mkt
 query
  • string

A piac, ahonnan az eredmények származnak. Az mkt általában az az ország, ahonnan a felhasználó kérést küld. Azonban más ország is lehet, ha a felhasználó nem olyan országban található, ahol Bing eredményeket ad. A piacnak formában kell lennie. Például: en-US. A sztring nem megkülönbözteti a kis- és nagybetűket. A lehetséges piaci értékek listáját a piaci kódokban találja. MEGJEGYZÉS: Ha ismert, javasoljuk, hogy mindig adja meg a piacot. Ha megadja a piacot, azzal elősegíti, hogy a Bing a kérelmet továbbítva megfelelő, optimális választ adjon vissza. Ha olyan piacot ad meg, amely nem szerepel a piaci kódok között, Bing a legjobban illeszkedő piaci kódot használja egy olyan belső leképezés alapján, amely változhat.
safeSearch
 query

Szűrje a képeredményeket olyan műveletekben, amelyek "VisualSearch" típusúak a felnőtt tartalomhoz. A lehetséges szűrőértékek a következők. Kikapcsolva: Felnőtt tartalommal rendelkező képeket adhat vissza. Mérsékelt: Ne ad vissza felnőtt tartalommal rendelkező képeket. Szigorú: Ne ad vissza felnőtt tartalommal rendelkező képeket. Az alapértelmezett érték a Moderate. Ha a kérés olyan piacról érkezik, amely Bing felnőtt házirendje megköveteli, hogy a safeSearch értéke Strict legyen, Bing figyelmen kívül hagyja a safeSearch értéket, és a Strict értéket használja. Ha a webhelyet használja: szűrjön a tudáskérelemben, előfordulhat, hogy a válasz felnőtt tartalmat tartalmaz, függetlenül attól, hogy a safeSearch lekérdezési paraméter mire van beállítva. Webhely használata: csak akkor, ha tisztában van a webhelyen található tartalommal, és a forgatókönyv támogatja a felnőtt tartalom lehetőségét.
setLang
 query
  • string

A felhasználói felület sztringjeihez használni kívánt nyelv. A nyelv megadásához használja az ISO 639-1 kétbetűs nyelvkódját. Az angol nyelv nyelvkódja például az EN. Az alapértelmezett érték az EN (angol). Bár nem kötelező, javasoljuk, hogy mindig adja meg a nyelvet. A SetLang beállítást általában az mkt által megadott nyelvre kell beállítania, hacsak a felhasználó nem szeretné, hogy a felhasználói felület sztringjei más nyelven jelenjenek meg. A felhasználóifelület-sztring egy olyan sztring, amelyet feliratként használnak a felhasználói felületen. A JSON-válaszobjektumok tartalmaznak néhány felhasználóifelület-sztringet. A válaszobjektumokban található, a Bing.com tulajdonságaira mutató hivatkozások is a megadott nyelvet alkalmazzák.

Kérelem fejléce

Media Types: "multipart/form-data", "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string
X-BingApis-SDK True

Aktiválja a Swagger-megfelelőséget.
Accept
  • string

Az alapértelmezett médiatípus az application/json. Ha meg szeretné adni, hogy a válasz JSON-LD-t használjon, állítsa az Elfogadás fejlécet az application/ld+json értékre.
Accept-Language
  • string

A felhasználói felületi sztringekhez használandó nyelvek vesszővel tagolt listája. A lista prioritás szerinti csökkenő sorrendben jelenik meg. További információ, beleértve a várt formátumot is, lásd: RFC2616. Ez a fejléc és a setLang lekérdezési paraméter kölcsönösen kizárja egymást; ne adja meg mindkettőt. Ha beállítja ezt a fejlécet, akkor a cc lekérdezési paramétert is meg kell adnia. Annak meghatározásához, hogy melyik piacnak kell visszaadnia az eredményeket, Bing a listából talált első támogatott nyelvet használja, és kombinálja a cc paraméter értékével. 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. A Bing által használt piac meghatározásához tekintse meg a BingAPIs-Market fejlécet. Ezt a fejlécet és a másolatot kap lekérdezési paramétert csak akkor használja, ha több nyelvet ad meg. Ellenkező esetben használja az mkt és a setLang lekérdezési paramétereket. A felhasználóifelület-sztring egy olyan sztring, amelyet feliratként használnak a felhasználói felületen. A JSON-válaszobjektumok tartalmaznak néhány felhasználóifelület-sztringet. A válaszobjektumokban található, a Bing.com tulajdonságaira mutató hivatkozások a megadott nyelvet alkalmazzák.
Content-Type
  • string

Többrészes/űrlap-adatokra kell állítani, és tartalmaznia kell egy határparamétert (például többrészes/űrlap-adatok; boundary=). További részletekért tekintse meg a Tartalom űrlaptípusokat.
User-Agent
  • string

A kérelmet küldő felhasználói ügynök. A Bing arra használja a felhasználói ügynököt, hogy optimalizált élményt nyújtson a mobilfelhasználóknak. Bár nem kötelező, javasoljuk, hogy mindig adja meg ezt a fejlécet. A felhasználói ügynöknek a gyakran használt böngészők által küldött sztringgel megegyezőnek kell lennie. A felhasználói ügynökökkel kapcsolatos információért lásd: RFC 2616. Az alábbiakban példákat láthat a felhasználóiügynök-sztringekre. Windows Phone-telefon: Mozilla/5.0 (kompatibilis; MSIE 10.0; Windows Phone-telefon 8.0; Trident/6.0; IEMobile/10.0; ARM; Érintés; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - us; SCH - I500 Build / MÉZESKALÁCS) AppleWebKit / 533.1 (KHTML; like Gecko) Verzió / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1, mint a 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; Érintés; rv:11.0) mint Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0, mint a Mac OS X) AppleWebKit / 537.51.1 (KHTML, mint a Gecko) Verzió / 7.0 Mobile / 11A465 Safari / 9537.53.
X-MSEdge-ClientID
  • string

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. 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. 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. Az ütköző tesztcsomagok hozzárendelése inkonzisztens felhasználói élményhez vezethet. 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. A Bing arra is felhasználhatja az ügyfél-azonosítót, hogy az ügyfél-azonosító keresési előzményeire szabja a webes találatokat, gazdagabb élményt nyújtva a felhasználónak. 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. 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. FONTOS: Bár nem kötelező, javasoljuk, hogy tekintse annak ezt a fejlécet. 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. 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. 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. 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. 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. Őrizze meg az ügyfél-azonosítót. 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. Ne használjon munkamenet-cookie-t. 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. 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. Bing válaszok tartalmazhatják ezt a fejlécet. 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. FIGYELEM: Győződjön meg arról, hogy ez az ügyfél-azonosító nem csatolható hitelesíthető felhasználói fiókadatokhoz. Ha az X-MSEdge-ClientID azonosítót is tartalmazza, nem tartalmazhat cookie-kat a kérésben.
X-MSEdge-ClientIP
  • string

Az ügyféleszköz IPv4- vagy IPv6-címe. Az IP-cím a felhasználó tartózkodási helyének felderítésére szolgál. A Bing arra használja a helyadatokat, hogy meghatározza a biztonságos keresés viselkedését. Bár nem kötelező, javasoljuk, hogy mindig adja meg ezt a fejlécet és az X-Search-Location fejlécet. Ne rejtse el a címet (például úgy, hogy 0-ra módosítja az utolsó oktettet). 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.
X-Search-Location
  • string

Kulcs/érték párok pontosvesszővel elválasztott listája, amely leírja az ügyfél földrajzi helyét. 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. Adja meg a kulcs/érték párt a következőként: :. Az alábbiakban láthatja a felhasználó tartózkodási helyének megadására használt kulcsokat. lat (kötelező): Az ügyfél helyének szélessége fokban. A földrajzi szélesség nem lehet -90,0 foknál kisebb és +90,0 foknál nagyobb. A negatív értékek a déli szélességeket, a pozitív értékek pedig az északi szélességeket jelölik. long (kötelező): Az ügyfél helyének hosszúsága fokban. A földrajzi hosszúság nem lehet -180,0 foknál kisebb és +180,0 foknál nagyobb. A negatív értékek a nyugati hosszúságokat, a pozitív értékek pedig a keleti hosszúságokat jelölik. re (kötelező): A sugár, mérőben, amely a koordináták vízszintes pontosságát határozza meg. Adja át az eszköz helymeghatározási szolgáltatása által visszaadott értéket. 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. ts (nem kötelező): Az UTC UNIX időbélyegzője, amikor az ügyfél a helyszínen volt. (A UNIX időbélyeg az 1970. január 1. óta eltelt másodpercek száma.) (nem kötelező): Az ügyfél relatív címsora vagy utazási iránya. 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. Csak akkor adja meg ezt a kulcsot, ha az sp kulcs nem nulla. sp (nem kötelező): A vízszintes sebesség (sebesség), méterben másodpercenként, hogy az ügyféleszköz utazik. alt (nem kötelező): Az ügyféleszköz magassága méterben. (nem kötelező): A koordináták függőleges pontosságát mérőben megadó sugár. Csak akkor adja meg ezt a kulcsot, ha a helyettesítő kulcsot adja meg. Bár a kulcsok nagy része nem kötelező, minél több információt ad meg, annál pontosabbak a helyeredmények. Bár nem kötelező, javasoljuk, hogy mindig adja meg a felhasználó földrajzi helyét. 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). Az optimális eredmény érdekében foglalja bele a kérelembe ezt a fejlécet és az X-MSEdge-ClientIP fejlécet, de legalább ezt a fejlécet.

Válaszok

Name Type Description
200 OK

Sikeres művelet.
Other Status Codes

Hiba történt. További részletekért tekintse meg a válasz típusát és/vagy az állapotkódot.

Biztonság

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Példák

Sample Request

POST {Endpoint}/bing/v7.0/images/visualsearch

Sample Response

Status code:
200 
{
  "_type": "ImageKnowledge",
  "tags": [
    {
      "image": {
        "thumbnailUrl": "https://tse4.mm.bing.net/th?q=Space+Needle&pid=Api&mkt=en-US&adlt=moderate"
      },
      "displayName": "Space Needle",
      "boundingBox": {
        "queryRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        },
        "displayRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        }
      },
      "actions": [
        {
          "_type": "ImageAction",
          "actionType": "ImageById",
          "image": {
            "webSearchUrl": "https://www.bing.com/images/search?view=detailv2&FORM=OIIRPO",
            "name": "",
            "contentUrl": "https://assets0.roadtrippers.com/uploads/poi_gallery_image/image/319703805/-quality_60_-interlace_Plane_-resize_1024x480_U__-gravity_center_-extent_1024x480/poi_gallery_image-image-9e436dcb-f4af-4965-9fd6-d526b1af1758.jpg",
            "hostPageUrl": "https://assets0.roadtrippers.com/uploads/poi_gallery_image/image/319703805/-quality_60_-interlace_Plane_-resize_1024x480_U__-gravity_center_-extent_1024x480/poi_gallery_image-image-9e436dcb-f4af-4965-9fd6-d526b1af1758.jpg",
            "contentSize": "47157 B",
            "encodingFormat": "jpeg",
            "hostPageDisplayUrl": "https://assets0.roadtrippers.com/uploads/poi_gallery_image/image/319703805/-quality_60_-interlace_Plane_-resize_1024x480_U__-gravity_center_-extent_1024x480/poi_gallery_image-image-9e436dcb-f4af-4965-9fd6-d526b1af1758.jpg",
            "width": 1024,
            "height": 480,
            "thumbnail": {
              "width": 0,
              "height": 0
            },
            "accentColor": "31749A"
          }
        }
      ]
    },
    {
      "image": {
        "thumbnailUrl": "https://tse4.mm.bing.net/th?q=city&pid=Api&mkt=en-US&adlt=moderate"
      },
      "displayName": "city",
      "boundingBox": {
        "queryRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        },
        "displayRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        }
      },
      "actions": [
        {
          "_type": "ImageAction",
          "webSearchUrl": "https://www.bing.com/images/search?q=city",
          "displayName": "city",
          "serviceUrl": "https://www.bing.com/api/v7/images/search?q=city",
          "actionType": "ImageResults"
        }
      ]
    }
  ],
  "image": {
    "imageInsightsToken": "ccid_5raYvpmc*mid_28189CE73748FE8CB0AB80F7B377C4DA64EA132E"
  }
}

Definíciók

AggregateOffer

A képhez kapcsolódó kereskedőktől származó ajánlatok listáját határozza meg.
AggregateRating

Meghatározza azokat a metrikákat, amelyek azt jelzik, hogy mások milyen jól értékelték az elemeket.
Currency

A pénzügyi pénznem. Például USD.
Error

Meghatározza a bekövetkezett hibát.
ErrorCode

A hibakategóriát azonosító hibakód.
ErrorResponse

A sikertelen kérést jelző legfelső szintű válasz.
ErrorSubCode

A hibakód, amely további segítséget nyújt a hiba azonosításában.
ImageEntityAction

Entitásműveletet definiál.
ImageKnowledge

Vizuális keresési API-választ definiál.
ImageModuleAction

Definiál egy képlista-műveletet.
ImageObject

Definiál egy képet.
ImageRecipesAction

Egy receptműveletet definiál.
ImageRelatedSearchesAction

Egy kapcsolódó keresési műveletet definiál.
ImageShoppingSourcesAction

Egy vásárlási forrást definiáló műveletet határoz meg.
ImagesImageMetadata

Meghatározza azoknak a webhelyeknek a számát, ahol vásárolhat vagy végrehajthat a képpel kapcsolatos egyéb műveleteket.
ImagesModule

Meghatározza a képek listáját.
ImageTag

Vizuális keresési címke.
ImageTagRegion

Az ImageTaghez kapcsolódó képterületet definiál.
ItemAvailability

Az elem rendelkezésre állása. A lehetséges értékek a következők: Discontinued, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.
NormalizedQuadrilateral

Egy kép egy régióját határozza meg. A régió egy konvex quadrilateral, amelyet a bal felső, a jobb felső, a bal alsó és a jobb alsó pontok koordinátái határoznak meg. A koordináták az eredeti kép szélességének és magasságának tört értékei a 0,0 és 1,0 közötti tartományban.
Offer

Meghatározza egy kereskedő ajánlatát.
Organization

Definiál egy szervezetet.
Point2D

Kétdimenziós pontot definiál X és Y koordinátákkal.
Query

Keresési lekérdezést definiál.
Recipe

Egy főzési receptet határoz meg.
RecipesModule

A receptek listáját határozza meg.
RelatedSearchesModule

A kapcsolódó keresések listáját határozza meg.
SafeSearch

Szűrje a képeredményeket olyan műveletekben, amelyek "VisualSearch" típusúak a felnőtt tartalomhoz. A lehetséges szűrőértékek a következők. Kikapcsolva: Felnőtt tartalommal rendelkező képeket adhat vissza. Mérsékelt: Ne ad vissza felnőtt tartalommal rendelkező képeket. Szigorú: Ne ad vissza felnőtt tartalommal rendelkező képeket. Az alapértelmezett érték a Moderate. Ha a kérés olyan piacról érkezik, amely Bing felnőtt házirendje megköveteli, hogy a safeSearch értéke Strict legyen, Bing figyelmen kívül hagyja a safeSearch értéket, és a Strict értéket használja. Ha a webhelyet használja: szűrjön a tudáskérelemben, előfordulhat, hogy a válasz felnőtt tartalmat tartalmaz, függetlenül attól, hogy a safeSearch lekérdezési paraméter mire van beállítva. Webhely használata: csak akkor, ha tisztában van a webhelyen található tartalommal, és a forgatókönyv támogatja a felnőtt tartalom lehetőségét.
Thing

Definiál egy dolgot.
XBingApisSDK

Aktiválja a Swagger-megfelelőséget.

AggregateOffer

A képhez kapcsolódó kereskedőktől származó ajánlatok listáját határozza meg.

Name Type Default Value Description
aggregateRating

Összesített minősítés, amely azt jelzi, hogy mások milyen jól értékelték a terméket.
availability

Az elem rendelkezésre állása. A lehetséges értékek a következők: Discontinued, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.
lastUpdated
  • string

Az ajánlat utolsó frissítésének dátuma. A dátum ÉÉÉÉ-HH-NN formátumban van.
offers

A kereskedőktől származó ajánlatok listája, amelyek a képhez kapcsolódó ajánlatokkal rendelkeznek.
price
  • number

A cikk ára.
priceCurrency USD

A pénzügyi pénznem. Például: USD.
seller

Az ajánlat eladója.

AggregateRating

Meghatározza azokat a metrikákat, amelyek azt jelzik, hogy mások milyen jól értékelték az elemeket.

Name Type Description
_type string:
  • Properties/Item
bestRating
  • number

A legmagasabb minősítésű felülvizsgálat. A lehetséges értékek 1,0 és 5,0 között vannak.
ratingValue
  • number

A középérték (átlag) minősítése. A lehetséges értékek 1,0 és 5,0 között vannak.
reviewCount
  • integer

A recept minősítésének vagy felülvizsgálatának száma.
text
  • string

Egy elem szöveges ábrázolása.

Currency

A pénzügyi pénznem. Például USD.

Name Type Description
AED
  • string
AFN
  • string
ALL
  • string
AMD
  • string
ANG
  • string
AOA
  • string
ARS
  • string
AUD
  • string
AWG
  • string
AZN
  • string
BAM
  • string
BBD
  • string
BDT
  • string
BGN
  • string
BHD
  • string
BIF
  • string
BMD
  • string
BND
  • string
BOB
  • string
BOV
  • string
BRL
  • string
BSD
  • string
BTN
  • string
BWP
  • string
BYR
  • string
BZD
  • string
CAD
  • string
CDF
  • string
CHE
  • string
CHF
  • string
CHW
  • string
CLF
  • string
CLP
  • string
CNY
  • string
COP
  • string
COU
  • string
CRC
  • string
CUC
  • string
CUP
  • string
CVE
  • string
CZK
  • string
DJF
  • string
DKK
  • string
DOP
  • string
DZD
  • string
EGP
  • string
ERN
  • string
ETB
  • string
EUR
  • string
FJD
  • string
FKP
  • string
GBP
  • string
GEL
  • string
GHS
  • string
GIP
  • string
GMD
  • string
GNF
  • string
GTQ
  • string
GYD
  • string
HKD
  • string
HNL
  • string
HRK
  • string
HTG
  • string
HUF
  • string
IDR
  • string
ILS
  • string
INR
  • string
IQD
  • string
IRR
  • string
ISK
  • string
JMD
  • string
JOD
  • string
JPY
  • string
KES
  • string
KGS
  • string
KHR
  • string
KMF
  • string
KPW
  • string
KRW
  • string
KWD
  • string
KYD
  • string
KZT
  • string
LAK
  • string
LBP
  • string
LKR
  • string
LRD
  • string
LSL
  • string
LYD
  • string
MAD
  • string
MDL
  • string
MGA
  • string
MKD
  • string
MMK
  • string
MNT
  • string
MOP
  • string
MRO
  • string
MUR
  • string
MVR
  • string
MWK
  • string
MXN
  • string
MXV
  • string
MYR
  • string
MZN
  • string
NAD
  • string
NGN
  • string
NIO
  • string
NOK
  • string
NPR
  • string
NZD
  • string
OMR
  • string
PAB
  • string
PEN
  • string
PGK
  • string
PHP
  • string
PKR
  • string
PLN
  • string
PYG
  • string
QAR
  • string
RON
  • string
RSD
  • string
RUB
  • string
RWF
  • string
SAR
  • string
SBD
  • string
SCR
  • string
SDG
  • string
SEK
  • string
SGD
  • string
SHP
  • string
SLL
  • string
SOS
  • string
SRD
  • string
SSP
  • string
STD
  • string
SYP
  • string
SZL
  • string
THB
  • string
TJS
  • string
TMT
  • string
TND
  • string
TOP
  • string
TRY
  • string
TTD
  • string
TWD
  • string
TZS
  • string
UAH
  • string
UGX
  • string
USD
  • string
UYU
  • string
UZS
  • string
VEF
  • string
VND
  • string
VUV
  • string
WST
  • string
XAF
  • string
XCD
  • string
XOF
  • string
XPF
  • string
YER
  • string
ZAR
  • string
ZMW
  • string

Error

Meghatározza a bekövetkezett hibát.

Name Type Default Value Description
code None

A hibakategóriát azonosító hibakód.
message
  • string

A hiba leírása.
moreDetails
  • string

A hibával kapcsolatos további információkat tartalmazó leírás.
parameter
  • string

A hibát okozó kérelem paramétere.
subCode

A hibakód, amely további segítséget nyújt a hiba azonosításában.
value
  • string

A paraméter értéke a kérelemben érvénytelen volt.

ErrorCode

A hibakategóriát azonosító hibakód.

Name Type Description
InsufficientAuthorization
  • string
InvalidAuthorization
  • string
InvalidRequest
  • string
None
  • string
RateLimitExceeded
  • string
ServerError
  • string

ErrorResponse

A sikertelen kérést jelző legfelső szintű válasz.

Name Type Description
_type
  • string
errors

A kérés sikertelenségének okait leíró hibák listája.
id
  • string

Sztringazonosító.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
webSearchUrl
  • string

Az elem Bing keresési eredményének URL-címe.

ErrorSubCode

A hibakód, amely további segítséget nyújt a hiba azonosításában.

Name Type Description
AuthorizationDisabled
  • string
AuthorizationExpired
  • string
AuthorizationMissing
  • string
AuthorizationRedundancy
  • string
Blocked
  • string
HttpNotAllowed
  • string
NotImplemented
  • string
ParameterInvalidValue
  • string
ParameterMissing
  • string
ResourceError
  • string
UnexpectedError
  • string

ImageEntityAction

Entitásműveletet definiál.

Name Type Description
_type string:

A művelet alosztályát adja meg.
actionType
  • string

A művelet típusát jelölő sztring.
datePublished
  • string

A CreativeWork közzétételének dátuma.
displayName
  • string

A művelet megjelenítendő neve.
isTopAction
  • boolean

Logikai érték, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.
provider

A kreatív munka forrása.
result

A műveletben előállított eredmény.
serviceUrl
  • string

Ezzel az URL-címvel további adatokat kérhet le a megfelelő művelet végrehajtásának módjának meghatározásához. A serviceUrl például JSON-t és egy kép URL-címét is visszaadhatja.
text
  • string

A kreatív munka szöveges tartalma.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.

ImageKnowledge

Vizuális keresési API-választ definiál.

Name Type Description
_type
  • string
id
  • string

Sztringazonosító.
image

A kért kép metaadatait tartalmazó képobjektum.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
tags

A vizuális keresési címkék listája.
webSearchUrl
  • string

Az elem Bing keresési eredményének URL-címe.

ImageModuleAction

Definiál egy képlista-műveletet.

Name Type Description
_type string:

A művelet alosztályát adja meg.
actionType
  • string

A művelet típusát jelölő sztring.
data

A képek listája.
datePublished
  • string

A CreativeWork közzétételének dátuma.
displayName
  • string

A művelet megjelenítendő neve.
isTopAction
  • boolean

Logikai érték, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.
provider

A kreatív munka forrása.
result

A műveletben előállított eredmény.
serviceUrl
  • string

Ezzel az URL-címvel további adatokat kérhet le a megfelelő művelet végrehajtásának módjának meghatározásához. A serviceUrl például JSON-t és egy kép URL-címét is visszaadhatja.
text
  • string

A kreatív munka szöveges tartalma.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.

ImageObject

Definiál egy képet.

Name Type Description
accentColor
  • string

Egy három bájtos hexadecimális szám, amely a képet uraló színt jelöli. Használja a színt ideiglenes háttérként az ügyfélen a kép betöltéséig.
contentSize
  • string

A médiaobjektum tartalmának mérete. Használja az "értékegység" formátumot (pl. "1024 B").
contentUrl
  • string

A médiaobjektum forrásának (fájljának) eredeti URL-címe (például a kép forrás URL-címe).
datePublished
  • string

A CreativeWork közzétételének dátuma.
encodingFormat
  • string

Kódolási formátum (pl. png, gif, jpeg stb.).
height
  • integer

A médiaobjektum magassága képpontban.
hostPageDisplayUrl
  • string

A médiaobjektumot üzemeltető lap URL-címe.
hostPageUrl
  • string

A médiaobjektumot üzemeltető lap URL-címe.
imageId
  • string

A kép egyedi azonosítója.
imageInsightsToken
  • string

A Visual Search API későbbi hívásához használt jogkivonat, amely további információkat kér a képről. A jogkivonat használatáról a knowledgeRequest kérelemparaméterben található imageInsightsToken mezőben talál további információt.
insightsMetadata

Azon webhelyek száma, ahol a képhez kapcsolódó egyéb műveleteket is vásárolhat vagy hajthat végre. Ha például a kép egy almás pitéről van szó, ez az objektum tartalmazza azoknak a webhelyeknek a számát, ahol apple pie-t vásárolhat. A UX-ban található ajánlatok számának jelzéséhez adja meg a hibás elemet, például egy bevásárlókocsi ikont, amely tartalmazza a darabszámot. Amikor a felhasználó az ikonra kattint, használja az imageInsightsTokent egy későbbi Visual Search API-hívásban a vásárlási webhelyek listájának lekéréséhez.
provider

A kreatív munka forrása.
text
  • string

A kreatív munka szöveges tartalma.
thumbnail

A kép miniatűrjének URL-címe.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.
visualWords
  • string

Csak belső használatra.
width
  • integer

A médiaobjektum szélessége képpontban.

ImageRecipesAction

Egy receptműveletet definiál.

Name Type Description
_type string:

A művelet alosztályát adja meg.
actionType
  • string

A művelet típusát jelölő sztring.
data

A képhez kapcsolódó receptek listája.
datePublished
  • string

A CreativeWork közzétételének dátuma.
displayName
  • string

A művelet megjelenítendő neve.
isTopAction
  • boolean

Logikai érték, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.
provider

A kreatív munka forrása.
result

A műveletben előállított eredmény.
serviceUrl
  • string

Ezzel az URL-címvel további adatokat kérhet le a megfelelő művelet végrehajtásának módjának meghatározásához. A serviceUrl például JSON-t és egy kép URL-címét is visszaadhatja.
text
  • string

A kreatív munka szöveges tartalma.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.

ImageRelatedSearchesAction

Egy kapcsolódó keresési műveletet definiál.

Name Type Description
_type string:

A művelet alosztályát adja meg.
actionType
  • string

A művelet típusát jelölő sztring.
data

A képhez kapcsolódó lekérdezések listája.
datePublished
  • string

A CreativeWork közzétételének dátuma.
displayName
  • string

A művelet megjelenítendő neve.
isTopAction
  • boolean

Logikai érték, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.
provider

A kreatív munka forrása.
result

A műveletben előállított eredmény.
serviceUrl
  • string

Ezzel az URL-címvel további adatokat kérhet le a megfelelő művelet végrehajtásának módjának meghatározásához. A serviceUrl például JSON-t és egy kép URL-címét is visszaadhatja.
text
  • string

A kreatív munka szöveges tartalma.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.

ImageShoppingSourcesAction

Egy vásárlási forrást definiáló műveletet határoz meg.

Name Type Description
_type string:

A művelet alosztályát adja meg.
actionType
  • string

A művelet típusát jelölő sztring.
data

A képhez kapcsolódó elemeket kínáló kereskedők listája.
datePublished
  • string

A CreativeWork közzétételének dátuma.
displayName
  • string

A művelet megjelenítendő neve.
isTopAction
  • boolean

Logikai érték, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.
provider

A kreatív munka forrása.
result

A műveletben előállított eredmény.
serviceUrl
  • string

Ezzel az URL-címvel további adatokat kérhet le a megfelelő művelet végrehajtásának módjának meghatározásához. A serviceUrl például JSON-t és egy kép URL-címét is visszaadhatja.
text
  • string

A kreatív munka szöveges tartalma.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.

ImagesImageMetadata

Meghatározza azoknak a webhelyeknek a számát, ahol vásárolhat vagy végrehajthat a képpel kapcsolatos egyéb műveleteket.

Name Type Description
aggregateOffer

A képen található termékek online ajánlatainak összegzése. Ha például a kép egy ruha, az ajánlat azonosíthatja a legalacsonyabb árat és a talált ajánlatok számát. Ezt a mezőt csak vizuálisan hasonló termékekre vonatkozó megállapítások tartalmazzák. Az ajánlat a következő mezőket tartalmazza: Név, AggregateRating, OfferCount és LowPrice.
recipeSourcesCount
  • integer

A képeken látható ételek receptjeit kínáló webhelyek száma.
shoppingSourcesCount
  • integer

A képen látható termékeket értékesítő webhelyek száma.

ImagesModule

Meghatározza a képek listáját.

Name Type Description
value

A képek listája.

ImageTag

Vizuális keresési címke.

Name Type Description
_type
  • string
actions ImageAction[]:

A címkén belüli műveletek. Az elemek sorrendje a műveletek alapértelmezett rangsorolási sorrendjét jelöli, és az első művelet a legvalószínűbb felhasználói szándék.
alternateName
  • string

Az elem aliasa.
bingId
  • string

Az elemet egyedileg azonosító azonosító.
boundingBox

A címke határolókerete. Az alapértelmezett címke esetében nincs határolókeret.
description
  • string

Az elem rövid leírása.
displayName
  • string

A címke megjelenítendő neve. Az alapértelmezett címke esetében a megjelenített név üres.
id
  • string

Sztringazonosító.
image

Az elem képe.
name
  • string

Az objektum által képviselt dolog neve.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
url
  • string

Az objektum által képviselt dologra vonatkozó további információk lekéréséhez szükséges URL-cím.
webSearchUrl
  • string

Az elem Bing keresési eredményének URL-címe.

ImageTagRegion

Az ImageTaghez kapcsolódó képterületet definiál.

Name Type Description
displayRectangle

A felhasználó számára megjelenítendő ajánlott téglalap.
queryRectangle

Egy téglalap, amely a címke érdeklődési területét vázolja fel.

ItemAvailability

Az elem rendelkezésre állása. A lehetséges értékek a következők: Discontinued, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.

Name Type Description
Discontinued
  • string
InStock
  • string
InStoreOnly
  • string
LimitedAvailability
  • string
OnlineOnly
  • string
OutOfStock
  • string
PreOrder
  • string
SoldOut
  • string

NormalizedQuadrilateral

Egy kép egy régióját határozza meg. A régió egy konvex quadrilateral, amelyet a bal felső, a jobb felső, a bal alsó és a jobb alsó pontok koordinátái határoznak meg. A koordináták az eredeti kép szélességének és magasságának tört értékei a 0,0 és 1,0 közötti tartományban.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.
bingId
  • string

Az elemet egyedileg azonosító azonosító.
bottomLeft

A bal alsó sarok koordináta.
bottomRight

A jobb alsó sarok koordináta.
description
  • string

Az elem rövid leírása.
id
  • string

Egy sztringazonosító.
image

Az elem képe.
name
  • string

Az objektum által képviselt dolog neve.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
topLeft

A bal felső sarok koordinátája.
topRight

A jobb felső sarok koordináta.
url
  • string

Az objektum által képviselt dologra vonatkozó további információk lekéréséhez szükséges URL-cím.
webSearchUrl
  • string

Az elem keresési eredményének Bing URL-címe.

Offer

Meghatározza egy kereskedő ajánlatát.

Name Type Default Value Description
_type
  • string
aggregateRating

Összesített minősítés, amely azt jelzi, hogy mások mennyire értékelték a terméket.
alternateName
  • string

Az elem aliasa.
availability

Az elem rendelkezésre állása. A lehetséges értékek a következők: Discontinued, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.
bingId
  • string

Az elemet egyedileg azonosító azonosító.
description
  • string

Az elem rövid leírása.
id
  • string

Sztringazonosító.
image

Az elem képe.
lastUpdated
  • string

Az ajánlat utolsó frissítésének dátuma. A dátum YYYY-MM-DD formátumban van.
name
  • string

Az objektum által képviselt dolog neve.
price
  • number

Az elem ára.
priceCurrency USD

A pénzügyi pénznem. Például USD.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
seller

Eladó ehhez az ajánlathoz.
url
  • string

Az objektum által képviselt dologra vonatkozó további információk lekéréséhez szükséges URL-cím.
webSearchUrl
  • string

Az elem Bing keresési eredményének URL-címe.

Organization

Definiál egy szervezetet.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.
bingId
  • string

Az elemet egyedileg azonosító azonosító.
description
  • string

Az elem rövid leírása.
id
  • string

Sztringazonosító.
image

Az elem képe.
name
  • string

Az objektum által képviselt dolog neve.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
url
  • string

Az objektum által képviselt dologra vonatkozó további információk lekéréséhez szükséges URL-cím.
webSearchUrl
  • string

Az elem Bing keresési eredményének URL-címe.

Point2D

Kétdimenziós pontot definiál X és Y koordinátákkal.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.
bingId
  • string

Az elemet egyedileg azonosító azonosító.
description
  • string

Az elem rövid leírása.
id
  • string

Egy sztringazonosító.
image

Az elem képe.
name
  • string

Az objektum által képviselt dolog neve.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
url
  • string

Az objektum által képviselt dologra vonatkozó további információk lekéréséhez szükséges URL-cím.
webSearchUrl
  • string

Az elem keresési eredményének Bing URL-címe.
x
  • number

A pont x koordinátája.
y
  • number

A pont y koordinátája.

Query

Keresési lekérdezést definiál.

Name Type Description
displayText
  • string

A lekérdezési kifejezés megjelenítési verziója.
searchLink
  • string

A kapcsolódó keresés eredményeinek lekéréséhez használt URL-cím. Az URL-cím használata előtt szükség szerint hozzá kell fűznie a lekérdezési paramétereket, és tartalmaznia kell az Ocp-Apim-Subscription-Key fejlécet. Ezt az URL-címet akkor használja, ha az eredményeket a saját felhasználói felületén jeleníti meg. Ellenkező esetben használja a webSearchUrl URL-címet.
text
  • string

A lekérdezési sztring. Ezt a sztringet használja lekérdezési kifejezésként egy új keresési kérelemben.
thumbnail

Egy kapcsolódó kép miniatűrjének URL-címe.
webSearchUrl
  • string

Az URL-cím, amely a felhasználót a lekérdezés Bing keresési eredmények lapjára viszi.

Recipe

Egy főzési receptet határoz meg.

Name Type Description
cookTime
  • string

Mennyi időt vesz igénybe az étel a főzéshez. Például PT25M. Az időformátummal kapcsolatos információkért lásd: http://en.wikipedia.org/wiki/ISO_8601#Durations.
datePublished
  • string

A CreativeWork közzétételének dátuma.
prepTime
  • string

Az összetevők előkészítéséhez szükséges idő. Például PT15M. Az időformátummal kapcsolatos információkért lásd: http://en.wikipedia.org/wiki/ISO_8601#Durations.
provider

A kreatív munka forrása.
text
  • string

A kreatív munka szöveges tartalma.
thumbnailUrl
  • string

Az elem miniatűrjének URL-címe.
totalTime
  • string

A recept elkészítéséhez és elkészítéséhez szükséges teljes idő. Például PT45M. Az időformátummal kapcsolatos információkért lásd: http://en.wikipedia.org/wiki/ISO_8601#Durations.

RecipesModule

A receptek listáját határozza meg.

Name Type Description
value

A receptek listája.

RelatedSearchesModule

A kapcsolódó keresések listáját határozza meg.

Name Type Description
value

A kapcsolódó keresések listája.

SafeSearch

Szűrje a képeredményeket olyan műveletekben, amelyek "VisualSearch" típusúak a felnőtt tartalomhoz. A lehetséges szűrőértékek a következők. Kikapcsolva: Felnőtt tartalommal rendelkező képeket adhat vissza. Mérsékelt: Ne ad vissza felnőtt tartalommal rendelkező képeket. Szigorú: Ne ad vissza felnőtt tartalommal rendelkező képeket. Az alapértelmezett érték a Moderate. Ha a kérés olyan piacról érkezik, amely Bing felnőtt házirendje megköveteli, hogy a safeSearch értéke Strict legyen, Bing figyelmen kívül hagyja a safeSearch értéket, és a Strict értéket használja. Ha a webhelyet használja: szűrjön a tudáskérelemben, előfordulhat, hogy a válasz felnőtt tartalmat tartalmaz, függetlenül attól, hogy a safeSearch lekérdezési paraméter mire van beállítva. Webhely használata: csak akkor, ha tisztában van a webhelyen található tartalommal, és a forgatókönyv támogatja a felnőtt tartalom lehetőségét.

Name Type Description
Moderate
  • string
Off
  • string
Strict
  • string

Thing

Definiál egy dolgot.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.
bingId
  • string

Az elemet egyedileg azonosító azonosító.
description
  • string

Az elem rövid leírása.
id
  • string

Sztringazonosító.
image

Az elem képe.
name
  • string

Az objektum által képviselt dolog neve.
readLink
  • string

Az erőforrást visszaküldött URL-cím. Az URL használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és foglalja bele az Ocp-Apim-Subscription-Key fejlécet.
url
  • string

Az objektum által képviselt dologra vonatkozó további információk lekéréséhez szükséges URL-cím.
webSearchUrl
  • string

Az elem Bing keresési eredményének URL-címe.

XBingApisSDK

Aktiválja a Swagger-megfelelőséget.

Name Type Description
true
  • string