Freigeben über


BingImages.BingImagesDetailsDefinitionStages.WithAllOptions Schnittstelle

public interface WithAllOptions

Die Phase der Definition, in der alle anderen optionalen Einstellungen angegeben werden können.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
BingImagesDetailsDefinitionStages.WithExecute withAcceptLanguage(String acceptLanguage)

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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Dieser Header und der [setLang]()-https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#setlangAbfrageparameter schließen sich gegenseitig aus. Geben Sie nicht beides an. Wenn Sie diesen Header festlegen, müssen Sie auch den [cc](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#cc)-Abfrageparameter 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](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt) und [setLang](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#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.

BingImagesDetailsDefinitionStages.WithExecute withClientId(String clientId)

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.

BingImagesDetailsDefinitionStages.WithExecute withClientIp(String clientIp)

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.

BingImagesDetailsDefinitionStages.WithExecute withContentType(String contentType)

Optionaler Anforderungsheader. Wenn Sie den [modules* ](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#modulesrequested)-Abfrageparameter auf RecognizedEntities festlegen, können Sie die Binärdatei eines Bilds im Textkörper einer POST-Anforderung angeben. Wenn Sie das Bild im Text einer POST-Anforderung angeben, müssen Sie diesen Header angeben und dessen Wert auf multipart/form-data festlegen. Die maximale Bildgröße beträgt 1 MB.

BingImagesDetailsDefinitionStages.WithExecute withCountryCode(String countryCode)

Ein zweistelliger Ländercode des Landes, aus dem die Ergebnisse stammen. Eine Liste der möglichen Werte finden Sie unter [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). Wenn Sie diesen Parameter festlegen, müssen Sie auch den Header [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage) angeben. Bing verwendet die erste unterstützte Sprache, die es aus der Sprachenliste findet, und kombiniert diese Sprache mit dem Ländercode, den Sie angeben, um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen. Wenn die Sprachenliste keine unterstützte Sprache enthält, findet Bing die nächstgelegene Sprache und den nächstgelegenen Markt, der die Anforderung unterstützt, oder es kann einen aggregierten oder Standardmarkt für die Ergebnisse anstelle eines angegebenen verwenden. Sie sollten diesen Abfrageparameter und den Accept-Language Abfrageparameter nur verwenden, wenn Sie mehrere Sprachen angeben. Andernfalls sollten Sie die Abfrageparameter mkt und setLang verwenden. Dieser Parameter und der [mkt](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt)-Abfrageparameter schließen sich gegenseitig aus– geben Sie nicht beide an.

BingImagesDetailsDefinitionStages.WithExecute withCropBottom(Double cropBottom)

Die untere Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withCropLeft(Double cropLeft)

Die linke Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withCropRight(Double cropRight)

Die rechte Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withCropTop(Double cropTop)

Die obere Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withCropType(ImageCropType cropType)

Der Zuschneidetyp, der beim Zuschneiden des Bilds basierend auf den Koordinaten verwendet werden soll, die in den Parametern cal, cat, car und cab angegeben sind. Folgende Werte sind möglich: 0: Rechteckig (Standard). Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen. Mögliche Werte sind: "Rechteckig".

BingImagesDetailsDefinitionStages.WithExecute withId(String id)

Eine ID, die ein Bild eindeutig identifiziert. Verwenden Sie diesen Parameter, um sicherzustellen, dass das angegebene Bild das erste Bild in der Liste der Bilder ist, das Von Bing zurückgegeben wird. Das ImageId-Feld des [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image)-Objekts enthält die ID, auf die Sie diesen Parameter festlegen.

BingImagesDetailsDefinitionStages.WithExecute withImageUrl(String imageUrl)

Die URL eines Bilds, von dem Sie Einblicke erhalten möchten. Verwenden Sie diesen Parameter als Alternative zur Verwendung des InsightsToken-Parameters, um das Bild anzugeben. Sie können das Bild auch angeben, indem Sie die Binärdatei des Bilds im Textkörper einer POST-Anforderung platzieren. Wenn Sie die binäre Option verwenden, lesen Sie den Header [Content* -Type](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#contenttype). Die maximal unterstützte Bildgröße beträgt 1 MB. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withInsightsToken(String insightsToken)

Ein Imagetoken. [imageInsightsToken](https:* //docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-referenceimage-imageinsightstoken) des [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image)-Objekts enthält das Token. Geben Sie diesen Parameter an, um zusätzliche Informationen zu einem Bild abzurufen, z. B. eine Untertitel oder Einkaufsquelle. Eine Liste der zusätzlichen Informationen zu einem Bild, das Sie abrufen können, finden Sie im Abfrageparameter [modules* ](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#modulesrequested). Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withLocation(String location)

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.

BingImagesDetailsDefinitionStages.WithExecute withMarket(String market)

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 [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). 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 [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes) aufgeführt ist, verwendet Bing einen am besten geeigneten Marktcode, der auf einer internen Zuordnung basiert, die änderungen vorbehalten ist. Dieser Parameter und der [cc]()-https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#ccAbfrageparameter schließen sich gegenseitig aus– geben Sie nicht beide an.

BingImagesDetailsDefinitionStages.WithExecute withModules(List<ImageInsightModule> modules)

Eine durch Trennzeichen getrennte Liste von Insights, die angefordert werden sollen. Die folgenden Werte (ohne Beachtung von Groß-/Kleinschreibung) sind möglich. Alle: Gibt alle Erkenntnisse zurück, sofern verfügbar, mit Ausnahme von RecognizedEntities. BRQ: Beste repräsentative Abfrage. Der Abfragebegriff, der das Bild am besten beschreibt. Beschriftung: Eine Untertitel, die Informationen zum Bild bereitstellt. Wenn die Untertitel Entitäten enthält, kann die Antwort Links zu Bildern dieser Entitäten enthalten. Sammlungen: Eine Liste verwandter Bilder. Rezepte: Eine Liste von Rezepten zum Kochen des Essens, das in den Bildern gezeigt wird. PagesIncluding: Eine Liste der Webseiten, die das Bild enthalten. RecognizedEntities: Eine Liste der Entitäten (Personen), die im Bild erkannt wurden. HINWEIS: Sie dürfen dieses Modul nicht mit einem anderen Modul angeben. Wenn Sie sie mit anderen Modulen angeben, enthält die Antwort keine erkannten Entitäten. RelatedSearches: Eine Liste verwandter Suchvorgänge, die von anderen Personen durchgeführt wurden. ShoppingSources: Eine Liste von Händlern, in denen Sie verwandte Angebote kaufen können. SimilarImages: Eine Liste von Bildern, die dem ursprünglichen Bild visuell ähnlich sind. SimilarProducts: Eine Liste von Bildern, die ein Produkt enthalten, das einem Produkt im Originalbild ähnelt. Tags: Stellt Merkmale des Inhaltstyps im Bild bereit. Wenn das Bild beispielsweise von einer Person ist, können die Tags das Geschlecht und die Art der Kleidung der Person angeben, die sie trägt. Wenn Sie ein Modul angeben und keine Daten für das Modul vorhanden sind, enthält das Antwortobjekt das zugehörige Feld nicht. Wenn Sie beispielsweise Caption angeben und nicht vorhanden ist, enthält die Antwort nicht das Feld imageCaption. Um verwandte Suchvorgänge einzuschließen, muss die Anforderung die ursprüngliche Abfragezeichenfolge enthalten. Obwohl die ursprüngliche Abfragezeichenfolge für ähnliche Bilder oder Produkte nicht erforderlich ist, sollten Sie sie immer einschließen, da sie zur Verbesserung der Relevanz und der Ergebnisse beitragen kann. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

BingImagesDetailsDefinitionStages.WithExecute withSafeSearch(SafeSearch safeSearch)

Filtern sie Bilder nach nicht jugendfreien Inhalten. Im Folgenden sind die möglichen Filterwerte aufgeführt. Off: Kann Bilder mit nicht jugendfreiem Inhalt zurückgeben. Wenn die Anforderung über die Bildsuche-API erfolgt, enthält die Antwort Miniaturansichten, die eindeutig (nicht fuzzy) sind. Wenn die Anforderung jedoch über die Websuche-API erfolgt, enthält die Antwort Miniaturansichten, die pixelig (Fuzzy) sind. Mittel: Wenn die Anforderung über die Bildersuche-API erfolgt, enthält die Antwort keine Bilder mit nicht jugendfreiem Inhalt. Wenn die Anforderung über die Websuche-API erfolgt, kann die Antwort Bilder mit nicht jugendfreiem Inhalt enthalten (die Miniaturansichten sind pixeliert (Fuzzy)). 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 Abfrageoperator site: verwenden, besteht die Möglichkeit, dass die Antwort nicht jugendfreie Inhalte enthält, unabhängig davon, auf was der abfrageparameter safeSearch 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 sind: "Off", "Moderate", "Strict".

BingImagesDetailsDefinitionStages.WithExecute withSetLang(String setLang)

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. Dieser Parameter und der [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage)-Header schließen sich gegenseitig aus. Geben Sie nicht beides an. 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.

BingImagesDetailsDefinitionStages.WithExecute withUserAgent(String userAgent)

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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Nachfolgend einige Beispiele für Zeichenfolgen für Benutzer-Agents. 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.

Details zur Methode

withAcceptLanguage

public BingImagesDetailsDefinitionStages.WithExecute withAcceptLanguage(String acceptLanguage)

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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Dieser Header und der [setLang]()-https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#setlangAbfrageparameter schließen sich gegenseitig aus. Geben Sie nicht beides an. Wenn Sie diesen Header festlegen, müssen Sie auch den [cc](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#cc)-Abfrageparameter 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](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt) und [setLang](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#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.

Parameters:

acceptLanguage

Returns:

nächste Definitionsphase

withClientId

public BingImagesDetailsDefinitionStages.WithExecute withClientId(String clientId)

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.

Parameters:

clientId

Returns:

nächste Definitionsphase

withClientIp

public BingImagesDetailsDefinitionStages.WithExecute withClientIp(String clientIp)

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.

Parameters:

clientIp

Returns:

Nächste Definitionsphase

withContentType

public BingImagesDetailsDefinitionStages.WithExecute withContentType(String contentType)

Optionaler Anforderungsheader. Wenn Sie den [modules* ](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#modulesrequested)-Abfrageparameter auf RecognizedEntities festlegen, können Sie die Binärdatei eines Bilds im Textkörper einer POST-Anforderung angeben. Wenn Sie das Bild im Text einer POST-Anforderung angeben, müssen Sie diesen Header angeben und dessen Wert auf multipart/form-data festlegen. Die maximale Bildgröße beträgt 1 MB.

Parameters:

contentType

Returns:

Nächste Definitionsphase

withCountryCode

public BingImagesDetailsDefinitionStages.WithExecute withCountryCode(String countryCode)

Ein zweistelliger Ländercode des Landes, aus dem die Ergebnisse stammen. Eine Liste der möglichen Werte finden Sie unter [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). Wenn Sie diesen Parameter festlegen, müssen Sie auch den Header [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage) angeben. Bing verwendet die erste unterstützte Sprache, die es aus der Sprachenliste findet, und kombiniert diese Sprache mit dem Ländercode, den Sie angeben, um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen. Wenn die Sprachenliste keine unterstützte Sprache enthält, findet Bing die nächstgelegene Sprache und den nächstgelegenen Markt, der die Anforderung unterstützt, oder es kann einen aggregierten oder Standardmarkt für die Ergebnisse anstelle eines angegebenen verwenden. Sie sollten diesen Abfrageparameter und den Accept-Language Abfrageparameter nur verwenden, wenn Sie mehrere Sprachen angeben. Andernfalls sollten Sie die Abfrageparameter mkt und setLang verwenden. Dieser Parameter und der [mkt](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt)-Abfrageparameter schließen sich gegenseitig aus– geben Sie nicht beide an.

Parameters:

countryCode

Returns:

Nächste Definitionsphase

withCropBottom

public BingImagesDetailsDefinitionStages.WithExecute withCropBottom(Double cropBottom)

Die untere Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

cropBottom

Returns:

Nächste Definitionsphase

withCropLeft

public BingImagesDetailsDefinitionStages.WithExecute withCropLeft(Double cropLeft)

Die linke Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

cropLeft

Returns:

Nächste Definitionsphase

withCropRight

public BingImagesDetailsDefinitionStages.WithExecute withCropRight(Double cropRight)

Die rechte Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

cropRight

Returns:

Nächste Definitionsphase

withCropTop

public BingImagesDetailsDefinitionStages.WithExecute withCropTop(Double cropTop)

Die obere Koordinate des zuzuschneidenden Bereichs. Die Koordinate ist ein Bruchteil der Höhe des ursprünglichen Bilds und wird von der oberen linken Ecke des Bilds gemessen. Geben Sie die Koordinate als Wert von 0,0 bis 1,0 an. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

cropTop

Returns:

Nächste Definitionsphase

withCropType

public BingImagesDetailsDefinitionStages.WithExecute withCropType(ImageCropType cropType)

Der Zuschneidetyp, der beim Zuschneiden des Bilds basierend auf den Koordinaten verwendet werden soll, die in den Parametern cal, cat, car und cab angegeben sind. Folgende Werte sind möglich: 0: Rechteckig (Standard). Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen. Mögliche Werte sind: "Rechteckig".

Parameters:

cropType

Returns:

Nächste Definitionsphase

withId

public BingImagesDetailsDefinitionStages.WithExecute withId(String id)

Eine ID, die ein Bild eindeutig identifiziert. Verwenden Sie diesen Parameter, um sicherzustellen, dass das angegebene Bild das erste Bild in der Liste der Bilder ist, das Von Bing zurückgegeben wird. Das ImageId-Feld des [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image)-Objekts enthält die ID, auf die Sie diesen Parameter festlegen.

Parameters:

id

Returns:

Nächste Definitionsphase

withImageUrl

public BingImagesDetailsDefinitionStages.WithExecute withImageUrl(String imageUrl)

Die URL eines Bilds, von dem Sie Einblicke erhalten möchten. Verwenden Sie diesen Parameter als Alternative zur Verwendung des InsightsToken-Parameters, um das Bild anzugeben. Sie können das Bild auch angeben, indem Sie die Binärdatei des Bilds im Textkörper einer POST-Anforderung platzieren. Wenn Sie die binäre Option verwenden, lesen Sie den Header [Content* -Type](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#contenttype). Die maximal unterstützte Bildgröße beträgt 1 MB. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

imageUrl

Returns:

Nächste Definitionsphase

withInsightsToken

public BingImagesDetailsDefinitionStages.WithExecute withInsightsToken(String insightsToken)

Ein Imagetoken. [imageInsightsToken](https:* //docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-referenceimage-imageinsightstoken) des [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image)-Objekts enthält das Token. Geben Sie diesen Parameter an, um zusätzliche Informationen zu einem Bild abzurufen, z. B. eine Untertitel oder Einkaufsquelle. Eine Liste der zusätzlichen Informationen zu einem Bild, das Sie abrufen können, finden Sie im Abfrageparameter [modules* ](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#modulesrequested). Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

insightsToken

Returns:

Nächste Definitionsphase

withLocation

public BingImagesDetailsDefinitionStages.WithExecute withLocation(String location)

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.

Parameters:

location

Returns:

Nächste Definitionsphase

withMarket

public BingImagesDetailsDefinitionStages.WithExecute withMarket(String market)

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 [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). 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 [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes) aufgeführt ist, verwendet Bing einen am besten geeigneten Marktcode, der auf einer internen Zuordnung basiert, die änderungen vorbehalten ist. Dieser Parameter und der [cc]()-https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#ccAbfrageparameter schließen sich gegenseitig aus– geben Sie nicht beide an.

Parameters:

market

Returns:

Nächste Definitionsphase

withModules

public BingImagesDetailsDefinitionStages.WithExecute withModules(List modules)

Eine durch Trennzeichen getrennte Liste von Insights, die angefordert werden sollen. Die folgenden Werte (ohne Beachtung von Groß-/Kleinschreibung) sind möglich. Alle: Gibt alle Erkenntnisse zurück, sofern verfügbar, mit Ausnahme von RecognizedEntities. BRQ: Beste repräsentative Abfrage. Der Abfragebegriff, der das Bild am besten beschreibt. Beschriftung: Eine Untertitel, die Informationen zum Bild bereitstellt. Wenn die Untertitel Entitäten enthält, kann die Antwort Links zu Bildern dieser Entitäten enthalten. Sammlungen: Eine Liste verwandter Bilder. Rezepte: Eine Liste von Rezepten zum Kochen des Essens, das in den Bildern gezeigt wird. PagesIncluding: Eine Liste der Webseiten, die das Bild enthalten. RecognizedEntities: Eine Liste der Entitäten (Personen), die im Bild erkannt wurden. HINWEIS: Sie dürfen dieses Modul nicht mit einem anderen Modul angeben. Wenn Sie sie mit anderen Modulen angeben, enthält die Antwort keine erkannten Entitäten. RelatedSearches: Eine Liste verwandter Suchvorgänge, die von anderen Personen durchgeführt wurden. ShoppingSources: Eine Liste von Händlern, in denen Sie verwandte Angebote kaufen können. SimilarImages: Eine Liste von Bildern, die dem ursprünglichen Bild visuell ähnlich sind. SimilarProducts: Eine Liste von Bildern, die ein Produkt enthalten, das einem Produkt im Originalbild ähnelt. Tags: Stellt Merkmale des Inhaltstyps im Bild bereit. Wenn das Bild beispielsweise von einer Person ist, können die Tags das Geschlecht und die Art der Kleidung der Person angeben, die sie trägt. Wenn Sie ein Modul angeben und keine Daten für das Modul vorhanden sind, enthält das Antwortobjekt das zugehörige Feld nicht. Wenn Sie beispielsweise Caption angeben und nicht vorhanden ist, enthält die Antwort nicht das Feld imageCaption. Um verwandte Suchvorgänge einzuschließen, muss die Anforderung die ursprüngliche Abfragezeichenfolge enthalten. Obwohl die ursprüngliche Abfragezeichenfolge für ähnliche Bilder oder Produkte nicht erforderlich ist, sollten Sie sie immer einschließen, da sie zur Verbesserung der Relevanz und der Ergebnisse beitragen kann. Verwenden Sie diesen Parameter nur mit der Insights-API. Geben Sie diesen Parameter nicht an, wenn Sie die APIs "Images", "Trending Images" oder "Web Search" aufrufen.

Parameters:

modules

Returns:

Nächste Definitionsphase

withSafeSearch

public BingImagesDetailsDefinitionStages.WithExecute withSafeSearch(SafeSearch safeSearch)

Filtern sie Bilder nach nicht jugendfreien Inhalten. Im Folgenden sind die möglichen Filterwerte aufgeführt. Off: Kann Bilder mit nicht jugendfreiem Inhalt zurückgeben. Wenn die Anforderung über die Bildsuche-API erfolgt, enthält die Antwort Miniaturansichten, die eindeutig (nicht fuzzy) sind. Wenn die Anforderung jedoch über die Websuche-API erfolgt, enthält die Antwort Miniaturansichten, die pixelig (Fuzzy) sind. Mittel: Wenn die Anforderung über die Bildersuche-API erfolgt, enthält die Antwort keine Bilder mit nicht jugendfreiem Inhalt. Wenn die Anforderung über die Websuche-API erfolgt, kann die Antwort Bilder mit nicht jugendfreiem Inhalt enthalten (die Miniaturansichten sind pixeliert (Fuzzy)). 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 Abfrageoperator site: verwenden, besteht die Möglichkeit, dass die Antwort nicht jugendfreie Inhalte enthält, unabhängig davon, auf was der abfrageparameter safeSearch 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 sind: "Off", "Moderate", "Strict".

Parameters:

safeSearch

Returns:

Nächste Definitionsphase

withSetLang

public BingImagesDetailsDefinitionStages.WithExecute withSetLang(String setLang)

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. Dieser Parameter und der [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage)-Header schließen sich gegenseitig aus. Geben Sie nicht beides an. 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.

Parameters:

setLang

Returns:

Nächste Definitionsphase

withUserAgent

public BingImagesDetailsDefinitionStages.WithExecute withUserAgent(String userAgent)

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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Nachfolgend einige Beispiele für Zeichenfolgen für Benutzer-Agents. 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.

Parameters:

userAgent

Returns:

Nächste Definitionsphase

Gilt für: