Aracılığıyla paylaş

WebSearchOptionalParams interface

  • Başvuru
Paket:
@azure/cognitiveservices-websearch

İsteğe Bağlı Parametreler.

Extends
RequestOptionsBase

Özellikler

acceptLanguage

Kullanıcı arabirimi dizeleri için kullanılacak bir veya daha fazla dilin virgülle ayrılmış listesi. Liste, tercih edilme durumuna göre azalan düzende sıralanır. Beklenen biçim de dahil olmak üzere ek bilgi için bkz. RFC2616. Bu üst bilgi ve setLang sorgu parametresi birbirini dışlar; her ikisini de belirtmeyin. Bu üst bilgiyi ayarlarsanız, cc sorgu parametresini de belirtmelisiniz. Bing, listeden bulduğu ilk desteklenen dili kullanır ve sonuç döndürecek pazarı belirlemek için bu dili cc parametre değeriyle birleştirir. Listede desteklenen bir dil yoksa, Bing isteği destekleyen en yakın dili ve pazarı bulur ve sonuçlar için belirtilen dil yerine toplu veya varsayılan bir pazar kullanabilir. Bu üst bilgiyi ve cc sorgu parametresini yalnızca birden çok dil belirtirseniz kullanmanız gerekir; aksi takdirde, mkt ve setLang sorgu parametrelerini kullanmanız gerekir. Kullanıcı arabirimi dizesi, kullanıcı arabiriminde etiket olarak kullanılan dizedir. JSON yanıt nesnelerinde çok az kullanıcı arabirimi dizesi vardır. Yanıt nesnelerinde Bing.com özelliklere bağlantılar belirtilen dili uygular.
answerCount

Yanıtın içermesini istediğiniz yanıt sayısı. Bing'in döndürdüğü yanıtlar derecelendirmeye bağlıdır. Örneğin, Bing bir istek için web sayfaları, resimler, videolar ve relatedSearches döndürürse ve bu parametreyi iki (2) olarak ayarlarsanız yanıtta web sayfaları ve görüntüler bulunur. responseFilter sorgu parametresini aynı isteğe eklediyseniz ve web sayfaları ve haberler olarak ayarladıysanız, yanıt yalnızca web sayfalarını içerir.
clientId

Bing, kullanıcılara tüm Bing API çağrılarında tutarlı bir davranış sağlamak için bu üst bilgiyi kullanır. Bing sık sık yeni özellikler ve geliştirmeler dağıtır ve farklı dağıtımlarda trafik ataması yapmak için anahtar olarak istemci kimliğini kullanır. Bir kullanıcı için birden çok istekte aynı istemci kimliğini kullanmazsanız, Bing kullanıcıyı birden çok çakışan dağıtıma atayabilir. Birden çok çakışan dağıtıma eklenmek, tutarsız bir kullanıcı deneyimine yol açabilir. Örneğin, ikinci isteğin dağıtım ataması ilkinden farklıysa, beklenmeyen bir deneyim yaşanabilir. Ayrıca, Bing istemci kimliğini kullanarak web sonuçlarını istemci kimliğinin arama geçmişine uyarlayabilir ve bu sayede kullanıcıya daha zengin bir deneyim sağlayabilir. Bing, istemci kimliği tarafından oluşturulan etkinliği analiz ederek sonuç derecelendirmelerini geliştirmeye yardımcı olması için de bu üst bilgiyi kullanabilir. İlgi geliştirmeleri Bing API'lerinin daha kaliteli sonuçlar vermesine yardımcı olur ve böylelikle API tüketicisi için daha yüksek tıklama oranları getirir. ÖNEMLİ: İsteğe bağlı olsa da, bu üst bilgiyi gerekli olarak kabul edebilirsiniz. Aynı son kullanıcı ile cihaz bileşimi için birden çok istekte aynı istemci kimliğini kullanıldığında, 1) API tüketicisi tutarlı bir kullanıcı deneyimi elde eder ve 2) Bing API'lerinden daha kaliteli sonuçlar alındığından tıklama oranları daha yüksek olur. Cihazda uygulamanızı kullanan her kullanıcının Bing tarafından oluşturulan benzersiz bir istemci kimliği olmalıdır. İsteğe bu üst bilgiyi eklemezseniz, Bing bir kimlik oluşturur ve bu kimliği X-MSEdge-ClientID yanıt üst bilgisinde döndürür. İsteğe bu üst bilgiyi EKLEMEMENİZ gereken tek durum, söz konusu cihazda kullanıcının uygulamanızı ilk kez kullanmasıdır. Cihazda uygulamanızın bu kullanıcı için yaptığı her Bing API'si isteğinde istemci kimliğini kullanın. İstemci kimliğinin kalıcı olmasını sağlayın. Tarayıcı uygulamasında kimliği kalıcı hale getirmek için, tüm oturumlarda kimliğin kullanmasını sağlayacak bir kalıcı HTTP tanımlama bilgisi kullanın. Oturum tanımlama bilgisi kullanmayın. Mobil uygulamalar gibi diğer uygulamalarda, kimliği kalıcı hale getirmek için cihazın kalıcı depolamasını kullanın. Kullanıcı o cihazda uygulamanızı yeniden kullandığında, kalıcı hale getirdiğiniz istemci kimliğini alın. Bing yanıtları bu üst bilgiyi içerebilir veya içermeyebilir. Yanıt bu üst bilgiyi içeriyorsa, istemci kimliğini yakalayın ve o cihazda kullanıcı için bunu izleyen tüm Bing isteklerinde onu kullanın. X-MSEdge-ClientID'yi eklerseniz isteğe tanımlama bilgileri eklememelisiniz.
clientIp

İstemci cihazının IPv4 veya IPv6 adresi. IP adresi, kullanıcının konumunu bulmak için kullanılır. Bing konum bilgisini kullanarak güvenli arama davranışını saptar. İsteğe bağlı olsa da, bu üst bilgiyi ve X-Search-Location üst bilgisini her zaman belirtmeniz önerilir. Adresi karartmayın (örneğin, son sekiz karakteri 0'la değiştirerek). Adresin karartılması, cihazın gerçek konumuna yakın olmayan bir konum sonucu verir ve bu da Bing'in hatalı sonuçlar sağlamasına yol açabilir.
count

Yanıtta döndürülecek arama sonuçlarının sayısı. Varsayılan değer 10, maksimum değer ise 50'dir. Teslim edilen gerçek sayı istenenden küçük olabilir. Bu parametreyi, sayfa sonuçlarına uzaklık parametresiyle birlikte kullanın. Örneğin, kullanıcı arabiriminiz sayfa başına 10 arama sonucu görüntülüyorsa, ilk sonuç sayfasını almak için sayıyı 10 ve uzaklığı 0 olarak ayarlayın. Sonraki her sayfa için uzaklığı 10 artır (örneğin, 0, 10, 20). Birden çok sayfanın sonuçlarda bazı çakışmalar içermesi mümkündür.
countryCode

Sonuçların geldiği ülkenin 2 karakterli ülke kodudur. Bu API yalnızca Birleşik Devletler pazarını destekler. Bu sorgu parametresini belirtirseniz, bu parametrenin bize ayarlanması gerekir. Bu parametreyi ayarlarsanız, Accept-Language üst bilgisini de belirtmelisiniz. Bing, dil listesinden bulduğu ilk desteklenen dili kullanır ve bu dili belirttiğiniz ülke koduyla birleştirerek sonuçların döndürüleceği pazarı belirler. Diller listesi desteklenen bir dil içermiyorsa, Bing isteği destekleyen en yakın dili ve pazarı bulur veya belirtilen bir dil yerine sonuçlar için toplu veya varsayılan bir pazar kullanabilir. Bu sorgu parametresini ve Accept-Language sorgu parametresini yalnızca birden çok dil belirtirseniz kullanmanız gerekir; aksi takdirde, mkt ve setLang sorgu parametrelerini kullanmanız gerekir. Bu parametre ve mkt sorgu parametresi birbirini dışlar; ikisini birden belirtmeyin.
freshness

Arama sonuçlarını şu yaş değerlerine göre filtreleyin: Day—Bing'in son 24 saat içinde keşfettiği web sayfalarını döndürün. Hafta— Bing'in son 7 gün içinde keşfettiği web sayfalarını döndürür. Ay— Son 30 gün içinde bulunan web sayfalarını döndürür. Bu filtre yalnızca web sayfası sonuçları için geçerlidir, haber ve görüntü gibi diğer sonuçlar için geçerli değildir. Olası değerler şunlardır: 'Gün', 'Hafta', 'Ay'
location

İstemcinin coğrafi konumunu açıklayan noktalı virgülle sınırlanmış anahtar/değer çifti listesi. Bing konum bilgisini kullanarak güvenli arama davranışını saptar ve ilgili yerel içeriği döndürür. Anahtar/değer çiftini olarak belirtin: Aşağıda, kullanıcının konumunu belirtmek için kullandığınız anahtarlar gösterilir. lat (gerekli): İstemcinin konumunun derece olarak enlemi. Enlem -90,0 değerinden büyük veya bu değere eşit ve +90,0 değerinden küçük veya bu değere eşit olmalıdır. Negatif değerler güney enlemlerini ve pozitif değerler de kuzey enlemlerini gösterir. long (gerekli): İstemcinin konumunun derece cinsinden boylamı. Boylam -180,0 değerinden büyük veya bu değere eşit ve +180,0 değerinden küçük veya bu değere eşit olmalıdır. Negatif değerler batı boylamlarını ve pozitif değerler de doğu boylamlarını gösterir. re (gerekli): Koordinatların yatay doğruluğunu belirten metre olarak yarıçap. Cihazın konum hizmeti tarafından döndürülen değeri geçirin. Normalde değerler GPS/Wi-Fi için 22 m, baz istasyonu triangülasyonu için 380 m ve ters IP araması için 18.000 m'dir. ts (isteğe bağlı): İstemcinin bulunduğu konumun UTC UNIX zaman damgası. (UNIX zaman damgası, 1 Ocak 1970'ten bu yana saniye sayısıdır.) head (isteğe bağlı): Müşterinin göreli başlığı veya seyahat yönü. Gerçek kuzeye göre saat yönünün tersine 0 ile 360 derece arasında bir seyahat yönü belirtin. Bu anahtarı yalnızca sp anahtarı sıfırdan farklıysa belirtin. sp (isteğe bağlı): Saniyedeki yatay hız (hız), istemci cihazının seyahat ediyor olmasıdır. alt (isteğe bağlı): İstemci cihazının metre olarak yüksekliği. şunlardır (isteğe bağlı): Koordinatların dikey doğruluğunu belirten metre olarak yarıçap. Bu anahtarı yalnızca alt anahtarı belirtirseniz belirtin. Anahtarların çoğu isteğe bağlı olsa da, ne kadar çok bilgi sağlarsanız konum sonuçları o kadar doğru olur. İsteğe bağlı olsa da, her zaman kullanıcının coğrafi konumunu belirtmeniz önerilir. İstemcinin IP adresi kullanıcının fiziksel konumunu doğru yansıtmıyorsa (örneğin istemci VPN kullanıyorsa), konumun belirtilmesi özellikle önemlidir. En iyi sonuçları elde etmek için, bu üst bilgiyi ve X-MSEdge-ClientIP üst bilgisini eklemelisiniz; ama en azından bu üst bilgiyi eklemeniz gerekir.
market

Sonuçların geldiği pazar. Genellikle mkt, kullanıcının istekte bulunduğu ülkedir. Ancak, kullanıcı Bing'in sonuçları teslim ettiği bir ülkede değilse farklı bir ülke olabilir. Piyasa - biçiminde olmalıdır. Örneğin, tr-TR. Dize büyük/küçük harfe duyarlı değildir. Biliniyorsa, her zaman pazarı belirtmeniz teşvik edilir. Pazarın belirtilmesi Bing’in isteği yönlendirmesine, uygun ve en iyi yanıtı döndürmesine yardımcı olur. Pazar Kodları'nda listelenmeyen bir pazar belirtirseniz, Bing, değişikliğe tabi iç eşlemeye dayalı olarak en uygun pazar kodunu kullanır. Bu parametre ve cc sorgu parametresi birbirini dışlar; ikisini birden belirtmeyin. Varsayılan değer: 'en-us'.
offset

Sonuçları döndürmeden önce atlana arama sonuçlarının sayısını gösteren sıfır tabanlı uzaklık. Varsayılan değer, 0'dur. Uzaklık küçük olmalıdır (totalEstimatedMatches - count). Sayfa sonuçlarında count parametresiyle birlikte bu parametreyi kullanın. Örneğin, kullanıcı arabiriminiz sayfa başına 10 arama sonucu görüntülüyorsa, ilk sonuç sayfasını almak için sayıyı 10 ve uzaklığı 0 olarak ayarlayın. Sonraki her sayfa için uzaklığı 10 artır (örneğin, 0, 10, 20). birden çok sayfanın sonuçlarda bazı çakışmalar içermesi mümkündür.
pragma

Varsayılan olarak, Bing önbelleğe alınmış içeriği (varsa) döndürür. Bing'in önbelleğe alınmış içeriği döndürmesini önlemek için, Pragma üst bilgisini no-cache olarak ayarlayın (örneğin, Pragma: no-cache).
promote

Derecelendirmelerinden bağımsız olarak yanıtın eklenmesini istediğiniz yanıtların virgülle ayrılmış listesi. Örneğin, answerCount değerini iki (2) olarak ayarlarsanız, Bing ilk iki dereceli yanıtı döndürür, ancak yanıtın haberleri de içermesini isterseniz, haberlere yükseltmeyi ayarlarsınız. En çok sıralanan yanıtlar web sayfaları, resimler, videolar ve relatedSearches ise, haberler dereceli bir yanıt olmadığından yanıtta web sayfaları ve resimler bulunur. Ancak video yükseltmeyi ayarlarsanız Bing, video yanıtını yanıta yükseltip web sayfaları, resimler ve videolar döndürür. Yükseltmek istediğiniz yanıtlar answerCount sınırına karşı sayılmaz. Örneğin, dereceli yanıtlar haberler, resimler ve videolar ise ve answerCount değerini 1 olarak ayarlayıp haberlere yükseltiyorsanız, yanıtta haberler ve görüntüler bulunur. Ya da dereceli yanıtlar videolar, resimler ve haberlerse yanıtta videolar ve haberler bulunur. Olası değerler Hesaplama, Görüntüler, Haberler, RelatedSearches, SpellSuggestions, TimeZone, Videolar, Web Sayfaları'dır. Yalnızca answerCount belirtirseniz kullanın.
responseFilter

Yanıta dahil etmek için virgülle ayrılmış yanıt listesi. Bu parametreyi belirtmezseniz yanıt, ilgili verilerin bulunduğu tüm arama yanıtlarını içerir. Olası filtre değerleri Hesaplama, Görüntüler, Haberler, relatedSearches, SpellSuggestions, TimeZone, Videolar, Web Sayfaları'dır. Tek bir yanıt almak için bu filtreyi kullanabilirsiniz ancak daha zengin sonuçlar elde etmek için yanıta özgü uç noktayı kullanmanız gerekir. Örneğin, yalnızca görüntüleri almak için isteği Görüntü Arama API'sinin uç noktalarına gönderin. RelatedSearches ve SpellSuggestions yanıtları, Görüntü Arama API'si gibi ayrı bir uç noktayı desteklemez (bunları yalnızca Web Araması API'si döndürür). Sıralama nedeniyle dışlanacak yanıtları eklemek için sorguyu yükseltme parametresine bakın.
safeSearch

