Images - Visual Search

A Vizuális keresési API segítségével információkat fedezhet fel egy képpel kapcsolatban, például vizuálisan hasonló képeket, vásárlási forrásokat és kapcsolódó kereséseket. Az API szövegfelismerést is végezhet, azonosíthatja az entitásokat (személyek, helyek, dolgok), más aktuális tartalmat is visszaadhat a felhasználó számára, és így tovább. További információt a Vizuális keresés áttekintése című témakörben talál.

POST {Endpoint}/bing/v7.0/images/visualsearch
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. Általában az mkt az az ország, ahonnan a felhasználó kéri. Azonban lehet, hogy egy másik országban, ha a felhasználó nem található olyan országban, ahol a Bing eredményeket. A piacnak a - formában kell lennie . Például: en-US. A karakterlánc nem szokja a kis- és nagybetűket. A lehetséges piaci értékek listáját a Piaci kódok ( Piackódok) tartalmazza. MEGJEGYZÉS: Ha ismert, akkor arra ösztönzik, hogy mindig adja meg a piacon. 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,a Bing a legjobban illeszkedő piaci kódot használja egy belső leképezés alapján, amely változhat.

safeSearch
query

Szűrje a képeredményeket a felnőtteknek szóló "VisualSearch" típusú műveletekre. A lehetséges szűrőértékek a következők. Ki: Felnőtteknek szóló képeket is visszaadhat. Mérsékelt: Felnőtt tartalmú képeket ne ad vissza. Szigorú: Ne küldje vissza a felnőtteknek szóló tartalmú képeket. Az alapértelmezett érték a Moderate. Ha a kérés olyan piacról érkezik, amelyen a Bing felnőttkori szabályzata megköveteli, hogy a biztonságos keresés szigorú legyen, a Bing figyelmen kívül hagyja a biztonságoskeresés értékét, és szigorú at használ. Ha a webhelyet használja: szűrő a tudáskérésben, előfordulhat, hogy a válasz felnőtt tartalmat tartalmazhat, függetlenül attól, hogy a safeSearch lekérdezési paraméter mire van beállítva. Webhely használata: csak akkor, ha ismeri a webhelyen található tartalmat, é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 setinfekt általában az mkt által megadott nyelvre állítja be, kivéve, ha a felhasználó azt szeretné, hogy a felhasználói felület karakterláncai 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

A swagger megfelelőség aktiválása.

Accept
  • string

Az alapértelmezett adathordozó-típus az alkalmazás/json. Ha azt szeretné megadni, hogy a válasz JSON-LD-thasználjon, állítsa az Accept fejlécet alkalmazás/ld+json ra.

Accept-Language
  • string

A felhasználói felület karakterláncaihoz használandó egy vagy több nyelv vesszővel tagolt listája. A lista prioritás szerinti csökkenő sorrendben jelenik meg. További információ, beleértve a várható formátumot, lásd: RFC2616. Ez a fejléc és a setLang lekérdezési paraméter kölcsönösen kizárják egymást; nem adja meg mindkettőt. Ha beállítja ezt a fejlécet, akkor a cc lekérdezési paramétert is meg kell adnia. A piac eredményének meghatározásához a 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. Csak akkor használja ezt a fejlécet és a cc query paramétert, 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; határ=). További információt a Tartaloműrlap-típusok ( Tartaloműrlap-típusok) területen talál.

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: Mozilla/5.0 (kompatibilis; MSIE 10.0; Windows Phone 8.0; Szigony/6.0; IEMobile/10.0; ARM; Érintés; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; hu - minket; SCH - I500 Build / Mézeskalács) AppleWebKit / 533.1 (KHTML; mint 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; mint gecko) Mobil / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Szigony / 7.0; Érintés; rv:11.0), mint a 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. A Bing-válaszok tartalmazhatják vagy nem tartalmazzá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: Gondoskodnia kell arról, hogy ez az ügyfélazonosító ne kapcsolódjon semmilyen hitelesíthető felhasználói fiókinformációhoz. Ha tartalmazza az X-MSEdge-ClientID azonosítót, nem tartalmazhat cookie-kat a kérelemben.

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: . 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 tartózkodási 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. hosszú (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 koordináták vízszintes pontosságát megadva, méterben megadott sugár. 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élyege, amikor az ügyfél a helyszínen volt. (A UNIX időbélyege az 1970. január 1.-e óta eltelt másodpercek száma.) fej (nem kötelező): Az ügyfél relatív iránya 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ő): Az ügyféleszköz által használt vízszintes sebesség (sebesség) méter per másodpercben. alt (nem kötelező): Az ügyféleszköz magassága méterben. a koordináták függőleges pontosságát megadva a sugár méterben. Csak akkor adja meg ezt a kulcsot, ha megadja az alt kulcsot. Bár a kulcsok nagy része nem kötelező, minél több információt ad meg, annál pontosabbak a helyadatok. 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

