Se usó la API de Cloud Translation para traducir esta página.

Contexto: Cómo definir un Motor de Búsqueda Programable

En esta página, se describe cómo definir las especificaciones de tu motor de búsqueda mediante un archivo de contexto.

Descripción general
Elementos de CustomSearchEngine

Descripción general

Un archivo de contexto describe la estructura de tu motor de búsqueda y define su comportamiento. La mejor manera de comenzar a aprender sobre los archivos de contexto es viendo un ejemplo simple. A medida que aumentes tu confianza, es posible que desees comenzar a experimentar con diversos elementos y atributos. Puedes usar los parámetros de configuración en el panel de control y, luego, ver la versión XML generada que se descargó desde la página Descripción general.

El siguiente código describe un motor de búsqueda sobre el cambio climático. Ten en cuenta que este motor de búsqueda tiene habilitada la búsqueda con imágenes.

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

Elementos de CustomSearchEngine

Un archivo de contexto básico incluye los siguientes elementos principales y secundarios.

Elemento	Obligatorio	Descripción
`CustomSearchEngine`	Obligatorio	Incluye toda la información sobre el motor de búsqueda. Tiene los siguientes atributos: `keywords` Especifica una lista (hasta 100 caracteres) de palabras clave separadas por espacios asociadas al motor de búsqueda. Si no se especifica, el Motor de Búsqueda Programable usará un valor vacío. `language` Especifica uno de los idiomas compatibles que se mostrarán en la interfaz de usuario. Si especificas un idioma, se mejorarán los resultados en ese idioma, pero no se filtrarán los resultados en otros idiomas. Si no se especifica, el Motor de Búsqueda Programable usará `en` (inglés). Si el valor es nulo, Motor de Búsqueda Programable usará el idioma de la configuración regional de tu usuario. `autocompletions` Indica si el Motor de Búsqueda Programable debe generar opciones de autocompletado GLOSARIO para tu motor de búsqueda. Los valores permitidos son `true` o `false`. Si es `true`, ten en cuenta que la generación de autocompletados puede tardar varias horas. Después de establecer este valor, debes modificar el código de tu cuadro de búsqueda para solicitar el autocompletado. Puedes obtener el código actualizado en la pestaña Obtener código en el Panel de control. Solo los motores de búsqueda que buscan sitios incluidos (una colección predeterminada de sitios web) pueden tener consultas autocompletadas.
`Title`	Obligatorio	El nombre de tu motor de búsqueda. Aparece en la página principal del Motor de Búsqueda Programable y en las páginas de resultados.
`Description`	Obligatorio	Es el texto descriptivo que aparece en la página de resumen de tu motor de búsqueda.
`Context`	Obligatorio	Contiene información sobre las etiquetas. Incluye los elementos secundarios `BackgroundLabels` y `Facet`.
`BackgroundLabels`	Opcional	Contenedor de etiquetas que se usan para promocionar, incluir o excluir sitios y páginas. Incluye uno o más elementos secundarios `Label`.
`Label`	Opcional	Etiqueta que se usa para promocionar sitios o determinar su inclusión o exclusión. Tiene los siguientes atributos: `name` El nombre de la etiqueta. `mode` `FILTER` (promociona o muestra exclusivamente los sitios preferidos) o `ELIMINATE` (excluye el sitio). Puedes personalizar estas etiquetas como desees.
`LookAndFeel`	Obligatorio	Controla el aspecto de tu motor de búsqueda. Tiene varios atributos y elementos secundarios que se describen en detalle en la página Diseño.
`ImageSearchSettings`	Opcional	Especifica si la búsqueda con imágenes está habilitada. Tiene los siguientes atributos: `enable` Especifica si la búsqueda con imágenes está habilitada para este motor de búsqueda. Los valores permitidos son `true` o `false`.