Créer une page de recherche personnalisée

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Pour activer la recherche de contenu accessible au public sur votre portail, vous pouvez créer une page de recherche dédiée sur laquelle vous intégrez un Moteur de recherche personnalisé Google (MRP). Par exemple, le portail affiché dans la figure suivante intègre un moteur de recherche personnalisé Google permettant d'effectuer des recherches parmi le contenu indexé par Google.

Avant d'intégrer un moteur de recherche personnalisé Google, notez les points suivants :

Une recherche effectuée à l'aide d'un MRP Google ne peut renvoyer que les résultats correspondant au contenu accessible au public. En d'autres termes, un utilisateur du portail n'a pas besoin de se connecter au portail pour afficher ce contenu.
À l'heure actuelle, vous ne pouvez pas désactiver les annonces dans les résultats de recherche si vous n'êtes pas un site à but non lucratif approuvé.
Le MRP Google n'est pas inclus dans une licence Apigee. (Une solution de recherche prête à l'emploi pour le portail intégré est prévue pour une version ultérieure.)
La console Google Search Console (qui n'est pas incluse dans une licence Apigee) est un autre outil que vous pouvez utiliser pour supprimer ou gérer la présence de votre portail dans l'index de recherche de Google.

Pour créer une page de recherche personnalisée, procédez comme suit :

Publiez le contenu de votre portail.
Créez un moteur de recherche personnalisé Google :
a. Accédez à la page de configuration de la recherche personnalisée Google.
b. Cliquez sur Add (Ajouter) pour créer un moteur de recherche personnalisé.

c. Configurez votre moteur de recherche personnalisé et identifiez le domaine du site du portail. Consultez la page Créer un moteur de recherche dans l'aide dédiée à la Recherche personnalisée Google.
d. Accélérez l'indexation du site en le validant et en le publiant à l'aide de Google Search Console. Consultez la page Valider votre site dans Search Console dans l'aide dédiée à la recherche personnalisée Google.

Ajoutez le script personnalisé suivant à votre portail. Consultez la page Ajouter des scripts personnalisés.

Définissez la variable cx sur l'ID de votre moteur de recherche Google et la valeur path sur l'URL de votre page de recherche.

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

Créez une page de recherche sur votre portail et personnalisez-la comme vous le souhaitez. Consultez la page Gérer les pages de votre portail.
Ajoutez l'ID de l'élément de recherche personnalisé (search-box) défini dans votre script personnalisé à l'emplacement où vous souhaitez voir apparaître le champ de recherche Google. Exemple :
```
<div id="search-box"></div>
```
Ajoutez la page de recherche aux liens de navigation de votre portail, si nécessaire. Pour en savoir plus, consultez la page Configurer la navigation.
Publiez votre page de recherche et les mises à jour des liens de navigation.