Siker.

Other Status Codes

Hiba történt. További részletekért ellenőrizze a válasz típusát és/vagy állapotkódját.

Biztonság

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Példák

Sample Request

POST {Endpoint}/bing/v7.0/images/visualsearch
Ocp-Apim-Subscription-Key: {API key}
X-BingApis-SDK: true
Content-Type: multipart/form-data

Sample Response

{
  "_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 lemezképhez kapcsolódó kereskedők ajánlatainak listáját határozza meg.

AggregateRating

Azokat a mutatókat határozza meg, amelyek azt jelzik, hogy egy elemet mások mennyire értékeltek.

Currency

A monetáris valuta. Például USD.

Error

A bekövetkezett hibát határozza meg.

ErrorCode

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

ErrorResponse

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

ErrorSubCode

A hibakód, amely tovább segít a hiba azonosításában.

ImageEntityAction

Entitásműveletet határoz meg.

ImageKnowledge

Vizuális keresési API-választ határoz meg.

ImageModuleAction

Képlista-műveletet határoz meg.

ImageObject

Egy képet határoz meg.

ImageRecipesAction

Receptműveletet határoz meg.

ImageRelatedSearchesAction

Kapcsolódó keresési műveletet határoz meg.

ImageShoppingSourcesAction

A vásárlási források műveletét határozza meg.

ImagesImageMetadata

Meghatározza a képhez kapcsolódó egyéb műveletek et megvásárolni vagy végrehajtani.

ImagesModule

A képek listáját határozza meg.

ImageTag

Vizuális keresési címke.

ImageTagRegion

Az ImageTag számára releváns képterületet határoz meg.

ItemAvailability

Az elem elérhetősége. A lehetséges értékek a következők: Megszűnt, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.

NormalizedQuadrilateral

A kép egy régióját határozza meg. A régió egy konvex négyszög, 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 a kereskedő ajánlatát.

Organization

Egy szervezetet határoz meg.

Point2D

Egy 2D pontot határoz meg X és Y koordinátákkal.

Query

Keresési lekérdezést határoz meg.

Recipe

Meghatározza a főzési receptet.

RecipesModule

Meghatározza a receptek listáját.

RelatedSearchesModule

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

SafeSearch

Szűrje a képeredményeket a felnőtteknek szóló "VisualSearch" típusú műveletekre. A lehetséges szűrőértékek a következők. Ki: Felnőtteknek szóló képeket is visszaadhat. Mérsékelt: Felnőtt tartalmú képeket ne ad vissza. Szigorú: Ne küldje vissza a felnőtteknek szóló tartalmú képeket. Az alapértelmezett érték a Moderate. Ha a kérés olyan piacról érkezik, amelyen a Bing felnőttkori szabályzata megköveteli, hogy a biztonságos keresés szigorú legyen, a Bing figyelmen kívül hagyja a biztonságoskeresés értékét, és szigorú at használ. Ha a webhelyet használja: szűrő a tudáskérésben, előfordulhat, hogy a válasz felnőtt tartalmat tartalmazhat, függetlenül attól, hogy a safeSearch lekérdezési paraméter mire van beállítva. Webhely használata: csak akkor, ha ismeri a webhelyen található tartalmat, és a forgatókönyv támogatja a felnőtt tartalom lehetőségét.

Thing

Meghatároz egy dolgot.

XBingApisSDK

A swagger megfelelőség aktiválása.

AggregateOffer

A lemezképhez kapcsolódó kereskedők ajánlatainak listáját határozza meg.

Name Type Description
aggregateRating

Összesített értékelés, amely azt jelzi, hogy mások mennyire értékelték a terméket.

availability

Az elem elérhetősége. A lehetséges értékek a következők: Megszűnt, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.

lastUpdated
  • string

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

offers

A képhez kapcsolódó ajánlatokkal rendelkező kereskedők ajánlatainak listája.

price
  • number

A cikk ára.

priceCurrency

A monetáris valuta. Például USD.

seller

Eladó erre az ajánlatra.

AggregateRating

Azokat a mutatókat határozza meg, amelyek azt jelzik, hogy egy elemet mások mennyire értékeltek.

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

A legmagasabb minősítésű értékelés. A lehetséges értékek 1,0 és 5,0 között lehetnek.

ratingValue
  • number

Az átlagos (átlagos) minősítés. A lehetséges értékek 1,0 és 5,0 között lehetnek.

reviewCount
  • integer

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

text
  • string

Elem szöveges ábrázolása.

Currency

A monetáris valuta. 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

A bekövetkezett hibát határozza meg.

Name Type Description
code

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ább segít a hiba azonosításában.

value
  • string

A paraméter értéke a kérelemben, amely é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 jelképező legfelső szintű válasz.

Name Type Description
_type
  • string
errors

A kérelem sikertelensse okait leíró hibák listája.

id
  • string

Karakterlánc-azonosító.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

ErrorSubCode

A hibakód, amely tovább segít 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 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ő karakterlánc.

datePublished
  • string

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

displayName
  • string

A művelet megjelenítendő neve.

isTopAction
  • boolean

Logikai változó, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.

provider

A kreatív munka forrása.

result

Az eredmény a cselekvés során keletkezett.

serviceUrl
  • string

Ezzel az URL-címmel további adatokat kaphat a megfelelő művelet megtetézéséhez. Például a serviceUrl előfordulhat, hogy egy kép URL-címét adja vissza JSON.For example, the serviceUrl might return JSON along with a image URL.

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 határoz meg.

Name Type Description
_type
  • string
id
  • string

Karakterlánc-azonosító.

image

A kért kép metaadatait tartalmazó képobjektum.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

tags

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

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

ImageModuleAction

Képlista-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ő karakterlánc.

data

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 változó, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.

provider

A kreatív munka forrása.

result

Az eredmény a cselekvés során keletkezett.

serviceUrl
  • string

Ezzel az URL-címmel további adatokat kaphat a megfelelő művelet megtetézéséhez. Például a serviceUrl előfordulhat, hogy egy kép URL-címét adja vissza JSON.For example, the serviceUrl might return JSON along with a image URL.

text
  • string

A kreatív munka szöveges tartalma.

thumbnailUrl
  • string

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

ImageObject

Egy képet határoz meg.

Name Type Description
accentColor
  • string

Hárombá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élben, amíg a kép be nem töltődik.

contentSize
  • string

A médiaobjektum-tartalom mérete. Használja az "értékegység" formátumot (pl. "1024 B").

contentUrl
  • string

Eredeti URL-cím a médiaobjektum forrásának (fájljának) lekéréséhez (pl. a kép forrásURL-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 tartalmazó lap URL-címének megjelenítése.

hostPageUrl
  • string

A médiaobjektumot tartalmazó lap URL-címe.

imageId
  • string

A kép egyedi azonosítója.

imageInsightsToken
  • string

A jogkivonat, amelyet a Visual Search API későbbi hívása során használ a lemezképtovábbi információk beszerzéséhez. A jogkivonat használatával kapcsolatos további információkért tekintse meg az imageInsightsToken mezőt a knowledgeRequest request paraméterben.

insightsMetadata

A képhez kapcsolódó egyéb műveleteket megvásárolni vagy végrehajtani. Ha például a kép almás pitéből áll, ez az objektum tartalmazza az almás pitét megvásárolni kívánt webhelyek számát. A felhasználói környezetben lévő ajánlatok számának jelzéséhez mellékeljen egy badginget, például egy bevásárlókocsi ikont, amely tartalmazza a számlálót. Amikor a felhasználó az ikonra kattint, használja az imageInsightsToken funkciót egy későbbi Visual Search API-hívásban a bevásárló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

Receptmű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ő karakterlánc.

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 változó, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.

provider

A kreatív munka forrása.

result

Az eredmény a cselekvés során keletkezett.

serviceUrl
  • string

Ezzel az URL-címmel további adatokat kaphat a megfelelő művelet megtetézéséhez. Például a serviceUrl előfordulhat, hogy egy kép URL-címét adja vissza JSON.For example, the serviceUrl might return JSON along with a image URL.

text
  • string

A kreatív munka szöveges tartalma.

thumbnailUrl
  • string

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

ImageRelatedSearchesAction

Kapcsolódó keresési 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ő karakterlánc.

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 változó, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.

provider

A kreatív munka forrása.

result

Az eredmény a cselekvés során keletkezett.

serviceUrl
  • string

Ezzel az URL-címmel további adatokat kaphat a megfelelő művelet megtetézéséhez. Például a serviceUrl előfordulhat, hogy egy kép URL-címét adja vissza JSON.For example, the serviceUrl might return JSON along with a image URL.

text
  • string

A kreatív munka szöveges tartalma.

thumbnailUrl
  • string

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

ImageShoppingSourcesAction

A vásárlási források műveletét határozza meg.

Name Type Description
_type string:

A művelet alosztályát adja meg.

actionType
  • string

A művelet típusát jelölő karakterlánc.

data

Azoknak a kereskedőknek a listája, akik a képhez kapcsolódó elemeket kínálnak.

datePublished
  • string

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

displayName
  • string

A művelet megjelenítendő neve.

isTopAction
  • boolean

Logikai változó, amely azt jelzi, hogy ez az eredmény a legfelső művelet-e.

provider

A kreatív munka forrása.

result

Az eredmény a cselekvés során keletkezett.

serviceUrl
  • string

Ezzel az URL-címmel további adatokat kaphat a megfelelő művelet megtetézéséhez. Például a serviceUrl előfordulhat, hogy egy kép URL-címét adja vissza JSON.For example, the serviceUrl might return JSON along with a image URL.

text
  • string

A kreatív munka szöveges tartalma.

thumbnailUrl
  • string

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

ImagesImageMetadata

Meghatározza a képhez kapcsolódó egyéb műveletek et megvásárolni vagy végrehajtani.

Name Type Description
aggregateOffer

A képen található termékek online ajánlatainak összefoglalása. Ha például a kép egy ruhából áll, az ajánlat azonosíthatja a legalacsonyabb árat és a talált ajánlatok számát. Csak vizuálisan hasonló termékek elemzések tartalmazzák ezt a mezőt. Az ajánlat a következő mezőket tartalmazza: Név, Összesítés, OfferCount és LowPrice.

recipeSourcesCount
  • integer

A képeken látható élelmiszerek receptjeit kínáló webhelyek száma.

shoppingSourcesCount
  • integer

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

ImagesModule

A képek listáját határozza meg.

Name Type Description
value

Képek listája.

ImageTag

Vizuális keresési címke.

Name Type Description
_type
  • string
actions ImageAction[]:

A címke lépései. 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óval azonosító.

boundingBox

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

description
  • string

A cikk rövid leírása.

displayName
  • string

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

id
  • string

Karakterlánc-azonosító.

image

Az elem képe.

name
  • string

Az objektum által képviselt dolog neve.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

url
  • string

Az URL-t, hogy minél több információt a dolog által képviselt objektum.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

ImageTagRegion

Az ImageTag számára releváns képterületet határoz meg.

Name Type Description
displayRectangle

Ajánlott téglalap a felhasználó számára.

queryRectangle

A címke érdeklődési területének körvonalait körvonalazó téglalap.

ItemAvailability

Az elem elérhetősége. A lehetséges értékek a következők: Megszűnt, 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

A kép egy régióját határozza meg. A régió egy konvex négyszög, 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óval azonosító.

bottomLeft

A bal alsó sarok koordináta.

bottomRight

A jobb alsó sarokkoordináta.

description
  • string

A cikk rövid leírása.

id
  • string

Karakterlánc-azonosító.

image

Az elem képe.

name
  • string

Az objektum által képviselt dolog neve.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

topLeft

A bal felső sarok koordináta.

topRight

A jobb felső sarok koordináta.

url
  • string

Az URL-t, hogy minél több információt a dolog által képviselt objektum.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

Offer

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

Name Type Description
_type
  • string
aggregateRating

Összesített értékelés, amely azt jelzi, hogy mások mennyire értékelték a terméket.

alternateName
  • string

Az elem aliasa.

availability

Az elem elérhetősége. A lehetséges értékek a következők: Megszűnt, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.

bingId
  • string

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

description
  • string

A cikk rövid leírása.

id
  • string

Karakterlánc-azonosí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

A cikk ára.

priceCurrency

A monetáris valuta. Például USD.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

seller

Eladó erre az ajánlatra.

url
  • string

Az URL-t, hogy minél több információt a dolog által képviselt objektum.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

Organization

Egy szervezetet határoz meg.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.

bingId
  • string

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

description
  • string

A cikk rövid leírása.

id
  • string

Karakterlánc-azonosító.

image

Az elem képe.

name
  • string

Az objektum által képviselt dolog neve.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

url
  • string

Az URL-t, hogy minél több információt a dolog által képviselt objektum.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

Point2D

Egy 2D pontot határoz meg X és Y koordinátákkal.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.

bingId
  • string

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

description
  • string

A cikk rövid leírása.

id
  • string

Karakterlánc-azonosító.

image

Az elem képe.

name
  • string

Az objektum által képviselt dolog neve.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

url
  • string

Az URL-t, hogy minél több információt a dolog által képviselt objektum.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

x
  • number

A pont x koordinátája.

y
  • number

A pont y koordinátája.

Query

Keresési lekérdezést határoz meg.

Name Type Description
displayText
  • string

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

searchLink
  • string

A kapcsolódó keresés eredményének lekeresé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. Akkor használja ezt az URL-címet, 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 karakterlánc. Ezt a karakterláncot használja lekérdezési kifejezésként egy új keresési kérelemben.

thumbnail

A kapcsolódó kép miniatűrjének URL-címe.

webSearchUrl
  • string

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

Recipe

Meghatározza a főzési receptet.

Name Type Description
cookTime
  • string

Az az idő, amíg az étel főzéshez szükséges. Például PT25M. Az időformátumról a http://en.wikipedia.org/wiki/ISO_8601#Durationstémakörben talál további információt.

datePublished
  • string

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

prepTime
  • string

Az összetevők elkészítéséhez szükséges idő. Például PT15M. Az időformátumról a http://en.wikipedia.org/wiki/ISO_8601#Durationstémakörben talál további információt.

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 teljes időt vesz igénybe, hogy előkészítse és főzzük a receptet. Például PT45M. Az időformátumról a http://en.wikipedia.org/wiki/ISO_8601#Durationstémakörben talál további információt.

RecipesModule

Meghatározza a receptek listáját.

Name Type Description
value

Egy lista a receptekről.

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 a felnőtteknek szóló "VisualSearch" típusú műveletekre. A lehetséges szűrőértékek a következők. Ki: Felnőtteknek szóló képeket is visszaadhat. Mérsékelt: Felnőtt tartalmú képeket ne ad vissza. Szigorú: Ne küldje vissza a felnőtteknek szóló tartalmú képeket. Az alapértelmezett érték a Moderate. Ha a kérés olyan piacról érkezik, amelyen a Bing felnőttkori szabályzata megköveteli, hogy a biztonságos keresés szigorú legyen, a Bing figyelmen kívül hagyja a biztonságoskeresés értékét, és szigorú at használ. Ha a webhelyet használja: szűrő a tudáskérésben, előfordulhat, hogy a válasz felnőtt tartalmat tartalmazhat, függetlenül attól, hogy a safeSearch lekérdezési paraméter mire van beállítva. Webhely használata: csak akkor, ha ismeri a webhelyen található tartalmat, é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

Meghatároz egy dolgot.

Name Type Description
_type
  • string
alternateName
  • string

Az elem aliasa.

bingId
  • string

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

description
  • string

A cikk rövid leírása.

id
  • string

Karakterlánc-azonosító.

image

Az elem képe.

name
  • string

Az objektum által képviselt dolog neve.

readLink
  • string

Az erőforrást visszaadó URL-cím. Az URL-cím használatához szükség szerint fűzze hozzá a lekérdezési paramétereket, és adja meg az Ocp-Apim-Subscription-Key fejlécet.

url
  • string

Az URL-t, hogy minél több információt a dolog által képviselt objektum.

webSearchUrl
  • string

A Bing keresési eredményének URL-címe ehhez az elemhez.

XBingApisSDK

A swagger megfelelőség aktiválása.

Name Type Description
true
  • string