BingCustomInstances.BingCustomInstancesImageSearchDefinitionStages.WithAllOptions Interface
public interface WithAllOptions
Étape de la définition qui permet de spécifier d’autres paramètres facultatifs.
Résumé de la méthode
| Modificateur et type | Méthode et description |
|---|---|
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withAcceptLanguage(String acceptLanguage)
Liste délimitée par des virgules d’une ou plusieurs langues à utiliser pour les chaînes d’interface utilisateur. Elle est triée par ordre de préférence décroissant. Pour plus d’informations, notamment sur le format attendu, consultez [RFC2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Cet en-tête et le paramètre de requête [setLang](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#setlang) s’excluent mutuellement ; ne spécifiez pas les deux. Si vous définissez cet en-tête, vous devez également spécifier le paramètre de requête [cc](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#cc). Pour déterminer le marché pour lequel retourner des résultats, Bing utilise la première langue prise en charge qu’il trouve dans la liste et la combine avec la valeur du paramètre cc. Si la liste ne comporte pas de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la demande, ou utilise un marché agrégé ou par défaut pour les résultats. Pour identifier le marché utilisé par Bing, voir l’en-tête BingAPIs-Market. Utilisez cet en-tête et le paramètre de requête cc uniquement si vous spécifiez plusieurs langues. Sinon, utilisez les paramètres de requête [mkt](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt) et [setLang](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#setlang). Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. Les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withAspect(ImageAspect aspect)
Filtrez les images selon les proportions suivantes. Tout : ne filtrez pas par aspect. La spécification de cette valeur revient à ne pas spécifier le paramètre d’aspect. Carré : retourne des images avec un rapport d’aspect standard. Large : retourne des images avec un format d’écran large. Grand : retourne des images avec un rapport d’aspect élevé. Les valeurs possibles sont les suivantes : 'All', 'Square', 'Wide', 'Tall'. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withClientId(String clientId)
Bing utilise cet en-tête pour garantir aux utilisateurs un comportement cohérent d’un appel d’API Bing à l’autre. Bing propose souvent de nouvelles fonctionnalités et améliorations, et se sert de l’ID client comme d’une clé pour attribuer le trafic aux différentes versions d’évaluation. Si vous n’assignez pas le même ID client à un utilisateur d’une demande à l’autre, Bing est susceptible d’affecter cet utilisateur à plusieurs versions d’évaluation en conflit, ce qui risque de nuire à l’expérience utilisateur. Par exemple, si la deuxième demande comporte une attribution de version d’évaluation différente de la première, l’expérience se révélera peut-être inattendue. De même, Bing peut utiliser l’ID client pour personnaliser les résultats web d’après l’historique de recherche correspondant à cet ID et ainsi proposer à l’utilisateur une expérience plus riche. Bing utilise également cet en-tête pour aider à améliorer le classement des résultats en analysant l’activité générée par un ID client. L’amélioration de la pertinence permet d’obtenir des résultats de meilleure qualité de la part des API Bing et, en retour, des taux de clic plus élevés pour le consommateur des API. IMPORTANT : Il est vivement recommandé d’indiquer cet en-tête, bien qu’il soit facultatif. Grâce à la persistance de l’ID client dans plusieurs demandes pour une même combinaison appareil/utilisateur final, (1) le consommateur des API bénéficie d’une expérience utilisateur cohérente et (2) le taux de clic est plus élevé du fait des résultats de meilleure qualité provenant des API Bing. Chaque utilisateur de votre application sur l’appareil doit avoir un ID client unique, généré par Bing. Si vous n’insérez pas cet en-tête dans la demande, Bing génère un ID et le retourne dans l’en-tête de réponse X-MSEdge-ClientID. La première fois que l’utilisateur utilise votre application sur cet appareil est la seule fois où vous ne devez PAS inclure cet en-tête dans la demande. Utilisez l’ID client pour chaque requête d’API Bing qu’effectue votre application pour cet utilisateur sur l’appareil. Conservez l’ID client. Pour conserver l’identifiant dans une application de navigateur, utilisez un cookie HTTP persistant qui garantit l’utilisation de cet identifiant dans toutes les sessions. N’utilisez pas de cookie de session. Dans le cas d’autres applications, comme des applications mobiles, utilisez le stockage persistant de l’appareil pour conserver cet identifiant. La prochaine fois que l’utilisateur utilisera votre application sur cet appareil, vous récupérerez l’ID client que vous aurez conservé. Les réponses de Bing ne comportent pas forcément cet en-tête. Si elles l’incluent, capturez l’ID client et utilisez-le pour toutes les demandes Bing suivantes concernant l’utilisateur sur cet appareil. Si vous insérez l’en-tête X-MSEdge-ClientID, n’incluez pas les cookies dans la requête. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withClientIp(String clientIp)
Adresse IPv4 ou IPv6 de l’appareil client. L’adresse IP est utilisée pour découvrir l’emplacement de l’utilisateur. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié. Nous vous conseillons de toujours indiquer cet en-tête et l’en-tête X-Search-Location, bien qu’ils soient facultatifs. N’obfusquez pas l’adresse (par exemple, en remplaçant le dernier octet par 0). Cela aurait pour effet d’éloigner la localisation de l’emplacement réel de l’appareil, ce qui pourrait conduire Bing à retourner des résultats erronés. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withColor(ImageColor color)
Filtrez les images selon les options de couleur suivantes. ColorOnly : retourne des images en couleur. Monochrome : retourne des images en noir et blanc. Renvoyer des images avec l’une des couleurs dominantes suivantes : Noir, Bleu, Brun, Gris, Vert, Orange, Rose, Violet, Rouge, Sarcelle, Blanc, Jaune. Les valeurs possibles sont les suivantes : 'ColorOnly', 'Monochrome', 'Black', 'Blue', 'Brown', 'Gray', 'Green', 'Orange', 'Pink', 'Purple', 'Red', 'Teal', 'White', 'Yellow'. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withCount(Integer count)
Nombre d’images à retourner dans la réponse. Le nombre réel renvoyé peut être inférieur à ce que vous avez demandé. La valeur par défaut est 35. La valeur maximale est 150. Vous utilisez ce paramètre avec le paramètre offset pour les résultats de page. Par exemple, si votre interface utilisateur affiche 20 images par page, définissez nombre sur 20 et décalage sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrémentez le décalage de 20 (par exemple, 0, 20, 40). Utilisez ce paramètre uniquement avec la recherche d’images API.Do ne spécifiez pas ce paramètre lors de l’appel des API Insights, Trending Images ou Recherche web. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withCountryCode(String countryCode)
Code à 2 caractères du pays d'où proviennent les résultats. Pour obtenir la liste des valeurs possibles, consultez [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). Si vous définissez ce paramètre, vous devez également spécifier l’en-tête [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage). Bing utilise la première langue prise en charge qu’il trouve dans la liste des langues, et combine cette langue avec le code de pays que vous spécifiez pour déterminer le marché pour lequel retourner des résultats. Si la liste des langues n’inclut pas de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la demande, ou il peut utiliser un marché agrégé ou par défaut pour les résultats au lieu d’un marché spécifié. Vous devez utiliser ce paramètre de requête et le paramètre de requête Accept-Language uniquement si vous spécifiez plusieurs langues ; sinon, vous devez utiliser les paramètres de requête mkt et setLang. Ce paramètre et le paramètre de requête [mkt](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt) s’excluent mutuellement. Ne spécifiez pas les deux. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withFreshness(Freshness freshness)
Filtrez les images selon les options de découverte suivantes. Jour : retourne les images découvertes par Bing au cours des dernières 24 heures. Semaine : retourne les images découvertes par Bing au cours des 7 derniers jours. Mois : retourne les images découvertes par Bing au cours des 30 derniers jours. Les valeurs possibles sont les suivantes : 'Day', 'Week', 'Month'. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withHeight(Integer height)
Filtrez les images qui ont la hauteur spécifiée, en pixels. Vous pouvez utiliser ce filtre avec le filtre de taille pour renvoyer de petites images dont la hauteur est de 150 pixels. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withId(String id)
ID qui identifie une image de manière unique. Utilisez ce paramètre pour vous assurer que l’image spécifiée est la première image de la liste d’images retournée par Bing. Le champ imageId de l’objet [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image) contient l’ID sur lequel vous définissez ce paramètre. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withImageContent(ImageContent imageContent)
Filtrez les images selon les types de contenu suivants. Visage : retourne des images qui n’affichent que le visage d’une personne. Portrait : retourne des images qui montrent uniquement la tête et les épaules d’une personne. Les valeurs possibles sont les suivantes : 'Visage', 'Portrait'. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withImageType(ImageType imageType)
Filtrez les images selon les types d’images suivants. AnimatedGif : retourne uniquement les GIF animés. Clipart : retourne uniquement les images clipart. Trait : retourne uniquement les dessins de traits. Photo : Retourne uniquement les photographies (à l’exception des dessins au trait, des gifs animés et des images clipart). Shopping : retourne uniquement les images qui contiennent des articles où Bing connaît un marchand qui vend les articles. Cette option est valide uniquement sur le marché en - US. Transparent : retourne uniquement les images avec un arrière-plan transparent. Les valeurs possibles sont les suivantes : « AnimatedGif », « Clipart », « Line », « Photo », « Shopping », « Transparent ». |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withLicense(ImageLicense license)
Filtrez les images selon les types de licence suivants. Tout : ne filtrez pas par type de licence. La spécification de cette valeur revient à ne pas spécifier le paramètre de licence. N’importe quel : retourne les images qui se trouvent sous n’importe quel type de licence. La réponse n’inclut pas d’images qui ne spécifient pas de licence ou la licence est inconnue. Public : retourner des images lorsque le créateur a renoncé à leurs droits exclusifs, dans toute la mesure autorisée par la loi. Partager : retourne des images qui peuvent être partagées avec d’autres personnes. La modification ou la modification de l’image peut ne pas être autorisée. En outre, la modification, le partage et l’utilisation de l’image à des fins commerciales peuvent ne pas être autorisés. En règle générale, cette option retourne le plus d’images. ShareCommercially : retourne des images qui peuvent être partagées avec d’autres personnes à des fins personnelles ou commerciales. La modification ou la modification de l’image peut ne pas être autorisée. Modifier : retourne les images qui peuvent être modifiées, partagées et utilisées. La modification ou la modification de l’image peut ne pas être autorisée. La modification, le partage et l’utilisation de l’image à des fins commerciales peuvent ne pas être autorisés. ModifyCommercially : retourne des images qui peuvent être modifiées, partagées et utilisées à des fins personnelles ou commerciales. En règle générale, cette option retourne le moins d’images. Pour plus d’informations sur ces types de licence, consultez [Filtrer les images par type de licence](http://go.microsoft.com/fwlink/?LinkId=309768). Les valeurs possibles sont « All », « Any », « Public », « Share », « ShareCommercially », « Modify », « ModifyCommercially ». |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withLocation(String location)
Liste délimitée par des points-virgules de paires clé/valeur qui décrivent la situation géographique du client. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié et retourner le contenu local pertinent. Spécifiez la paire clé/valeur sous la forme <clé>:<valeur>. Voici les clés permettant de spécifier l’emplacement de l’utilisateur. lat (obligatoire) : latitude de l’emplacement du client, en degrés. Elle doit être supérieure ou égale à -90,0 et inférieure ou égale à +90,0. Les valeurs négatives indiquent les latitudes sud et les valeurs positives les latitudes nord. long (obligatoire) : longitude de l’emplacement du client, en degrés. Elle doit être supérieure ou égale à -180,0 et inférieure ou égale à +180,0. Les valeurs négatives indiquent les longitudes occidentales et les valeurs positives les longitudes orientales. re (obligatoire) : rayon, en mètres, qui spécifie la précision horizontale des coordonnées. Transmettez la valeur retournée par le service de localisation de l’appareil. Voici quelques valeurs courantes : 22 m pour le GPS/Wi-Fi, 380 m pour la triangulation des tours cellulaires et 18 000 m pour la recherche IP inversée. ts (facultatif) : horodatage UNIX UTC du moment où le client se trouvait à l’emplacement. (L’horodatage UNIX correspond au nombre de secondes depuis le 1er janvier 1970.) head (facultatif) : titre ou sens de déplacement relatif du client. Spécifiez-la en degrés, entre 0 et 360, dans le sens horaire par rapport au nord géographique. Spécifiez cette clé uniquement si la clé sp est différente de zéro. sp (facultatif) : vitesse horizontale (vitesse), en mètres par seconde, que l’appareil client est en train de parcourir. alt (facultatif) : altitude de l’appareil client, en mètres. sont (facultatif) : rayon, en mètres, qui spécifie la précision verticale des coordonnées. Spécifiez cette clé uniquement si vous spécifiez la touche de remplacement. Bien que la plupart des clés soient facultatives, plus vous fournissez d’informations, plus les résultats de localisation sont précis. Nous vous conseillons de toujours indiquer la situation géographique de l’utilisateur (qui est facultative). C’est particulièrement important si l’adresse IP du client ne reflète pas exactement l’emplacement physique de l’utilisateur (par exemple, si le client utilise un VPN). Pour des résultats optimaux, précisez cet en-tête et l’en-tête X-MSEdge-ClientIP ; au minimum, indiquez cet en-tête. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMarket(String market)
Marché d’où proviennent les résultats. En règle générale, mkt est le pays à partir duquel l’utilisateur effectue la demande. Toutefois, il peut s’agir d’un autre pays si l’utilisateur ne se trouve pas dans un pays où Bing fournit des résultats. Le marché doit être sous la forme <du code-pays><> de langue. Par exemple, en-US. La chaîne ne respecte pas la casse. Pour obtenir la liste des valeurs de marché possibles, consultez [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). REMARQUE : S’il est connu, nous vous encourageons à toujours spécifier le marché. Le fait d’indiquer le marché aide Bing à router la requête et à renvoyer une réponse appropriée et optimale. Si vous spécifiez un marché qui n’est pas répertorié dans [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes), Bing utilise un code de marché le mieux adapté en fonction d’un mappage interne susceptible de changer. Ce paramètre et le paramètre de requête [cc](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#cc) s’excluent mutuellement. Ne spécifiez pas les deux. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMaxFileSize(Long maxFileSize)
Filtrez les images qui sont inférieures ou égales à la taille de fichier spécifiée. La taille de fichier maximale que vous pouvez spécifier est de 520 192 octets. Si vous spécifiez une valeur plus élevée, l’API utilise 520 192. Il est possible que la réponse inclue des images légèrement plus grandes que le maximum spécifié. Vous pouvez spécifier ce filtre et minFileSize pour filtrer les images dans une plage de tailles de fichier. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMaxHeight(Long maxHeight)
Filtrez les images dont la hauteur est inférieure ou égale à la hauteur spécifiée. Spécifiez la hauteur en pixels. Vous pouvez spécifier ce filtre et minHeight pour filtrer les images dans une plage de hauteurs. Ce filtre et le filtre de hauteur s’excluent mutuellement. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMaxWidth(Long maxWidth)
Filtrez les images dont la largeur est inférieure ou égale à la largeur spécifiée. Spécifiez la largeur en pixels. Vous pouvez spécifier ce filtre et maxWidth pour filtrer les images dans une plage de largeurs. Ce filtre et le filtre de largeur s’excluent mutuellement. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMinFileSize(Long minFileSize)
Filtrez les images qui sont supérieures ou égales à la taille de fichier spécifiée. La taille de fichier maximale que vous pouvez spécifier est de 520 192 octets. Si vous spécifiez une valeur plus élevée, l’API utilise 520 192. Il est possible que la réponse inclue des images légèrement plus petites que le minimum spécifié. Vous pouvez spécifier ce filtre et maxFileSize pour filtrer les images dans une plage de tailles de fichier. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMinHeight(Long minHeight)
Filtrez les images dont la hauteur est supérieure ou égale à la hauteur spécifiée. Spécifiez la hauteur en pixels. Vous pouvez spécifier ce filtre et maxHeight pour filtrer les images dans une plage de hauteurs. Ce filtre et le filtre de hauteur s’excluent mutuellement. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withMinWidth(Long minWidth)
Filtrez les images dont la largeur est supérieure ou égale à la largeur spécifiée. Spécifiez la largeur en pixels. Vous pouvez spécifier ce filtre et maxWidth pour filtrer les images dans une plage de largeurs. Ce filtre et le filtre de largeur s’excluent mutuellement. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withOffset(Long offset)
Décalage de base zéro qui indique le nombre d’images à ignorer avant de retourner des images. La valeur par défaut est 0. Le décalage doit être inférieur à ([totalEstimatedMatches](htt* ps://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-referencetotalestimatedmatches)
|
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withSafeSearch(SafeSearch safeSearch)
Filtrez les images pour le contenu pour adultes. Voici les valeurs de filtre possibles. Désactivé : peut renvoyer des images avec du contenu pour adultes. Si la demande se fait via l’API Recherche d’images, la réponse inclut des images miniatures qui sont claires (non floues). Toutefois, si la requête se fait via l’API Recherche web, la réponse inclut des images miniatures pixelisées (floues). Modéré : si la demande passe par l’API Recherche d’images, la réponse n’inclut pas d’images avec du contenu pour adultes. Si la demande est effectuée via l’API Recherche web, la réponse peut inclure des images avec du contenu pour adultes (les images miniatures sont pixelisées (floues)). Strict : ne retournez pas d’images avec du contenu pour adultes. La valeur par défaut est Modéré. Si la demande provient d’un marché où la stratégie pour adultes de Bing exige que safeSearch soit défini sur Strict, Bing ignore la valeur safeSearch et utilise Strict. Si vous utilisez l’opérateur de requête site : , il est possible que la réponse contienne du contenu pour adultes, quel que soit le paramètre de requête safeSearch défini. Utiliser le site : uniquement si vous connaissez le contenu du site et si votre scénario prend en charge la possibilité de contenu pour adultes. Les valeurs possibles sont les suivantes : « Off », « Moderate », « Strict ». |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withSetLang(String setLang)
Langue à utiliser pour les chaînes de l’interface utilisateur. Spécifiez la langue en utilisant le code de langue ISO 639-1 à deux lettres. Par exemple, celui de l’anglais est EN. La valeur par défaut est EN (anglais). Nous vous conseillons de toujours indiquer la langue, bien qu’elle soit facultative. En règle générale, vous définissez setLang sur la même langue spécifiée par mkt, sauf si l’utilisateur souhaite que les chaînes d’interface utilisateur soient affichées dans une autre langue. Ce paramètre et l’en-tête [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage) s’excluent mutuellement ; ne spécifiez pas les deux. Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. En outre, les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withSize(ImageSize size)
Filtrez les images selon les tailles suivantes. Tout : ne filtrez pas par taille. Spécifier cette valeur revient à ne pas spécifier le paramètre size. Petit : retourne des images inférieures à 200 x 200 pixels. Moyen : retourne des images supérieures ou égales à 200 x 200 pixels, mais inférieures à 500 x 500 pixels. Grande : retourne des images de 500 x 500 pixels ou plus. Papier peint : renvoyer des images de papier peint. Vous pouvez utiliser ce paramètre avec les paramètres de hauteur ou de largeur. Par exemple, vous pouvez utiliser la hauteur et la taille pour demander de petites images de 150 pixels. Les valeurs possibles sont les suivantes : 'All', 'Small', 'Medium', 'Large', 'Wallpaper'. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withUserAgent(String userAgent)
Agent utilisateur à l’origine de la requête. Bing utilise l’agent utilisateur pour offrir une expérience optimisée aux utilisateurs mobiles. Nous vous conseillons de toujours indiquer cet en-tête, bien qu’il soit facultatif. L’agent utilisateur doit correspondre à la chaîne envoyée par n’importe quel navigateur couramment utilisé. Pour plus d’informations sur les agents utilisateur, consultez [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Voici quelques exemples de chaînes de l’agent utilisateur. Windows Phone : Mozilla/5.0 (compatible ; MSIE 10.0 ; Windows Phone 8.0 ; Trident/6.0 ; IEMobile/10.0 ; BRAS; Toucher; NOKIA; Lumia 822). Android : Mozilla / 5.0 (Linux ; U; Android 2.3.5 ; en - us; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; like Gecko) Version / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; Processeur iPhone OS 6_1 comme Mac OS X) AppleWebKit / 536.26 (KHTML; comme Gecko) Mobile / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC : Mozilla / 5.0 (Windows NT 6.3 ; WOW64; Trident / 7.0; Toucher; rv:11.0) comme Gecko. iPad: Mozilla / 5.0 (iPad; Système d’exploitation processeur 7_0 comme Mac OS X) AppleWebKit / 537.51.1 (KHTML, comme Gecko) Version / 7.0 Mobile / 11A465 Safari / 9537.53. |
| BingCustomInstancesImageSearchDefinitionStages.WithExecute |
withWidth(Integer width)
Filtrez les images qui ont la largeur spécifiée, en pixels. Vous pouvez utiliser ce filtre avec le filtre de taille pour renvoyer de petites images d’une largeur de 150 pixels. |
Détails de la méthode
withAcceptLanguage
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withAcceptLanguage(String acceptLanguage)
Liste délimitée par des virgules d’une ou plusieurs langues à utiliser pour les chaînes d’interface utilisateur. Elle est triée par ordre de préférence décroissant. Pour plus d’informations, notamment sur le format attendu, consultez [RFC2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Cet en-tête et le paramètre de requête [setLang](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#setlang) s’excluent mutuellement ; ne spécifiez pas les deux. Si vous définissez cet en-tête, vous devez également spécifier le paramètre de requête [cc](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#cc). Pour déterminer le marché pour lequel retourner des résultats, Bing utilise la première langue prise en charge qu’il trouve dans la liste et la combine avec la valeur du paramètre cc. Si la liste ne comporte pas de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la demande, ou utilise un marché agrégé ou par défaut pour les résultats. Pour identifier le marché utilisé par Bing, voir l’en-tête BingAPIs-Market. Utilisez cet en-tête et le paramètre de requête cc uniquement si vous spécifiez plusieurs langues. Sinon, utilisez les paramètres de requête [mkt](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt) et [setLang](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#setlang). Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. Les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée.
Parameters:
Returns:
withAspect
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withAspect(ImageAspect aspect)
Filtrez les images selon les proportions suivantes. Tout : ne filtrez pas par aspect. La spécification de cette valeur revient à ne pas spécifier le paramètre d’aspect. Carré : retourne des images avec un rapport d’aspect standard. Large : retourne des images avec un format d’écran large. Grand : retourne des images avec un rapport d’aspect élevé. Les valeurs possibles sont les suivantes : 'All', 'Square', 'Wide', 'Tall'.
Parameters:
Returns:
withClientId
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withClientId(String clientId)
Bing utilise cet en-tête pour garantir aux utilisateurs un comportement cohérent d’un appel d’API Bing à l’autre. Bing propose souvent de nouvelles fonctionnalités et améliorations, et se sert de l’ID client comme d’une clé pour attribuer le trafic aux différentes versions d’évaluation. Si vous n’assignez pas le même ID client à un utilisateur d’une demande à l’autre, Bing est susceptible d’affecter cet utilisateur à plusieurs versions d’évaluation en conflit, ce qui risque de nuire à l’expérience utilisateur. Par exemple, si la deuxième demande comporte une attribution de version d’évaluation différente de la première, l’expérience se révélera peut-être inattendue. De même, Bing peut utiliser l’ID client pour personnaliser les résultats web d’après l’historique de recherche correspondant à cet ID et ainsi proposer à l’utilisateur une expérience plus riche. Bing utilise également cet en-tête pour aider à améliorer le classement des résultats en analysant l’activité générée par un ID client. L’amélioration de la pertinence permet d’obtenir des résultats de meilleure qualité de la part des API Bing et, en retour, des taux de clic plus élevés pour le consommateur des API. IMPORTANT : Il est vivement recommandé d’indiquer cet en-tête, bien qu’il soit facultatif. Grâce à la persistance de l’ID client dans plusieurs demandes pour une même combinaison appareil/utilisateur final, (1) le consommateur des API bénéficie d’une expérience utilisateur cohérente et (2) le taux de clic est plus élevé du fait des résultats de meilleure qualité provenant des API Bing. Chaque utilisateur de votre application sur l’appareil doit avoir un ID client unique, généré par Bing. Si vous n’insérez pas cet en-tête dans la demande, Bing génère un ID et le retourne dans l’en-tête de réponse X-MSEdge-ClientID. La première fois que l’utilisateur utilise votre application sur cet appareil est la seule fois où vous ne devez PAS inclure cet en-tête dans la demande. Utilisez l’ID client pour chaque requête d’API Bing qu’effectue votre application pour cet utilisateur sur l’appareil. Conservez l’ID client. Pour conserver l’identifiant dans une application de navigateur, utilisez un cookie HTTP persistant qui garantit l’utilisation de cet identifiant dans toutes les sessions. N’utilisez pas de cookie de session. Dans le cas d’autres applications, comme des applications mobiles, utilisez le stockage persistant de l’appareil pour conserver cet identifiant. La prochaine fois que l’utilisateur utilisera votre application sur cet appareil, vous récupérerez l’ID client que vous aurez conservé. Les réponses de Bing ne comportent pas forcément cet en-tête. Si elles l’incluent, capturez l’ID client et utilisez-le pour toutes les demandes Bing suivantes concernant l’utilisateur sur cet appareil. Si vous insérez l’en-tête X-MSEdge-ClientID, n’incluez pas les cookies dans la requête.
Parameters:
Returns:
withClientIp
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withClientIp(String clientIp)
Adresse IPv4 ou IPv6 de l’appareil client. L’adresse IP est utilisée pour découvrir l’emplacement de l’utilisateur. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié. Nous vous conseillons de toujours indiquer cet en-tête et l’en-tête X-Search-Location, bien qu’ils soient facultatifs. N’obfusquez pas l’adresse (par exemple, en remplaçant le dernier octet par 0). Cela aurait pour effet d’éloigner la localisation de l’emplacement réel de l’appareil, ce qui pourrait conduire Bing à retourner des résultats erronés.
Parameters:
Returns:
withColor
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withColor(ImageColor color)
Filtrez les images selon les options de couleur suivantes. ColorOnly : retourne des images en couleur. Monochrome : retourne des images en noir et blanc. Renvoyer des images avec l’une des couleurs dominantes suivantes : Noir, Bleu, Brun, Gris, Vert, Orange, Rose, Violet, Rouge, Sarcelle, Blanc, Jaune. Les valeurs possibles sont les suivantes : 'ColorOnly', 'Monochrome', 'Black', 'Blue', 'Brown', 'Gray', 'Green', 'Orange', 'Pink', 'Purple', 'Red', 'Teal', 'White', 'Yellow'.
Parameters:
Returns:
withCount
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withCount(Integer count)
Nombre d’images à retourner dans la réponse. Le nombre réel renvoyé peut être inférieur à ce que vous avez demandé. La valeur par défaut est 35. La valeur maximale est 150. Vous utilisez ce paramètre avec le paramètre offset pour les résultats de page. Par exemple, si votre interface utilisateur affiche 20 images par page, définissez nombre sur 20 et décalage sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrémentez le décalage de 20 (par exemple, 0, 20, 40). Utilisez ce paramètre uniquement avec la recherche d’images API.Do ne spécifiez pas ce paramètre lors de l’appel des API Insights, Trending Images ou Recherche web.
Parameters:
Returns:
withCountryCode
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withCountryCode(String countryCode)
Code à 2 caractères du pays d'où proviennent les résultats. Pour obtenir la liste des valeurs possibles, consultez [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). Si vous définissez ce paramètre, vous devez également spécifier l’en-tête [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage). Bing utilise la première langue prise en charge qu’il trouve dans la liste des langues, et combine cette langue avec le code de pays que vous spécifiez pour déterminer le marché pour lequel retourner des résultats. Si la liste des langues n’inclut pas de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la demande, ou il peut utiliser un marché agrégé ou par défaut pour les résultats au lieu d’un marché spécifié. Vous devez utiliser ce paramètre de requête et le paramètre de requête Accept-Language uniquement si vous spécifiez plusieurs langues ; sinon, vous devez utiliser les paramètres de requête mkt et setLang. Ce paramètre et le paramètre de requête [mkt](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#mkt) s’excluent mutuellement. Ne spécifiez pas les deux.
Parameters:
Returns:
withFreshness
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withFreshness(Freshness freshness)
Filtrez les images selon les options de découverte suivantes. Jour : retourne les images découvertes par Bing au cours des dernières 24 heures. Semaine : retourne les images découvertes par Bing au cours des 7 derniers jours. Mois : retourne les images découvertes par Bing au cours des 30 derniers jours. Les valeurs possibles sont les suivantes : 'Day', 'Week', 'Month'.
Parameters:
Returns:
withHeight
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withHeight(Integer height)
Filtrez les images qui ont la hauteur spécifiée, en pixels. Vous pouvez utiliser ce filtre avec le filtre de taille pour renvoyer de petites images dont la hauteur est de 150 pixels.
Parameters:
Returns:
withId
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withId(String id)
ID qui identifie une image de manière unique. Utilisez ce paramètre pour vous assurer que l’image spécifiée est la première image de la liste d’images retournée par Bing. Le champ imageId de l’objet [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image) contient l’ID sur lequel vous définissez ce paramètre.
Parameters:
Returns:
withImageContent
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withImageContent(ImageContent imageContent)
Filtrez les images selon les types de contenu suivants. Visage : retourne des images qui n’affichent que le visage d’une personne. Portrait : retourne des images qui montrent uniquement la tête et les épaules d’une personne. Les valeurs possibles sont les suivantes : 'Visage', 'Portrait'.
Parameters:
Returns:
withImageType
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withImageType(ImageType imageType)
Filtrez les images selon les types d’images suivants. AnimatedGif : retourne uniquement les GIF animés. Clipart : retourne uniquement les images clipart. Trait : retourne uniquement les dessins de traits. Photo : Retourne uniquement les photographies (à l’exception des dessins au trait, des gifs animés et des images clipart). Shopping : retourne uniquement les images qui contiennent des articles où Bing connaît un marchand qui vend les articles. Cette option est valide uniquement sur le marché en - US. Transparent : retourne uniquement les images avec un arrière-plan transparent. Les valeurs possibles sont les suivantes : « AnimatedGif », « Clipart », « Line », « Photo », « Shopping », « Transparent ».
Parameters:
Returns:
withLicense
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withLicense(ImageLicense license)
Filtrez les images selon les types de licence suivants. Tout : ne filtrez pas par type de licence. La spécification de cette valeur revient à ne pas spécifier le paramètre de licence. N’importe quel : retourne les images qui se trouvent sous n’importe quel type de licence. La réponse n’inclut pas d’images qui ne spécifient pas de licence ou la licence est inconnue. Public : retourner des images lorsque le créateur a renoncé à leurs droits exclusifs, dans toute la mesure autorisée par la loi. Partager : retourne des images qui peuvent être partagées avec d’autres personnes. La modification ou la modification de l’image peut ne pas être autorisée. En outre, la modification, le partage et l’utilisation de l’image à des fins commerciales peuvent ne pas être autorisés. En règle générale, cette option retourne le plus d’images. ShareCommercially : retourne des images qui peuvent être partagées avec d’autres personnes à des fins personnelles ou commerciales. La modification ou la modification de l’image peut ne pas être autorisée. Modifier : retourne les images qui peuvent être modifiées, partagées et utilisées. La modification ou la modification de l’image peut ne pas être autorisée. La modification, le partage et l’utilisation de l’image à des fins commerciales peuvent ne pas être autorisés. ModifyCommercially : retourne des images qui peuvent être modifiées, partagées et utilisées à des fins personnelles ou commerciales. En règle générale, cette option retourne le moins d’images. Pour plus d’informations sur ces types de licence, consultez [Filtrer les images par type de licence](http://go.microsoft.com/fwlink/?LinkId=309768). Les valeurs possibles sont « All », « Any », « Public », « Share », « ShareCommercially », « Modify », « ModifyCommercially ».
Parameters:
Returns:
withLocation
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withLocation(String location)
Liste délimitée par des points-virgules de paires clé/valeur qui décrivent la situation géographique du client. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié et retourner le contenu local pertinent. Spécifiez la paire clé/valeur sous la forme <clé>:<valeur>. Voici les clés permettant de spécifier l’emplacement de l’utilisateur. lat (obligatoire) : latitude de l’emplacement du client, en degrés. Elle doit être supérieure ou égale à -90,0 et inférieure ou égale à +90,0. Les valeurs négatives indiquent les latitudes sud et les valeurs positives les latitudes nord. long (obligatoire) : longitude de l’emplacement du client, en degrés. Elle doit être supérieure ou égale à -180,0 et inférieure ou égale à +180,0. Les valeurs négatives indiquent les longitudes occidentales et les valeurs positives les longitudes orientales. re (obligatoire) : rayon, en mètres, qui spécifie la précision horizontale des coordonnées. Transmettez la valeur retournée par le service de localisation de l’appareil. Voici quelques valeurs courantes : 22 m pour le GPS/Wi-Fi, 380 m pour la triangulation des tours cellulaires et 18 000 m pour la recherche IP inversée. ts (facultatif) : horodatage UNIX UTC du moment où le client se trouvait à l’emplacement. (L’horodatage UNIX correspond au nombre de secondes depuis le 1er janvier 1970.) head (facultatif) : titre ou sens de déplacement relatif du client. Spécifiez-la en degrés, entre 0 et 360, dans le sens horaire par rapport au nord géographique. Spécifiez cette clé uniquement si la clé sp est différente de zéro. sp (facultatif) : vitesse horizontale (vitesse), en mètres par seconde, que l’appareil client est en train de parcourir. alt (facultatif) : altitude de l’appareil client, en mètres. sont (facultatif) : rayon, en mètres, qui spécifie la précision verticale des coordonnées. Spécifiez cette clé uniquement si vous spécifiez la touche de remplacement. Bien que la plupart des clés soient facultatives, plus vous fournissez d’informations, plus les résultats de localisation sont précis. Nous vous conseillons de toujours indiquer la situation géographique de l’utilisateur (qui est facultative). C’est particulièrement important si l’adresse IP du client ne reflète pas exactement l’emplacement physique de l’utilisateur (par exemple, si le client utilise un VPN). Pour des résultats optimaux, précisez cet en-tête et l’en-tête X-MSEdge-ClientIP ; au minimum, indiquez cet en-tête.
Parameters:
Returns:
withMarket
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMarket(String market)
Marché d’où proviennent les résultats. En règle générale, mkt est le pays à partir duquel l’utilisateur effectue la demande. Toutefois, il peut s’agir d’un autre pays si l’utilisateur ne se trouve pas dans un pays où Bing fournit des résultats. Le marché doit être sous la forme <du code-pays><> de langue. Par exemple, en-US. La chaîne ne respecte pas la casse. Pour obtenir la liste des valeurs de marché possibles, consultez [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes). REMARQUE : S’il est connu, nous vous encourageons à toujours spécifier le marché. Le fait d’indiquer le marché aide Bing à router la requête et à renvoyer une réponse appropriée et optimale. Si vous spécifiez un marché qui n’est pas répertorié dans [Market Co* des](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#market-codes), Bing utilise un code de marché le mieux adapté en fonction d’un mappage interne susceptible de changer. Ce paramètre et le paramètre de requête [cc](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#cc) s’excluent mutuellement. Ne spécifiez pas les deux.
Parameters:
Returns:
withMaxFileSize
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMaxFileSize(Long maxFileSize)
Filtrez les images qui sont inférieures ou égales à la taille de fichier spécifiée. La taille de fichier maximale que vous pouvez spécifier est de 520 192 octets. Si vous spécifiez une valeur plus élevée, l’API utilise 520 192. Il est possible que la réponse inclue des images légèrement plus grandes que le maximum spécifié. Vous pouvez spécifier ce filtre et minFileSize pour filtrer les images dans une plage de tailles de fichier.
Parameters:
Returns:
withMaxHeight
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMaxHeight(Long maxHeight)
Filtrez les images dont la hauteur est inférieure ou égale à la hauteur spécifiée. Spécifiez la hauteur en pixels. Vous pouvez spécifier ce filtre et minHeight pour filtrer les images dans une plage de hauteurs. Ce filtre et le filtre de hauteur s’excluent mutuellement.
Parameters:
Returns:
withMaxWidth
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMaxWidth(Long maxWidth)
Filtrez les images dont la largeur est inférieure ou égale à la largeur spécifiée. Spécifiez la largeur en pixels. Vous pouvez spécifier ce filtre et maxWidth pour filtrer les images dans une plage de largeurs. Ce filtre et le filtre de largeur s’excluent mutuellement.
Parameters:
Returns:
withMinFileSize
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMinFileSize(Long minFileSize)
Filtrez les images qui sont supérieures ou égales à la taille de fichier spécifiée. La taille de fichier maximale que vous pouvez spécifier est de 520 192 octets. Si vous spécifiez une valeur plus élevée, l’API utilise 520 192. Il est possible que la réponse inclue des images légèrement plus petites que le minimum spécifié. Vous pouvez spécifier ce filtre et maxFileSize pour filtrer les images dans une plage de tailles de fichier.
Parameters:
Returns:
withMinHeight
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMinHeight(Long minHeight)
Filtrez les images dont la hauteur est supérieure ou égale à la hauteur spécifiée. Spécifiez la hauteur en pixels. Vous pouvez spécifier ce filtre et maxHeight pour filtrer les images dans une plage de hauteurs. Ce filtre et le filtre de hauteur s’excluent mutuellement.
Parameters:
Returns:
withMinWidth
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withMinWidth(Long minWidth)
Filtrez les images dont la largeur est supérieure ou égale à la largeur spécifiée. Spécifiez la largeur en pixels. Vous pouvez spécifier ce filtre et maxWidth pour filtrer les images dans une plage de largeurs. Ce filtre et le filtre de largeur s’excluent mutuellement.
Parameters:
Returns:
withOffset
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withOffset(Long offset)
Décalage de base zéro qui indique le nombre d’images à ignorer avant de retourner des images. La valeur par défaut est 0. Le décalage doit être inférieur à ([totalEstimatedMatches](htt* ps://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-referencetotalestimatedmatches)
count). Utilisez ce paramètre avec le paramètre count pour pager les résultats. Par exemple, si votre interface utilisateur affiche 20 images par page, définissez nombre sur 20 et décalage sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrémentez le décalage de 20 (par exemple, 0, 20, 40). Il est possible que plusieurs pages incluent des chevauchements dans les résultats. Pour éviter les doublons, consultez [nextO* ffset](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#nextoffset). Utilisez ce paramètre uniquement avec l’API Image. Ne spécifiez pas ce paramètre lors de l’appel de l’API Trending Images ou de l’API Recherche web.
Parameters:
Returns:
withSafeSearch
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withSafeSearch(SafeSearch safeSearch)
Filtrez les images pour le contenu pour adultes. Voici les valeurs de filtre possibles. Désactivé : peut renvoyer des images avec du contenu pour adultes. Si la demande se fait via l’API Recherche d’images, la réponse inclut des images miniatures qui sont claires (non floues). Toutefois, si la requête se fait via l’API Recherche web, la réponse inclut des images miniatures pixelisées (floues). Modéré : si la demande passe par l’API Recherche d’images, la réponse n’inclut pas d’images avec du contenu pour adultes. Si la demande est effectuée via l’API Recherche web, la réponse peut inclure des images avec du contenu pour adultes (les images miniatures sont pixelisées (floues)). Strict : ne retournez pas d’images avec du contenu pour adultes. La valeur par défaut est Modéré. Si la demande provient d’un marché où la stratégie pour adultes de Bing exige que safeSearch soit défini sur Strict, Bing ignore la valeur safeSearch et utilise Strict. Si vous utilisez l’opérateur de requête site : , il est possible que la réponse contienne du contenu pour adultes, quel que soit le paramètre de requête safeSearch défini. Utiliser le site : uniquement si vous connaissez le contenu du site et si votre scénario prend en charge la possibilité de contenu pour adultes. Les valeurs possibles sont les suivantes : « Off », « Moderate », « Strict ».
Parameters:
Returns:
withSetLang
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withSetLang(String setLang)
Langue à utiliser pour les chaînes de l’interface utilisateur. Spécifiez la langue en utilisant le code de langue ISO 639-1 à deux lettres. Par exemple, celui de l’anglais est EN. La valeur par défaut est EN (anglais). Nous vous conseillons de toujours indiquer la langue, bien qu’elle soit facultative. En règle générale, vous définissez setLang sur la même langue spécifiée par mkt, sauf si l’utilisateur souhaite que les chaînes d’interface utilisateur soient affichées dans une autre langue. Ce paramètre et l’en-tête [Accept-Langua* ge](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#acceptlanguage) s’excluent mutuellement ; ne spécifiez pas les deux. Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. En outre, les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée.
Parameters:
Returns:
withSize
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withSize(ImageSize size)
Filtrez les images selon les tailles suivantes. Tout : ne filtrez pas par taille. Spécifier cette valeur revient à ne pas spécifier le paramètre size. Petit : retourne des images inférieures à 200 x 200 pixels. Moyen : retourne des images supérieures ou égales à 200 x 200 pixels, mais inférieures à 500 x 500 pixels. Grande : retourne des images de 500 x 500 pixels ou plus. Papier peint : renvoyer des images de papier peint. Vous pouvez utiliser ce paramètre avec les paramètres de hauteur ou de largeur. Par exemple, vous pouvez utiliser la hauteur et la taille pour demander de petites images de 150 pixels. Les valeurs possibles sont les suivantes : 'All', 'Small', 'Medium', 'Large', 'Wallpaper'.
Parameters:
Returns:
withUserAgent
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withUserAgent(String userAgent)
Agent utilisateur à l’origine de la requête. Bing utilise l’agent utilisateur pour offrir une expérience optimisée aux utilisateurs mobiles. Nous vous conseillons de toujours indiquer cet en-tête, bien qu’il soit facultatif. L’agent utilisateur doit correspondre à la chaîne envoyée par n’importe quel navigateur couramment utilisé. Pour plus d’informations sur les agents utilisateur, consultez [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Voici quelques exemples de chaînes de l’agent utilisateur. Windows Phone : Mozilla/5.0 (compatible ; MSIE 10.0 ; Windows Phone 8.0 ; Trident/6.0 ; IEMobile/10.0 ; BRAS; Toucher; NOKIA; Lumia 822). Android : Mozilla / 5.0 (Linux ; U; Android 2.3.5 ; en - us; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; like Gecko) Version / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; Processeur iPhone OS 6_1 comme Mac OS X) AppleWebKit / 536.26 (KHTML; comme Gecko) Mobile / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC : Mozilla / 5.0 (Windows NT 6.3 ; WOW64; Trident / 7.0; Toucher; rv:11.0) comme Gecko. iPad: Mozilla / 5.0 (iPad; Système d’exploitation processeur 7_0 comme Mac OS X) AppleWebKit / 537.51.1 (KHTML, comme Gecko) Version / 7.0 Mobile / 11A465 Safari / 9537.53.
Parameters:
Returns:
withWidth
public BingCustomInstancesImageSearchDefinitionStages.WithExecute withWidth(Integer width)
Filtrez les images qui ont la largeur spécifiée, en pixels. Vous pouvez utiliser ce filtre avec le filtre de taille pour renvoyer de petites images d’une largeur de 150 pixels.
Parameters:
Returns:
S’applique à
Azure SDK for Java
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour