Memfilter jawaban yang disertakan oleh respons pencarian

Peringatan

API Pencarian Bing berpindah dari Cognitive Services ke Layanan Pencarian Bing. Mulai 30 Oktober 2020, instans baru Pencarian Bing harus diprovisi dengan mengikuti proses yang didokumentasikan di sini. API Pencarian Bing yang diprovisi menggunakan Cognitive Services akan didukung selama tiga tahun ke depan atau hingga akhir Perjanjian Enterprise Anda, mana pun yang terjadi terlebih dahulu. Untuk instruksi migrasi, lihat Layanan Pencarian Bing.

Saat Anda mengkueri web, Bing mengembalikan semua konten yang relevan yang ditemukannya untuk pencarian. Misalnya, jika kueri pencarian adalah "sailing+dinghies", respons mungkin berisi jawaban berikut:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43C...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    },
    "images" : {
        "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
        "readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA5CA6464E5D...",
        "isFamilyFriendly" : true,
        "value" : [...]
    },
    "rankingResponse" : {
        "mainline" : {
            "items" : [...]
        }
    }
}    

Parameter kueri

Untuk memfilter jawaban yang dikembalikan oleh Bing, gunakan parameter kueri di bawah ini saat memanggil API.

ResponseFilter

Anda dapat memfilter jenis jawaban yang disertakan Bing dalam respons (misalnya gambar, video, dan berita) dengan menggunakan parameter kueri responseFilter, yang merupakan daftar jawaban yang dibatasi koma. Jawaban akan disertakan dalam respons jika Bing menemukan konten yang relevan untuk itu.

Untuk mengecualikan jawaban spesifik dari respons seperti gambar, prepend karakter - ke jenis jawaban. Contohnya:

&responseFilter=-images,-videos

Berikut ini menunjukkan cara menggunakan responseFilter untuk meminta gambar, video, dan berita tentang dinghies berlayar. Saat Anda menyandikan untai (karakter) kueri, koma berubah menjadi %2C.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&responseFilter=images%2Cvideos%2Cnews&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

Berikut ini memperlihatkan respons terhadap kueri sebelumnya. Karena Bing tidak menemukan hasil video dan berita yang relevan, responsnya tidak menyertakannya.

{
    "_type" : "SearchResponse",
    "images" : {
        "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
        "readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3AD78B183C56456C...",
        "isFamilyFriendly" : true,
        "value" : [...]
    },
    "rankingResponse" : {
        "mainline" : {
            "items" : [{
                "answerType" : "Images",
                "value" : {
                    "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images"
                }
            }]
        }
    }
}

Meskipun Bing tidak mengembalikan hasil video dan berita dalam tanggapan sebelumnya, bukan berarti konten video dan berita tidak ada. Ini hanya berarti bahwa halaman tidak menyertakannya. Namun, jika Anda halaman melalui lebih banyak hasil, halaman berikutnya kemungkinan akan menyertakannya. Selain itu, jika Anda memanggil titik akhir Api Pencarian Video dan API Pencarian Berita secara langsung, respons kemungkinan akan berisi hasil.

Anda tidak dianjurkan untuk menggunakan responseFilter untuk mendapatkan hasil dari satu API. Jika Anda ingin konten dari satu API Bing, panggil API tersebut secara langsung. Misalnya, untuk hanya menerima gambar, kirim permintaan ke titik akhir API Pencarian Gambar, https://api.cognitive.microsoft.com/bing/v7.0/images/search atau salah satu titik akhir Gambar lainnya. Memanggil API tunggal penting tidak hanya karena alasan kinerja tetapi karena API khusus konten menawarkan hasil yang lebih kaya. Misalnya, Anda dapat menggunakan filter yang tidak tersedia untuk API Pencarian Web untuk memfilter hasilnya.

Situs

Untuk mendapatkan hasil pencarian dari domain tertentu, sertakan parameter kueri site: dalam untai (karakter) kueri.

https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us

Catatan

Bergantung pada kueri, jika Anda menggunakan operator kueri site:, ada kemungkinan respons berisi konten dewasa terlepas dari pengaturan safeSearch. Anda harus menggunakan site: hanya jika Anda mengetahui konten di situs dan skenario Anda mendukung kemungkinan konten dewasa.

Kesegaran

Untuk membatasi hasil jawaban web ke halaman web yang ditemukan Bing selama periode tertentu, atur parameter kueri kesegaran ke salah satu nilai tidak sensitif kasus berikut ini:

  • Day — Mengembalikan halaman web yang ditemukan Bing dalam 24 jam terakhir
  • Week — Mengembalikan halaman web yang ditemukan Bing dalam 7 hari terakhir
  • Month — Mengembalikan halaman web yang ditemukan dalam 30 hari terakhir

Anda juga dapat mengatur parameter ini ke rentang tanggal kustom dalam formulir, YYYY-MM-DD..YYYY-MM-DD.

https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-01..2019-05-30

Untuk membatasi hasil ke satu tanggal, atur parameter kesegaran ke tanggal tertentu:

https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-04

Hasilnya dapat mencakup halaman web yang berada di luar periode yang ditentukan jika jumlah halaman web yang cocok dengan Bing dengan kriteria filter Anda kurang dari jumlah halaman web yang Anda minta (atau nomor default yang dikembalikan Bing).

Membatasi jumlah jawaban dalam respons

Bing dapat mengembalikan beberapa jenis jawaban dalam respons JSON. Misalnya, jika Anda meminta layar + dinghies, Bing mungkin kembali webpages, images, videos, dan relatedSearches.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "relatedSearches" : {...},
    "videos" : {...},
    "rankingResponse" : {...}
}

Untuk membatasi jumlah jawaban yang dikembalikan Bing ke dua jawaban teratas (halaman web dan gambar), atur parameter kueri answerCount menjadi 2.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

Respon hanya mencakup webPages dan images.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "rankingResponse" : {...}
}

Jika Anda menambahkan parameter kueri responseFilter ke kueri sebelumnya dan mengaturnya ke halaman web dan berita, respons hanya berisi halaman web karena berita tidak diberi pangkat.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "rankingResponse" : {...}
}

Mempromosikan jawaban yang tidak diberi pangkat

Jika pangkat teratas menjawab bahwa Bing kembali untuk kueri adalah halaman web, gambar, video, dan relatedSearches, respons akan menyertakan jawaban tersebut. Jika Anda mengatur answerCount ke dua (2), Bing mengembalikan dua jawaban pangkat teratas: halaman web dan gambar. Jika Anda ingin Bing menyertakan gambar dan video dalam respons, tentukan parameter kueri promosikan dan atur ke gambar dan video.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&promote=images%2Cvideos&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

Berikut ini adalah respons terhadap permintaan di atas. Bing mengembalikan dua jawaban, halaman web, dan gambar teratas, dan mempromosikan video ke dalam jawabannya.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailiing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "videos" : {...},
    "rankingResponse" : {...}
}

Jika Anda mengatur promote ke berita, respons tidak menyertakan jawaban berita karena itu bukan jawaban pangkat yang hanya — dapat Anda promosikan jawaban berpangkat.

Jawaban yang ingin Anda promosikan tidak dihitung terhadap batas answerCount. Misalnya, jika jawaban pangkat adalah berita, gambar, dan video, dan Anda mengatur answerCount ke 1 dan promote ke berita, respons berisi berita dan gambar. Atau, jika jawaban pangkat adalah video, gambar, dan berita, respons berisi video dan berita.

Anda hanya dapat menggunakan promote jika Anda menentukan parameter kueri answerCount.