Cette page a été traduite par l'API Cloud Translation.

Configurer l'interface utilisateur

Cette page du tutoriel Google Cloud Search explique comment configurer une application de recherche personnalisée à l'aide du widget Recherche intégrable. Pour commencer ce guide depuis le début, reportez-vous au tutoriel de mise en route de Cloud Search.

Installer des dépendances

Si le connecteur n'a pas fini d'indexer le dépôt, ouvrez une nouvelle interface système et poursuivez la procédure dans celle-ci.
À partir de la ligne de commande, remplacez le répertoire par cloud-search-samples/end-to-end/search-interface.
Pour télécharger les dépendances requises pour exécuter le serveur Web, exécutez la commande suivante:

npm install

Créer les identifiants de l'application de recherche

Le connecteur requiert les identifiants du compte de service pour appeler les API Cloud Search. Pour créer les identifiants:

Revenez à la console Google Cloud.
Dans le volet de navigation de gauche, cliquez sur Identifiants.
Dans la liste déroulante Créer des identifiants, sélectionnez ID client OAuth. La page "Créer un ID client OAuth" s'affiche.
(Facultatif) Si vous n'avez pas encore configuré l'écran d'autorisation, cliquez sur CONFIGURER L'ÉCRAN D'AUTORISATION. L'écran d'autorisation OAuth s'affiche.
1. Cliquez sur Interne, puis sur CRÉER. Un autre écran "Consentement OAuth" s'affiche.
2. Renseignez les champs obligatoires. Pour en savoir plus, consultez la section sur le consentement de l'utilisateur dans la section Configurer OAuth 2.0.
Cliquez sur la liste déroulante Type d'application et sélectionnez Application Web.
Dans le champ Nom, saisissez "tutoriel".
Dans le champ Origines JavaScript autorisées, cliquez sur AJOUTER UN URI. Un champ "URI" vide s'affiche.
Dans le champ URI, saisissez http://localhost:8080.
Cliquez sur CRÉER. L'écran "Client OAuth créé" s'affiche.
Notez l'ID client. Cette valeur permet d'identifier l'application lors de la demande d'autorisation de l'utilisateur avec OAuth2. Le secret client n'est pas nécessaire pour cette implémentation.
Cliquez sur OK.

Créer l'application de recherche

La prochaine étape consiste à créer une application de recherche dans la console d'administration. L'application de recherche est une représentation virtuelle de l'interface de recherche et de sa configuration par défaut.

Revenez à la console d'administration Google.
Cliquez sur l'icône Applications. La page "Administration des applications" s'affiche.
Cliquez sur Google Workspace. La page "Apps Google Workspace administration" (Administration des applications Google Workspace) s'affiche.
Faites défiler la page et cliquez sur Cloud Search. La page "Paramètres de Google Workspace" s'affiche.
Cliquez sur Applications de recherche. La page "Search Appplications" (Recherche d'applications) s'affiche.
Cliquez sur le signe + jaune. La boîte de dialogue "Créer une application de recherche" s'affiche.
Dans le champ Nom à afficher, saisissez "tutoriel".
Cliquez sur CRÉER.
Cliquez sur l'icône en forme de crayon à côté de l'application de recherche que vous venez de créer ("Modifier l'application de recherche"). La page "Détails de la recherche d'applications" s'affiche.
Notez l'ID de l'application.
À droite de Sources de données, cliquez sur l'icône en forme de crayon.
À côté de "tutoriel", cliquez sur le bouton Activer. Ce bouton active la source de données du tutoriel pour l'application de recherche nouvellement créée.
À droite de la source de données "Tutoriel", cliquez sur Options d'affichage.
Vérifiez tous les aspects.
Cliquez sur ENREGISTRER.
Cliquez sur OK.

Configurer l'application Web

Après avoir créé les identifiants et l'application de recherche, mettez à jour la configuration de l'application pour inclure ces valeurs comme suit:

À partir de la ligne de commande, remplacez le répertoire par "cloud-search-samples/end-to-end/search-interface/public".
Ouvrez le fichier app.js dans un éditeur de texte.
Recherchez la variable searchConfig en haut du fichier.
Remplacez [client-id] par l'ID client OAuth créé précédemment.
Remplacez [application-id] par l'ID de l'application de recherche indiqué dans la section précédente.
Enregistrez le fichier.

Exécuter l'application

Démarrez l'application en exécutant la commande suivante:

npm run start

Interroger l'index

Pour interroger l'index à l'aide du widget Recherche:

Ouvrez votre navigateur et accédez à http://localhost:8080.
Cliquez sur Se connecter pour autoriser l'application à interroger Cloud Search à votre place.
Dans le champ de recherche, saisissez une requête, telle que le mot "test", puis appuyez sur Entrée. Les résultats de la requête doivent apparaître sur la page, ainsi que les attributs et les commandes de pagination permettant de naviguer dans les résultats.

Comprendre le code

Les sections restantes examinent la création de l'interface utilisateur.

Charger le widget

Le widget et les bibliothèques associées sont chargés en deux phases. La première consiste à charger le script d'amorce:

index.html

Afficher sur GitHub

<script src="https://apis.google.com/js/api.js?mods=enable_cloud_search_widget&onload=onLoad" async defer></script>

La seconde consiste à appeler le rappel onLoad quand le script est prêt. Sont ensuite chargés le client API Google, Google Sign-in et les bibliothèques de widgets Cloud Search.

app.js

Afficher sur GitHub

/**
 * Load the cloud search widget & auth libraries. Runs after
 * the initial gapi bootstrap library is ready.
 */
function onLoad() {
  gapi.load('client:auth2:cloudsearch-widget', initializeApp)
}

Le reste de l'initialisation de l'application est géré par initializeApp une fois que toutes les bibliothèques nécessaires ont été chargées.

Gérer l'autorisation

Les utilisateurs doivent autoriser l'application à effectuer des requêtes en leur nom. Le widget peut directement demander cette autorisation à l'utilisateur, mais vous pouvez améliorer l'expérience utilisateur en la gérant vous-même.

L'application propose deux affichages différents de l'interface de recherche en fonction de l'état de connexion de l'utilisateur.

index.html

Afficher sur GitHub

<div class="content">
  <div id="app" hidden>
    <div id="header">
      <button id="sign-out">Sign-out</button>
    </div>
    <!-- Markup for widget...-->
  </div>
  <div id="welcome" hidden>
    <h1>Cloud Search Tutorial</h1>
    <p>Sign in with your Google account to search.</p>
    <button id="sign-in">Sign-in</button>
  </div>
</div>

L'affichage approprié est activé et les gestionnaires des événements de connexion et déconnexion sont configurés pendant l'initialisation:

app.js

Afficher sur GitHub

/**
 * Initialize the app after loading the Google API client &
 * Cloud Search widget.
 */
async function initializeApp() {
  await gapi.auth2.init({
      'clientId': searchConfig.clientId,
      'scope': 'https://www.googleapis.com/auth/cloud_search.query'
  });

  let auth = gapi.auth2.getAuthInstance();

  // Watch for sign in status changes to update the UI appropriately
  let onSignInChanged = (isSignedIn) => {
    document.getElementById("app").hidden = !isSignedIn;
    document.getElementById("welcome").hidden = isSignedIn;
    if (resultsContainer) {
      resultsContainer.clear();
    }
  }
  auth.isSignedIn.listen(onSignInChanged);
  onSignInChanged(auth.isSignedIn.get()); // Trigger with current status

  // Connect sign-in/sign-out buttons
  document.getElementById("sign-in").onclick = (e) =>  auth.signIn();
  document.getElementById("sign-out").onclick = (e) => auth.signOut();

  // ...

}

Créer l'interface de recherche

Le widget Recherche nécessite une petite quantité de balisage HTML pour la saisie de la recherche et la présentation des résultats de recherche:

index.html

Afficher sur GitHub

<div id="search_bar">
  <div>
    <div id="suggestions_anchor">
      <input type="text" id="search_input" placeholder="Search for...">
    </div>
  </div>
</div>
<div id="facet_results" ></div>
<div id="search_results" ></div>

Le widget est initialisé et lié aux éléments d'entrée et de conteneur lors de l'initialisation:

app.js

Afficher sur GitHub

gapi.config.update('cloudsearch.config/apiVersion', 'v1');
resultsContainer = new gapi.cloudsearch.widget.resultscontainer.Builder()
  .setSearchApplicationId(searchConfig.searchAppId)
  .setSearchResultsContainerElement(document.getElementById('search_results'))
  .setFacetResultsContainerElement(document.getElementById('facet_results'))
  .build();

const searchBox = new gapi.cloudsearch.widget.searchbox.Builder()
  .setSearchApplicationId(searchConfig.searchAppId)
  .setInput(document.getElementById('search_input'))
  .setAnchor(document.getElementById('suggestions_anchor'))
  .setResultsContainer(resultsContainer)
  .build();

Félicitations, vous avez terminé le tutoriel. Continuez pour obtenir des instructions de nettoyage.

Précédent Suivant