Skicka sökfrågor till API:et för visuell sökning i Bing
Varning
Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.
I den här artikeln beskrivs parametrarna och attributen för begäranden som skickas till API:et för visuell sökning i Bing samt svarsobjektet.
Du kan få insikter om en bild på tre sätt:
- Använda en insiktstoken som du får från en bild i ett tidigare anrop till en av slutpunkterna för API för bildsökning i Bing .
- Skickar URL:en för en bild.
- Ladda upp en bild (i binärt format).
Begäranden om visuell sökning i Bing
Om du skickar visuell sökning till en bildtoken eller URL visar följande kodfragment det JSON-objekt som du måste inkludera i brödtexten i POST:
{
"imageInfo" : {
"url" : "",
"imageInsightsToken" : "",
"cropArea" : {
"top" : 0.1,
"left" : 0.5,
"right" : 0.9,
"bottom" : 0.9
}
},
"knowledgeRequest" : {
"filters" : {
"site" : ""
}
}
}
Objektet imageInfo måste innehålla antingen fältet url eller imageInsightsToken, men inte båda. url Ange fältet till URL:en för en Internettillgänglig bild. Den maximala storleken som stöds är 1 MB.
En insiktstoken måste anges för imageInsightsToken. Anropa API för Bing-bild för att få en token för insikter. Svaret innehåller en lista över Image objekt. Varje Image-objekt innehåller ett imageInsightsToken-fält som innehåller token.
Fältet cropArea är valfritt. Beskärningsområdet anger det övre vänstra hörnet och det nedre högra hörnet i en region av intresse. Ange värden i intervallet 0.0 till och med 1.0. Värdena är en del av den totala bredden eller höjden. Till exempel markerar exemplet ovan höger halva av bilden som det intressanta området. Inkludera den om du vill begränsa insiktsbegäran till det intressanta området.
Objektet filters innehåller ett platsfilter (se fältet site) som du kan använda för att begränsa liknande bilder och liknande produktresultat till en specifik domän. Om bilden till exempel är av en Surface Book kan du ange site till www.microsoft.com.
Om du vill hämta insikter om en lokal kopia av en bild kan du överföra bilden som binära data.
Mer information om att inkludera dessa alternativ i brödtexten i POST finns i Typer av innehållsformulär.
Sökslutpunkt
Slutpunkten för visuell sökning är: https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch.
Begäranden måste skickas som HTTP POST-begäranden.
Frågeparametrar
Här följer frågeparametrarna som din begäran bör ange. Du bör minst inkludera frågeparametern mkt :
| Name | Värde | Typ | Obligatorisk |
|---|---|---|---|
| cc | En landskod med två tecken som representerar var resultatet kommer ifrån. Om du anger parametern måste du även ange huvudet Accept-Language. Bing använder det första språket som stöds på listan över språk och kombinerar språket med landskoden som du anger för att fastställa vilken marknad som resultatet som returneras från. Om listan över språk inte innehåller något språk som stöds hittar Bing det närmaste språket och marknaden som har stöd för begäran. Eller så kan den använda en sammansatt eller standardmarknad för resultatet i stället för den angivna. Du bör endast använda den här frågeparametern och Accept-Language-frågeparametern om du anger flera språk. I annat fall bör du använda frågeparametrarna mkt och setLang.Den här parametern och mkt-frågeparametern är ömsesidigt uteslutande – ange inte båda. |
Sträng | No |
| mkt | Marknaden som resultatet kommer från. OBSERVERA: Du bör alltid ange marknaden, om det är känt. Om du anger marknaden gör det enklare för Bing att dirigera begäran och returnera ett lämpligt och optimalt svar. Den här parametern och frågeparametern cc utesluter varandra – ange inte båda. |
Sträng | Yes |
| safeSearch | Ett filter för vuxet innehåll. Här följer de möjliga skiftlägeskänsliga filtervärdena.
Standardinställningen är Måttlig. Obs! Om förfrågan kommer från en marknad för vilken Bings princip för vuxet innehåll kräver att safeSearch ska vara inställd på Strikt ignorerar Bing värdet safeSearch och använder Strikt.OBSERVERA: Om du använder site: frågeoperatorn finns det en risk att svaret innehåller vuxet innehåll oavsett vad safeSearch frågeparametern är inställd på. Använd endast site: om du är medveten om innehållet på webbplatsen och ditt scenario tillåter möjligheten att det förekommer innehåll som är olämpligt för barn. |
Sträng | No |
| setLang | Språket som ska användas för användargränssnittssträngar. Ange språket med hjälp av språkkoden ISO 639-1 med två bokstäver. Språkkoden för engelska är till exempel EN. Standardvärdet är EN (engelska). Även om det är valfritt bör du alltid ange språket. Normalt anger du setLang på samma språk som anges av mkt om inte användaren vill att gränssnittets strängar ska visas på ett annat språk.Den här parametern och accept-language-huvudet är ömsesidigt uteslutande – ange inte båda. En användargränssnittssträng är en sträng som används som en etikett i ett användargränssnitt. Det finns några användargränssnittssträngar i JSON-svarsobjekt. Alla länkar till Bing.com-egenskaper i svarsobjekten använder det angivna språket. |
Sträng | No |
Sidhuvuden
Här följer huvudena som din begäran bör ange. Huvudena Content-Type och Ocp-Apim-Subscription-Key är de enda obligatoriska rubrikerna, men du bör även inkludera User-Agent, X-MSEdge-ClientID, X-MSEdge-ClientIPoch X-Search-Location.
| Huvud | Description |
|---|---|
| Accept-Language | Valfritt begärandehuvud. En kommaavgränsad lista över språk som ska användas för användargränssnittssträngar. Listan är i fallande prioritetsordning. Mer information, bland annat om det förväntade formatet, finns i RFC2616. Det här huvudet och frågeparametern setLang är ömsesidigt uteslutande – ange inte båda. Om du anger huvudet måste du även ange frågeparametern cc. För att fastställa vilken marknad som resultat ska returneras för använder Bing det första språk som stöds på listan och kombinerar det med parametervärdet cc. Om listan inte innehåller något språk som stöds hittar Bing det närmaste språket och marknaden som har stöd för begäran, eller så använder Bing en aggregerad eller standardmarknad för resultatet. Information om hur du fastställer vilken marknad Bing använde finns i BingAPIs-Market rubriken.Använd enbart det här huvudet och cc-frågeparametern om du anger flera språk. Annars kan du använda frågeparametrarna mkt och setLang.En användargränssnittssträng är en sträng som används som en etikett i ett användargränssnitt. Det finns några användargränssnittssträngar i JSON-svarsobjekt. Alla länkar till Bing.com-egenskaper i svarsobjekten använder det angivna språket. |
| Content-Type | |
| BingAPIs-Market | Svarshuvud. Marknaden som används av begäran. Formuläret är <languageCode-countryCode<>>. Exempel: sv-SE. |
| BingAPIs-TraceId | Svarshuvud. ID för loggposten som innehåller information om begäran. När ett fel uppstår ska du avbilda detta ID. Om det inte går att fastställa och lösa problemet ska du ange ID:t tillsammans med annan information som du ger supportteamet. |
| Ocp-Apim-Subscription-Key | Begärandehuvud som krävs. Prenumerationsnyckeln som du fick när du registrerade dig för den här tjänsten i Azure AI-tjänster. |
| Pragma | |
| User-Agent | Valfritt begärandehuvud. Användaragenten som skapade begäran. Bing använder användaragenten för att ge mobila användare en optimerad upplevelse. Även om det är valfritt rekommenderar vi även att du alltid anger det här huvudet. Användaragenten ska vara samma sträng som alla vanliga webbläsare skickar. Information om användaragenter finns i RFC 2616. Här följer några exempel på användaragentsträngar.
|
| X-MSEdge-ClientID | Valfritt huvud för begäran och svar. Bing använder det här huvudet för att ge användarna konsekvent beteende i Bing API-anrop. Bing ger ofta förhandsversioner av nya funktioner och förbättringar och använder klient-ID som en nyckel för att tilldela trafik till olika förhandsversioner. Om du inte använder samma klient-ID för en användare vid flera förfrågningar kan sedan Bing tilldela användaren flera motstridiga förhandsversioner. Om du tilldelas flera motstridiga förhandsversioner kan det leda till en inkonsekvent användarupplevelse. Om till exempel den andra begäran har en annan förhandsversionstilldelning än den första kan upplevelsen vara oväntad. Bing kan också använda klient-ID för att skräddarsy webbresultatet för klient-ID:ts sökhistorik, vilket ger användaren en mer omfattande upplevelse. Bing använder också det här huvudet för att förbättra resultatets rangordning genom att analysera aktiviteten som genererats av ett klient-ID. Relevansförbättringarna kan ge bättre resultat som levereras av Bing-API: er, vilka i sin tur möjliggör högre klickfrekvens för API-konsumenten. Viktigt! Även om det är valfritt bör du överväga att använda det här huvudet som krävs. Bestående klient-ID för flera förfrågningar för samma slutanvändare och enhetskombination gör det möjligt 1) för API-konsumenten att få en konsekvent användarupplevelse och 2) att få högre klickfrekvens via resultat av högre kvalitet från Bing-API: er. Följande är de grundläggande användningsregler som gäller för det här huvudet.
Obs! Bing-svar kanske eller kanske inte omfattar det här huvudet. Om svaret innehåller det här huvudet ska du avbilda klient-ID:t och använda det för alla efterföljande Bing-begäranden för användaren på enheten. Obs! Om du inkluderar X-MSEdge-ClientID får du inte ta med cookies i begäran. |
| X-MSEdge-ClientIP | Valfritt begärandehuvud. Klientenhetens IPv4- eller IPv6-adress. IP-adressen används för att identifiera användarens plats. Bing använder platsinformationen för att fastställa SafeSearch-beteende. Obs!Även om det är valfritt rekommenderar vi att du alltid anger det här huvudet och huvudet X-Search-Location. Förvräng inte adressen (till exempel genom att ändra den sista oktetten till 0). Om adressresultatet förvillas på en plats som inte är i närheten av enhetens verkliga plats kan det leda till att Bing presenterar felaktiga resultat. |
| X-Search-Location | Valfritt begärandehuvud. En semikolonavgränsad lista med nyckel/värde-par som beskriver klientens geografiska plats. Bing använder platsinformationen till att fastställa ett säkert sökbeteende och returnera relevant lokalt innehåll. Ange nyckel/värde-par som <nyckel>:<värde>. Följande är de nycklar som används för att ange användarens plats.
Obs!Även om det är valfritt rekommenderar vi att du alltid anger användarens geografiska plats. Det är särskilt viktigt att ange plats om klientens IP-adress inte exakt avspeglar användarens fysiska plats (till exempel om klienten använder VPN). För optimala resultat bör du inkludera det här huvudet och X-MSEdge-ClientIP huvudet, men du bör åtminstone inkludera det här huvudet. |
Anteckning
Kom ihåg att Bing-sökning API-användnings- och visningskrav kräver efterlevnad av alla tillämpliga lagar, inklusive användning av dessa rubriker. I till exempel vissa jurisdiktioner, som Europa, finns det krav på att skaffa användarens medgivande innan du placerar vissa spårningsenheter på användarenheter.
Typer av innehållsformulär
Varje begäran måste innehålla Content-Type rubriken. Huvudet måste anges till: multipart/form-data; boundary=\<boundary string\>, där <gränssträngen> är en unik, täckande sträng som identifierar gränsen för formulärdata. Till exempel boundary=boundary_1234-abcd.
Om du skickar en bildtoken eller URL för visuell sökning visar följande kodfragment de formulärdata som du måste inkludera i brödtexten i POST. Formulärdata måste innehålla Content-Disposition huvudet och du måste ange dess name parameter till "knowledgeRequest". Mer information om imageInfo objektet finns i begäran.
--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"
{
"imageInfo" : {
"url" : "https://contoso.com/2018/05/fashion/red.jpg"
}
}
--boundary_1234-abcd--
Du kan också ange enableEntityData attributet i rubriken till true för detaljerad information om huvudentiteten i bilden som du laddar upp, inklusive länkar till webben och attributionsinformation. Det här fältet är false som standard.
--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"
{
"imageInfo" : {
"url" : "https://contoso.com/2018/05/fashion/red.jpg"
},
"knowledgeRequest" : {
"invokedSkillsRequestData" : {
"enableEntityData" : "true"
}
}
}
--boundary_1234-abcd--
Om du laddar upp en lokal bild visar följande kodfragment de formulärdata som du måste inkludera i brödtexten i POST. Formulärdata måste innehålla Content-Disposition rubriken. Parametern name måste anges till ”image” och parametern filename kan anges till valfri sträng. Rubriken Content-Type kan vara inställd på alla vanliga mime-avbildningstyper. Innehållet i formuläret är binära data i bilden. Den maximala bildstorlek som du kan ladda upp är 1 MB. Det som är störst av bredden eller höjden ska vara 1 500 bildpunkter eller mindre.
--boundary_1234-abcd
Content-Disposition: form-data; name="image"; filename="myimagefile.jpg"
Content-Type: image/jpeg
ÿØÿà JFIF ÖÆ68g-¤CWŸþ29ÌÄøÖ‘º«™æ±èuZiÀ)"óÓß°Î= ØJ9á+*G¦...
--boundary_1234-abcd--
Följande kodfragment visar hur du anger det intressanta området för en uppladdad bild:
--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"
{
"imageInfo" : {
"cropArea" : {
"top" : 0.2,
"left" : 0.3,
"bottom" : 0.7,
"right" : 0.6
}
}
}
--boundary_1234-abcd
Content-Disposition: form-data; name="image"; filename="image"
Content-Type: image/jpeg
ÿØÿà JFIF ÖÆ68g-¤CWŸþ29ÌÄøÖ‘º«™æ±èuZiÀ)"óÓß°Î= ØJ9á+*G¦...
--boundary_1234-abcd--
Exempelbegäran
Följande kodfragment visar en fullständig begäran om bildinsikter som skickar en bildtoken och region av intresse. Du får insiktstoken från ett tidigare anrop till /images/search:
POST https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch?mkt=en-us HTTP/1.1
Content-Type: multipart/form-data; boundary=boundary_1234-abcd
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"
{
"imageInfo" : {
"imageInsightsToken" : "mid_D6426898706EC7..."
"cropArea" : {
"top" : 0.1,
"left" : 0.2,
"bottom" : 0.7,
"right" : 0.5
}
}
}
--boundary_1234-abcd--
Svar från visuell sökning i Bing
Anteckning
Eftersom URL-format och parametrar kan komma att ändras utan föregående meddelande använder du alla URL:er som de är. Du bör inte använda beroenden för URL-formatet eller parametrarna, förutom där det anges.
Om det finns insikter för avbildningen innehåller svaret en eller flera tags som innehåller insikterna. Fältet image innehåller insiktstoken för indatabilden:
{
"_type" : "ImageKnowledge",
"tags" : [
{...},
{...},
{...},
{...},
{...}
],
"image" : {
"imageInsightsToken" : "bcid_AF8C9CA409421B..."
}
}
Fältet tags innehåller ett visningsnamn och en lista med åtgärder (insikter). En av taggarna innehåller ett displayName-fält som har angetts till en tom sträng. Den här taggen innehåller standardinsikterna, till exempel webbsidor som innehåller den bilden, snarlika bilder och shoppingkällor för poster som hittades på bilden. Eftersom hela bilden är av intresse inkluderar standardinsiktstaggen inte avgränsningsrutor för de intressanta regionerna:
{
"_type" : "ImageKnowledge",
"tags" : [
{
"displayName" : "",
"actions" : [
{...},
{...},
{...},
{...}
]
},
{...},
{...},
{...},
{...}
],
"image" : {
"imageInsightsToken" : "bcid_AF8C9CA409421B..."
}
}
En lista över standardinsikter finns i Standardinsiktstaggen.
Resten av taggarna innehåller andra insikter som kan vara av intresse för användaren. Om bilden exempelvis innehåller text kan en av taggarna omfatta en TextResults-insikt som innehåller den identifierade texten. Eller, om Bing känner igen en entitet (dvs. en kulturellt välkänd/populär person, plats eller sak) i bilden, kan en av taggarna identifiera entiteten. Visuell sökning returnerar också en mängd olika villkor (taggar) som härletts från den inmatade bilden. Med de här taggarna kan användarna utforska begrepp som finns i bilden. Om bilden till exempel föreställer berömda idrottare kan en av taggarna vara sport, som innehåller länkar till bilder av sport.
Varje tagg innehåller ett visningsnamn som du kan använda för att kategorisera insikter, avgränsningsrektangel som identifierar den intressanta regionen som insikten gäller för och en miniatyrbild av bilden. Om bilden föreställer en person som har på sig en sporttröja kan en av taggarna innehålla en avgränsningsrektangel som en gräns för tröjan och inkludera VisualSearch- och ProductVisualSearch-insikter. Och en annan tagg kan innehålla ImageResults-insikter som innehåller en URL för API-begäran /images/search för att hämta bilder som är relaterade eller en Bing.com-sökwebbadress som leder användaren till bildsökningsresultat för Bing.com.
Alla andra taggar än insiktstaggarna innehåller avgränsningsrektanglar som identifierar områden av intresse på bilden. Om bilden till exempel innehåller flera identifierade personer kan taggarna innehålla avgränsningsrektanglar för var och en av personerna, eller om bilden innehåller identifierade klädesplagg kan taggarna innehålla avgränsningsrektanglar för varje identifierat klädesplagg. Du kan använda avgränsningsrektanglarna för att skapa aktiva punkter över bilden som vid ett klick innehåller information om innehållet för den delen av bilden. Du får inte ta med aktiva punkter i en bild för avgränsningsrektanglar som identifierar hela bilden.
Textigenkänning
Om bilden innehåller text som tjänsten känner igen innehåller en av taggarna en TextResults-insikt (åtgärd). displayName Insikterna innehåller den tolkade texten:
{
"image" : {
"thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23Text..."
},
"displayName" : "##TextRecognition",
"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" : [{
"displayName" : "WALK BIKE ACROSS BRIDGE",
"actionType" : "TextResults"
}],
"sources" : ["OCR"]
}
Eftersom taggens displayName-fält innehåller ##TextRecognition ska du inte använda den som ett kategorihuvud i UX. Det gäller alla visningsnamn som börjar med ##. Använd i stället åtgärdens visningsnamn.
Textigenkänning kan också identifiera kontaktuppgifter på visitkort, till exempel telefonnummer och e-postadresser. Avgränsningsrektangeln identifierar platsen för kontaktuppgifterna för kortet.
{
"image" : {
"thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23TextRecognition..."
},
"displayName" : "##TextRecognition",
"boundingBox" : {
"queryRectangle" : {
"topLeft" : {"x" : 0.635, "y" : 0},
"topRight" : {"x" : 0.77, "y" : 0},
"bottomRight" : {"x" : 0.77, "y" : 0.4873333},
"bottomLeft" : {"x" : 0.635, "y" : 0.4873333}
},
"displayRectangle" : {
"topLeft" : {"x" : 0.635, "y" : 0},
"topRight" : {"x" : 0.77, "y" : 0},
"bottomRight" : {"x" : 0.77, "y" : 0.4873333},
"bottomLeft" : {"x" : 0.635, "y" : 0.4873333}
}
},
"actions" : [
{
"url" : "tel:888%20555%201212",
"actionType" : "Uri"
}
],
"sources" : ["OCR"]
},
{
"image" : {
"thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23TextRecognition..."
},
"displayName" : "##TextRecognition",
"boundingBox" : {
"queryRectangle" : {
"topLeft" : {"x" : 0.63, "y" : 0},
"topRight" : {"x" : 0.866, "y" : 0},
"bottomRight" : {"x" : 0.866, "y" : 0.5553334},
"bottomLeft" : {"x" : 0.63, "y" : 0.5553334}
},
"displayRectangle" : {
"topLeft" : {"x" : 0.63, "y" : 0},
"topRight" : {"x" : 0.866, "y" : 0},
"bottomRight" : {"x" : 0.866, "y" : 0.5553334},
"bottomLeft" : {"x" : 0.63, "y" : 0.5553334}
}
},
"actions" : [
{
"url" : "mailto:someone@outlook.com",
"actionType" : "Uri"
}
],
"sources" : ["OCR"]
},
{
"image" : {
"thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23TextRecognition..."
},
"displayName" : "##TextRecognition",
"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" : [
{
"displayName" : "CHARLENE WHITNEY Graphic Designer 888 555 1212 someone@outlook.com www.contoso.com",
"actionType" : "TextResults"
}
],
"sources" : ["OCR"]
}
Om bilden innehåller en identifierad entitet, till exempel en kulturellt välkänd/populär person, plats eller sak, kan en av taggarna innehålla en entitetsinsikt. Fälten mainEntity och data är bara tillgängliga om enableEntityData attributet i Content-Type huvudet är inställt på true.
{
"image" : {
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?q=Statue+of+Liberty..."
},
"displayName" : "Statue of Liberty",
"boundingBox" : {
"queryRectangle" : {
"topLeft" : {"x" : 0.40625, "y" : 0.1757813},
"topRight" : {"x" : 0.6171875, "y" : 0.1757813},
"bottomRight" : {"x" : 0.6171875, "y" : 0.3867188},
"bottomLeft" : {"x" : 0.40625, "y" : 0.3867188}
},
"displayRectangle" : {
"topLeft" : {"x" : 0.40625, "y" : 0.1757813},
"topRight" : {"x" : 0.6171875, "y" : 0.1757813},
"bottomRight" : {"x" : 0.6171875, "y" : 0.3867188},
"bottomLeft" : {"x" : 0.40625, "y" : 0.3867188}
}
},
"actions" : [
{
"_type" : "ImageEntityAction",
"webSearchUrl" : "https:\/\/www.bing.com\/search?q=Statue+of+Liberty",
"displayName" : "Statue of Liberty",
"actionType" : "Entity",
"mainEntity" : {
"name" = "Statue of liberty",
"bingId" : "..."
},
"data" : {
"id" : "https://api.cognitive.microsoft.com/api/v7/entities/...",
"readLink": "https://www.bingapis.com/api/v7/search?q=...",
"readLinkPingSuffix": "...",
"contractualRules": [
{
"_type": "ContractualRules/LicenseAttribution",
"targetPropertyName": "description",
"mustBeCloseToContent": true,
"license": {
"name": "CC-BY-SA",
"url": "http://creativecommons.org/licenses/by-sa/3.0/",
"urlPingSuffix": "..."
},
"licenseNotice": "Text under CC-BY-SA license"
},
{
"_type": "ContractualRules/LinkAttribution",
"targetPropertyName": "description",
"mustBeCloseToContent": true,
"text": "Wikipedia",
"url": "http://en.wikipedia.org/wiki/...",
"urlPingSuffix": "..."
}
],
"webSearchUrl": "https://www.bing.com/entityexplore?q=...",
"webSearchUrlPingSuffix": "...",
"name": "Statue of Liberty",
"image": {
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=...",
"hostPageUrl": "http://upload.wikimedia.org/wikipedia/...",
"hostPageUrlPingSuffix": "...",
"width": 50,
"height": 50,
"sourceWidth": 474,
"sourceHeight": 598
},
"description" : "...",
"bingId": "..."
}
}
]
}