Aracılığıyla paylaş


Bing Yerel İş Arama API'si v7 başvurusu

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Yerel İşletme Arama API'si restoranlar, oteller veya diğer yerel işletmeler içeren sonuçları almak için Bing'e bir arama sorgusu gönderir. Yerler için, sorgu yerel işletmenin adını veya bir kategoriyi (örneğin, yakınımdaki restoranlar) belirtebilir. Varlık sonuçları kişileri, yerleri veya nesneleri kapsar. Bu bağlamda iş varlıkları, eyaletler, ülkeler/bölgeler vb. yer alır.

Bu bölümde yanıt nesneleri ve arama sonuçlarını etkileyen sorgu parametreleri ve üst bilgileri hakkında teknik ayrıntılar sağlanır. İstekte bulunmayı gösteren örnekler için bkz. Yerel İş Araması C# hızlı başlangıcı veya Yerel İş Arama Java hızlı başlangıcı.

İsteklerin içermesi gereken üst bilgiler hakkında bilgi için bkz. Üst bilgiler.

İsteklerin içermesi gereken sorgu parametreleri hakkında bilgi için bkz. Sorgu parametreleri.

Yanıtın içerdiği JSON nesneleri hakkında bilgi için bkz . Yanıt nesneleri.

Sonuçların izin verilen kullanımı ve görüntülenmesi hakkında bilgi için bkz . Kullanım ve görüntüleme gereksinimleri.

Uç Nokta

Yerel iş sonuçları istemek için şu konuma bir GET isteği gönderin:

https://api.cognitive.microsoft.com/bing/v7.0/localbusinesses/search

İsteğin HTTPS protokolünü kullanması gerekir.

Not

En fazla URL uzunluğu 2.048 karakterdir. URL uzunluğunuzun sınırı aşmadığından emin olmak için sorgu parametrelerinizin uzunluk üst sınırı 1.500 karakterden az olmalıdır. URL 2.048 karakteri aşarsa, sunucu 404 Bulunamadı değerini döndürür.

Üst Bilgiler

Bir istek ve yanıtın içerebileceği üst bilgiler aşağıdadır.

Üst bilgi Description
Kabul Et İsteğe bağlı istek üst bilgisi.

Varsayılan medya türü application/json'dır. Yanıtın JSON-LD kullandığını belirtmek için Accept üst bilgisini application/ld+json olarak ayarlayın.
Accept-Language İsteğe bağlı istek üst bilgisi.

Kullanıcı arabirimi dizelerinde kullanılacak virgülle sınırlanmış bir dil listesi. Liste, tercih edilme durumuna göre azalan düzende sıralanır. Beklenen biçim de içinde olmak üzere daha fazla bilgi için bkz. RFC2616.

Bu üst bilgi ve setLang sorgu parametresi birbirini dışlar; ikisini birden belirtmeyin.

Bu üst bilgiyi ayarlarsanız, cc sorgu parametresini de belirtmelisiniz. Hangi pazardan sonuç döndürüleceğini belirlemek için, Bing listeden bulduğu ilk desteklenen dili kullanır ve bunu cc parametresinin değeriyle birleştirir. Liste desteklenen bir dil içermiyorsa, Bing isteği destekleyen en yakın dili ve pazarı bulur ya da sonuçlar için toplu veya varsayılan bir pazar kullanır. Bing'in kullandığı pazarı saptamak için BingAPIs-Market üst bilgisine bakın.

Ancak birden çok dil belirtirseniz bu üst bilgiyi ve cc sorgu parametresini kullanın. Aksi takdirde, mkt ile setLang sorgu parametrelerini kullanın.

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 özelliklerine yönelik bağlantılar da belirtilen dildedir.
BingAPIs-Market Yanıt üst bilgisi.

İstek tarafından kullanılan pazar. Form languageCode-countryCode şeklindedir<>.>< Örneğin, tr-TR.
BingAPIs-TraceId Yanıt üst bilgisi.

İsteğin ayrıntılarını içeren günlük girdisinin kimliği. Hata oluştuğunda, bu kimliği yakalayın. Sorunu belirleyemez ve çözemezseniz, Destek ekibine diğer bilgilerle birlikte bu kimliği de sağlayın.
Ocp-Apim-Subscription-Key Gerekli istek üst bilgisi.

Azure AI hizmetlerinde bu hizmete kaydolduğunuz sırada aldığınız abonelik anahtarı.
Pragma İsteğe bağlı istek üst bilgisi

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).
User-Agent İsteğe bağlı istek üst bilgisi.

İ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 önerilir.

User-agent, yaygın olarak kullanılan tarayıcılardan gönderilen dizeyle aynı olmalıdır. Kullanıcı aracıları hakkında bilgi için bkz. RFC 2616.

Aşağıda örnek user-agent dizelerini bulabilirsiniz.
  • Windows Phone—Mozilla/5.0 (uyumlu; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; KOL; Dokunmatik; NOKİA; Lumia 822)

  • Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Derleme/GINGERBREAD) AppleWebKit/533.1 (KHTML; Gecko gibi) Sürüm/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone; MAC OS X gibi CPU iPhone OS 6_1) AppleWebKit/536.26 (KHTML; Gecko gibi) Mobile/10B142 iPhone4; 1 BingWeb/3.03.1428.20120423

  • BILGISAYAR—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Dokunmatik; rv:11.0) like Gecko

  • iPad—Mozilla/5.0 (iPad; MAC OS X gibi CPU OS 7_0) AppleWebKit/537.51.1 (KHTML, Gecko gibi) Sürüm/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID İsteğe bağlı istek ve yanıt üst bilgisi.

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.

Bu üst bilgi için geçerli olan temel kullanım kuralları şunlardır:
  • 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.

  • DİKKAT: Bu İstemci Kimliğinin doğrulanabilir kullanıcı hesabı bilgilerine bağlanamadığını kontrol etmeniz gerekir.

  • İ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.

NOT: 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.

NOT: X-MSEdge-ClientID üst bilgisini eklerseniz, isteğe tanımlama bilgileri eklememelisiniz.
X-MSEdge-ClientIP İsteğe bağlı istek üst bilgisi.

İ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.

NOT: İ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.
X-Search-Location İsteğe bağlı istek üst bilgisi.

