Criar uma página de pesquisa personalizada

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Para ativar a pesquisa do conteúdo disponível publicamente no seu portal, pode criar uma página de pesquisa dedicada onde incorpora um Motor de pesquisa personalizado (EPC) Google.

Antes de incorporar um motor de pesquisa personalizado Google, tenha em atenção o seguinte:

• A pesquisa através de um MEC do Google só pode devolver resultados de conteúdo disponível publicamente. Por outras palavras, um utilizador do portal não pode ter de iniciar sessão no portal para ver o conteúdo.
• Neste momento, não pode desativar os anúncios nos resultados da pesquisa, a menos que seja um site sem fins lucrativos aprovado.
• O MEC do Google não está incluído numa licença do Apigee. (Está planeada uma solução de pesquisa pronta a usar no portal integrado para um lançamento futuro.)
• A Google Search Console (também não incluída numa licença do Apigee) é outra ferramenta que pode usar para remover ou gerir a presença do seu portal no índice de pesquisa do Google.

Para criar uma página de pesquisa personalizada:

1. Publique o conteúdo do portal.

2. Crie um motor de pesquisa personalizado do Google:

   1. Navegue para a página de configuração da Pesquisa personalizada do Google.
   2. Clique em Adicionar para criar um novo Motor de Pesquisa Programável.
   3. Configure o seu motor de pesquisa personalizado e identifique o domínio do site do portal. Consulte o artigo Crie um motor de pesquisa na Ajuda da Pesquisa Personalizada do Google. A configuração de pesquisa personalizada devolve algo semelhante ao seguinte:

      <script async src="https://cse.google.com/cse.js?cx=e13bcb52d46f04dfd"></script>
      <div class="gcse-search"></div>

      Onde cx=e13bcb52d46f04dfd é o ID do motor de pesquisa Google.
   Sugestão: pode acelerar a indexação do site validando e enviando o seu site através da Google Search Console. Consulte o artigo Valide o seu site na Search Console na Ajuda da Google Search Console.

3. Adicione o seguinte script personalizado ao seu portal. Consulte o artigo Adicionar scripts personalizados.

   Defina a variável cx para o ID do seu motor de pesquisa Google, por exemplo, e13bcb52d46f04dfd, e o valor path para o URL da sua página de pesquisa, por exemplo, /search.

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

4. Crie uma nova página de pesquisa no seu portal e personalize-a conforme descrito no artigo Faça a gestão das páginas no seu portal.

5. Adicione o ID do elemento de pesquisa personalizada (search-box) definido no seu script personalizado na localização onde quer que a caixa de pesquisa do Google seja apresentada. Por exemplo <div id="search-box"></div>

6. Adicione a página de pesquisa à navegação do portal, conforme descrito em Configurar navegação.

7. Publique as atualizações da página de pesquisa e de navegação.

O Google demora algum tempo a indexar o seu site, pelo que pode não ver os resultados da pesquisa imediatamente. (A indexação completa pode demorar alguns dias a um mês.) Pode querer atrasar a publicação da página de pesquisa até ter testado a pesquisa do site do portal (ao longo do tempo) e estar satisfeito com os resultados devolvidos.