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

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.

Présentation
Éléments CustomSearchEngine

Présentation

Un fichier de contexte décrit la structure de votre moteur de recherche et définit son comportement. Le meilleur moyen de se familiariser avec les fichiers de contexte est de consulter un exemple simple. Lorsque vous gagnerez en confiance, vous voudrez peut-être commencer à expérimenter divers éléments et attributs. Vous pouvez tester les paramètres du panneau de configuration, puis afficher la version XML générée téléchargée depuis la page Présentation.

Le code suivant décrit un moteur de recherche dédié au changement climatique. Notez que la recherche d'images est activée pour 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 éléments principaux et enfants suivants.

Élément	Valeur	Description
`CustomSearchEngine`	Obligatoire	Contient toutes les informations sur le moteur de recherche. Comporte les attributs suivants: <ph type="x-smartling-placeholder"> </ph> `keywords` Spécifie une liste de mots clés (100 caractères maximum) associés au moteur de recherche, séparés par un espace. Si aucune valeur n'est spécifiée, Programmable Search Engine utilise une valeur vide. `language` Spécifie l'une des langues disponibles à afficher dans l'interface utilisateur. Si vous indiquez une langue, les résultats dans cette langue seront améliorés, mais ceux dans les autres langues ne seront pas filtrés. Si aucune valeur n'est spécifiée, Programmable Search Engine utilise `en` (anglais). Si la valeur est nulle, Programmable Search Engine utilise 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 des termes de 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 sur des sites inclus (ensemble prédéterminé de sites Web) peuvent proposer des requêtes de saisie semi-automatique.
`Title`	Obligatoire	Nom de votre moteur de recherche. Il s'affiche 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 du moteur de recherche.
`Context`	Obligatoire	Contient des informations sur les étiquettes. Inclut les éléments enfants `BackgroundLabels` et `Facet`.
`BackgroundLabels`	Facultatif	Conteneur pour les 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. Comporte les attributs suivants: <ph type="x-smartling-placeholder"> </ph> `name` Nom du libellé. `mode` `FILTER` (fait la promotion ou présente exclusivement des sites préférés) ou `ELIMINATE` (exclut un 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 Éléments graphiques.
`ImageSearchSettings`	Facultatif	Indique si la recherche dans des images est activée. Comporte 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`.