Yetişkinlere yönelik içeriği filtrelemek için kullanılan bir filtre. Kapalı: Yetişkinlere yönelik metin, resim veya video içeren web sayfalarını döndürebilirsiniz. Orta: Yetişkinlere yönelik resimler veya videolar değil, yetişkinlere yönelik metin içeren web sayfaları döndürebilirsiniz. Katı: Yetişkinlere yönelik metin, resim veya video içeren web sayfalarını döndürmeyin. Varsayılan ayar Moderate değeridir. İstek, Bing'in yetişkin ilkesinin safeSearch değerinin Strict olarak ayarlanmasını gerektirdiği bir marketten geliyorsa, Bing safeSearch değerini yoksayar ve Strict kullanır. site: sorgu işlecini kullanırsanız, safeSearch sorgu parametresinin neye ayarlandığına bakılmaksızın yanıtın yetişkinlere ait içerik içerme olasılığı vardır. Siteyi kullan: Yalnızca sitedeki içeriğin farkındaysanız ve senaryonuz yetişkinlere yönelik içerik olasılığını destekliyorsa. Olası değerler şunlardır: 'Kapalı', 'Orta', 'Katı'
setLang

Kullanıcı arabirimi dizelerinde kullanılacak dil. Dili belirtirken ISO 639-1 2 harfi dil kodunu kullanın. Örneğin, Türkçe için dil kodu TR'dir. Varsayılan değer EN (İngilizce) ayarıdır. İsteğe bağlı olsa da, her zaman dil belirtmelisiniz. Genellikle, kullanıcı kullanıcı arabirimi dizelerinin farklı bir dilde görüntülenmesini istemediği sürece setLang'i mkt tarafından belirtilen aynı dile ayarlarsınız. Bu parametre ve Accept-Language üst bilgisi birbirini dışlar; her ikisini de belirtmeyin. Kullanıcı arabirimi dizesi, kullanıcı arabiriminde etiket olarak kullanılan dizedir. JSON yanıt nesnelerinde çok az kullanıcı arabirimi dizesi vardır. Ayrıca, yanıt nesnelerinde Bing.com özelliklerine yönelik bağlantılar da belirtilen dildedir.
textDecorations

Görüntü dizelerinin isabet vurgulama karakterleri gibi süsleme işaretçileri içerip içermeyeceğini belirleyen boole değeri. True ise, dizeler işaretçiler içerebilir. Varsayılan değer false. İşaretçi olarak Unicode karakterlerinin mi yoksa HTML etiketlerinin mi kullanılacağını belirtmek için textFormat sorgu parametresine bakın.
textFormat

Metin süslemeleri için kullanılacak işaretçilerin türü (bkz. textDecorations sorgu parametresi). Olası değerler Ham:Özel biçimlendirme gerektiren içeriği işaretlemek için Unicode karakterleri kullanın. Unicode karakterleri E000 ile E019 arasında yer alır. Örneğin Bing, E000 ve E001 kullanarak sorgu terimlerinin başlangıcını ve sonunu isabet vurgulama için işaretler. HTML—Özel biçimlendirme gerektiren içeriği işaretlemek için HTML etiketlerini kullanın. Örneğin, görüntüleme dizelerindeki sorgu terimlerini vurgulamak için etiketleri kullanın . Varsayılan değer Raw'dır. , >ve & gibi <kaçılabilir HTML karakterleri içeren görüntü dizeleri için textFormat HTML olarak ayarlanırsa, Bing karakterleri uygun şekilde çıkarır (örneğin, < öğesine kaçış karakteri <verilir). Olası değerler şunlardır: 'Ham', 'Html'
userAgent

İsteği başlatan kullanıcı aracısı. Bing, mobil kullanıcılara iyileştirilmiş bir deneyim sağlamak için kullanıcı aracısını kullanır. İsteğe bağlı olsa da, bu üst bilgiyi her zaman belirtmeniz kesinlikle önerilir. Kullanıcı aracısı, yaygın olarak kullanılan tarayıcıların göndereceği dizeyle aynı olmalıdır. Kullanıcı aracıları hakkında bilgi için bkz. RFC 2616.

Devralınan Özellikler

abortSignal

İstekleri durdurmak için kullanılabilecek sinyal.
customHeaders

İstek gönderilmeden önce uygulanacak kullanıcı tanımlı özel istek üst bilgileri.
onDownloadProgress

İndirme ilerlemesi üzerine tetiklenen geri çağırma.
onUploadProgress

Karşıya yükleme ilerlemesi üzerine tetiklenen geri çağırma.
timeout

Bir isteğin otomatik olarak sonlandırılmadan önce ne kadar süre alabileceğini milisaniye cinsinden belirtin.

Özellik Ayrıntıları

acceptLanguage

Kullanıcı arabirimi dizeleri için kullanılacak bir veya daha fazla dilin virgülle ayrılmış listesi. Liste, tercih edilme durumuna göre azalan düzende sıralanır. Beklenen biçim de dahil olmak üzere ek bilgi için bkz. RFC2616. Bu üst bilgi ve setLang sorgu parametresi birbirini dışlar; her ikisini de belirtmeyin. Bu üst bilgiyi ayarlarsanız, cc sorgu parametresini de belirtmelisiniz. Bing, listeden bulduğu ilk desteklenen dili kullanır ve sonuç döndürecek pazarı belirlemek için bu dili cc parametre değeriyle birleştirir. Listede desteklenen bir dil yoksa, Bing isteği destekleyen en yakın dili ve pazarı bulur ve sonuçlar için belirtilen dil yerine toplu veya varsayılan bir pazar kullanabilir. Bu üst bilgiyi ve cc sorgu parametresini yalnızca birden çok dil belirtirseniz kullanmanız gerekir; aksi takdirde, mkt ve setLang sorgu parametrelerini kullanmanız gerekir. Kullanıcı arabirimi dizesi, kullanıcı arabiriminde etiket olarak kullanılan dizedir. JSON yanıt nesnelerinde çok az kullanıcı arabirimi dizesi vardır. Yanıt nesnelerinde Bing.com özelliklere bağlantılar belirtilen dili uygular.

