Standardinformationstag
Warnung
Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.
Das Standardinformationstag ist das Tag, bei dem für das Feld displayName eine leere Zeichenfolge festgelegt ist. Das folgende Beispiel zeigt die mögliche Liste von Standardinformationen (Aktionen). Die Liste der Aktionen, die in der Antwort enthalten sind, hängt vom Image ab. Und für jede Aktion kann die Liste der Eigenschaften je nach Image variieren. Überprüfen Sie also, ob die Eigenschaft vorhanden ist, bevor Sie versuchen, sie zu verwenden.
{
"_type" : "ImageKnowledge",
"tags" : [
{
"displayName" : "",
"actions" : [
{
"_type" : "ImageModuleAction",
"actionType" : "PagesIncluding",
"data" : {
"value" : [...]
}
},
{
"_type" : "ImageShoppingSourcesAction",
"actionType" : "ShoppingSources",
"data" : {
"offers" : [...]
}
},
{
"image" : {...},
"actionType" : "MoreSizes"
},
{
"_type" : "ImageModuleAction",
"actionType" : "VisualSearch",
"data" : {
"value" : [...]
}
},
{
"_type" : "ImageRecipesAction",
"actionType" : "Recipes",
"data" : {
"value" : [...]
}
},
{
"image" : {...},
"actionType" : "ImageById"
},
{
"_type" : "ImageModuleAction",
"actionType" : "ProductVisualSearch",
"data" : {
"value" : [...]
}
},
{
"_type" : "ImageRelatedSearchesAction",
"actionType" : "RelatedSearches",
"data" : {
"value" : [...]
}
},
{
"_type" : "ImageRelatedSearchesAction",
"actionType" : "DocumentLevelSuggestions",
"data" : {
"value" : [...]
}
}
]
},
{...},
{...},
{...},
{...}
],
"image" : {
"imageInsightsToken" : "bcid_AF8C9CA409421B..."
}
}
Auswertung vom Typ PagesIncluding
Die Auswertung vom Typ PagesIncluding bietet eine Liste von Webseiten, die dieses Bild enthalten. Es ist eigentlich eine Liste von Image-Objekten, und das hostPageUrl-Feld enthält die URL der Webseite, die das Bild enthält. Eine Beispielverwendung finden Sie unter Beispiel für die Auswertung vom Typ PagesIncluding.
{
"_type" : "ImageModuleAction",
"actionType" : "PagesIncluding",
"data" : {
"value" : [
{
"webSearchUrl" : "https://www.bing.com\/images\/search?",
"name" : "Today's smoking hot country",
"thumbnailUrl" : "https:\/\/tse2.mm.bing.net\/th?id=OIP...",
"datePublished" : "2017-09-20T12:00:00.0000000Z",
"contentUrl" : "http:\/\/contoso.com\/wordstuff",
"hostPageUrl" : "http:\/\/contoso.com\/2017\/09\/20\/car",
"contentSize" : "122540 B",
"encodingFormat" : "jpeg",
"hostPageDisplayUrl" : "contoso.com\/2017\/09\/20\/car",
"width" : 894,
"height" : 1200,
"thumbnail" : {
"width" : 474,
"height" : 636
},
"imageInsightsToken" : "ccid_CO5GEthj*mid_5323B1",
"insightsMetadata" : {
"pagesIncludingCount" : 12,
"availableSizesCount" : 7
},
"imageId" : "5323B1900FB9087B6B45D176D234E1F2F23CD3A5",
"accentColor" : "55585B"
}
]
}
}
Auswertung vom Typ ShoppingSources
Die Auswertung vom Typ ShoppingSources bietet eine Liste von Websites, auf denen der Benutzer den im Bild gezeigten Artikel kaufen kann. Die Liste der Angebote beinhaltet die URL der Webseite, auf der der Benutzer den Artikel kaufen kann, den Preis des Artikels und Details zur Beurteilung oder Bewertung. Ein Verwendungsbeispiel finden Sie unter Beispiel für ShoppingSources.
{
"_type" : "ImageShoppingSourcesAction",
"actionType" : "ShoppingSources",
"data" : {
"offers" : [
{
"name" : "Apple Pie",
"url" : "https:\/\/contoso.com\/product_p\/l10.htm",
"description" : "A taste of the crust, apple, and pie filling...",
"seller" : {
"name" : "Contoso"
},
"price" : 3.99,
"priceCurrency" : "USD",
"aggregateRating" : {
"ratingValue" : 5
},
"lastUpdated" : "2018-04-16T00:00:00.0000000"
}
]
}
}
Auswertung vom Typ MoreSizes
Die Auswertung vom Typ MoreSizes gibt die Anzahl unterschiedlicher Größen des Bilds (größer oder kleiner) an, die von Bing im Internet gefunden wurde (siehe availableSizesCount-Feld):
{
"image" : {
"webSearchUrl" : "https:\/\/www.bing.com\/images\/search?view=detai...",
"name" : "Making Apple Pie",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OIP....",
"datePublished" : "2013-06-21T12:00:00.0000000Z",
"contentUrl" : "http:\/\/contoso.com\/content\/uploads\/2013\/06\/apple-pie.jpg",
"hostPageUrl" : "http:\/\/contoso.com\/2013\/06\/21\/making-apple-pie\/",
"contentSize" : "134847 B",
"encodingFormat" : "jpeg",
"hostPageDisplayUrl" : "contoso.com\/2013\/06\/21\/making-apple-pie",
"width" : 1050,
"height" : 765,
"thumbnail" : {
"width" : 474,
"height" : 345
},
"imageInsightsToken" : "ccid_tmaGQ2eU*mid_D12339146CF...",
"insightsMetadata" : {
"recipeSourcesCount" : 6,
"pagesIncludingCount" : 103,
"availableSizesCount" : 28
},
"imageId" : "D12339146CFEDF3D409CC7A66D2C98D0D71904D4",
"accentColor" : "3A0B01"
},
"actionType" : "MoreSizes"
},
Auswertung vom Typ VisualSearch
Die Auswertung vom Typ VisualSearch bietet eine Liste von Bildern, die dem ursprünglichen Bild ähneln (einen ähnlichen Inhalt wie das ursprüngliche Bild aufweisen). Ein Verwendungsbeispiel finden Sie unter Beispiel für die Auswertung vom Typ VisualSearch.
{
"_type" : "ImageModuleAction",
"actionType" : "VisualSearch",
"data" : {
"value" : [
{
"webSearchUrl" : "https:\/\/www.bing.com\/images\/search?view=...",
"name" : "An apple pie...",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OIP.z...",
"datePublished" : "2017-03-18T00:17:00.0000000Z",
"contentUrl" : "http:\/\/contoso.net\/images\/8\/8a\/an_apple_pie.png",
"hostPageUrl" : "http:\/\/contoso.com\/wiki\/an_apple_pie.png",
"contentSize" : "87930 B",
"encodingFormat" : "png",
"hostPageDisplayUrl" : "contoso.com\/wiki\/an_apple_pie.png",
"width" : 263,
"height" : 192,
"thumbnail" : {
"width" : 474,
"height" : 346
},
"imageInsightsToken" : "ccid_zhRxfGkI*mid_1DCBA7AA6D231...",
"insightsMetadata" : {
"recipeSourcesCount" : 6,
"pagesIncludingCount" : 103,
"availableSizesCount" : 28
},
"imageId" : "1DCBA7AA6D23147F9DD06D47DB3A38EB25389",
"accentColor" : "3E0D01"
}
]
}
}
Auswertung vom Typ Recipes
Die Auswertung vom Typ Recipes bietet eine Liste von Webseiten, die ein Rezept für das auf dem Bild gezeigte Nahrungsmittel enthalten. Ein Verwendungsbeispiel finden Sie unter Beispiel für die Auswertung vom Typ Recipes.
{
"_type" : "ImageRecipesAction",
"actionType" : "Recipes",
"data" : {
"value" : [
{
"name" : "Granny's Apple Pie",
"url" : "http:\/\/contoso.com\/recipes\/appetizer\/apple-pie.html",
"description" : "I love Granny's apple pie. Sooooo delicious...",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=A63002cd9",
"creator" : {
"_type" : "Person",
"name" : "Charlene Whitney"
},
"aggregateRating" : {
"text" : "5",
"ratingValue" : 5,
"bestRating" : 5,
"reviewCount" : 1
},
"cookTime" : "PT45M",
"prepTime" : "PT1H",
"totalTime" : "PT1H45M"
}
]
}
}
Auswertung vom Typ ImageById
Die Auswertung vom Typ ImageById bietet ein Image-Objekt des Bilds, für das Sie Auswertungen angefordert haben:
{
"image" : {
"webSearchUrl" : "https:\/\/www.bing.com\/images\/search?view=deta...",
"name" : "Making Apple Pie",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OIP...",
"datePublished" : "2013-06-21T12:00:00.0000000Z",
"contentUrl" : "http:\/\/contoso.com\/content\/uploads\/2013\/06\/apple-pie.jpg",
"hostPageUrl" : "http:\/\/contoso.com\/2013\/06\/21\/making-apple-pie\/",
"contentSize" : "134847 B",
"encodingFormat" : "jpeg",
"hostPageDisplayUrl" : "contoso.com\/2013\/06\/21\/making-apple-pie",
"width" : 1050,
"height" : 765,
"thumbnail" : {
"width" : 474,
"height" : 345
},
"imageInsightsToken" : "ccid_tmaGQ2eU*mid_D12339146CFE...",
"insightsMetadata" : {
"recipeSourcesCount" : 6,
"pagesIncludingCount" : 103,
"availableSizesCount" : 28
},
"imageId" : "D12339146CFEDF3D409A66D2C98D0D71904D4",
"accentColor" : "3A0B01"
},
"actionType" : "ImageById"
},
Auswertung vom Typ ProductVisualSearch
Die Auswertung vom Typ ProductVisualSearch bietet eine Liste mit Bildern von Produkten, die den im ursprünglichen Bild gezeigten Produkten ähneln. Das Feld insightsMetadata kann Informationen zu Angeboten für den Erwerb des Produkts und zum Preis des Produkts enthalten.
{
"_type" : "ImageModuleAction",
"actionType" : "ProductVisualSearch",
"data" : {
"value" : [
{
"webSearchUrl" : "https:\/\/www.bing.com\/images\/search?view=detail...",
"name" : "Contoso 4-Piece Kitchen Package...",
"thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OIP.l9hzaabu-RJd...",
"datePublished" : "2017-07-16T04:28:00.0000000Z",
"contentUrl" : "https:\/\/www.contoso.com\/assets\/media\/images\/prod...",
"hostPageUrl" : "https:\/\/www.contoso.com\/4-piece-kitchen-package...",
"contentSize" : "13594 B",
"encodingFormat" : "jpeg",
"hostPageDisplayUrl" : "https:\/\/www.contoso.com\/4-piece-kitchen-package...",
"width" : 450,
"height" : 332,
"thumbnail" : {
"width" : 474,
"height" : 349
},
"imageInsightsToken" : "ccid_l9hzaabu*mid_70A8B616355D681DB9A5A...",
"insightsMetadata" : {
"shoppingSourcesCount" : 1,
"recipeSourcesCount" : 0,
"aggregateOffer" : {
"name":"4-Piece Kitchen Package with...",
"priceCurrency":"USD",
"lowPrice":2756,
"offers" : [
{
"name" : "4-Piece Kitchen Package with...",
"url" : "https:\/\/www.fabrikam.com\/1234.html?ref=bing",
"description" : "This 36 Frenchdoor refrigerator by...",
"seller" : {
"name" : "Fabrikam",
"image" : {
"url" : "https:\/\/tse1.mm.bing.net\/th?id=A818f811..."
}
},
"price" : 2756,
"priceCurrency" : "USD",
"availability" : "InStock",
"lastUpdated" : "2018-02-20T00:00:00.0000000"
}
],
"offerCount":1
},
"pagesIncludingCount" : 4,
"availableSizesCount" : 2
},
"imageId" : "70A8B616355D681DA5980A8D0514BCC995A3",
"accentColor" : "60646B"
}
]
}
}
Auswertung vom Typ RelatedSearches
Die Auswertung vom Typ RelatedSearches bietet eine Liste verwandter Suchvorgänge, die von anderen Personen durchgeführt wurden (basierend auf den Suchbegriffen anderer Benutzer). Ein Verwendungsbeispiel finden Sie unter Beispiel für die Auswertung vom Typ RelatedSearches.
{
"_type" : "ImageRelatedSearchesAction",
"actionType" : "RelatedSearches",
"data" : {
"value" : [
{
"text" : "Homemade Apple Pies Recipes",
"displayText" : "Homemade Apple Pies Recipes",
"webSearchUrl" : "https:\/\/www.bing.com\/images\/search?q=Homemade...",
"thumbnail" : {
"url" : "https:\/\/tse1.mm.bing.net\/th?q=Homemade+Apple+Pies"
}
}
]
}
}
Auswertung vom Typ DocumentLevelSuggestions
Die Auswertung vom Typ DocumentLevelSuggestions bietet eine Liste vorgeschlagener Suchbegriffe basierend auf dem Inhalt des Bilds:
{
"_type" : "ImageRelatedSearchesAction",
"actionType" : "DocumentLevelSuggestions",
"data" : {
"value" : [
{
"text" : "American Apple Pie",
"displayText" : "American Apple Pie",
"webSearchUrl" : "https:\/\/www.bing.com\/images\/search?q=American",
"thumbnail" : {
"url" : "https:\/\/tse3.mm.bing.net\/th?q=American+Apple+Pie."
}
}
]
}
}
Nächste Schritte
Sehen Sie sich Beispiele für die Verwendung von Auswertungen in Bing an, um zu erfahren, wie Bing möglicherweise die visuellen Auswertungen anzeigt.
Die folgenden Schnellstartanleitungen ermöglichen einen schnellen Einstieg in die Verwendung Ihrer ersten Anforderung: