Images.VisualSearchMethodWithHttpMessagesAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.CognitiveServices.Search.VisualSearch

Assembly:: Microsoft.Azure.CognitiveServices.Search.VisualSearch.dll

Paket:: Microsoft.Azure.CognitiveServices.Search.VisualSearch v2.0.0

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

VisualSearchMethodWithHttpMessagesAsync(String, String, String, String, String, String, String, String, String, VisualSearchRequest, Stream, Dictionary<String,List<String>>, CancellationToken)

Mit der visuellen Bildsuche-API können Sie ein Bild an Bing senden und eine Liste relevanter Tags abrufen. Jedes Tag enthält potenzielle Aktionen, an denen ein Benutzer interessiert sein könnte. Dieser Abschnitt enthält technische Details zum Anforderungsformat und den Headern, die Sie zum Anfordern von Aktionen und zu den JSON-Antwortobjekten verwenden, die diese enthalten. Beispiele für das Senden von Anforderungen finden Sie unter Suchen im Web nach Bildern.

VisualSearchMethodWithHttpMessagesAsync(String, String, String, String, String, String, String, String, String, String, Stream, Dictionary<String,List<String>>, CancellationToken)

Mit der API für die visuelle Suche können Sie Einblicke in ein Bild wie visuell ähnliche Bilder, Einkaufsquellen und verwandte Suchvorgänge gewinnen. Die API kann auch Texterkennung durchführen, Entitäten (Personen, Orte, Dinge) identifizieren, andere aktuelle Inhalte zurückgeben, die der Benutzer erkunden kann, und vieles mehr. Weitere Informationen finden Sie unter Übersicht über die visuelle Suche.

VisualSearchMethodWithHttpMessagesAsync(String, String, String, String, String, String, String, String, String, VisualSearchRequest, Stream, Dictionary<String,List<String>>, CancellationToken)

Mit der Api für die visuelle Bildsuche können Sie ein Bild an Bing senden und eine Liste relevanter Tags abrufen. Jedes Tag enthält potenzielle Aktionen, an denen ein Benutzer möglicherweise interessiert ist. Dieser Abschnitt enthält technische Details zum Anforderungsformat und den Headern, die Sie zum Anfordern von Aktionen und zu den JSON-Antwortobjekten verwenden, die diese enthalten. Beispiele zum Senden von Anforderungen finden Sie unter Suchen im Web nach Bildern.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge>> VisualSearchMethodWithHttpMessagesAsync (string acceptLanguage = default, string contentType = default, string userAgent = default, string clientId = default, string clientIp = default, string location = default, string market = default, string safeSearch = default, string setLang = default, Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.VisualSearchRequest knowledgeRequest = default, System.IO.Stream image = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member VisualSearchMethodWithHttpMessagesAsync : string * string * string * string * string * string * string * string * string * Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.VisualSearchRequest * System.IO.Stream * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge>>
override this.VisualSearchMethodWithHttpMessagesAsync : string * string * string * string * string * string * string * string * string * Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.VisualSearchRequest * System.IO.Stream * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge>>

Public Function VisualSearchMethodWithHttpMessagesAsync (Optional acceptLanguage As String = Nothing, Optional contentType As String = Nothing, Optional userAgent As String = Nothing, Optional clientId As String = Nothing, Optional clientIp As String = Nothing, Optional location As String = Nothing, Optional market As String = Nothing, Optional safeSearch As String = Nothing, Optional setLang As String = Nothing, Optional knowledgeRequest As VisualSearchRequest = Nothing, Optional image As Stream = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of ImageKnowledge))

Parameter

acceptLanguage: String

Eine durch Trennzeichen getrennte Liste einer oder mehrerer Sprachen, die für Benutzeroberflächenzeichenfolgen verwendet werden soll. Die Liste ist absteigend nach Präferenz sortiert. Weitere Informationen, einschließlich des erwarteten Formats, finden Sie unter RFC2616. Dieser Header und der abfrageparameter setLang schließen sich gegenseitig aus. Geben Sie nicht beides an. Wenn Sie diesen Header festlegen, müssen Sie auch den Abfrageparameter cc angeben. Um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen, verwendet Bing die erste unterstützte Sprache, die es aus der Liste findet, und kombiniert sie mit dem cc-Parameterwert. Enthält die Liste keine unterstützte Sprache, sucht Bing die nächstgelegene Sprache und den nächstgelegenen Markt, die bzw. der die Anforderung unterstützt. Alternativ dazu wird für die Ergebnisse ein aggregierter oder Standardmarkt verwendet. Wenn Sie sehen möchten, welchen Markt Bing verwendet hat, untersuchen Sie den Header „BingAPIs-Market“. Verwenden Sie diesen Header und den abfrageparameter cc nur, wenn Sie mehrere Sprachen angeben. Verwenden Sie andernfalls die Abfrageparameter mkt und setLang. Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird. Die JSON-Antwortobjekte enthalten nur wenige Zeichenfolgen für Benutzeroberflächen. Die Links zu Eigenschaften von „bing.com“ in den Antwortobjekten verwenden die angegebene Sprache.

contentType: String

Optionaler Anforderungsheader. Wenn Sie den Modulabfrageparameter auf RecognizedEntities festlegen, können Sie die Binärdatei eines Bilds im Textkörper einer POST-Anforderung angeben. Wenn Sie das Bild im Textkörper einer POST-Anforderung angeben, müssen Sie diesen Header angeben und seinen Wert auf mehrteilig/form-daten festlegen. Die maximale Bildgröße beträgt 1 MB.

userAgent: String

Der Benutzer-Agent, von dem die Anforderung stammt. Bing verwendet den Benutzer-Agent, um die Erfahrung mobiler Benutzer zu optimieren. Auch wenn dies optional ist, sollten Sie diesen Header immer angeben. Der Benutzer-Agent sollte der Zeichenfolge entsprechen, die alle häufig verwendeten Browser senden. Informationen zu Benutzer-Agents finden Sie unter RFC 2616. Im Folgenden sind Beispiele für Benutzer-Agent-Zeichenfolgen aufgeführt. Windows Phone: Mozilla/5.0 (kompatibel; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - uns; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; wie Gecko) Version / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1 wie Mac OS X) AppleWebKit / 536.26 (KHTML; wie Gecko) Mobile / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Dreizack / 7.0; Touch; rv:11.0) wie Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0 wie Mac OS X) AppleWebKit / 537.51.1 (KHTML, wie Gecko) Version / 7.0 Mobile / 11A465 Safari / 9537.53

clientId: String

Bing verwendet diesen Header, um Benutzern beim Aufrufen der Bing-API ein konsistentes Verhalten bereitzustellen. Bing testet häufig neue Funktionen und Verbesserungen und verwendet dabei die Client-ID als Schlüssel für die Zuweisung von Datenverkehr an verschiedene Flights. Wenn Sie für einen Benutzer bei unterschiedlichen Anforderungen nicht dieselbe Client-ID verwenden, weist Bing den Benutzer möglicherweise mehreren widersprüchlichen Flights zu. Die Zuweisung zu mehreren widersprüchlichen Flights kann zu einer inkonsistenten Benutzererfahrung führen. Weist die zweite Anforderung beispielsweise eine andere Flight-Zuweisung als die erste auf, kann dies zu einer unerwarteten Benutzererfahrung führen. Außerdem kann Bing die Client-ID zur Anpassung der Webergebnisse an den Suchverlauf dieser Client-ID verwenden. Dies führt zu einer noch besseren Benutzererfahrung. Bing verwendet den Header auch, um die Rangfolge der Ergebnisse zu verbessern, indem es die Aktivität der Client-ID analysiert. Durch die verbesserte Relevanz erhöht sich die Qualität der von Bing-APIs bereitgestellten Ergebnisse, was wiederum zu höheren Durchklickraten für den API-Consumer führt. WICHTIG: Auch wenn er optional ist, sollten Sie diesen Header als erforderlich betrachten. Das Beibehalten der Client-ID für dieselbe Kombination aus Benutzer und Gerät über mehrere Anforderungen hinweg ermöglicht 1) dem API-Consumer eine konsistente Benutzererfahrung sowie 2) höhere Durchklickraten durch eine bessere Qualität der Bing-API-Ergebnisse. Jeder Benutzer, der die Anwendung auf dem Gerät verwendet, muss über eine eindeutige, von Bing generierte Client-ID verfügen. Wenn Sie diesen Header nicht in die Anforderung einfügen, generiert Bing eine ID, die im Antwortheader „X-MSEdge-ClientID“ zurückgegeben wird. Der einzige Zeitpunkt, zu dem dieser Header NICHT in eine Anforderung eingeschlossen werden sollte, ist bei der erstmaligen Verwendung der App auf dem Gerät. Verwenden Sie die Client-ID für jede Anforderung der Bing-API, die die App für diesen Benutzer auf dem Gerät durchführt. Behalten Sie die Client-ID bei. Verwenden Sie ein permanentes HTTP-Cookie, um sicherzustellen, dass die ID in einer Browser-App bei allen Sitzungen verwendet wird. Verwenden Sie kein Sitzungscookie. Verwenden Sie für andere Apps wie z.B. mobile Apps den permanenten Speicher des Geräts, um die ID beizubehalten. Rufen Sie bei der nächsten Verwendung der App auf dem Gerät durch den Benutzer die gespeicherte Client-ID ab. Bing-Antworten können diesen Header enthalten, müssen es aber nicht. Enthält die Antwort diesen Header, erfassen Sie die Client-ID, und verwenden Sie sie für alle nachfolgenden Bing-Anforderungen des Benutzers auf diesem Gerät. Wenn Sie den Header „X-MSEdge-ClientID“ einfügen, dürfen Sie in die Anforderung nicht gleichzeitig Cookies einschließen.

clientIp: String

Die IPv4- oder IPv6-Adresse des Clientgeräts. Die IP-Adresse wird verwendet, um den Standort des Benutzers zu ermitteln. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten. Auch wenn dies optional ist, sollten Sie diesen Header und den Header „X-Search-Location“ immer angeben. Verschleiern Sie nicht die Adresse (z.B. durch Ändern des letzten Oktetts in 0). Durch Verschleiern der Adresse stimmen Ihr Standort und der tatsächliche Gerätestandort nicht überein, wodurch Bing möglicherweise fehlerhafte Ergebnisse anzeigt.

location: String

Eine durch Semikolons getrennte Liste mit Schlüssel/Wert-Paaren, die den geografischen Standort des Clients beschreiben. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten und zur Rückgabe von lokalen relevanten Inhalten. Geben Sie das Schlüssel-Wert-Paar im Format <Schlüssel>:<Wert> an. Verwenden Sie die folgenden Schlüssel zur Angabe des Benutzerstandorts. lat (erforderlich): Der Breitengrad des Clientstandorts in Grad. Der Breitengrad muss größer als oder gleich -90,0 und kleiner als oder gleich +90,0 sein. Negative Werte geben südliche Breitengrade und positive Werte nördliche Breitengrade an. long (erforderlich): Der Längengrad des Clientstandorts in Grad. Der Längengrad muss größer als oder gleich -180,0 und kleiner als oder gleich +180,0 sein. Negative Werte geben westliche Längengrade und positive Werte östliche Längengrade an. re (erforderlich): Der Radius in Metern, der die horizontale Genauigkeit der Koordinaten angibt. Übergeben Sie den Wert, der vom Standortdienst des Geräts zurückgegeben wird. Typische Werte sind 22 m für GPS/WLAN, 380 m für die Funkmasttriangulation und 18.000 m für die umgekehrte IP-Suche. ts (optional): Der UTC-UNIX-Zeitstempel des Zeitpunkts, an dem sich der Client am Standort befand. (Der UNIX-Zeitstempel ist die Anzahl von Sekunden seit dem 1. Januar 1970.) head (optional): Die relative Richtung oder Fahrtrichtung des Clients. Geben Sie die Reiserichtung von 0 bis 360 (in Grad) im Uhrzeigersinn ausgehend vom geografischen Norden an. Geben Sie diesen Schlüssel nur an, wenn der SP-Schlüssel nichtzero ist. sp (optional): Die horizontale Geschwindigkeit (Geschwindigkeit) in Metern pro Sekunde, die das Clientgerät unterwegs ist. alt (optional): Die Höhe des Clientgeräts in Metern. sind (optional): Der Radius in Metern, der die vertikale Genauigkeit der Koordinaten angibt. Geben Sie diesen Schlüssel nur an, wenn Sie die Alt-Taste angeben. Auch wenn viele der Schlüssel optional sind, werden die Standortergebnisse immer genauer, je mehr Informationen Sie bereitstellen. Auch wenn dies optional ist, sollten Sie den geografischen Standort des Benutzers immer angeben. Besonders wichtig ist die Standortangabe dann, wenn die IP-Adresse des Clients den physischen Standort des Benutzers nicht exakt wiedergibt (wenn der Client beispielsweise VPN verwendet). Für optimale Ergebnisse sollten Sie diesen Header und den Header „X-MSEdge-ClientIP“ einfügen. Auf jeden Fall sollten Sie aber zumindest diesen Header verwenden.

