Contexte: Définir un moteur de recherche programmable

Cette page explique comment définir les spécifications de votre moteur de recherche à l'aide d'un fichier de contexte.

  1. Présentation
  2. Éléments CustomSearchEngine

Présentation

Le fichier de contexte décrit la structure de votre moteur de recherche et définit son comportement. Le meilleur moyen de vous familiariser avec les fichiers de contexte est de consulter un exemple simple. À mesure que vous gagnez en confiance, vous pouvez commencer à tester différents éléments et attributs. Vous pouvez jouer avec les paramètres du panneau de configuration, puis visualiser la version XML générée téléchargée depuis la page Vue d'ensemble.

Le code suivant décrit un moteur de recherche sur le changement climatique. Notez que la recherche d'images est activée sur ce moteur de recherche.

<CustomSearchEngine keywords="climate &quot;global warming&quot; &quot;greenhouse gases&quot;"
                    language="en">
  <Title>RealClimate</Title>
  <Description>Science behind global warming and climate change.</Description>
  <Context>
    <BackgroundLabels>
      <Label name="_include_" mode="FILTER"/>
      <Label name="_exclude_" mode="ELIMINATE"/>
    </BackgroundLabels>
  </Context>
  <LookAndFeel/>
  <ImageSearchSettings enable="true"/>
</CustomSearchEngine>

Éléments CustomSearchEngine

Un fichier de contexte de base comprend les principaux éléments suivants et les éléments enfants.

Élément Obligatoire Description
CustomSearchEngine Obligatoire Contient toutes les informations sur le moteur de recherche. Possède les attributs suivants :
  • keywords : spécifie une liste (100 caractères maximum) de mots clés séparés par des espaces associés au moteur de recherche. Si aucune valeur n'est spécifiée, Programmable Search Engine utilisera une valeur vide.
  • language : spécifie l'une des langues acceptées à afficher dans l'interface utilisateur. Si vous indiquez une langue, les résultats dans cette langue seront améliorés, mais pas les résultats dans les autres langues ne seront pas filtrés. Si ce champ n'est pas spécifié, Programmable Search Engine utilisera en (anglais). Si la valeur est "null", Programmable Search Engine utilisera la langue des paramètres régionaux de l'utilisateur.
  • autocompletions : indique si Programmable Search Engine doit générer des termes de saisie semi-automatique GLOSSAIRE pour votre moteur de recherche. Les valeurs autorisées sont true ou false. Si la valeur est true, notez que la génération de la saisie semi-automatique peut prendre plusieurs heures. Après avoir défini cette valeur, vous devez modifier le code de votre champ de recherche pour demander la saisie semi-automatique. Vous pouvez obtenir le code mis à jour dans l'onglet Obtenir le code du panneau de configuration. Seuls les moteurs de recherche qui effectuent des recherches incluent des sites (ensemble prédéterminé de sites Web) peuvent proposer des requêtes avec saisie semi-automatique.
Title Obligatoire Nom de votre moteur de recherche. Il apparaît sur la page d'accueil de Programmable Search Engine et sur les pages de résultats.
Description Obligatoire Texte descriptif qui s'affiche sur la page de présentation de votre moteur de recherche.
Context Obligatoire Contient des informations sur les étiquettes. Inclut les éléments enfants BackgroundLabels et Facet.
BackgroundLabels Facultatif Conteneur des libellés utilisés pour promouvoir, inclure ou exclure des sites et des pages. Inclut un ou plusieurs éléments Label enfants.
Label Facultatif Libellé utilisé pour promouvoir des sites ou déterminer l'inclusion ou l'exclusion de sites. Possède les attributs suivants :
  • name : nom du libellé.
  • mode. FILTER (fait la promotion ou affiche exclusivement les sites préférés) ou ELIMINATE (exclut le site). Vous pouvez personnaliser ces libellés comme vous le souhaitez.
LookAndFeel Obligatoire Permet de contrôler l'apparence de votre moteur de recherche. Elle comporte plusieurs attributs et éléments enfants décrits en détail sur la page Apparence.

ImageSearchSettings Facultatif

Indique si la recherche dans des images est activée. Possède les attributs suivants:

  • enable. Indique si la recherche dans des images est activée pour ce moteur de recherche. Les valeurs autorisées sont true ou false.