Como criar uma página de pesquisa personalizada

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Para ativar a pesquisa do conteúdo disponível publicamente no seu portal, crie uma página de pesquisa dedicada. Basta incorporar um Mecanismo de pesquisa personalizado do Google (CSE, na sigla em inglês). Por exemplo, o portal mostrado na figura a seguir incorpora um CSE do Google que permite pesquisar o conteúdo indexado pelo Google.

Antes de incorporar um mecanismo de pesquisa personalizado do Google, observe o seguinte:

A pesquisa que usa um CSE do Google pode retornar apenas resultados para conteúdo disponível publicamente. Em outras palavras, um usuário do portal não precisa fazer login para visualizar o conteúdo.
No momento, não é possível desativar anúncios em resultados de pesquisa, a menos que você seja um site de organizações sem fins lucrativos aprovado.
O Google CSE não está incluído em uma licença da Apigee. Uma solução de pesquisa pronta para uso no portal integrado está sendo planejada para uma versão futura.
O Google Search Console (também não incluído em uma licença Apigee) é outra ferramenta que você pode usar para remover ou gerenciar a presença do seu portal no índice de pesquisa do Google.

Para criar uma página de pesquisa personalizada:

Publique o conteúdo do portal.
Crie um mecanismo de pesquisa personalizado do Google:
a. Navegue até a página de configuração da Pesquisa personalizada do Google.
b. Clique em Adicionar para criar um novo mecanismo de pesquisa personalizado.

c. Configure seu mecanismo de pesquisa personalizado e identifique o domínio do site do portal. Consulte Criar um mecanismo de pesquisa na ajuda da Pesquisa personalizada do Google.
d. Para acelerar a indexação do site, verifique e envie seu site usando o Google Search Console. Consulte Verificar seu site no Search Console na Ajuda da Pesquisa personalizada do Google.

Adicione o script personalizado a seguir ao seu portal. Consulte Como adicionar scripts personalizados.

Defina a variável cx como seu ID do mecanismo de pesquisa do Google e o valor path para o URL da página de pesquisa.

<script>
window.portal = {
 pageEventListeners: {
   onLoad: (path) => {
     // Update with your search page URL
     if (path === '/your-search-page-URL') {
       // Add your Google search engine ID
       var cx = 'your-search-engine-id';
       var gcse = document.createElement('script');
       gcse.type = 'text/javascript';
       gcse.async = true;
       gcse.src = 'https://cse.google.com/cse.js?cx=' + cx;
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(gcse, s);
       gcse.onload = function () {
         var search = document.createElement('gcse:search');
         // Note the element ID name
         var searchBox = document.getElementById('search-box');
         searchBox.appendChild(search);
       };
     }
   }
 }
};
</script>

Crie uma nova página de pesquisa no seu portal e personalize-a como quiser. Consulte Gerenciar páginas no portal.
Adicione o ID do elemento de pesquisa personalizada (search-box) definido no seu script personalizado no local onde você quer que a caixa de pesquisa do Google apareça. Exemplo:
```
<div id="search-box"></div>
```
Adicione a página de pesquisa à navegação do portal, conforme necessário. Consulte Configurar a navegação para mais informações.
Publique sua página de pesquisa e atualizações de navegação.