market: String

Der Markt, aus dem die Ergebnisse stammen. In der Regel ist mkt das Land, aus dem der Benutzer die Anforderung stellt. Es kann jedoch ein anderes Land sein, wenn sich der Benutzer nicht in einem Land befindet, in dem Bing Ergebnisse liefert. Der Markt muss in der Formatsprache <Code-Ländercode><> vorliegen. Beispiel: en-US. Bei der Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet. Eine Liste der möglichen Marktwerte finden Sie unter Marktcodes. HINWEIS: Falls bekannt, sollten Sie immer den Markt angeben. Die Angabe des Marktes ermöglicht Bing, die Anforderung weiterzuleiten und eine geeignete und optimale Antwort zurückzugeben. Wenn Sie einen Markt angeben, der nicht in Marktcodes aufgeführt ist, verwendet Bing einen am besten geeigneten Marktcode, der auf einer internen Zuordnung basiert, die Änderungen unterliegt.

safeSearch: String

Filtern Sie die Bildergebnisse in Aktionen mit dem Typ "VisualSearch" für nicht jugendfreie Inhalte. Im Folgenden sind die möglichen Filterwerte aufgeführt. Off: Kann Bilder mit nicht jugendfreiem Inhalt zurückgeben. Mittel: Geben Sie keine Bilder mit nicht jugendfreiem Inhalt zurück. Streng: Geben Sie keine Bilder mit nicht jugendfreien Inhalten zurück. Die Standardeinstellung ist „Moderate“. Wenn die Anforderung aus einem Markt stammt, für den die Bing-Richtlinie für Erwachsene erfordert, dass safeSearch auf Strict festgelegt ist, ignoriert Bing den safeSearch-Wert und verwendet Strict. Wenn Sie den Website:-Filter in der Wissensanforderung verwenden, besteht die Möglichkeit, dass die Antwort nicht jugendfreie Inhalte enthält, unabhängig davon, auf was der safeSearch-Abfrageparameter festgelegt ist. Website verwenden: Nur, wenn Sie die Inhalte auf der Website kennen und Ihr Szenario die Möglichkeit von nicht jugendfreien Inhalten unterstützt. Mögliche Werte: "Off", "Moderate", "Strict"

setLang: String

Die Sprache, die für Zeichenfolgen der Benutzeroberfläche verwendet werden soll. Geben Sie die Sprache mithilfe des zweistelligen Sprachcodes nach ISO 639-1 an. Der Sprachcode für Englisch lautet z.B. „EN“. Der Standardwert ist „EN“ (Englisch). Auch wenn dies optional ist, sollten Sie immer eine Sprache angeben. In der Regel legen Sie setLang auf die gleiche Sprache fest, die von mkt angegeben wird, es sei denn, der Benutzer möchte, dass die Benutzeroberflächenzeichenfolgen in einer anderen Sprache angezeigt werden. Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird. Die JSON-Antwortobjekte enthalten nur wenige Zeichenfolgen für Benutzeroberflächen. Die angegebene Sprache wird auch in Links zu Eigenschaften von „bing.com“ in den Antwortobjekten verwendet.

knowledgeRequest: VisualSearchRequest

Ein JSON-Objekt, das Informationen zum Bild enthält. Die Felder image und imageInsightsToken schließen sich gegenseitig aus. Der Text der Anforderung darf nur eines davon enthalten.

image: Stream

Die hochgeladene Bilddatei. Die Größe des Images ist auf 1 MB beschränkt, und der Dateiname muss "image" lauten. Die Felder image und imageInsightsToken schließen sich gegenseitig aus. Der Text der Anforderung darf nur eines davon enthalten.

customHeaders: Dictionary<String,List<String>>

Header, die der Anforderung hinzugefügt werden.

cancellationToken: CancellationToken

Das Abbruchtoken.

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

SerializationException

Wird ausgelöst, wenn die Antwort nicht deserialisiert werden kann

Gilt für:

VisualSearchMethodWithHttpMessagesAsync(String, String, String, String, String, String, String, String, String, String, Stream, Dictionary<String,List<String>>, CancellationToken)