acceptLanguage?: string

Özellik Değeri

string

answerCount

Yanıtın içermesini istediğiniz yanıt sayısı. Bing'in döndürdüğü yanıtlar derecelendirmeye bağlıdır. Örneğin, Bing bir istek için web sayfaları, resimler, videolar ve relatedSearches döndürürse ve bu parametreyi iki (2) olarak ayarlarsanız yanıtta web sayfaları ve görüntüler bulunur. responseFilter sorgu parametresini aynı isteğe eklediyseniz ve web sayfaları ve haberler olarak ayarladıysanız, yanıt yalnızca web sayfalarını içerir.

answerCount?: number

Özellik Değeri

number

clientId

Bing, kullanıcılara tüm Bing API çağrılarında tutarlı bir davranış sağlamak için bu üst bilgiyi kullanır. Bing sık sık yeni özellikler ve geliştirmeler dağıtır ve farklı dağıtımlarda trafik ataması yapmak için anahtar olarak istemci kimliğini kullanır. Bir kullanıcı için birden çok istekte aynı istemci kimliğini kullanmazsanız, Bing kullanıcıyı birden çok çakışan dağıtıma atayabilir. Birden çok çakışan dağıtıma eklenmek, tutarsız bir kullanıcı deneyimine yol açabilir. Örneğin, ikinci isteğin dağıtım ataması ilkinden farklıysa, beklenmeyen bir deneyim yaşanabilir. Ayrıca, Bing istemci kimliğini kullanarak web sonuçlarını istemci kimliğinin arama geçmişine uyarlayabilir ve bu sayede kullanıcıya daha zengin bir deneyim sağlayabilir. Bing, istemci kimliği tarafından oluşturulan etkinliği analiz ederek sonuç derecelendirmelerini geliştirmeye yardımcı olması için de bu üst bilgiyi kullanabilir. İlgi geliştirmeleri Bing API'lerinin daha kaliteli sonuçlar vermesine yardımcı olur ve böylelikle API tüketicisi için daha yüksek tıklama oranları getirir. ÖNEMLİ: İsteğe bağlı olsa da, bu üst bilgiyi gerekli olarak kabul edebilirsiniz. Aynı son kullanıcı ile cihaz bileşimi için birden çok istekte aynı istemci kimliğini kullanıldığında, 1) API tüketicisi tutarlı bir kullanıcı deneyimi elde eder ve 2) Bing API'lerinden daha kaliteli sonuçlar alındığından tıklama oranları daha yüksek olur. Cihazda uygulamanızı kullanan her kullanıcının Bing tarafından oluşturulan benzersiz bir istemci kimliği olmalıdır. İsteğe bu üst bilgiyi eklemezseniz, Bing bir kimlik oluşturur ve bu kimliği X-MSEdge-ClientID yanıt üst bilgisinde döndürür. İsteğe bu üst bilgiyi EKLEMEMENİZ gereken tek durum, söz konusu cihazda kullanıcının uygulamanızı ilk kez kullanmasıdır. Cihazda uygulamanızın bu kullanıcı için yaptığı her Bing API'si isteğinde istemci kimliğini kullanın. İstemci kimliğinin kalıcı olmasını sağlayın. Tarayıcı uygulamasında kimliği kalıcı hale getirmek için, tüm oturumlarda kimliğin kullanmasını sağlayacak bir kalıcı HTTP tanımlama bilgisi kullanın. Oturum tanımlama bilgisi kullanmayın. Mobil uygulamalar gibi diğer uygulamalarda, kimliği kalıcı hale getirmek için cihazın kalıcı depolamasını kullanın. Kullanıcı o cihazda uygulamanızı yeniden kullandığında, kalıcı hale getirdiğiniz istemci kimliğini alın. Bing yanıtları bu üst bilgiyi içerebilir veya içermeyebilir. Yanıt bu üst bilgiyi içeriyorsa, istemci kimliğini yakalayın ve o cihazda kullanıcı için bunu izleyen tüm Bing isteklerinde onu kullanın. X-MSEdge-ClientID'yi eklerseniz isteğe tanımlama bilgileri eklememelisiniz.

clientId?: string

Özellik Değeri

string

clientIp

