Filtrar as respostas que a resposta de pesquisa inclui

Artigo
07/08/2019

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Quando consulta a Web, o Bing devolve todos os conteúdos relevantes que encontra para a pesquisa. Por exemplo, se a consulta de pesquisa for "sailing+dinghies", a resposta poderá conter as seguintes respostas:

{
    "_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" : [...]
        }
    }
}

Parâmetros de consulta

Para filtrar as respostas devolvidas pelo Bing, utilize os parâmetros de consulta abaixo ao chamar a API.

ResponseFilter

Pode filtrar os tipos de respostas que o Bing inclui na resposta (por exemplo, imagens, vídeos e notícias) através do parâmetro de consulta responseFilter , que é uma lista delimitada por vírgulas de respostas. Será incluída uma resposta na resposta se o Bing encontrar conteúdo relevante para a mesma.

Para excluir respostas específicas da resposta, como imagens, prepare um - caráter para o tipo de resposta. Por exemplo:

&responseFilter=-images,-videos

O seguinte mostra como utilizar responseFilter para pedir imagens, vídeos e notícias de dinghies à vela. Quando codifica a cadeia de consulta, as vírgulas mudam para %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

Segue-se a resposta à consulta anterior. Como o Bing não encontrou resultados de vídeo e notícias relevantes, a resposta não os inclui.

{
    "_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"
                }
            }]
        }
    }
}

Embora o Bing não tenha devolvido resultados de vídeo e notícias na resposta anterior, não significa que o conteúdo de vídeo e notícias não exista. Significa simplesmente que a página não as incluiu. No entanto, se analisar mais resultados, é provável que as páginas subsequentes os incluam. Além disso, se chamar diretamente os pontos finais da API de Pesquisa de Vídeos e da API de Pesquisa de Notícias , é provável que a resposta contenha resultados.

Não é possível utilizar responseFilter para obter resultados de uma única API. Se quiser conteúdo de uma única API do Bing, chame essa API diretamente. Por exemplo, para receber apenas imagens, envie um pedido para o ponto https://api.cognitive.microsoft.com/bing/v7.0/images/search final da API de Pesquisa de Imagens ou para um dos outros pontos finais de Imagens . Chamar a API única é importante não só por motivos de desempenho, mas porque as APIs específicas do conteúdo oferecem resultados mais avançados. Por exemplo, pode utilizar filtros que não estão disponíveis para a API de Pesquisa na Web para filtrar os resultados.

Site

Para obter resultados de pesquisa de um domínio específico, inclua o site: parâmetro de consulta na cadeia de consulta.

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

Nota

Consoante a consulta, se utilizar o site: operador de consulta, existe a possibilidade de a resposta poder conter conteúdo para adultos, independentemente da definição safeSearch . Deve utilizar site: apenas se tiver conhecimento do conteúdo do site e se o seu cenário suportar a possibilidade de conteúdo para adultos.

Atualização

Para limitar os resultados da resposta Web a páginas Web detetadas pelo Bing durante um período específico, defina o parâmetro de consulta de atualização para um dos seguintes valores não sensíveis a maiúsculas e minúsculas:

Day — Devolver páginas Web que o Bing detetou nas últimas 24 horas
Week — Devolver páginas Web que o Bing detetou nos últimos 7 dias
Month — Devolver páginas Web detetadas nos últimos 30 dias

Também pode definir este parâmetro para um intervalo de datas personalizado no formulário , YYYY-MM-DD..YYYY-MM-DD.

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

Para limitar os resultados a uma única data, defina o parâmetro de atualização para uma data específica:

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

Os resultados podem incluir páginas Web que se inserem fora do período especificado se o número de páginas Web que o Bing corresponde aos critérios de filtro for menor do que o número de páginas Web que pediu (ou o número predefinido devolvido pelo Bing).

Limitar o número de respostas na resposta

O Bing pode devolver vários tipos de resposta na resposta JSON. Por exemplo, se consultar sailing+dinghies, o Bing poderá devolver webpages, images, videose relatedSearches.

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

Para limitar o número de respostas que o Bing devolve às duas principais respostas (páginas Web e imagens), defina o parâmetro de consulta answerCount como 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

A resposta inclui apenas webPages e images.

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

Se adicionar o responseFilter parâmetro de consulta à consulta anterior e o definir como páginas Web e notícias, a resposta contém apenas páginas Web porque as notícias não estão classificadas.

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

Promover respostas que não estão classificadas

Se as respostas mais bem classificadas que o Bing devolve para uma consulta forem páginas Web, imagens, vídeos e procuras relacionadas, a resposta incluirá essas respostas. Se definir answerCount para dois (2), o Bing devolve as duas principais respostas classificadas: páginas Web e imagens. Se quiser que o Bing inclua imagens e vídeos na resposta, especifique o parâmetro de promoção da consulta e defina-o como imagens e vídeos.

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

Segue-se a resposta ao pedido acima. O Bing devolve as duas principais respostas, páginas Web e imagens e promove vídeos para a resposta.

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

Se definir promote notícias, a resposta não inclui a resposta de notícias porque não é uma resposta classificada— só pode promover respostas classificadas.

As respostas que pretende promover não contam para o answerCount limite. Por exemplo, se as respostas classificadas forem notícias, imagens e vídeos e definir answerCount como 1 e promote para notícias, a resposta contém notícias e imagens. Ou, se as respostas classificadas forem vídeos, imagens e notícias, a resposta contém vídeos e notícias.

Só poderá utilizar promote se especificar o answerCount parâmetro de consulta.