İ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 <anahtar>:<değer> olarak belirtin. Aşağıda, kullanıcının konumunu belirtmek için kullandığınız anahtarlar gösterilir.

  • lat—İ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—İstemcinin konumunun boylamı derece olarak. 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— 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— İstemcinin bulunduğu konumun UTC UNIX zaman damgası. (UNIX zaman damgası 1 Ocak 1970'den başlayarak saniye sayısıdır.)

  • head—İsteğe bağlı. İstemcinin göreli 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ı ancak sp anahtarı sıfırdan farklı bir değer olduğunda belirtin.

  • sp— Saniyedeki yatay hız (hız), istemci cihazının seyahat ediyor olmasıdır.

  • alt— İstemci cihazının metre olarak yüksekliği.

  • are—İsteğe bağlı. Koordinatların dikey doğruluğunu belirten metre cinsinden yarıçap. Yarıçap varsayılan olarak 50 Kilometre'ye ayarlanır. Bu anahtarı ancak alt anahtarı belirttiğiniz durumda belirtin.

NOT: Bu anahtarlar isteğe bağlı olsa da, ne kadar fazla bilgi sağlarsanız konum sonuçları o kadar doğru olur.

NOT: 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.

Not

Kullanım Koşulları'nın, bu üst bilgilerin kullanımıyla ilgili olanlar da dahil olmak üzere tüm ilgili yasalara uymayı gerektirdiğini unutmayın. Örneğin, Avrupa gibi bazı yasama bölgelerinde kullanıcı cihazlarına izleme cihazları takmadan önce kullanıcının iznini almak gerekir.

Sorgu parametreleri

İstek aşağıdaki sorgu parametrelerini içerebilir. Gerekli parametreler için Gerekli sütununa bakın. Sorgu parametrelerini URL ile kodlamanız gerekir.

Name Değer Tür Gerekli
Sayısı Parametresi tarafından offset belirtilen dizinden başlayarak döndürülecek sonuç sayısı. Dize No
localCategories aramayı iş kategorisine göre tanımlayan seçeneklerin listesi. Bkz. Yerel İş Kategorileri araması Dize No
mkt Sonuçların geldiği pazar.

Olası pazar değerlerinin listesi için bkz. Piyasa Kodları.

NOT: Yerel İş Arama API'si şu anda yalnızca en-us pazarını ve dilini destekler.

Dize Yes
Uzaklık Parametresi tarafından count belirtilen sonuçları başlatacak dizin. Tamsayı No
S Kullanıcının arama terimi. Dize No
responseFormat Yanıt için kullanılacak medya türü. Aşağıdakiler büyük/küçük harfe duyarlı olmayan olası değerlerdir.
  • JSON
  • JSONLD

Varsayılan değer JSON'dır. Yanıtın içerdiği JSON nesneleri hakkında bilgi için bkz . Yanıt Nesneleri.

JsonLd belirtirseniz, yanıt gövdesi arama sonuçlarını içeren JSON-LD nesnelerini içerir. JSON-LD hakkında bilgi için bkz. JSON-LD.
Dize No
safeSearch Yetişkinlere yönelik içeriği filtrelemek için kullanılan bir filtre. Aşağıdakiler, büyük/küçük harfe duyarlı olmayan olası filtre değerleridir.
  • 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 olmasa da yetişkinlere yönelik metin içeren web sayfalarını 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.

NOT: İstek, Bing'in yetişkin ilkesinin Zorunlu olarak ayarlanmasını gerektiren safeSearch bir marketten geliyorsa, Bing değeri yoksayar safeSearch ve Strict kullanır.

NOT:site: sorgu işlecini kullanmanız durumunda, safeSearch parametresinin ayarına bakılmaksızın yanıtta yetişkinlere yönelik içerik bulunabilir. site: işlecini yalnızca sitenin içeriği hakkında bilgi sahibiyseniz ve senaryonuz, yetişkinlere yönelik içeriğin mevcut olma ihtimalini destekliyorsa kullanın.
Dize No
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. Kullanıcı tarafından kullanıcı arabirimi dizelerinin farklı dilde görüntülenmesi istenmediği sürece, normalde setLang parametresini mkt parametresiyle aynı dile ayarlarsınız.

Bu parametre ve Accept-Language üst bilgisi birbirini dışlar; ikisini birden 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.
Dize No

Yanıt Nesneleri

Aşağıda, yanıtın içerebileceği JSON yanıt nesneleri yer alır. İstek başarılı olursa, yanıttaki en üst düzey nesne SearchResponse nesnesidir. İstek başarısız olursa en üst düzey nesne ErrorResponse nesnesidir.

Nesne Description
Yer Restoran veya otel gibi yerel bir işletmeyle ilgili bilgileri tanımlar.

Hata

Oluşan hatayı tanımlar.

Öğe Açıklama Tür
Kod Hata kategorisini tanımlayan hata kodu. Olası kodların listesi için bkz. Hata Kodları. Dize
İleti Hatanın açıklaması. Dize
moreDetails Hata hakkında ek bilgi sağlayan bir açıklama. Dize
Parametre Hataya neden olan istekteki sorgu parametresi. Dize
Subcode Hatayı tanımlayan hata kodu. Örneğin, InvalidRequest ise code ParameterInvalid subCode veya ParameterInvalidValue olabilir. Dize
Değer Sorgu parametresinin geçerli olmayan değeri. Dize

ErrorResponse

İstek başarısız olduğunda yanıtın içerdiği en üst düzey nesne.

Name Değer Tür
_Türü İpucu yazın. Dize
Hata İsteğin başarısız olmasının nedenlerini açıklayan hataların listesi. Hata[]

Lisans

Metnin veya fotoğrafın altında kullanılabileceğini lisansı tanımlar.

Name Değer Tür
name Lisansın adı. Dize
url Kullanıcının lisans hakkında daha fazla bilgi edinebileceği bir web sitesinin URL'si.

Köprü oluşturmak için adı ve URL'yi kullanın.
Dize

Köprü bileşenlerini tanımlar.

Name Değer Tür
_Türü İpucu yazın. Dize
metin Görüntüleme metni. Dize
url BIR URL. Köprü oluşturmak için URL'yi kullanın ve metni görüntüleyin. Dize

Kuruluş

Yayımcı tanımlar.

Yayımcının adını, web sitesini veya her ikisini birden sağlayabileceğini unutmayın.

Name Değer Tür
name Yayımcının adı. Dize
url Yayımcının web sitesinin URL'si.

Yayımcının bir web sitesi sağlamayabileceğini unutmayın.
Dize

Yer

Restoran veya otel gibi yerel bir işletmeyle ilgili bilgileri tanımlar.

Name Değer Tür
_Türü Aşağıdakilerden birine ayarlanabilen tür ipucu:

  • Otel
  • Yerel İş
  • Restoran
  • Dize
    adres Varlığın bulunduğu posta adresi. Posta Adresi
    entityPresentationInfo Varlığın türünü belirlemek için kullanabileceğiniz ipuçları gibi varlık hakkında ek bilgiler. Örneğin, ister restoran ister otel olsun. Alan entityScenario ListItem olarak ayarlanır. EntityPresentationInfo
    name Varlığın adı. Dize
    Telefon Varlığın telefon numarası. Dize
    url Varlığın web sitesinin URL'si.

    Tıklandığında kullanıcıyı varlığın web sitesine götüren bir köprü oluşturmak için varlığın adıyla birlikte bu URL'yi kullanın.
    Dize
    webSearchUrl Bing'in bu yer için arama sonucunun URL'si. Dize

    Querycontext

    Bing'in istek için kullandığı sorgu bağlamını tanımlar.

    Öğe Açıklama Tür
    adultIntent Belirtilen sorgunun yetişkin amacına sahip olup olmadığını gösteren boole değeri. Sorgunun yetişkin amacı varsa değer doğrudur ; aksi takdirde false. Boole
    alterationOverrideQuery Bing'i özgün dizeyi kullanmaya zorlamak için kullanılacak sorgu dizesi. Örneğin, sorgu dizesi downwind'i kurtarıyorsa geçersiz kılma sorgu dizesi +saling downwind olacaktır. %2Bsaling+downwind ile sonuçlanan sorgu dizesini kodlamayı unutmayın.

    Bu alan yalnızca özgün sorgu dizesi yazım hatası içeriyorsa eklenir.
    Dize
    alteredQuery Bing tarafından sorguyu gerçekleştirmek için kullanılan sorgu dizesi. Bing, özgün sorgu dizesi yazım hataları içeriyorsa değiştirilmiş sorgu dizesini kullanır. Örneğin, sorgu dizesi ise saling downwind, değiştirilen sorgu dizesi olacaktır sailing downwind.

    Bu alan yalnızca özgün sorgu dizesi yazım hatası içeriyorsa eklenir.
    Dize
    askUserForLocation Bing'in doğru sonuçlar sağlamak için kullanıcının konumunu gerektirip gerektirmediğini gösteren boole değeri. X-MSEdge-ClientIP ve X-Search-Location üst bilgilerini kullanarak kullanıcının konumunu belirttiyseniz, bu alanı yoksayabilirsiniz.

    Doğru sonuçları sağlamak için kullanıcının konumuna ihtiyaç duyan "bugünün hava durumu" veya "yakınımdaki restoranlar" gibi konum algılamalı sorgular için bu alan true olarak ayarlanır.

    Konumu içeren konum algılamalı sorgular için (örneğin, "Seattle hava durumu"), bu alan false olarak ayarlanır. Bu alan, "en çok satanlar" gibi konum bilgisi olmayan sorgular için false olarak da ayarlanır.
    Boole
    originalQuery İstekte belirtilen sorgu dizesi. Dize

    Tanımlana -bilen

    Name Değer Tür
    kimlik Kaynak tanımlayıcısı Dize

    RankingGroup

    Ana hat gibi bir arama sonuçları grubu tanımlar.

    Name Değer Tür
    öğe Grupta görüntülenecek arama sonuçlarının listesi. RankingItem

    RankingItem

    Görüntülenecek bir arama sonucu öğesi tanımlar.

    Name Değer Tür
    resultIndex Görüntülenecek yanıttaki öğenin sıfır tabanlı dizini. Öğe bu alanı içermiyorsa, yanıttaki tüm öğeleri görüntüleyin. Örneğin, Tüm haber makalelerini Haber yanıtında görüntüleyin. Tamsayı
    answerType Görüntülenecek öğeyi içeren yanıt. Örneğin, Haberler.

    SearchResponse nesnesinde yanıtı bulmak için türünü kullanın. Tür, SearchResponse alanının adıdır.

    Ancak, yanıt türünü yalnızca bu nesne değer alanını içeriyorsa kullanın; aksi takdirde, yoksayın.
    Dize
    textualIndex Görüntülenecek textualAnswers içindeki yanıtın dizini. İşaretsiz Tamsayı
    değer Görüntülenecek yanıtı veya görüntülenecek yanıtın bir öğesini tanımlayan kimlik. Kimlik bir yanıt tanımlarsa yanıtın tüm öğelerini görüntüleyin. Tanımlana -bilen

    RankingResponse

    Arama sonuçları sayfasının içeriğinin nereye ve hangi sırayla yerleştirilmesi gerektiğini tanımlar.

    Name Değer
    Mainline Ana satırda görüntülenecek arama sonuçları.
    Kutup En görünür işlemin karşılanması gereken arama sonuçları (örneğin, ana hat ve kenar çubuğunun üstünde görüntülenir).
    Kenar çubuğu Kenar çubuğunda görüntülenecek arama sonuçları.

    Searchresponse

    İstek başarılı olduğunda yanıtın içerdiği en üst düzey nesneyi tanımlar.

    Hizmetin bir hizmet reddi saldırısı olduğundan şüphelenirse isteğin başarılı olacağını unutmayın (HTTP durum kodu 200 Tamam); ancak yanıtın gövdesi boş olacaktır.

    Name Değer Tür
    _Türü SearchResponse olarak ayarlanmış ipucu yazın. Dize
    verir Arama sorgusuyla ilgili varlıkların listesi. JSON nesnesi
    Querycontext Bing'in istek için kullandığı sorgu dizesini içeren nesne.

    Bu nesne, kullanıcı tarafından girilen sorgu dizesini içerir. Ayrıca, sorgu dizesi yazım hatası içeriyorsa, Bing'in sorgu için kullandığı değiştirilmiş bir sorgu dizesi de içerebilir.
    Querycontext

    Hata kodları

    Bir isteğin döndürdüğü olası HTTP durum kodları aşağıdadır.

    Durum Kodu Description
    200 Başarılı.
    400 Sorgu parametrelerinden biri eksik veya geçersiz.
    401 Abonelik anahtarı eksik veya geçerli değil.
    403 Kullanıcının kimliği doğrulandı (örneğin, geçerli bir abonelik anahtarı kullandı) ancak istenen kaynak için izinleri yok.

    Bing, çağıranın aylık sorgu kotasını aşması durumunda da bu durumu döndürebilir.
    410 İstek, HTTPS protokolü yerine HTTP kullandı. DESTEKLENEN tek protokol HTTPS'dir.
    429 Çağıran, saniye başına sorgu kotasını aştı.
    500 Beklenmeyen sunucu hatası.

    İstek başarısız olursa yanıt, hatanın nedenini açıklayan Error nesnelerinin listesini içeren bir ErrorResponse nesnesi içerir. Hata bir parametreyle ilgiliyse, parameter alan sorun olan parametreyi tanımlar. Hata bir parametre değeriyle ilgiliyse, value alan geçerli olmayan değeri tanımlar.

    {
      "_type": "ErrorResponse", 
      "errors": [
        {
          "code": "InvalidRequest", 
          "subCode": "ParameterMissing", 
          "message": "Required parameter is missing.", 
          "parameter": "q" 
        }
      ]
    }
    
    {
      "_type": "ErrorResponse", 
      "errors": [
        {
          "code": "InvalidAuthorization", 
          "subCode": "AuthorizationMissing", 
          "message": "Authorization is required.", 
          "moreDetails": "Subscription key is not recognized."
        }
      ]
    }
    

    Olası hata kodu ve alt hata kodu değerleri aşağıdadır.

    Kod SubCode Description
    ServerError UnexpectedError
    ResourceError
    NotImplemented
    HTTP durum kodu 500'dür.
    InvalidRequest ParameterMissing
    ParameterInvalidValue
    HttpNotAllowed
    Engellendi
    İsteğin herhangi bir bölümü geçerli olmadığından Bing InvalidRequest döndürür. Örneğin, gerekli bir parametre eksik veya parametre değeri geçerli değil.

    Hata ParameterMissing veya ParameterInvalidValue ise, HTTP durum kodu 400'dür.

    HTTPS yerine HTTP protokolü kullanırsanız, Bing HttpNotAllowed döndürür ve HTTP durum kodu 410'dur.
    RateLimitExceeded Alt kod yok Bing, saniye başına sorgu (QPS) veya aylık sorgu (QPM) kotasını aştığınızda RateLimitExceeded döndürür.

    QPS'yi aşarsanız, Bing HTTP durum kodu 429'u döndürür ve QPM'yi aşarsanız Bing 403 döndürür.
    InvalidAuthorization AuthorizationMissing
    AuthorizationRedundancy
    Bing çağıranın kimliğini doğrulayamazsa Bing InvalidAuthorization döndürür. Örneğin, Ocp-Apim-Subscription-Key üst bilgi eksik veya abonelik anahtarı geçerli değil.

    Birden fazla kimlik doğrulama yöntemi belirtirseniz yedeklilik oluşur.

    Hata InvalidAuthorization ise HTTP durum kodu 401'dir.
    InsufficientAuthorization AuthorizationDisabled
    AuthorizationExpired
    Çağıranın kaynağa erişim izinleri olmadığında Bing InsufficientAuthorization döndürür. Abonelik anahtarının devre dışı bırakılması veya süresinin dolması durumunda bu durum oluşabilir.

    Hata InsufficientAuthorization ise HTTP durum kodu 403'dür.

    Sonraki adımlar