İstemci cihazının IPv4 veya IPv6 adresi. IP adresi, kullanıcının konumunu bulmak için kullanılır. Bing konum bilgisini kullanarak güvenli arama davranışını saptar. İsteğe bağlı olsa da, bu üst bilgiyi ve X-Search-Location üst bilgisini her zaman belirtmeniz önerilir. Adresi karartmayın (örneğin, son sekiz karakteri 0'la değiştirerek). Adresin karartılması, cihazın gerçek konumuna yakın olmayan bir konum sonucu verir ve bu da Bing'in hatalı sonuçlar sağlamasına yol açabilir.

clientIp?: string

Özellik Değeri

string

count

Yanıtta döndürülecek arama sonuçlarının sayısı. Varsayılan değer 10, maksimum değer ise 50'dir. Teslim edilen gerçek sayı istenenden küçük olabilir. Bu parametreyi, sayfa sonuçlarına uzaklık parametresiyle birlikte kullanın. Örneğin, kullanıcı arabiriminiz sayfa başına 10 arama sonucu görüntülüyorsa, ilk sonuç sayfasını almak için sayıyı 10 ve uzaklığı 0 olarak ayarlayın. Sonraki her sayfa için uzaklığı 10 artır (örneğin, 0, 10, 20). Birden çok sayfanın sonuçlarda bazı çakışmalar içermesi mümkündür.

count?: number

Özellik Değeri

number

countryCode

Sonuçların geldiği ülkenin 2 karakterli ülke kodudur. Bu API yalnızca Birleşik Devletler pazarını destekler. Bu sorgu parametresini belirtirseniz, bu parametrenin bize ayarlanması gerekir. Bu parametreyi ayarlarsanız, Accept-Language üst bilgisini de belirtmelisiniz. Bing, dil listesinden bulduğu ilk desteklenen dili kullanır ve bu dili belirttiğiniz ülke koduyla birleştirerek sonuçların döndürüleceği pazarı belirler. Diller listesi desteklenen bir dil içermiyorsa, Bing isteği destekleyen en yakın dili ve pazarı bulur veya belirtilen bir dil yerine sonuçlar için toplu veya varsayılan bir pazar kullanabilir. Bu sorgu parametresini ve Accept-Language sorgu parametresini yalnızca birden çok dil belirtirseniz kullanmanız gerekir; aksi takdirde, mkt ve setLang sorgu parametrelerini kullanmanız gerekir. Bu parametre ve mkt sorgu parametresi birbirini dışlar; ikisini birden belirtmeyin.

countryCode?: string

Özellik Değeri

string

freshness

Arama sonuçlarını şu yaş değerlerine göre filtreleyin: Day—Bing'in son 24 saat içinde keşfettiği web sayfalarını döndürün. Hafta— Bing'in son 7 gün içinde keşfettiği web sayfalarını döndürür. Ay— Son 30 gün içinde bulunan web sayfalarını döndürür. Bu filtre yalnızca web sayfası sonuçları için geçerlidir, haber ve görüntü gibi diğer sonuçlar için geçerli değildir. Olası değerler şunlardır: 'Gün', 'Hafta', 'Ay'

freshness?: Freshness

Özellik Değeri

Freshness

location

İstemcinin coğrafi konumunu açıklayan noktalı virgülle sınırlanmış anahtar/değer çifti listesi. Bing konum bilgisini kullanarak güvenli arama davranışını saptar ve ilgili yerel içeriği döndürür. Anahtar/değer çiftini olarak belirtin: Aşağıda, kullanıcının konumunu belirtmek için kullandığınız anahtarlar gösterilir. lat (gerekli): İstemcinin konumunun derece olarak enlemi. Enlem -90,0 değerinden büyük veya bu değere eşit ve +90,0 değerinden küçük veya bu değere eşit olmalıdır. Negatif değerler güney enlemlerini ve pozitif değerler de kuzey enlemlerini gösterir. long (gerekli): İstemcinin konumunun derece cinsinden boylamı. Boylam -180,0 değerinden büyük veya bu değere eşit ve +180,0 değerinden küçük veya bu değere eşit olmalıdır. Negatif değerler batı boylamlarını ve pozitif değerler de doğu boylamlarını gösterir. re (gerekli): Koordinatların yatay doğruluğunu belirten metre olarak yarıçap. Cihazın konum hizmeti tarafından döndürülen değeri geçirin. Normalde değerler GPS/Wi-Fi için 22 m, baz istasyonu triangülasyonu için 380 m ve ters IP araması için 18.000 m'dir. ts (isteğe bağlı): İstemcinin bulunduğu konumun UTC UNIX zaman damgası. (UNIX zaman damgası, 1 Ocak 1970'ten bu yana saniye sayısıdır.) head (isteğe bağlı): Müşterinin göreli başlığı veya seyahat yönü. Gerçek kuzeye göre saat yönünün tersine 0 ile 360 derece arasında bir seyahat yönü belirtin. Bu anahtarı yalnızca sp anahtarı sıfırdan farklıysa belirtin. sp (isteğe bağlı): Saniyedeki yatay hız (hız), istemci cihazının seyahat ediyor olmasıdır. alt (isteğe bağlı): İstemci cihazının metre olarak yüksekliği. şunlardır (isteğe bağlı): Koordinatların dikey doğruluğunu belirten metre olarak yarıçap. Bu anahtarı yalnızca alt anahtarı belirtirseniz belirtin. Anahtarların çoğu isteğe bağlı olsa da, ne kadar çok bilgi sağlarsanız konum sonuçları o kadar doğru olur. İsteğe bağlı olsa da, her zaman kullanıcının coğrafi konumunu belirtmeniz önerilir. İstemcinin IP adresi kullanıcının fiziksel konumunu doğru yansıtmıyorsa (örneğin istemci VPN kullanıyorsa), konumun belirtilmesi özellikle önemlidir. En iyi sonuçları elde etmek için, bu üst bilgiyi ve X-MSEdge-ClientIP üst bilgisini eklemelisiniz; ama en azından bu üst bilgiyi eklemeniz gerekir.

location?: string

Özellik Değeri

string

market

Sonuçların geldiği pazar. Genellikle mkt, kullanıcının istekte bulunduğu ülkedir. Ancak, kullanıcı Bing'in sonuçları teslim ettiği bir ülkede değilse farklı bir ülke olabilir. Piyasa - biçiminde olmalıdır. Örneğin, tr-TR. Dize büyük/küçük harfe duyarlı değildir. Biliniyorsa, her zaman pazarı belirtmeniz teşvik edilir. Pazarın belirtilmesi Bing’in isteği yönlendirmesine, uygun ve en iyi yanıtı döndürmesine yardımcı olur. Pazar Kodları'nda listelenmeyen bir pazar belirtirseniz, Bing, değişikliğe tabi iç eşlemeye dayalı olarak en uygun pazar kodunu kullanır. Bu parametre ve cc sorgu parametresi birbirini dışlar; ikisini birden belirtmeyin. Varsayılan değer: 'en-us'.

market?: string

Özellik Değeri

string

offset

Sonuçları döndürmeden önce atlana arama sonuçlarının sayısını gösteren sıfır tabanlı uzaklık. Varsayılan değer, 0'dur. Uzaklık küçük olmalıdır (totalEstimatedMatches - count). Sayfa sonuçlarında count parametresiyle birlikte bu parametreyi kullanın. Örneğin, kullanıcı arabiriminiz sayfa başına 10 arama sonucu görüntülüyorsa, ilk sonuç sayfasını almak için sayıyı 10 ve uzaklığı 0 olarak ayarlayın. Sonraki her sayfa için uzaklığı 10 artır (örneğin, 0, 10, 20). birden çok sayfanın sonuçlarda bazı çakışmalar içermesi mümkündür.

offset?: number

Özellik Değeri

number

pragma

Varsayılan olarak, Bing önbelleğe alınmış içeriği (varsa) döndürür. Bing'in önbelleğe alınmış içeriği döndürmesini önlemek için, Pragma üst bilgisini no-cache olarak ayarlayın (örneğin, Pragma: no-cache).

pragma?: string

Özellik Değeri

string

promote

Derecelendirmelerinden bağımsız olarak yanıtın eklenmesini istediğiniz yanıtların virgülle ayrılmış listesi. Örneğin, answerCount değerini iki (2) olarak ayarlarsanız, Bing ilk iki dereceli yanıtı döndürür, ancak yanıtın haberleri de içermesini isterseniz, haberlere yükseltmeyi ayarlarsınız. En çok sıralanan yanıtlar web sayfaları, resimler, videolar ve relatedSearches ise, haberler dereceli bir yanıt olmadığından yanıtta web sayfaları ve resimler bulunur. Ancak video yükseltmeyi ayarlarsanız Bing, video yanıtını yanıta yükseltip web sayfaları, resimler ve videolar döndürür. Yükseltmek istediğiniz yanıtlar answerCount sınırına karşı sayılmaz. Örneğin, dereceli yanıtlar haberler, resimler ve videolar ise ve answerCount değerini 1 olarak ayarlayıp haberlere yükseltiyorsanız, yanıtta haberler ve görüntüler bulunur. Ya da dereceli yanıtlar videolar, resimler ve haberlerse yanıtta videolar ve haberler bulunur. Olası değerler Hesaplama, Görüntüler, Haberler, RelatedSearches, SpellSuggestions, TimeZone, Videolar, Web Sayfaları'dır. Yalnızca answerCount belirtirseniz kullanın.

promote?: AnswerType[]

Özellik Değeri

AnswerType[]

responseFilter

Yanıta dahil etmek için virgülle ayrılmış yanıt listesi. Bu parametreyi belirtmezseniz yanıt, ilgili verilerin bulunduğu tüm arama yanıtlarını içerir. Olası filtre değerleri Hesaplama, Görüntüler, Haberler, relatedSearches, SpellSuggestions, TimeZone, Videolar, Web Sayfaları'dır. Tek bir yanıt almak için bu filtreyi kullanabilirsiniz ancak daha zengin sonuçlar elde etmek için yanıta özgü uç noktayı kullanmanız gerekir. Örneğin, yalnızca görüntüleri almak için isteği Görüntü Arama API'sinin uç noktalarına gönderin. RelatedSearches ve SpellSuggestions yanıtları, Görüntü Arama API'si gibi ayrı bir uç noktayı desteklemez (bunları yalnızca Web Araması API'si döndürür). Sıralama nedeniyle dışlanacak yanıtları eklemek için sorguyu yükseltme parametresine bakın.

responseFilter?: AnswerType[]

Özellik Değeri

AnswerType[]

safeSearch

Yetişkinlere yönelik içeriği filtrelemek için kullanılan bir filtre. Kapalı: Yetişkinlere yönelik metin, resim veya video içeren web sayfalarını döndürebilirsiniz. Orta: Yetişkinlere yönelik resimler veya videolar değil, yetişkinlere yönelik metin içeren web sayfaları döndürebilirsiniz. Katı: Yetişkinlere yönelik metin, resim veya video içeren web sayfalarını döndürmeyin. Varsayılan ayar Moderate değeridir. İstek, Bing'in yetişkin ilkesinin safeSearch değerinin Strict olarak ayarlanmasını gerektirdiği bir marketten geliyorsa, Bing safeSearch değerini yoksayar ve Strict kullanır. site: sorgu işlecini kullanırsanız, safeSearch sorgu parametresinin neye ayarlandığına bakılmaksızın yanıtın yetişkinlere ait içerik içerme olasılığı vardır. Siteyi kullan: Yalnızca sitedeki içeriğin farkındaysanız ve senaryonuz yetişkinlere yönelik içerik olasılığını destekliyorsa. Olası değerler şunlardır: 'Kapalı', 'Orta', 'Katı'

safeSearch?: SafeSearch

Özellik Değeri

SafeSearch

setLang

Kullanıcı arabirimi dizelerinde kullanılacak dil. Dili belirtirken ISO 639-1 2 harfi dil kodunu kullanın. Örneğin, Türkçe için dil kodu TR'dir. Varsayılan değer EN (İngilizce) ayarıdır. İsteğe bağlı olsa da, her zaman dil belirtmelisiniz. Genellikle, kullanıcı kullanıcı arabirimi dizelerinin farklı bir dilde görüntülenmesini istemediği sürece setLang'i mkt tarafından belirtilen aynı dile ayarlarsınız. Bu parametre ve Accept-Language üst bilgisi birbirini dışlar; her ikisini de belirtmeyin. Kullanıcı arabirimi dizesi, kullanıcı arabiriminde etiket olarak kullanılan dizedir. JSON yanıt nesnelerinde çok az kullanıcı arabirimi dizesi vardır. Ayrıca, yanıt nesnelerinde Bing.com özelliklerine yönelik bağlantılar da belirtilen dildedir.

setLang?: string

Özellik Değeri

string

textDecorations

Görüntü dizelerinin isabet vurgulama karakterleri gibi süsleme işaretçileri içerip içermeyeceğini belirleyen boole değeri. True ise, dizeler işaretçiler içerebilir. Varsayılan değer false. İşaretçi olarak Unicode karakterlerinin mi yoksa HTML etiketlerinin mi kullanılacağını belirtmek için textFormat sorgu parametresine bakın.

textDecorations?: boolean

Özellik Değeri

boolean

textFormat

Metin süslemeleri için kullanılacak işaretçilerin türü (bkz. textDecorations sorgu parametresi). Olası değerler Ham:Özel biçimlendirme gerektiren içeriği işaretlemek için Unicode karakterleri kullanın. Unicode karakterleri E000 ile E019 arasında yer alır. Örneğin Bing, E000 ve E001 kullanarak sorgu terimlerinin başlangıcını ve sonunu isabet vurgulama için işaretler. HTML—Özel biçimlendirme gerektiren içeriği işaretlemek için HTML etiketlerini kullanın. Örneğin, görüntüleme dizelerindeki sorgu terimlerini vurgulamak için etiketleri kullanın . Varsayılan değer Raw'dır. , >ve & gibi <kaçılabilir HTML karakterleri içeren görüntü dizeleri için textFormat HTML olarak ayarlanırsa, Bing karakterleri uygun şekilde çıkarır (örneğin, < öğesine kaçış karakteri <verilir). Olası değerler şunlardır: 'Ham', 'Html'

textFormat?: TextFormat

Özellik Değeri

TextFormat

userAgent

İsteği başlatan kullanıcı aracısı. Bing, mobil kullanıcılara iyileştirilmiş bir deneyim sağlamak için kullanıcı aracısını kullanır. İsteğe bağlı olsa da, bu üst bilgiyi her zaman belirtmeniz kesinlikle önerilir. Kullanıcı aracısı, yaygın olarak kullanılan tarayıcıların göndereceği dizeyle aynı olmalıdır. Kullanıcı aracıları hakkında bilgi için bkz. RFC 2616.

userAgent?: string

Özellik Değeri

string

Devralınan Özellik Detayları

abortSignal

İstekleri durdurmak için kullanılabilecek sinyal.

abortSignal?: AbortSignalLike

Özellik Değeri

AbortSignalLike

msRest.RequestOptionsBase.abortSignal'dan Devralındı

customHeaders

İstek gönderilmeden önce uygulanacak kullanıcı tanımlı özel istek üst bilgileri.

customHeaders?: {[key: string]: string}

Özellik Değeri

{[key: string]: string}

msRest.RequestOptionsBase.customHeaders'dan Devralındı

onDownloadProgress

İndirme ilerlemesi üzerine tetiklenen geri çağırma.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Özellik Değeri

(progress: TransferProgressEvent) => void

msRest.RequestOptionsBase.onDownloadProgress'ten Devralındı

onUploadProgress

Karşıya yükleme ilerlemesi üzerine tetiklenen geri çağırma.

onUploadProgress?: (progress: TransferProgressEvent) => void

Özellik Değeri

(progress: TransferProgressEvent) => void

msRest.RequestOptionsBase.onUploadProgress'ten Devralındı

timeout

Bir isteğin otomatik olarak sonlandırılmadan önce ne kadar süre alabileceğini milisaniye cinsinden belirtin.

timeout?: number

Özellik Değeri

number

msRest.RequestOptionsBase.timeout'tan Devralındı