Provedores de pesquisa na Web do Windows Search

Pesquisa do Windows atualmente usa o aplicativo Microsoft Bing para retornar conteúdo da Web e resultados de pesquisa. Na Área Econômica Europeia (EEE), você pode instalar aplicativos que implementam um provedor de pesquisa na Web para retornar o conteúdo da Web e os resultados da pesquisa em Windows Pesquisa.

Os provedores de pesquisa se integram à experiência de pesquisa criando um pacote MSIX com um arquivo de manifesto de pacote que fornece as informações necessárias para o sistema operacional registrar o provedor de pesquisa. Após a instalação, o provedor de pesquisa é habilitado por padrão nas experiências de pesquisa Windows. No Windows Configurações, os usuários podem habilitar e desabilitar provedores de pesquisa instalados e gerenciar a ordem dos provedores nos resultados da pesquisa. Os usuários podem remover um provedor de pesquisa por meio da página Settings > Apps > Aplicativos Instalados em Configurações de Windows.

Para desenvolvimento e teste, quando o Modo de Desenvolvedor estiver habilitado e o aplicativo do provedor de busca tiver sido instalado manualmente no dispositivo, ele aparecerá na lista de provedores de busca disponíveis. Para obter mais informações, consulte Configurações para desenvolvedores.

Depois que o provedor de pesquisa é registrado com o sistema operacional, as consultas de usuário são passadas para o ponto de extremidade HTTP especificado pelo provedor no manifesto do pacote usando uma cadeia de caracteres de consulta padronizada. O endpoint retorna resultados sugeridos em um documento JSON. Com cada URL sugerido no documento de resposta, o provedor de pesquisa inclui a URL do endpoint de visualização, que retorna um documento HTML exibido no painel de visualização na interface de resultados de pesquisa.

Este artigo fornece diretrizes para a criação de um pacote de aplicativos do provedor de pesquisa e detalhes dos protocolos para implementação de endpoints HTTP do provedor de pesquisa.

Criar um pacote de app para extensibilidade de pesquisa

Os provedores de pesquisa se registram no sistema operacional por meio de um pacote MSIX que contém informações necessárias sobre o provedor, como o nome do provedor de pesquisa e os pontos de extremidade HTTP para sugestões e visualizações.

Extensão de aplicativo do provedor de pesquisa

O arquivo de manifesto do pacote de aplicativos dá suporte a várias extensões e recursos diferentes para aplicativos Windows. O formato do manifesto do pacote do aplicativo é definido por um conjunto de esquemas documentados na Referência de esquemas de manifesto do pacote. Os provedores de pesquisa declaram suas informações de registro no uap3:AppExtension. O atributo Name da extensão deve ser definido como "com.microsoft.windows.websearchprovider".

Os provedores de pesquisa devem incluir uap3:Properties como o filho de uap3:AppExtension. O esquema de manifesto do pacote não impõe a estrutura do elemento uap3:Properties, exceto pelo requisito de ser XML bem formado. O restante desta seção descreve o formato XML que o sistema operacional espera para registrar com êxito um provedor de pesquisa.

<uap3:Extension Category="windows.appExtension">
  <uap3:AppExtension Name="com.microsoft.windows.websearchprovider" DisplayName="SearchExampleApp" Id="ContosoSearchApp" PublicFolder="Public">
    <uap3:Properties>
    <!-- Search provider registration content goes here -->
    </uap3:Properties>
  </uap3:AppExtension>
</uap3:Extension>

Hierarquia de elementos

uap3:Propriedades

  Endpoint

  Protocolo

Ponto final

O endereço HTTPS para o qual o sistema operacional enviará solicitações de consulta de pesquisa.

Protocolo

O esquema de protocolo que será usado ao iniciar os resultados da pesquisa na Web fornecidos. Se o protocolo especificado não for registrado por um aplicativo no sistema operacional, o navegador padrão será iniciado para obter os resultados da pesquisa. Para obter mais informações sobre como registrar esquemas de protocolo, consulte uap:Protocol.

Arquivo manifesto de pacote de exemplo

O seguinte é um exemplo de appmanifest.xml arquivo de manifesto de pacote para registrar um provedor de Pesquisa do Windows.

<!-- appxmanifest.xml -->

  <uap3:Extension Category="windows.appExtension">
	  <uap3:AppExtension Name="com.microsoft.windows.websearchprovider" DisplayName="CustomSearch" Id="CustomSearchApp" PublicFolder="Public">
		  <uap3:Properties>
			  <Endpoint>https://customsearchendpoint</Endpoint>
			  <Protocol>customsearch</Protocol>
		  </uap3:Properties>
	  </uap3:AppExtension>
  </uap3:Extension>
  <uap:Extension Category="windows.protocol">
	  <uap:Protocol Name="customsearch"/>
  </uap:Extension>

Implementar um endpoint de sugestão do provedor do Windows Search

Os provedores de pesquisa devem expor e registrar um ponto de extremidade HTTPS que é chamado pelo SO quando um usuário digita na caixa de pesquisa do Windows. Esse ponto de extremidade deve retornar uma cadeia de caracteres formatada em JSON que contém as sugestões de pesquisa para a consulta de usuário fornecida. O conteúdo deve ser entregue via HTTPS. A integração de pesquisa não dá suporte ao conteúdo entregue por HTTP.

Formato de solicitação HTTPS de sugestão

A solicitação HTTPS para o endpoint de sugestão usa o seguinte formato.

https://contoso.com?setlang=en-US&cc=US&qry=

Os parâmetros de consulta passados para o endpoint de sugestão são os seguintes.

Sugestão de cabeçalhos de resposta HTTPS

O provedor de pesquisa deve incluir os cabeçalhos a seguir na resposta do ponto de extremidade HTTPS de sugestão.

• Access-Control-Allow-Origin: https://www.bing.com
• Access-Control-Allow-Credentials: verdadeiro
• Access-Control-Allow-Methods: GET
• Tipo de conteúdo: application/json; charset=utf-8
• Comprimento do conteúdo: [Deve ser o comprimento exato da resposta]

Formato JSON de resposta à sugestão

O ponto de extremidade HTTPS do provedor de pesquisa para sugestões deve retornar um documento JSON com o seguinte formato. Os nomes de chave devem corresponder exatamente ao formato.

{"Suggestions": 
   [{"Attributes": 
     {"url":"https://www.contoso.com/search?q=projection+matrix","query":"projection matrix","previewPaneUrl":"http://www.contoso.com/preview"} ,"Text":"projection matrix"}, 
    {"Attributes": 
     {"url":"https://www.contoso.com/search?q=rotation+matrix","query":"rotation matrix","previewPaneUrl":"http://www.contoso.com/preview"} ,"Text":"rotation matrix"}
    ] 
} 

Implementar um endpoint de visualização do provedor do Windows Search

Os provedores de pesquisa retornam a URL de um endpoint HTTPS que oferece uma pré-visualização HTML da página associada a cada sugestão nos resultados de busca. A resposta do ponto de extremidade de visualização deve fornecer o código HTML de uma página funcional.

Visualizar formato de solicitação HTTPS

A solicitação HTTPS para o endereço de pré-visualização usa o seguinte formato.

https://contoso.com?Darkschemeovr=1

Os parâmetros de consulta passados para o endpoint de sugestão são os seguintes.

Visualizar cabeçalhos de resposta HTTPS

• Access-Control-Allow-Origin: https://www.bing.com
• Access-Control-Allow-Credentials: verdadeiro
• Access-Control-Allow-Methods: GET
• Tipo de Conteúdo: texto/html; charset=utf-8
• Tamanho do Conteúdo: [Deve ser o tamanho exato da pré-visualização HTML]

Solicitação OPTIONS e CORS (Compartilhamento de Recursos entre Origens)

O cliente de pesquisa de Windows envia uma solicitação HTTP OPTIONS (pré-vôo CORS) antes de cada solicitação GET. Os provedores de pesquisa devem dar suporte ao método de solicitação OPTIONS e responder com HTTP 200 OK.

Artigos relacionados