BingImages.BingImagesSearchDefinitionStages.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 |
|---|---|
| BingImagesSearchDefinitionStages.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. |
| BingImagesSearchDefinitionStages.WithExecute |
withAspect(ImageAspect aspect)
Filtern Sie Bilder nach den folgenden Seitenverhältnissen. Alle: Filtern Sie nicht nach Aspekt. Das Angeben dieses Werts ist identisch mit dem Nicht-Angeben des Aspektparameters. Quadratisch: Gibt Bilder mit Standardseitenverhältnis zurück. Breit: Geben Sie Bilder mit einem Breitbildseitenverhältnis zurück. Hoch: Gibt Bilder mit hohem Seitenverhältnis zurück. Mögliche Werte sind: "All", "Square", "Wide", "Tall". |
| BingImagesSearchDefinitionStages.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. |
| BingImagesSearchDefinitionStages.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. |
| BingImagesSearchDefinitionStages.WithExecute |
withColor(ImageColor color)
Filtern Sie Bilder nach den folgenden Farboptionen. ColorOnly: Gibt Farbbilder zurück. Monochrom: Gibt Schwarzweißbilder zurück. Zurückgeben von Bildern mit einer der folgenden dominierenden Farben: Schwarz, Blau, Braun, Grau, Grün, Orange, Rosa, Lila, Rot, Teal, Weiß, Gelb. Mögliche Werte sind: "ColorOnly", "Monochrome", "Black", "Blue", "Brown", "Gray", "Green", "Orange", "Pink", "Purple", "Red", "Teal", "White", "Yellow". |
| BingImagesSearchDefinitionStages.WithExecute |
withCount(Integer count)
Die Anzahl der Bilder, die in der Antwort zurückgegeben werden sollen. Die tatsächlich gelieferte Anzahl kann geringer sein als angefordert. Der Standardwert ist 35. Der Maximalwert ist 150. Sie verwenden diesen Parameter zusammen mit dem Offsetparameter, um Ergebnisse zu seiten. Wenn ihre Benutzeroberfläche beispielsweise 20 Bilder pro Seite anzeigt, legen Sie die Anzahl auf 20 und den Offset auf 0 fest, um die erste Seite der Ergebnisse zu erhalten. Erhöhen Sie für jede nachfolgende Seite den Offset um 20 (z. B. 0, 20, 40). Verwenden Sie diesen Parameter nur mit dem API.Do geben Sie diesen Parameter beim Aufrufen der Insights-, Trending Images- oder Websuche-APIs nicht an. |
| BingImagesSearchDefinitionStages.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 aus der Sprachenliste gefunden wird, und kombiniert diese Sprache mit dem von Ihnen angegebenen Ländercode, 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 beides an. |
| BingImagesSearchDefinitionStages.WithExecute |
withFreshness(Freshness freshness)
Filtern Sie Bilder nach den folgenden Ermittlungsoptionen. Tag: Gibt Bilder zurück, die von Bing innerhalb der letzten 24 Stunden entdeckt wurden. Woche: Gibt Bilder zurück, die von Bing innerhalb der letzten 7 Tage ermittelt wurden. Monat: Gibt Bilder zurück, die von Bing innerhalb der letzten 30 Tage gefunden wurden. Mögliche Werte: "Day", "Week", "Month". |
| BingImagesSearchDefinitionStages.WithExecute |
withHeight(Integer height)
Filtern Sie Bilder mit der angegebenen Höhe in Pixel. Sie können diesen Filter mit dem Größenfilter verwenden, um kleine Bilder mit einer Höhe von 150 Pixeln zurückzugeben. |
| BingImagesSearchDefinitionStages.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 Von Bing zurückgegebenen Bilder ist. Das Feld imageId 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. |
| BingImagesSearchDefinitionStages.WithExecute |
withImageContent(ImageContent imageContent)
Filtern Sie Bilder nach den folgenden Inhaltstypen. Gesicht: Gibt Bilder zurück, die nur das Gesicht einer Person zeigen. Portrait: Geben Sie Bilder zurück, die nur Kopf und Schultern einer Person zeigen. Mögliche Werte sind "Face", "Portrait". |
| BingImagesSearchDefinitionStages.WithExecute |
withImageType(ImageType imageType)
Filtern Sie Bilder nach den folgenden Bildtypen. AnimatedGif: Gibt nur animierte GIFs zurück. Clipart: Gibt nur Clipart-Bilder zurück. Linie: Gibt nur Linienzeichnungen zurück. Foto: Nur Fotos zurückgeben (ausgenommen Linienzeichnungen, animierte Gifs und Cliparts). Shopping: Geben Sie nur Bilder zurück, die Elemente enthalten, in denen Bing von einem Händler weiß, der die Artikel verkauft. Diese Option ist nur auf dem en -US-Markt gültig. Transparent: Gibt nur Bilder mit transparentem Hintergrund zurück. Mögliche Werte sind: "AnimatedGif", "Clipart", "Line", "Photo", "Shopping", "Transparent". |
| BingImagesSearchDefinitionStages.WithExecute |
withLicense(ImageLicense license)
Filtern Sie Bilder nach den folgenden Lizenztypen. Alle: Filtern Sie nicht nach Lizenztyp. Die Angabe dieses Werts ist identisch mit der Angabe des Lizenzparameters. Any: Gibt Images zurück, die unter einem beliebigen Lizenztyp stehen. Die Antwort enthält keine Images, die keine Lizenz angeben, oder die Lizenz ist unbekannt. Öffentlich: Geben Sie Bilder zurück, bei denen der Ersteller auf seine ausschließlichen Rechte verzichtet hat, soweit gesetzlich zulässig. Freigeben: Gibt Bilder zurück, die für andere freigegeben werden können. Das Ändern oder Bearbeiten des Bilds ist möglicherweise nicht zulässig. Außerdem ist das Ändern, Freigeben und Verwenden des Bilds für kommerzielle Zwecke möglicherweise nicht zulässig. In der Regel gibt diese Option die meisten Bilder zurück. ShareCommercially: Gibt Bilder zurück, die für persönliche oder kommerzielle Zwecke für andere freigegeben werden können. Das Ändern oder Bearbeiten des Bilds ist möglicherweise nicht zulässig. Ändern: Gibt Images zurück, die geändert, freigegeben und verwendet werden können. Das Ändern oder Bearbeiten des Bilds ist möglicherweise nicht zulässig. Das Ändern, Freigeben und Verwenden des Images für kommerzielle Zwecke ist möglicherweise nicht zulässig. ModifyCommercially: Gibt Bilder zurück, die für persönliche oder kommerzielle Zwecke geändert, freigegeben und verwendet werden können. In der Regel gibt diese Option die wenigsten Bilder zurück. Weitere Informationen zu diesen Lizenztypen finden Sie unter [Filter Images By License Type](http://go.microsoft.com/fwlink/?LinkId=309768). Mögliche Werte sind: "All", "Any", "Public", "Share", "ShareCommercially", "Modify", "ModifyCommercially". |
| BingImagesSearchDefinitionStages.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 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. 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. |
| BingImagesSearchDefinitionStages.WithExecute |
withMarket(String market)
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 möglicher 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 Marktcode, der am besten geeignet ist, basierend auf einer internen Zuordnung, die sich ändern kann. 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 beide nicht an. |
| BingImagesSearchDefinitionStages.WithExecute |
withMaxFileSize(Long maxFileSize)
Filtern Sie Bilder, die kleiner oder gleich der angegebenen Dateigröße sind. Die maximale Dateigröße, die Sie angeben können, beträgt 520.192 Bytes. Wenn Sie einen größeren Wert angeben, verwendet die API 520.192. Es ist möglich, dass die Antwort Bilder enthält, die etwas größer als das angegebene Maximum sind. Sie können diesen Filter und minFileSize angeben, um Bilder innerhalb eines Bereichs von Dateigrößen zu filtern. |
| BingImagesSearchDefinitionStages.WithExecute |
withMaxHeight(Long maxHeight)
Filtern Sie Bilder mit einer Höhe, die kleiner oder gleich der angegebenen Höhe ist. Geben Sie die Höhe in Pixel an. Sie können diesen Filter und minHeight angeben, um Bilder innerhalb eines Höhenbereichs zu filtern. Dieser Filter und der Höhenfilter schließen sich gegenseitig aus. |
| BingImagesSearchDefinitionStages.WithExecute |
withMaxWidth(Long maxWidth)
Filtern Sie Bilder mit einer Breite, die kleiner oder gleich der angegebenen Breite ist. Geben Sie die Breite in Pixel an. Sie können diesen Filter und maxWidth angeben, um Bilder innerhalb eines Breitenbereichs zu filtern. Dieser Filter und der Breitenfilter schließen sich gegenseitig aus. |
| BingImagesSearchDefinitionStages.WithExecute |
withMinFileSize(Long minFileSize)
Filtern Sie Bilder, die größer oder gleich der angegebenen Dateigröße sind. Die maximale Dateigröße, die Sie angeben können, beträgt 520.192 Bytes. Wenn Sie einen größeren Wert angeben, verwendet die API 520.192. Es ist möglich, dass die Antwort Bilder enthält, die etwas kleiner als das angegebene Minimum sind. Sie können diesen Filter und maxFileSize angeben, um Bilder innerhalb eines Bereichs von Dateigrößen zu filtern. |
| BingImagesSearchDefinitionStages.WithExecute |
withMinHeight(Long minHeight)
Filtern Sie Bilder, deren Höhe größer oder gleich der angegebenen Höhe ist. Geben Sie die Höhe in Pixel an. Sie können diesen Filter und maxHeight angeben, um Bilder innerhalb eines Höhenbereichs zu filtern. Dieser Filter und der Höhenfilter schließen sich gegenseitig aus. |
| BingImagesSearchDefinitionStages.WithExecute |
withMinWidth(Long minWidth)
Filtern Sie Bilder mit einer Breite, die größer oder gleich der angegebenen Breite ist. Geben Sie die Breite in Pixel an. Sie können diesen Filter und maxWidth angeben, um Bilder innerhalb eines Breitenbereichs zu filtern. Dieser Filter und der Breitenfilter schließen sich gegenseitig aus. |
| BingImagesSearchDefinitionStages.WithExecute |
withOffset(Long offset)
Der nullbasierte Offset, der die Anzahl der Zu überspringenden Bilder angibt, bevor Bilder zurückgegeben werden. Die Standardeinstellung ist 0. Der Offset sollte kleiner als ([totalEstimatedMatches](htt* ps://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-referencetotalestimatedmatches) sein.
|
| BingImagesSearchDefinitionStages.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 jugendfreien Inhalten zurückgeben. Wenn die Anforderung über die Bildsuche-API erfolgt, enthält die Antwort Miniaturansichten, die eindeutig (non-fuzzy) sind. Wenn die Anforderung jedoch über die Websuche-API erfolgt, enthält die Antwort Miniaturansichten, die pixelig (fuzzy) sind. Moderat: Wenn die Anforderung über die Bildsuche-API erfolgt, enthält die Antwort keine Bilder mit nicht jugendfreien Inhalten. Wenn die Anforderung über die Websuche-API erfolgt, kann die Antwort Bilder mit nicht jugendfreien Inhalten enthalten (die Miniaturansichten sind pixeliert (Fuzzy)). Streng: Geben Sie keine Bilder mit nicht jugendfreien Inhalten zurück. Die Standardeinstellung ist „Moderate“. Wenn die Anforderung von einem Markt stammt, für den die Erwachsenenrichtlinie von Bing erfordert, dass safeSearch auf Strict festgelegt ist, ignoriert Bing den wert safeSearch 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 safeSearch-Abfrageparameter festgelegt ist. Website verwenden: nur, wenn Sie den Inhalt auf der Website kennen und Ihr Szenario die Möglichkeit von erwachsenen Inhalten unterstützt. Mögliche Werte sind: "Off", "Moderate", "Strict". |
| BingImagesSearchDefinitionStages.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 dieselbe 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. |
| BingImagesSearchDefinitionStages.WithExecute |
withSize(ImageSize size)
Filtern Sie Bilder nach den folgenden Größen. Alle: Filtern Sie nicht nach Größe. Die Angabe dieses Werts ist identisch mit der Angabe des Größenparameters. Klein: Gibt Bilder zurück, die kleiner als 200 x 200 Pixel sind. Mittel: Gibt Bilder zurück, die größer oder gleich 200 x 200 Pixel, aber kleiner als 500 x 500 Pixel sind. Groß: Gibt Bilder zurück, die 500 x 500 Pixel oder größer sind. Hintergrundbild: Hintergrundbilder zurückgeben. Sie können diesen Parameter zusammen mit den Höhen- oder Breitenparametern verwenden. Beispielsweise können Sie Höhe und Größe verwenden, um kleine Bilder mit einer Größe von 150 Pixeln anzufordern. Mögliche Werte sind: "All", "Small", "Medium", "Large", "Wallpaper". |
| BingImagesSearchDefinitionStages.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. |
| BingImagesSearchDefinitionStages.WithExecute |
withWidth(Integer width)
Filtern Sie Bilder mit der angegebenen Breite in Pixel. Sie können diesen Filter mit dem Größenfilter verwenden, um kleine Bilder mit einer Breite von 150 Pixel zurückzugeben. |
Details zur Methode
withAcceptLanguage
public BingImagesSearchDefinitionStages.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:
Returns:
withAspect
public BingImagesSearchDefinitionStages.WithExecute withAspect(ImageAspect aspect)
Filtern Sie Bilder nach den folgenden Seitenverhältnissen. Alle: Filtern Sie nicht nach Aspekt. Das Angeben dieses Werts ist identisch mit dem Nicht-Angeben des Aspektparameters. Quadratisch: Gibt Bilder mit Standardseitenverhältnis zurück. Breit: Geben Sie Bilder mit einem Breitbildseitenverhältnis zurück. Hoch: Gibt Bilder mit hohem Seitenverhältnis zurück. Mögliche Werte sind: "All", "Square", "Wide", "Tall".
Parameters:
Returns:
withClientId
public BingImagesSearchDefinitionStages.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:
Returns:
withClientIp
public BingImagesSearchDefinitionStages.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:
Returns:
withColor
public BingImagesSearchDefinitionStages.WithExecute withColor(ImageColor color)
Filtern Sie Bilder nach den folgenden Farboptionen. ColorOnly: Gibt Farbbilder zurück. Monochrom: Gibt Schwarzweißbilder zurück. Zurückgeben von Bildern mit einer der folgenden dominierenden Farben: Schwarz, Blau, Braun, Grau, Grün, Orange, Rosa, Lila, Rot, Teal, Weiß, Gelb. Mögliche Werte sind: "ColorOnly", "Monochrome", "Black", "Blue", "Brown", "Gray", "Green", "Orange", "Pink", "Purple", "Red", "Teal", "White", "Yellow".
Parameters:
Returns:
withCount
public BingImagesSearchDefinitionStages.WithExecute withCount(Integer count)
Die Anzahl der Bilder, die in der Antwort zurückgegeben werden sollen. Die tatsächlich gelieferte Anzahl kann geringer sein als angefordert. Der Standardwert ist 35. Der Maximalwert ist 150. Sie verwenden diesen Parameter zusammen mit dem Offsetparameter, um Ergebnisse zu seiten. Wenn ihre Benutzeroberfläche beispielsweise 20 Bilder pro Seite anzeigt, legen Sie die Anzahl auf 20 und den Offset auf 0 fest, um die erste Seite der Ergebnisse zu erhalten. Erhöhen Sie für jede nachfolgende Seite den Offset um 20 (z. B. 0, 20, 40). Verwenden Sie diesen Parameter nur mit dem API.Do geben Sie diesen Parameter beim Aufrufen der Insights-, Trending Images- oder Websuche-APIs nicht an.
Parameters:
Returns:
withCountryCode
public BingImagesSearchDefinitionStages.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 aus der Sprachenliste gefunden wird, und kombiniert diese Sprache mit dem von Ihnen angegebenen Ländercode, 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 beides an.
Parameters:
Returns:
withFreshness
public BingImagesSearchDefinitionStages.WithExecute withFreshness(Freshness freshness)
Filtern Sie Bilder nach den folgenden Ermittlungsoptionen. Tag: Gibt Bilder zurück, die von Bing innerhalb der letzten 24 Stunden entdeckt wurden. Woche: Gibt Bilder zurück, die von Bing innerhalb der letzten 7 Tage ermittelt wurden. Monat: Gibt Bilder zurück, die von Bing innerhalb der letzten 30 Tage gefunden wurden. Mögliche Werte: "Day", "Week", "Month".
Parameters:
Returns:
withHeight
public BingImagesSearchDefinitionStages.WithExecute withHeight(Integer height)
Filtern Sie Bilder mit der angegebenen Höhe in Pixel. Sie können diesen Filter mit dem Größenfilter verwenden, um kleine Bilder mit einer Höhe von 150 Pixeln zurückzugeben.
Parameters:
Returns:
withId
public BingImagesSearchDefinitionStages.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 Von Bing zurückgegebenen Bilder ist. Das Feld imageId 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:
Returns:
withImageContent
public BingImagesSearchDefinitionStages.WithExecute withImageContent(ImageContent imageContent)
Filtern Sie Bilder nach den folgenden Inhaltstypen. Gesicht: Gibt Bilder zurück, die nur das Gesicht einer Person zeigen. Portrait: Geben Sie Bilder zurück, die nur Kopf und Schultern einer Person zeigen. Mögliche Werte sind "Face", "Portrait".
Parameters:
Returns:
withImageType
public BingImagesSearchDefinitionStages.WithExecute withImageType(ImageType imageType)
Filtern Sie Bilder nach den folgenden Bildtypen. AnimatedGif: Gibt nur animierte GIFs zurück. Clipart: Gibt nur Clipart-Bilder zurück. Linie: Gibt nur Linienzeichnungen zurück. Foto: Nur Fotos zurückgeben (ausgenommen Linienzeichnungen, animierte Gifs und Cliparts). Shopping: Geben Sie nur Bilder zurück, die Elemente enthalten, in denen Bing von einem Händler weiß, der die Artikel verkauft. Diese Option ist nur auf dem en -US-Markt gültig. Transparent: Gibt nur Bilder mit transparentem Hintergrund zurück. Mögliche Werte sind: "AnimatedGif", "Clipart", "Line", "Photo", "Shopping", "Transparent".
Parameters:
Returns:
withLicense
public BingImagesSearchDefinitionStages.WithExecute withLicense(ImageLicense license)
Filtern Sie Bilder nach den folgenden Lizenztypen. Alle: Filtern Sie nicht nach Lizenztyp. Die Angabe dieses Werts ist identisch mit der Angabe des Lizenzparameters. Any: Gibt Images zurück, die unter einem beliebigen Lizenztyp stehen. Die Antwort enthält keine Images, die keine Lizenz angeben, oder die Lizenz ist unbekannt. Öffentlich: Geben Sie Bilder zurück, bei denen der Ersteller auf seine ausschließlichen Rechte verzichtet hat, soweit gesetzlich zulässig. Freigeben: Gibt Bilder zurück, die für andere freigegeben werden können. Das Ändern oder Bearbeiten des Bilds ist möglicherweise nicht zulässig. Außerdem ist das Ändern, Freigeben und Verwenden des Bilds für kommerzielle Zwecke möglicherweise nicht zulässig. In der Regel gibt diese Option die meisten Bilder zurück. ShareCommercially: Gibt Bilder zurück, die für persönliche oder kommerzielle Zwecke für andere freigegeben werden können. Das Ändern oder Bearbeiten des Bilds ist möglicherweise nicht zulässig. Ändern: Gibt Images zurück, die geändert, freigegeben und verwendet werden können. Das Ändern oder Bearbeiten des Bilds ist möglicherweise nicht zulässig. Das Ändern, Freigeben und Verwenden des Images für kommerzielle Zwecke ist möglicherweise nicht zulässig. ModifyCommercially: Gibt Bilder zurück, die für persönliche oder kommerzielle Zwecke geändert, freigegeben und verwendet werden können. In der Regel gibt diese Option die wenigsten Bilder zurück. Weitere Informationen zu diesen Lizenztypen finden Sie unter [Filter Images By License Type](http://go.microsoft.com/fwlink/?LinkId=309768). Mögliche Werte sind: "All", "Any", "Public", "Share", "ShareCommercially", "Modify", "ModifyCommercially".
Parameters:
Returns:
withLocation
public BingImagesSearchDefinitionStages.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 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. 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:
Returns:
withMarket
public BingImagesSearchDefinitionStages.WithExecute withMarket(String market)
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 möglicher 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 Marktcode, der am besten geeignet ist, basierend auf einer internen Zuordnung, die sich ändern kann. 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 beide nicht an.
Parameters:
Returns:
withMaxFileSize
public BingImagesSearchDefinitionStages.WithExecute withMaxFileSize(Long maxFileSize)
Filtern Sie Bilder, die kleiner oder gleich der angegebenen Dateigröße sind. Die maximale Dateigröße, die Sie angeben können, beträgt 520.192 Bytes. Wenn Sie einen größeren Wert angeben, verwendet die API 520.192. Es ist möglich, dass die Antwort Bilder enthält, die etwas größer als das angegebene Maximum sind. Sie können diesen Filter und minFileSize angeben, um Bilder innerhalb eines Bereichs von Dateigrößen zu filtern.
Parameters:
Returns:
withMaxHeight
public BingImagesSearchDefinitionStages.WithExecute withMaxHeight(Long maxHeight)
Filtern Sie Bilder mit einer Höhe, die kleiner oder gleich der angegebenen Höhe ist. Geben Sie die Höhe in Pixel an. Sie können diesen Filter und minHeight angeben, um Bilder innerhalb eines Höhenbereichs zu filtern. Dieser Filter und der Höhenfilter schließen sich gegenseitig aus.
Parameters:
Returns:
withMaxWidth
public BingImagesSearchDefinitionStages.WithExecute withMaxWidth(Long maxWidth)
Filtern Sie Bilder mit einer Breite, die kleiner oder gleich der angegebenen Breite ist. Geben Sie die Breite in Pixel an. Sie können diesen Filter und maxWidth angeben, um Bilder innerhalb eines Breitenbereichs zu filtern. Dieser Filter und der Breitenfilter schließen sich gegenseitig aus.
Parameters:
Returns:
withMinFileSize
public BingImagesSearchDefinitionStages.WithExecute withMinFileSize(Long minFileSize)
Filtern Sie Bilder, die größer oder gleich der angegebenen Dateigröße sind. Die maximale Dateigröße, die Sie angeben können, beträgt 520.192 Bytes. Wenn Sie einen größeren Wert angeben, verwendet die API 520.192. Es ist möglich, dass die Antwort Bilder enthält, die etwas kleiner als das angegebene Minimum sind. Sie können diesen Filter und maxFileSize angeben, um Bilder innerhalb eines Bereichs von Dateigrößen zu filtern.
Parameters:
Returns:
withMinHeight
public BingImagesSearchDefinitionStages.WithExecute withMinHeight(Long minHeight)
Filtern Sie Bilder, deren Höhe größer oder gleich der angegebenen Höhe ist. Geben Sie die Höhe in Pixel an. Sie können diesen Filter und maxHeight angeben, um Bilder innerhalb eines Höhenbereichs zu filtern. Dieser Filter und der Höhenfilter schließen sich gegenseitig aus.
Parameters:
Returns:
withMinWidth
public BingImagesSearchDefinitionStages.WithExecute withMinWidth(Long minWidth)
Filtern Sie Bilder mit einer Breite, die größer oder gleich der angegebenen Breite ist. Geben Sie die Breite in Pixel an. Sie können diesen Filter und maxWidth angeben, um Bilder innerhalb eines Breitenbereichs zu filtern. Dieser Filter und der Breitenfilter schließen sich gegenseitig aus.
Parameters:
Returns:
withOffset
public BingImagesSearchDefinitionStages.WithExecute withOffset(Long offset)
Der nullbasierte Offset, der die Anzahl der Zu überspringenden Bilder angibt, bevor Bilder zurückgegeben werden. Die Standardeinstellung ist 0. Der Offset sollte kleiner als ([totalEstimatedMatches](htt* ps://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-referencetotalestimatedmatches) sein.
count). Verwenden Sie diesen Parameter zusammen mit dem Count-Parameter, um Ergebnisse zu seiten. Wenn ihre Benutzeroberfläche beispielsweise 20 Bilder pro Seite anzeigt, legen Sie die Anzahl auf 20 und den Offset auf 0 fest, um die erste Seite der Ergebnisse zu erhalten. Erhöhen Sie für jede nachfolgende Seite den Offset um 20 (z. B. 0, 20, 40). Es ist möglich, dass mehrere Seiten einige Überschneidungen in den Ergebnissen enthalten. Informationen zur Vermeidung von Duplikaten finden Sie unter [nextO* ffset](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#nextoffset). Verwenden Sie diesen Parameter nur mit der Image-API. Geben Sie diesen Parameter nicht an, wenn Sie die Trending Images-API oder die Websuche-API aufrufen.
Parameters:
Returns:
withSafeSearch
public BingImagesSearchDefinitionStages.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 jugendfreien Inhalten zurückgeben. Wenn die Anforderung über die Bildsuche-API erfolgt, enthält die Antwort Miniaturansichten, die eindeutig (non-fuzzy) sind. Wenn die Anforderung jedoch über die Websuche-API erfolgt, enthält die Antwort Miniaturansichten, die pixelig (fuzzy) sind. Moderat: Wenn die Anforderung über die Bildsuche-API erfolgt, enthält die Antwort keine Bilder mit nicht jugendfreien Inhalten. Wenn die Anforderung über die Websuche-API erfolgt, kann die Antwort Bilder mit nicht jugendfreien Inhalten enthalten (die Miniaturansichten sind pixeliert (Fuzzy)). Streng: Geben Sie keine Bilder mit nicht jugendfreien Inhalten zurück. Die Standardeinstellung ist „Moderate“. Wenn die Anforderung von einem Markt stammt, für den die Erwachsenenrichtlinie von Bing erfordert, dass safeSearch auf Strict festgelegt ist, ignoriert Bing den wert safeSearch 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 safeSearch-Abfrageparameter festgelegt ist. Website verwenden: nur, wenn Sie den Inhalt auf der Website kennen und Ihr Szenario die Möglichkeit von erwachsenen Inhalten unterstützt. Mögliche Werte sind: "Off", "Moderate", "Strict".
Parameters:
Returns:
withSetLang
public BingImagesSearchDefinitionStages.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 dieselbe 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:
Returns:
withSize
public BingImagesSearchDefinitionStages.WithExecute withSize(ImageSize size)
Filtern Sie Bilder nach den folgenden Größen. Alle: Filtern Sie nicht nach Größe. Die Angabe dieses Werts ist identisch mit der Angabe des Größenparameters. Klein: Gibt Bilder zurück, die kleiner als 200 x 200 Pixel sind. Mittel: Gibt Bilder zurück, die größer oder gleich 200 x 200 Pixel, aber kleiner als 500 x 500 Pixel sind. Groß: Gibt Bilder zurück, die 500 x 500 Pixel oder größer sind. Hintergrundbild: Hintergrundbilder zurückgeben. Sie können diesen Parameter zusammen mit den Höhen- oder Breitenparametern verwenden. Beispielsweise können Sie Höhe und Größe verwenden, um kleine Bilder mit einer Größe von 150 Pixeln anzufordern. Mögliche Werte sind: "All", "Small", "Medium", "Large", "Wallpaper".
Parameters:
Returns:
withUserAgent
public BingImagesSearchDefinitionStages.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:
Returns:
withWidth
public BingImagesSearchDefinitionStages.WithExecute withWidth(Integer width)
Filtern Sie Bilder mit der angegebenen Breite in Pixel. Sie können diesen Filter mit dem Größenfilter verwenden, um kleine Bilder mit einer Breite von 150 Pixel zurückzugeben.
Parameters:
Returns:
Gilt für:
Azure SDK for Java