Mit der API für die visuelle Suche können Sie Erkenntnisse zu einem Bild gewinnen, z. B. visuell ähnliche Bilder, Einkaufsquellen und verwandte Suchvorgänge. Die API kann auch Texterkennung durchführen, Entitäten (Personen, Orte, Dinge) identifizieren, andere aktuelle Inhalte zurückgeben, die der Benutzer untersuchen kann, und vieles mehr. Weitere Informationen finden Sie unter Übersicht über die visuelle Suche.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge>> VisualSearchMethodWithHttpMessagesAsync (string acceptLanguage = default, string contentType = default, string userAgent = default, string clientId = default, string clientIp = default, string location = default, string market = default, string safeSearch = default, string setLang = default, string knowledgeRequest = default, System.IO.Stream image = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member VisualSearchMethodWithHttpMessagesAsync : string * string * string * string * string * string * string * string * string * string * System.IO.Stream * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge>>
override this.VisualSearchMethodWithHttpMessagesAsync : string * string * string * string * string * string * string * string * string * string * System.IO.Stream * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge>>

Public Function VisualSearchMethodWithHttpMessagesAsync (Optional acceptLanguage As String = Nothing, Optional contentType As String = Nothing, Optional userAgent As String = Nothing, Optional clientId As String = Nothing, Optional clientIp As String = Nothing, Optional location As String = Nothing, Optional market As String = Nothing, Optional safeSearch As String = Nothing, Optional setLang As String = Nothing, Optional knowledgeRequest As String = Nothing, Optional image As Stream = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of ImageKnowledge))

Parameter

acceptLanguage: String

Eine durch Trennzeichen getrennte Liste einer oder mehrerer Sprachen, die für Benutzeroberflächenzeichenfolgen verwendet werden soll. Die Liste ist absteigend nach Präferenz sortiert. Weitere Informationen, einschließlich des erwarteten Formats, finden Sie unter RFC2616. Dieser Header und der setLang-Abfrageparameter schließen sich gegenseitig aus. geben Sie nicht beide an. Wenn Sie diesen Header festlegen, müssen Sie auch den Abfrageparameter cc angeben. Um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen, verwendet Bing die erste unterstützte Sprache, die es aus der Liste findet, und kombiniert sie mit dem Cc-Parameterwert. Enthält die Liste keine unterstützte Sprache, sucht Bing die nächstgelegene Sprache und den nächstgelegenen Markt, die bzw. der die Anforderung unterstützt. Alternativ dazu wird für die Ergebnisse ein aggregierter oder Standardmarkt verwendet. Wenn Sie sehen möchten, welchen Markt Bing verwendet hat, untersuchen Sie den Header „BingAPIs-Market“. Verwenden Sie diesen Header und den abfrageparameter cc nur, wenn Sie mehrere Sprachen angeben. Verwenden Sie andernfalls die Abfrageparameter mkt und setLang. Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird. Die JSON-Antwortobjekte enthalten nur wenige Zeichenfolgen für Benutzeroberflächen. Die Links zu Eigenschaften von „bing.com“ in den Antwortobjekten verwenden die angegebene Sprache.

contentType: String

Er muss festgelegt sein auf „multipart/form-data“ und einen Begrenzungsparameter enthalten (z.B. „multipart/form-data; boundary=<boundary string>“). Weitere Informationen finden Sie unter Inhaltsformulartypen.

userAgent: String

Der Benutzer-Agent, von dem die Anforderung stammt. Bing verwendet den Benutzer-Agent, um die Erfahrung mobiler Benutzer zu optimieren. Auch wenn dies optional ist, sollten Sie diesen Header immer angeben. Der Benutzer-Agent sollte der Zeichenfolge entsprechen, die alle häufig verwendeten Browser senden. Informationen zu Benutzer-Agents finden Sie unter RFC 2616. Im Folgenden sind Beispiele für Benutzer-Agent-Zeichenfolgen aufgeführt. Windows Phone: Mozilla/5.0 (kompatibel; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - uns; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; wie Gecko) Version / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1 wie Mac OS X) AppleWebKit / 536.26 (KHTML; wie Gecko) Mobile / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Trident / 7.0; Touch; rv:11.0) wie Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0 wie Mac OS X) AppleWebKit / 537.51.1 (KHTML, wie Gecko) Version / 7.0 Mobile / 11A465 Safari / 9537.53.

clientId: String

Bing verwendet diesen Header, um Benutzern beim Aufrufen der Bing-API ein konsistentes Verhalten bereitzustellen. Bing testet häufig neue Funktionen und Verbesserungen und verwendet dabei die Client-ID als Schlüssel für die Zuweisung von Datenverkehr an verschiedene Flights. Wenn Sie für einen Benutzer bei unterschiedlichen Anforderungen nicht dieselbe Client-ID verwenden, weist Bing den Benutzer möglicherweise mehreren widersprüchlichen Flights zu. Die Zuweisung zu mehreren widersprüchlichen Flights kann zu einer inkonsistenten Benutzererfahrung führen. Weist die zweite Anforderung beispielsweise eine andere Flight-Zuweisung als die erste auf, kann dies zu einer unerwarteten Benutzererfahrung führen. Außerdem kann Bing die Client-ID zur Anpassung der Webergebnisse an den Suchverlauf dieser Client-ID verwenden. Dies führt zu einer noch besseren Benutzererfahrung. Bing verwendet den Header auch, um die Rangfolge der Ergebnisse zu verbessern, indem es die Aktivität der Client-ID analysiert. Durch die verbesserte Relevanz erhöht sich die Qualität der von Bing-APIs bereitgestellten Ergebnisse, was wiederum zu höheren Durchklickraten für den API-Consumer führt. WICHTIG: Auch wenn er optional ist, sollten Sie diesen Header als erforderlich betrachten. Das Beibehalten der Client-ID für dieselbe Kombination aus Benutzer und Gerät über mehrere Anforderungen hinweg ermöglicht 1) dem API-Consumer eine konsistente Benutzererfahrung sowie 2) höhere Durchklickraten durch eine bessere Qualität der Bing-API-Ergebnisse. Jeder Benutzer, der die Anwendung auf dem Gerät verwendet, muss über eine eindeutige, von Bing generierte Client-ID verfügen. Wenn Sie diesen Header nicht in die Anforderung einfügen, generiert Bing eine ID, die im Antwortheader „X-MSEdge-ClientID“ zurückgegeben wird. Der einzige Zeitpunkt, zu dem dieser Header NICHT in eine Anforderung eingeschlossen werden sollte, ist bei der erstmaligen Verwendung der App auf dem Gerät. Verwenden Sie die Client-ID für jede Anforderung der Bing-API, die die App für diesen Benutzer auf dem Gerät durchführt. Behalten Sie die Client-ID bei. Verwenden Sie ein permanentes HTTP-Cookie, um sicherzustellen, dass die ID in einer Browser-App bei allen Sitzungen verwendet wird. Verwenden Sie kein Sitzungscookie. Verwenden Sie für andere Apps wie z.B. mobile Apps den permanenten Speicher des Geräts, um die ID beizubehalten. Rufen Sie bei der nächsten Verwendung der App auf dem Gerät durch den Benutzer die gespeicherte Client-ID ab. Bing-Antworten können diesen Header enthalten, müssen es aber nicht. Enthält die Antwort diesen Header, erfassen Sie die Client-ID, und verwenden Sie sie für alle nachfolgenden Bing-Anforderungen des Benutzers auf diesem Gerät. ACHTUNG: Vergewissern Sie sich, dass die Client-ID nicht mit authentifizierbaren Benutzerkontoinformationen verknüpft werden kann. Wenn Sie den Header „X-MSEdge-ClientID“ einfügen, dürfen Sie in die Anforderung nicht gleichzeitig Cookies einschließen.

clientIp: String

location: String

Eine durch Semikolons getrennte Liste mit Schlüssel/Wert-Paaren, die den geografischen Standort des Clients beschreiben. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten und zur Rückgabe von lokalen relevanten Inhalten. Geben Sie das Schlüssel-Wert-Paar im Format <Schlüssel>:<Wert> an. Verwenden Sie die folgenden Schlüssel zur Angabe des Benutzerstandorts. lat (erforderlich): Der Breitengrad des Clientstandorts in Grad. Der Breitengrad muss größer als oder gleich -90,0 und kleiner als oder gleich +90,0 sein. Negative Werte geben südliche Breitengrade und positive Werte nördliche Breitengrade an. long (erforderlich): Der Längengrad des Standorts des Clients in Grad. Der Längengrad muss größer als oder gleich -180,0 und kleiner als oder gleich +180,0 sein. Negative Werte geben westliche Längengrade und positive Werte östliche Längengrade an. re (erforderlich): Der Radius in Metern, der die horizontale Genauigkeit der Koordinaten angibt. Übergeben Sie den Wert, der vom Standortdienst des Geräts zurückgegeben wird. Typische Werte sind 22 m für GPS/WLAN, 380 m für die Funkmasttriangulation und 18.000 m für die umgekehrte IP-Suche. ts (optional): Der UTC-UNIX-Zeitstempel des Zeitpunkts, an dem sich der Client am Standort befand. (Der UNIX-Zeitstempel ist die Anzahl der Sekunden seit dem 1. Januar 1970.) head (optional): Die relative Richtung oder Richtung des Clients. Geben Sie die Reiserichtung von 0 bis 360 (in Grad) im Uhrzeigersinn ausgehend vom geografischen Norden an. Geben Sie diesen Schlüssel nur an, wenn der SP-Schlüssel ungleich null ist. sp (optional): Die horizontale Geschwindigkeit (Geschwindigkeit) in Metern pro Sekunde, die das Clientgerät unterwegs ist. alt (optional): Die Höhe des Clientgeräts in Metern. are (optional): Der Radius in Metern, der die vertikale Genauigkeit der Koordinaten angibt. Geben Sie diesen Schlüssel nur an, wenn Sie die Alt-Taste angeben. Auch wenn viele der Schlüssel optional sind, werden die Standortergebnisse immer genauer, je mehr Informationen Sie bereitstellen. Auch wenn dies optional ist, sollten Sie den geografischen Standort des Benutzers immer angeben. Besonders wichtig ist die Standortangabe dann, wenn die IP-Adresse des Clients den physischen Standort des Benutzers nicht exakt wiedergibt (wenn der Client beispielsweise VPN verwendet). Für optimale Ergebnisse sollten Sie diesen Header und den Header „X-MSEdge-ClientIP“ einfügen. Auf jeden Fall sollten Sie aber zumindest diesen Header verwenden.

market: String

Der Markt, aus dem die Ergebnisse stammen. In der Regel ist mkt das Land, aus dem der Benutzer die Anforderung sendet. Es kann sich jedoch um ein anderes Land handelt, wenn sich der Benutzer nicht in einem Land befindet, in dem Bing Ergebnisse liefert. Der Markt muss in der Formatsprache <Code-Ländercode>> vorliegen<. Beispiel: en-US. Bei der Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet. Eine Liste der möglichen Marktwerte finden Sie unter Marktcodes. HINWEIS: Falls bekannt, sollten Sie immer den Markt angeben. Die Angabe des Marktes ermöglicht Bing, die Anforderung weiterzuleiten und eine geeignete und optimale Antwort zurückzugeben. Wenn Sie einen Markt angeben, der nicht in Marktcodes aufgeführt ist, verwendet Bing einen am besten geeigneten Marktcode, der auf einer internen Zuordnung basiert, die Änderungen unterliegt.

safeSearch: String

setLang: String

knowledgeRequest: String

Die Formulardaten sind ein JSON-Objekt, das das Bild mithilfe eines Insights-Tokens oder einer URL zum Bild identifiziert. Das Objekt kann auch einen optionalen Zuschneidebereich enthalten, der einen relevanten Bereich im Bild identifiziert. Das Insights-Token und die URL schließen sich gegenseitig aus. Geben Sie nicht beides an. Sie können knowledgeRequest-Formulardaten und Bildformulardaten in derselben Anforderung nur angeben, wenn knowledgeRequest-Formulardaten nur das Feld cropArea angeben (es darf kein Insights-Token oder eine URL enthalten).

image: Stream

Die Formulardaten sind eine Bildbinärdatei. Der Name-Parameter des Content-Disposition-Headers muss auf "image" festgelegt werden. Sie müssen eine Bildbinärdatei angeben, wenn Sie zum Angeben des Bilds keine knowledgeRequest-Formulardaten verwenden. Sie dürfen nicht beide Formulare verwenden, um ein Bild anzugeben. Sie können knowledgeRequest-Formulardaten und Bildformulardaten in derselben Anforderung nur angeben, wenn knowledgeRequest-Formulardaten nur das Feld cropArea angeben (es darf kein Insights-Token oder eine URL enthalten).