En esta página, se hace referencia a la versión XML de la API de Custom Search JSON, que está disponible solo para los clientes de Google Site Search.
- Descripción general
- Formato de solicitud del Motor de Búsqueda Programable
- Resultados XML
Descripción general
El servicio de Google WebSearch permite a los clientes de Google Site Search mostrar resultados de la Búsqueda de Google en sus propios sitios web. El servicio WebSearch usa un protocolo simple basado en HTTP para entregar los resultados de la búsqueda. Los administradores de búsqueda tienen control total sobre la forma en que solicitan resultados de la búsqueda y cómo los presentan al usuario final. En este documento, se describen los detalles técnicos de la solicitud de la Búsqueda de Google y los formatos de resultados.
Para recuperar resultados de Google WebSearch, tu aplicación envía a Google una solicitud HTTP simple. Luego, Google mostrará los resultados de la búsqueda en formato XML. Los resultados con formato XML te permiten personalizar la forma en que se muestran los resultados de la búsqueda.
Formato de solicitud de WebSearch
- Descripción general de la solicitud
- Términos de búsqueda
- Parámetros de la solicitud
- Ejemplos de consultas de WebSearch
- Definiciones de los parámetros de búsqueda de WebSearch
- Consultas de imágenes de ejemplo
- Definiciones de los parámetros de búsqueda de imágenes
- Búsqueda avanzada
- Parámetros de búsqueda avanzada
- Términos de búsqueda especiales
- Límites de solicitud
Descripción general de la solicitud
La solicitud de búsqueda de Google es un comando HTTP GET
estándar. Incluye una colección de parámetros relevantes para tus consultas. Estos parámetros se incluyen en la URL de la solicitud como pares nombre=valor separados por caracteres de unión (&). Los parámetros incluyen datos como la búsqueda y un ID de motor único (cx
) que identifica el motor que realiza la solicitud HTTP. El servicio WebSearch o Image Search muestra resultados XML en respuesta a tus solicitudes HTTP.
Términos de búsqueda
La mayoría de las solicitudes de búsqueda incluyen uno o más términos de búsqueda. Un término de consulta aparece como el valor de un parámetro en la solicitud de búsqueda.
Los términos de búsqueda pueden especificar varios tipos de información para filtrar y organizar los resultados de la búsqueda que muestra Google. Las consultas pueden especificar lo siguiente:
- Palabras o frases para incluir o
excluir
- Todas las palabras de una búsqueda (predeterminado)
- Una frase exacta en la búsqueda
- Cualquier palabra o frase en una búsqueda
- En qué parte del documento se deben buscar los
términos de búsqueda.
- En cualquier parte del documento (predeterminado)
- Solo en el cuerpo del documento
- Solo en el título del documento
- Solo en la URL del documento
- Solo en los vínculos del documento
- Restricciones en los documentos en sí
- Incluir o excluir documentos de tipos de archivo específicos (como archivos PDF o documentos de Word)
- Consultas de URL especiales que muestran información sobre una URL determinada, en lugar de realizar una búsqueda
- Consultas que muestran información general sobre una URL, como su categoría, fragmento o lenguaje de Open Directory
- Consultas que muestran el conjunto de páginas web que vinculan a una URL
- Consultas que muestran un conjunto de páginas web similares a una URL determinada
Búsqueda predeterminada
Los valores de los parámetros de búsqueda deben tener escape de URL. Ten en cuenta que debes sustituir el signo más (“+”) por cualquier secuencia de espacios en blanco en la búsqueda. Esto se analiza más a fondo en la sección Escapado de URL de este documento.
El término de búsqueda se envía al servicio WebSearch mediante el parámetro q. Un término de búsqueda de muestra es el siguiente:
q=horses+cows+pigs
De forma predeterminada, el servicio Google WebSearch solo muestra documentos que incluyan todos los términos en la búsqueda.
Parámetros de la solicitud
En esta sección, se enumeran los parámetros que puedes usar cuando realizas una solicitud de búsqueda. Los parámetros se dividen en dos listas. La primera lista contiene parámetros que son relevantes para todas las solicitudes de búsqueda. La segunda lista contiene parámetros que solo son relevantes para las solicitudes de búsqueda avanzada.
Se requieren tres parámetros de solicitud:
- El parámetro client se debe establecer en
google-csbe
- El parámetro output especifica el formato de los resultados en formato XML que se muestran. Los resultados se pueden mostrar con (xml) o sin (
xml_no_dtd
) una referencia al DTD de Google. Te recomendamos establecer este valor enxml_no_dtd
. Nota: Si no especificas este parámetro, los resultados se mostrarán en HTML en lugar de XML.
- El parámetro cx que representa el ID único del motor
Los parámetros de solicitud más usados, distintos de los mencionados anteriormente, son los siguientes:
- num: La cantidad solicitada de resultados de la búsqueda
- q: Los términos de búsqueda
- start: el índice de inicio para los resultados
Ejemplos de consultas de WebSearch
En los siguientes ejemplos, se muestran un par de solicitudes HTTP de WebSearch para ilustrar cómo se usan los diferentes parámetros de consulta. Las definiciones de los diferentes parámetros de búsqueda se proporcionan en las secciones Definiciones de parámetros de consulta de WebSearch y Parámetros de búsqueda de búsqueda avanzada de este documento.
En esta solicitud, se solicitan los primeros 10 resultados (start=0&num=10
) para el término de consulta "red sox" (q=red+sox
). La consulta también especifica que los resultados deben provenir de sitios web canadienses (cr=countryCA
) y deben escribirse en francés (lr=lang_fr
). Por último, la consulta especifica valores para los parámetros client, output y cx, los tres son obligatorios.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
En este ejemplo, se usan algunos de los parámetros de búsqueda avanzada para personalizar aún más la búsqueda. Esta solicitud usa el parámetro as_q (as_q=red+sox
) en lugar del parámetro q. También usa el parámetro as_eq para excluir cualquier documento que contenga la palabra "Yankees" de los resultados de la búsqueda (as_eq=yankees
).
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Definiciones de los parámetros de consulta de WebSearch
c2coff | |||||||
---|---|---|---|---|---|---|---|
Descripción | Opcional: El parámetro c2coff habilita o inhabilita la función de búsqueda en chino simplificado y tradicional. El valor predeterminado para este parámetro es
|
||||||
Ejemplos | q=google&c2coff=1 |
client | |
---|---|
Descripción | Obligatorio: El parámetro |
Ejemplos | q=google&client=google-csbe |
cr | |
---|---|
Descripción | Opcional: El parámetro Para determinar el país de un documento, Google WebSearch analiza lo siguiente:
Consulta la sección Valores del parámetro de país (cr) para obtener una lista de los valores válidos para este parámetro. |
Ejemplos | q=Frodo&cr=countryNZ |
cx | |
---|---|
Descripción | Obligatorio: El parámetro |
Ejemplos | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
filter | |||||||
---|---|---|---|---|---|---|---|
Descripción | Opcional: El parámetro filter activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta la sección Filtrado automático de este documento para obtener más información acerca de los filtros de resultados de la Búsqueda de Google. El valor predeterminado del parámetro
Nota: De forma predeterminada, Google aplica el filtrado en todos los resultados de la búsqueda para mejorar su calidad. |
||||||
Ejemplos | q=google&filter=0 |
gl | |
---|---|
Descripción | Opcional: El valor del parámetro Especificar un valor del parámetro |
Ejemplos | Esta solicitud mejora los documentos escritos en el Reino Unido en
los resultados de WebSearch: |
hl | |
---|---|
Descripción | Opcional: El parámetro Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información y, también, Idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles. |
Ejemplos | Esta solicitud se orienta a los anuncios de vino en francés. (Vin es el término francés para el vino). q=vin&ip=10.10.10.10&ad=w5&hl=fr |
hq | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos | Esta solicitud busca "pizza" Y "queso". La expresión es la misma que
|
ie | |
---|---|
Descripción | Opcional: El parámetro Consulta la sección Codificación de caracteres para saber cuándo deberías usar este parámetro. Consulta la sección Esquemas de codificación de caracteres para obtener una lista de valores |
Ejemplos | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Descripción | Opcional: El parámetro Para determinar el idioma de un documento, Google WebSearch analiza lo siguiente:
Consulta la sección Valores de la colección de idioma ( |
Ejemplos | q=Frodo&lr=lang_en |
num | |
---|---|
Descripción | Opcional: El parámetro El valor predeterminado de Nota: Si la cantidad total de resultados de la búsqueda es menor que la cantidad solicitada, se mostrarán todos los resultados de la búsqueda disponibles. |
Ejemplos | q=google&num=10 |
oe | |
---|---|
Descripción | Opcional: El parámetro Consulta la sección Codificación de caracteres para saber cuándo deberías usar este parámetro. Consulta la sección Esquemas de codificación de caracteres para obtener una lista de valores |
Ejemplos | q=google&ie=utf8&oe=utf8 |
salida | |||||||
---|---|---|---|---|---|---|---|
Descripción | Obligatorio: El parámetro
|
||||||
Ejemplos | output=xml_no_dtd |
q | |
---|---|
Descripción | Opcional: El parámetro También hay una serie de términos de búsqueda especiales que se pueden usar como parte del valor del parámetro En el panel de control de la Búsqueda de Google, se incluye un informe de las principales búsquedas que se enviaron con el parámetro Nota: El valor especificado para el parámetro q debe tener escape de URL. |
Ejemplos | q=vacation&as_oq=london+paris |
seguro | |||||||||
---|---|---|---|---|---|---|---|---|---|
Descripción | Opcional: El parámetro
Consulta la sección Cómo filtrar contenido para adultos con SafeSearch para obtener más información acerca de esta función. |
||||||||
Ejemplos | q=adult&safe=high |
start | |
---|---|
Descripción | Opcional: El parámetro El parámetro |
Ejemplos | start=10 |
sort | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos |
|
UD | |
---|---|
Descripción | Opcional: El parámetro http://www.花井鮨.com Los valores válidos para este parámetro son Si el parámetro http://www.xn--elq438j.com. Nota: Esta es una función beta. |
Ejemplos | q=google&ud=1 |
Búsqueda avanzada
Los parámetros adicionales que se enumeran debajo de la imagen son relevantes para las consultas de búsqueda avanzada. Cuando envías una búsqueda avanzada, los valores de varios parámetros (p.ej., as_eq, as_epq, as_oq, etc.) se incluyen en los términos de consulta para esa búsqueda. En la imagen, se muestra la página de Búsqueda avanzada de Google. En la imagen, el nombre de cada parámetro de búsqueda avanzada se escribe en texto red dentro del campo en la página al que corresponde ese parámetro o junto a él.
![](https://services.google.com/images/as_examples/advanced_search.jpg?authuser=6&hl=es)
Parámetros de búsqueda avanzada
as_dt | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos | as_dt=i,as_dt=e |
as_epq | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos | as_epq=abraham+lincoln |
as_eq | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos |
|
as_lq | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos |
|
as_nlo | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos | El siguiente comando establece un rango de búsqueda de 5 a 10, inclusive:
|
as_nhi | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos | El siguiente comando establece un rango de búsqueda de 5 a 10, inclusive:
|
as_oq | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos |
|
as_q | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos |
|
as_qdr | |
---|---|
Descripción | Opcional: El parámetro
|
Ejemplos |
En este ejemplo, se solicitan resultados del año pasado:
En este ejemplo, se solicitan resultados de los últimos 10 días:
|
as_sitesearch | |
---|---|
Descripción | Opcional: El parámetro |
Ejemplos |
|
Términos de búsqueda especiales
Google WebSearch permite el uso de varios términos de búsqueda especiales que acceden a funciones adicionales del motor de búsqueda de Google. Estos términos de búsqueda especiales deben incluirse en el valor del parámetro de solicitud q. Al igual que otros términos de búsqueda, los términos de búsqueda especiales deben tener con escape de URL. Un número de los términos de búsqueda especiales contiene dos puntos (:). Este carácter también debe tener escape de URL; su valor de URL de escape es %3A
.
Vínculos de retroceso [link:] | |
---|---|
Descripción | El término de consulta La versión de También puedes usar el parámetro de solicitud as_lq para enviar una solicitud Nota: No puedes especificar otros términos de consulta cuando usas |
Ejemplos |
|
Booleano O Búsqueda [ O ] | |
---|---|
Descripción | El término de consulta También puedes usar el parámetro de solicitud as_oq para enviar una búsqueda de cualquier término en un conjunto de términos. Nota: Si una solicitud de búsqueda especifica la consulta "Londres + O+París", los resultados de la búsqueda incluirán documentos que contengan al menos una de esas dos palabras. En algunos casos, los documentos de los resultados de la búsqueda pueden contener ambas palabras. |
Ejemplos | Busca Londres o París: Entrada del usuario:
london OR
paris Término de búsqueda:q=london+OR+paris Busca vacaciones y Londres o París: Término de búsqueda:
q=vacation+london+OR+paris Busca vacaciones y uno de Londres, París o chocolates: Término de búsqueda:
q=vacation+london+OR+paris+OR+chocolates Busca vacaciones y chocolates, además de Londres o París, y el peso menor es el de los chocolates: Término de búsqueda:
q=vacation+london+OR+paris+chocolates Busca vacaciones, chocolates y flores en documentos que también contengan Londres o París: Término de búsqueda:
q=vacation+london+OR+paris+chocolates+flowers Busca vacaciones y uno de Londres o París, y busca uno de chocolates o flores: Término de búsqueda: q=vacation+london+OR+paris+chocolates+OR+flowers |
Excluir término de consulta [-] | |
---|---|
Descripción | El término de consulta de exclusión ( La versión de El término de consulta de exclusión es útil cuando un término de búsqueda tiene más de un significado. Por ejemplo, la palabra "bajo" podría mostrar resultados sobre peces o música. Si buscaras documentos sobre los peces, podrías excluir documentos sobre música de los resultados de la búsqueda mediante el uso del término de consulta de exclusión. También puedes usar el parámetro de solicitud as_eq para excluir de los resultados de la búsqueda los documentos que coincidan con una palabra o frase en particular. |
Ejemplos | Entrada del usuario: bass -music Término de búsqueda: q=bass+%2Dmusic |
Exclusión de tipo de archivo [ -filetype: ] | |
---|---|
Descripción | El término de consulta La versión de Nota: Puedes excluir varios tipos de archivos de los resultados de la búsqueda si agregas más términos Entre los tipos de archivo que admite Google, se incluyen los siguientes:
Es posible que se agreguen otros tipos de archivo en el futuro. Puedes encontrar una lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google. |
Ejemplos | En este ejemplo, se muestran documentos que mencionan “Google”, pero que
no son documentos PDF: En este ejemplo, se muestran documentos que mencionan “Google”, pero
se excluyen los documentos PDF y de Word: |
Filtrado del tipo de archivo [ filetype: ] | |
---|---|
Descripción | El término de consulta La versión de Puedes restringir los resultados de la búsqueda a los documentos que coincidan con una de varias extensiones de archivo agregando más términos de búsqueda de De forma predeterminada, los resultados de la búsqueda incluyen documentos con cualquier extensión de archivo. Entre los tipos de archivo que admite Google, se incluyen los siguientes:
Es posible que se agreguen otros tipos de archivo en el futuro. Puedes encontrar una lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google. |
Ejemplos | En este ejemplo, se muestran documentos PDF que mencionan “Google”: En este ejemplo, se muestran documentos PDF y de Word que mencionan
“Google”: |
Incluir término de consulta [+] | |
---|---|
Descripción | El término de búsqueda de inclusión (+) especifica que una palabra o frase debe aparecer en todos los documentos incluidos en los resultados de la búsqueda. Si quieres usar el término de búsqueda "include", debes anteponer la palabra o frase que se debe incluir en todos los resultados de la búsqueda con "+" (un signo más). La versión de Antes de identificar los resultados de la búsqueda, debes usar |
Ejemplos | Entrada del usuario: Star Wars Episode +I Término de búsqueda: q=Star+Wars+Episode+%2BI |
Búsqueda de solo vínculos, todos los términos [ allinlinks: ] | |
---|---|
Descripción | El término de búsqueda Si tu búsqueda incluye el término La versión de |
Ejemplos | Entrada del usuario:allinlinks: Google search Término de búsqueda: q=allinlinks%3A+Google+search |
Búsqueda de frases | |
---|---|
Descripción | El término de consulta de búsqueda de frase (") te permite buscar frases completas encerrando las frases entre comillas o conectándolas con guiones. La versión de Las búsquedas de frases son particularmente útiles si buscas citas famosas o nombres propios. También puedes usar el parámetro de solicitud as_epq para enviar una búsqueda de frase. |
Ejemplos | Entrada del usuario:"Abraham Lincoln" Término de búsqueda: q=%22Abraham+Lincoln%22 |
Búsqueda de solo texto, todos los términos [allintext:] | |
---|---|
Descripción | El término de consulta Si la búsqueda incluye el término La versión de |
Ejemplos | En este ejemplo, se especifica que las palabras “Google” y “búsqueda” deben aparecer en el cuerpo de todos los documentos incluidos en los resultados de la búsqueda: Entrada del usuario: allintext:Google search Término de búsqueda: q=allintext%3AGoogle+search |
Búsqueda por título, un solo término [intitle:] | |
---|---|
Descripción | El término de consulta Nota: Puedes especificar más de una palabra que se debe incluir en el título del documento. Para ello, coloca el término de consulta La versión de |
Ejemplos | En este ejemplo, se especifica que la palabra "Google" debe aparecer en los títulos de cualquier documento en los resultados de la búsqueda, y la palabra "search" debe aparecer en cualquier lugar de los títulos, las URLs, los vínculos o el texto del cuerpo de esos documentos: |
Búsqueda de títulos, todos los términos [allintitle:] | |
---|---|
Descripción | El término de consulta Nota: Escribir La versión de |
Ejemplos | En este ejemplo, se especifica que las palabras “Google” y “búsqueda”
deben aparecer en los títulos de cualquier documento en los resultados de la búsqueda: |
Búsqueda de URL, término único [inurl:] | |
---|---|
Descripción | El término de búsqueda El término de consulta La versión de |
Ejemplos | En este ejemplo, se especifica que la palabra "Google" debe aparecer en las URLs de cualquier documento de los resultados de la búsqueda, y la palabra "search" debe aparecer en cualquier lugar de los títulos, las URLs, los vínculos o el texto del cuerpo de esos documentos: |
Búsqueda de URL, todos los términos [allinurl:] | |
---|---|
Descripción | El término de consulta El término de consulta La versión de |
Ejemplos | En este ejemplo, se especifica que las palabras “Google” y “búsqueda”
deben aparecer en las URLs de cualquier documento de los resultados de la búsqueda: |
Información del documento web [info:] | |
---|---|
Descripción | El término de consulta La versión de Nota: No puedes especificar otros términos de consulta cuando usas |
Ejemplos | Entrada del usuario: info:www.google.com Término de búsqueda: q=info%3Awww.google.com |
Consultas de imágenes de ejemplo
En los siguientes ejemplos, se muestran un par de solicitudes HTTP de imagen para ilustrar cómo se usan los diferentes parámetros de consulta. Las definiciones de los diferentes parámetros de consulta se proporcionan en las secciones Definiciones de parámetros de consulta de imágenes de este documento.
Esta solicitud solicita los primeros 5 resultados (start=0&num=5
) para el término de búsqueda "monkey" (q=monkey
), del tipo de archivo .png. Por último, la consulta especifica valores para los parámetros client
, output
y cx
, los tres son obligatorios.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Parámetros de búsqueda de imágenes
as_filetype | |
---|---|
Descripción | Opcional: Muestra imágenes de un tipo especificado. Los valores permitidos son |
Ejemplos | q=google&as_filetype=png |
imgsz | |
---|---|
Descripción | Opcional: Muestra imágenes de un tamaño especificado, en el que el tamaño puede ser uno de los siguientes:
|
Ejemplos | q=google&as_filetype=png&imgsz=icon |
imgtype. | |
---|---|
Descripción | Opcional: Muestra imágenes de un tipo, que puede ser una de las siguientes opciones:
|
Ejemplos | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
Descripción | Opcional: Muestra imágenes en blanco y negro, en escala de grises o en color:
|
Ejemplos | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
Descripción | Opcional: Muestra imágenes de un color dominante específico:
|
Ejemplos | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Descripción | Opcional: Filtros basados en licencias. Entre los valores admitidos, se incluyen los siguientes:
|
Ejemplos | q=cats&as_filetype=png&as_rights=cc_attribute |
Límites de solicitudes
En el siguiente gráfico, se enumeran las limitaciones para las solicitudes de búsqueda que envías a Google:
Componente | Límite | Explicación |
---|---|---|
Longitud de la solicitud de búsqueda | 2,048 bytes | |
Cantidad de términos de búsqueda | 10 | Incluye términos en los siguientes parámetros: q, as_epq, as_eq, as_lq, as_oq, as_q. |
Cantidad de resultados | 20 | Si estableces el parámetro num en un número superior a 20, solo se mostrarán 20 resultados. Para obtener más resultados, tendrías que enviar varias solicitudes y aumentar el valor del parámetro start con cada solicitud. |
Internacionalización de consultas y presentación de resultados
El servicio Google WebSearch te permite buscar documentos en varios idiomas. Puedes especificar la codificación de caracteres que se debe utilizar para interpretar tu solicitud HTTP y codificar tu respuesta XML (mediante los parámetros de búsqueda ie y oe). También puedes filtrar los resultados para incluir solo los documentos escritos en ciertos idiomas.
En las siguientes secciones, se analizan problemas relacionados con la búsqueda en varios idiomas:
Codificación de caracteres
Los servidores envían datos, como páginas web, a usuarios-agentes, como navegadores, como una secuencia de bytes codificados. Luego, el usuario-agente decodifica los bytes en una secuencia de caracteres. Cuando envías solicitudes al servicio WebSearch, puedes especificar los esquemas de codificación para la búsqueda y la respuesta XML que recibes.
Puedes usar el parámetro de solicitud ie para especificar el mecanismo de codificación de los caracteres en tu solicitud HTTP. También puedes usar el parámetro oe a fin de especificar el esquema de codificación que Google debe usar para codificar tu respuesta XML. Si utilizas un esquema de codificación distinto de ISO-8859-1
(o latin1
), asegúrate de especificar los valores correctos para los parámetros ie y oe.
Nota: Si proporcionas la funcionalidad de búsqueda para varios idiomas, te recomendamos que uses el valor de codificación utf8
(UTF-8) para los parámetros ie y oe.
Consulta el apéndice de Esquemas de codificación de caracteres para obtener una lista completa de los valores que puedes utilizar para los parámetros ie y oe.
Para obtener más información general sobre la codificación de caracteres, consulta http://www.w3.org/TR/REC-html40/charset.html.
Idiomas de la interfaz
Puedes usar el parámetro de solicitud hl para identificar el idioma de tu interfaz gráfica. El valor del parámetro hl puede afectar los resultados de la búsqueda con XML, especialmente en las consultas internacionales cuando no se especifica de manera explícita la restricción de idioma (usando el parámetro lr). En esos casos, el parámetro hl puede promover resultados de la búsqueda en el mismo idioma que el idioma de entrada del usuario.
Te sugerimos que configures el parámetro hl de forma explícita en los resultados de la búsqueda para asegurarte de que Google seleccione los resultados de mayor calidad para cada consulta.
Consulta la sección Idiomas de interfaz compatibles a fin de obtener una lista completa de los valores válidos para el parámetro hl.
Búsqueda de documentos escritos en idiomas específicos
Puedes usar el parámetro de solicitud lr para restringir los resultados de la búsqueda a los documentos escritos en un idioma o un conjunto de idiomas en particular.
El parámetro lr admite operadores booleanos para que puedas especificar varios idiomas que se deben incluir (o excluir) de los resultados de la búsqueda.
En los siguientes ejemplos, se muestra cómo puedes usar los operadores booleanos para solicitar documentos en diferentes lenguajes.
Para los documentos escritos en japonés:
lr=lang_jp
Para documentos escritos en italiano o alemán:
lr=lang_it|lang_de
Para los documentos que no están escritos en húngaro ni checo:
lr=(-lang_hu).(-lang_cs)
Consulta la sección Valores de colección de lenguajes para obtener una lista completa de los valores posibles para el parámetro lr y la sección Operadores booleanos para obtener un análisis detallado del uso de estos operadores.
Búsqueda en chino simplificado y tradicional
El chino simplificado y el chino tradicional son dos variantes de escritura del idioma chino. El mismo concepto puede escribirse de manera diferente en cada variante. Dada una búsqueda en una de las variantes, el servicio de Google WebSearch puede mostrar resultados que incluyan páginas en ambas variantes.
Para usar esta función, sigue estos pasos:
- Establece el parámetro de solicitud c2coff en 0
y - Realiza una de las siguientes acciones:
En el siguiente ejemplo, se muestran los parámetros de consulta que incluirías en una solicitud de resultados en chino simplificado y tradicional. (Ten en cuenta que la información adicional requerida, como el cliente, no se incluye en el ejemplo).
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Filtra los resultados
Google WebSearch ofrece varias formas de filtrar los resultados de la búsqueda:
- Filtrado automático de los resultados de la búsqueda
- Filtros por idioma y país
- Cómo filtrar contenido para adultos con SafeSearch
Filtrado automático de los resultados de la búsqueda
En un esfuerzo por proporcionar los mejores resultados de la búsqueda posible, Google usa dos técnicas para filtrar automáticamente los resultados que, por lo general, se consideran no deseados:
-
Contenido duplicado: Si varios documentos contienen la misma información, solo el documento más relevante de ese conjunto se incluye en los resultados de la búsqueda.
-
Acumulación de hosts: Si hay muchos resultados de la búsqueda del mismo sitio, es posible que Google no muestre todos los resultados de ese sitio o que los muestre en una posición inferior
en la clasificación que de otra manera.
Te recomendamos que dejes estos filtros activados para las solicitudes de búsqueda típicas, ya que estos mejoran significativamente la calidad de la mayoría de los resultados de la búsqueda. Sin embargo, puedes omitir estos filtros automáticos si configuras el parámetro de consulta filter en 0 en tu solicitud de búsqueda.
Filtros por idioma y país
El servicio Google WebSearch muestra los resultados de un índice principal de todos los documentos web. El índice principal contiene subcolecciones de documentos que se agrupan por atributos específicos, como el idioma y el país de origen.
Puedes usar los parámetros de solicitud lr y cr para restringir los resultados de la búsqueda a subcolecciones de documentos escritos en idiomas específicos o que se originen en países determinados, respectivamente.
Para determinar el idioma de un documento, Google WebSearch analiza lo siguiente:
- El dominio de nivel superior (TLD) de la URL del documento
- metaetiquetas de idioma del documento
- idioma principal utilizado en el cuerpo del texto del documento
Consulta también la definición del parámetro lr, la sección sobre Cómo buscar documentos escritos en idiomas específicos y los Valores de la colección de idiomas que se pueden usar como valores para el parámetro lr a fin de obtener más información sobre cómo restringir los resultados según el idioma.
Para determinar el país de un documento, Google WebSearch analiza lo siguiente:
- El dominio de nivel superior (TLD) de la URL del documento
- la ubicación geográfica de la dirección IP del servidor web
Consulta también la definición del parámetro cr y los valores de la colección por país que se pueden usar como valores para el parámetro cr a fin de obtener más información sobre cómo restringir los resultados por país de origen.
Nota: Puedes combinar valores de idioma y valores de país para personalizar tus resultados de la búsqueda. Por ejemplo, puedes solicitar documentos redactados en francés y que provengan de Francia o Canadá, o bien documentos que provengan de Holanda y no estén escritos en inglés. Los parámetros lr y cr admiten operadores booleanos.
Cómo filtrar contenido para adultos con SafeSearch
Muchos clientes de Google no desean mostrar resultados de la búsqueda de sitios con contenido para adultos. Con el filtro SafeSearch, puedes filtrar los resultados de la búsqueda que incluyan contenido para adultos y eliminarlos. Los filtros de Google usan tecnología propia para verificar palabras clave, frases y URL. Si bien ningún filtro es 100 por ciento preciso, SafeSearch quitará la mayor parte del contenido para adultos de los resultados de la búsqueda.
Google se esfuerza por mantener SafeSearch lo más actualizado y completo posible rastreando continuamente la Web e incorporando actualizaciones de las sugerencias de los usuarios.
SafeSearch está disponible en los siguientes idiomas:
Neerlandés Inglés Francés Alemán |
Italiano Portugués (Brasil) Español Chino tradicional |
Puedes ajustar el grado en el que Google filtra los resultados por el contenido para adultos mediante el parámetro de búsqueda safe. En la siguiente tabla, se explica la configuración de SafeSearch de Google y la manera en la que afectará los resultados de la búsqueda:
Nivel de SafeSearch | Descripción |
---|---|
high | Habilita una versión más estricta de búsqueda segura. |
medium | Bloquea las páginas web que contengan pornografía y otro contenido sexual explícito. |
desactivado | No filtra el contenido para adultos de los resultados de la búsqueda. |
* La configuración predeterminada de SafeSearch está desactivada.
Si SafeSearch está activado y encuentras sitios que incluyen contenido ofensivo en los resultados, envía un correo electrónico con la URL del sitio a safesearch@google.com para que lo investiguemos.
Resultados XML
- Google XML Results DTD
- Información acerca de la respuesta XML
- Resultados XML para búsquedas regulares y avanzadas
- Búsqueda regular y avanzada: consulta de muestra y resultado XML
- Búsqueda estándar/avanzada: etiquetas XML
DTD de resultados XML de Google
Google usa el mismo DTD para describir el formato XML para todos los tipos de resultados de la búsqueda. Muchos de los atributos y las etiquetas se aplican a todos los tipos de búsqueda. Sin embargo, algunas etiquetas solo se aplican a determinados tipos de búsqueda. Por lo tanto, las definiciones en la DTD pueden ser menos restrictivas que las que se proporcionan en este documento.
En este documento, se describen los aspectos de la DTD que son relevantes para WebSearch. Cuando observas la DTD, si trabajas en WebSearch, puedes ignorar de forma segura las etiquetas y los atributos que no están documentados aquí. Si la definición difiere entre la DTD y la documentación, se indica ese hecho en este documento.
Google puede mostrar los resultados en formato XML con o sin una referencia al DTD más reciente. La DTD es una guía para ayudar a los administradores de búsqueda y los analizadores de XML a comprender los resultados de XML de Google. Dado que la gramática XML de Google puede cambiar de vez en cuando, no debes configurar el analizador para que use el DTD a fin de validar cada resultado XML.
Además, no debes configurar el analizador de XML para recuperar el DTD cada vez que envíes una solicitud de búsqueda. Google actualiza el DTD con poca frecuencia, y estas solicitudes crean requisitos de retraso y ancho de banda innecesarios.
Google recomienda que uses el formato de salida xml_no_dtd para obtener resultados XML. Si especificas el formato de salida xml en tu solicitud de búsqueda, la única diferencia es la inclusión de la siguiente línea en los resultados XML:
<!DOCTYPE GSP SYSTEM "google.dtd">
Puedes acceder a la versión más reciente de DTD en http://www.google.com/google.dtd.
Ten en cuenta que es posible que no todas las funciones de DTD estén disponibles o sean compatibles en este momento.
Información acerca de la respuesta XML
- Todos los valores de elementos son HTML válido adecuado para la visualización, a menos que se indique lo contrario en las definiciones de la etiqueta XML.
- Algunos valores de elementos son URLs que deben estar codificadas en HTML antes de mostrarse.
- El analizador XML debe ignorar los atributos y las etiquetas no documentados. Esto permite que tu aplicación continúe funcionando sin modificaciones si Google agrega más funciones al resultado XML.
- Algunos caracteres deben tener escape cuando se incluyen como valores en las etiquetas XML. Tu procesador XML debe volver a convertir estas entidades en los caracteres correspondientes. Si no conviertes entidades correctamente, es posible que el navegador muestre el carácter & como "&", por ejemplo.
El XML estándar documenta estos caracteres y se reproducen en la tabla que aparece a continuación:
“Basado Formas con escape Entidad Código de carácter Et y & & Comillas simples ' ' ' Comillas dobles " " " Mayor que > > > Menor que < < <
Resultados XML para búsquedas regulares y avanzadas
Búsqueda regular o avanzada: consulta de muestra y resultado XML
En esta solicitud de WebSearch de ejemplo, se solicitan 10 resultados (num=10
) sobre el término de búsqueda "socer" (q=socer
), que es la palabra "fútbol" que se escribió mal en este ejemplo).
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
Esta solicitud muestra el siguiente resultado XML. Ten en cuenta que hay varios comentarios en el resultado XML para indicar dónde aparecerían ciertas etiquetas no incluidas en el resultado.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Búsqueda estándar/avanzada: etiquetas XML
Tanto las respuestas XML para las solicitudes de búsqueda normales como las de búsqueda avanzada usan el mismo conjunto de etiquetas XML. Estas etiquetas XML se muestran en el ejemplo de XML anterior y se explican en las tablas que aparecen a continuación.
Las etiquetas XML que aparecen a continuación se enumeran alfabéticamente por nombre de etiqueta, y cada definición contiene una descripción de la etiqueta, un ejemplo que muestra cómo aparecería en un resultado XML y el formato de su contenido. Si la etiqueta es una subetiqueta de otra etiqueta XML, o si tiene subetiquetas o atributos propios, esa información también se proporciona en la tabla de definición de la etiqueta.
Es posible que se muestren símbolos al lado de algunas subetiquetas en las definiciones que aparecen a continuación. Estos son los símbolos y sus respectivos significados:
* = cero o más instancias de la subetiqueta
+ = una o más instancias de la subetiqueta
A | B | C | D | V | G | C | I | I | L | N | P | R | S | T | U | X |
anchor_text | |
---|---|
Definición | La etiqueta <anchor_text> especifica el texto que debes mostrar a los usuarios para identificar una etiqueta de perfeccionamiento asociada con un conjunto de resultados de la búsqueda. Debido a que las etiquetas de perfeccionamiento reemplazan los caracteres no alfanuméricos con guiones bajos, no debes mostrar el valor de la etiqueta <label> en la interfaz de usuario. En su lugar, debes mostrar el valor de la etiqueta <anchor_text>. |
Ejemplo | <anchor_text>campos de golf</anchor_text> |
Subetiqueta de | FacetItem |
Formato del Contenido | Texto |
BLOQUEAR | |
---|---|
Definición | Esta etiqueta encapsula el contenido de un bloque en la línea de cuerpo de un resultado de promoción. Cada bloque tiene las subetiquetas T, U y L. Una etiqueta T no vacía indica que el bloque contiene texto; las etiquetas U y L no vacías indican que el bloque contiene un vínculo (con la URL proporcionada en la subetiqueta U y el texto de anclaje en la subetiqueta L). |
Subetiquetas | T, U y L |
Subetiqueta de | BODY_LINE |
Formato del Contenido | Vacía |
BODY_LINE | |
---|---|
Definición | Esta etiqueta encapsula el contenido de una línea en el cuerpo del resultado promocionado. Cada línea de cuerpo consta de varias etiquetas BLOQUEAR, que contienen texto o un vínculo con una URL y texto de hipervínculo. |
Subetiquetas | BLOQUEAR* |
Subetiqueta de | SL_MAIN |
Formato del Contenido | Vacía |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definición | La etiqueta <C> indica que el servicio WebSearch puede recuperar una versión almacenada en caché de esta URL de resultados de la búsqueda. No puedes recuperar páginas almacenadas en caché a través de la API de XML, pero puedes redireccionar a los usuarios a www.google.com para este contenido. |
|||||||||
Attributes |
|
|||||||||
Ejemplo | <C SZ="6,000" CID="kvOXK_cYSSgJ" /> | |||||||||
Subetiqueta de | HAS | |||||||||
Formato del Contenido | Vacía |
C2C | |
---|---|
Definición | La etiqueta <C2C> indica que el resultado hace referencia a una página en chino tradicional. Esta etiqueta solo aparece cuando la búsqueda en chino simplificado y tradicional está habilitada. Consulta la definición del parámetro de consulta c2coff para obtener más información sobre cómo habilitar o inhabilitar esta función. |
Formato del Contenido | Texto |
Contexto | |
---|---|
Definición | La etiqueta <Context> encapsula una lista de etiquetas de perfeccionamiento asociadas con un conjunto de resultados de la búsqueda. |
Ejemplo | <Context> |
Subetiquetas | title, Facet+ |
Formato del Contenido | Contenedor |
FECHA DE CRAWL | |
---|---|
Definición | La etiqueta <CRAWLDATE> identifica la fecha en la que se rastreó por última vez la página. No se muestra |
Ejemplo | <CRAWLDATE>21 de mayo de 2005</CRAWLDATE> |
Subetiqueta de | R |
Formato del Contenido | Texto |
DI | |
---|---|
Definición | La etiqueta <DI> encapsula la información de categoría del Proyecto de directorio abierto (ODP) para un solo resultado de la búsqueda. |
Ejemplo | <DI> |
Subetiquetas | ¿DT?, ¿DS? |
Subetiqueta de | HAS |
Formato del Contenido | Vacía |
DS | |
---|---|
Definición | La etiqueta <DS> proporciona el resumen correspondiente a una sola categoría en el directorio de ODP. |
Ejemplo | <DS>Publica tu currículo de <b>fútbol</b> directamente en Internet.</DS> |
Subetiqueta de | DI |
Formato del Contenido | Texto (puede contener HTML) |
DT | |
---|---|
Definición | La etiqueta <DT> proporciona el título de una sola categoría que aparece en el directorio de ODP. |
Ejemplo | <DT>SoccerConnection.net</DT> |
Subetiqueta de | DI |
Formato del Contenido | Texto (puede contener HTML) |
Faceta | |
---|---|
Definición | La etiqueta <Facet> contiene una agrupación lógica de etiquetas <FacetItem>. Puedes crear estas agrupaciones con el formato de especificación XML de Motor de Búsqueda Programable. Si no creas estas agrupaciones, la etiqueta results_xml_tag_Context><Context> contendrá hasta cuatro etiquetas <Facet>. Los elementos dentro de cada etiqueta <Facet> se agruparán con fines de visualización, pero es posible que no tengan una relación lógica. |
Ejemplo | <Facet> |
Subetiquetas | FacetItem+, título+ |
Subetiqueta de | Contexto |
Formato del Contenido | Contenedor |
FacetItem | |
---|---|
Definición | La etiqueta <FacetItem> contiene información sobre una etiqueta de perfeccionamiento asociada con un conjunto de resultados de la búsqueda. |
Ejemplo | <FacetItem> |
Subetiquetas | etiqueta, anchor_text+ |
Subetiqueta de | Faceta |
Formato del Contenido | FacetItem |
FI | |
---|---|
Definición | La etiqueta <FI> sirve como una marca que indica si se aplicó el filtrado de documentos para la búsqueda. Consulta la sección Filtrado automático de este documento para obtener más información acerca de los filtros de los resultados de la Búsqueda de Google. |
Ejemplo | <FI /> |
Subetiqueta de | RES |
Formato del Contenido | Vacía |
PPG | |||||||
---|---|---|---|---|---|---|---|
Definición | La etiqueta <GSP> encapsula todos los datos que se muestran en los resultados de la búsqueda XML de Google. "GSP" es una abreviatura de "Protocolo de Búsqueda de Google". |
||||||
Attributes |
|
||||||
Ejemplo | <GSP VER="3.2"> | ||||||
Subetiquetas | PARAM+, Q, RES?, TM | ||||||
Formato del Contenido | Vacía |
HAS | |
---|---|
Definición | La etiqueta <HAS> contiene información sobre cualquier parámetro de solicitud de búsqueda especial admitido para una URL en particular.
Nota: La definición de <HAS> para WebSearch es más restrictiva que en la DTD. |
Subetiquetas | DI?, L?, C?, RT? |
Subetiqueta de | R |
ISURL | |
---|---|
Definición | Google muestra la etiqueta <ISURL> si la búsqueda asociada es una URL. |
Subetiqueta de | GSP |
Formato del Contenido | Vacía |
L | |
---|---|
Definición | La presencia de la etiqueta <L> indica que el servicio WebSearch puede encontrar otros sitios vinculados a esta URL de resultados de la búsqueda. Para encontrar ese tipo de sitios, utiliza el término de búsqueda especial link:. |
Subetiqueta de | HAS |
Formato del Contenido | Vacía |
etiqueta | |
---|---|
Definición | La etiqueta <label> especifica una etiqueta de perfeccionamiento que puedes usar para filtrar los resultados de la búsqueda que recibes. Para usar una etiqueta de perfeccionamiento, agrega la string more:[[label tag value]] al valor del parámetro q en tu solicitud HTTP a Google, como se muestra en el siguiente ejemplo. Ten en cuenta que este valor debe tener escape de URL antes de enviar la consulta a Google. This example uses the refinement label golf_courses to Nota: La etiqueta <label> no es lo mismo que la etiqueta <Label>, la cual identifica una etiqueta de perfeccionamiento asociada con una URL específica en los resultados de la búsqueda. |
Ejemplo | <label>campos_golf</label> |
Subetiqueta de | FacetItem |
Formato del Contenido | Texto |
LANG | |
---|---|
Definición | La etiqueta <LANG> contiene el criterio más preciso de Google del idioma del resultado de la búsqueda. |
Ejemplo | <LANG>en</LANG> |
Subetiqueta de | R |
Formato del Contenido | Texto |
M | |
---|---|
Definición | La etiqueta <M> identifica la cantidad total estimada de resultados para la búsqueda. Nota: Es posible que esta estimación no sea precisa. |
Ejemplo | <M>16200000</M> |
Subetiqueta de | RES |
Formato del Contenido | Texto |
Recién nacido | |
---|---|
Definición | La etiqueta <NB> contiene información de navegación (vínculos a la página siguiente de los resultados de la búsqueda o a la página anterior de los resultados de la búsqueda) para el conjunto de resultados. Nota: Esta etiqueta solo está presente si hay más resultados disponibles. |
Ejemplo | <NB> |
Subetiquetas | NU?, PU? |
Subetiqueta de | RES |
Formato del Contenido | Vacía |
NU | |
---|---|
Definición | La etiqueta <NU> contiene un vínculo relativo a la siguiente página de resultados de la búsqueda. |
Ejemplo | <NU>/search?q=flowers&num=10&hl=es-419&ie=UTF-8 &output=xml&client=test&start=10</NU> |
Subetiqueta de | Nota: |
Formato del Contenido | Texto (URL relativa) |
PARÁMETRO | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Definición | La etiqueta <PARAM> identifica un parámetro de entrada enviado en la solicitud HTTP asociada con el resultado en formato XML. La información sobre el parámetro está incluida en los atributos de la etiqueta (name, value, original_value) y habrá una etiqueta PARAM por cada parámetro enviado en la solicitud HTTP. |
||||||||||||
Attributes |
|
||||||||||||
Ejemplo | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
Subetiqueta de | GSP | ||||||||||||
Formato del Contenido | Complejo |
PU | |
---|---|
Definición | La etiqueta <PU> proporciona un vínculo relativo a la página anterior de los resultados de la búsqueda. |
Ejemplo | <PU>/search?q=flowers&num=10&hl=es-419&output=xml &client=test&start=10</PU> |
Subetiqueta de | Nota: |
Formato del Contenido | Texto (URL relativa) |
P. | |
---|---|
Definición | La etiqueta <Q> identifica la búsqueda enviada en la solicitud HTTP asociada con el resultado XML. |
Ejemplo | <Q>pizza</Q> |
Subetiqueta de | GSP |
Formato del Contenido | Texto |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definición | La etiqueta <R> encapsula los detalles de un resultado de la búsqueda individual. Nota: La definición de la etiqueta <R> para WebSearch es más restrictiva que en la DTD. |
|||||||||
Attributes |
|
|||||||||
Subetiquetas | U, UE, T?, FECHA.CRAWLDATE, ¿V?, ¿LANG?, HAS | |||||||||
Subetiqueta de | RES |
RESPONDER | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definición | La etiqueta <RES> encapsula el conjunto de resultados de la búsqueda individuales y detalles acerca de esos resultados. |
|||||||||
Attributes |
|
|||||||||
Ejemplo | <RES SN="1" EN="10"> | |||||||||
Subetiquetas | ¿M, FI?, XT?, NB?: R* | |||||||||
Subetiqueta de | GSP | |||||||||
Formato del Contenido | Vacía |
S | |
---|---|
Definición | La etiqueta <S> contiene un extracto de un resultado de la búsqueda que muestra los términos de búsqueda resaltados en negrita. Los saltos de línea se incluyen en el extracto para ajustar el texto correctamente. |
Ejemplo | <S>Washington (CNN): una oferta para poner fin al conflicto para el Senado ante las elecciones judiciales del presidente <b>Bush</b> permitiría que cinco nominados avanzaran a una votación final y, a la vez, preservara los |
Subetiqueta de | R |
Formato del Contenido | Texto (HTML) |
SL_MAIN | |
---|---|
Definición | Esta etiqueta encapsula el contenido de un resultado de promoción. Se usa para analizar promociones. El texto de anclaje y la URL del vínculo de título se incluyen en las subetiquetas T y U, respectivamente. Las líneas de texto del cuerpo y los vínculos se incluyen en las subetiquetas BODY_LINE. |
Subetiquetas | BODY_LINE*, T y U |
Subetiqueta de | SL_RESULTS |
Formato del Contenido | Vacía |
SL_RESULTS | |
---|---|
Definición | Etiqueta de contenedor para los resultados promocionados. Una de ellas aparecerá cada vez que tengas una promoción en los resultados de la búsqueda. La subetiqueta SL_MAIN contiene los datos del resultado principal. |
Subetiquetas | SL_MAIN* |
Subetiqueta de | R |
Formato del Contenido | Vacía |
Ortografía | |
---|---|
Definición | La etiqueta <Spelling> contiene una sugerencia ortográfica alternativa para la consulta enviada. Esta etiqueta solo aparece en la primera página de los resultados de la búsqueda. Las sugerencias ortográficas están disponibles en inglés, chino, japonés y coreano. Nota: Google solo mostrará sugerencias ortográficas para las consultas en las que el valor del parámetro gl esté en letras minúsculas. |
Ejemplo | <Spelling> |
Subetiquetas | Sugerencia |
Subetiqueta de | GSP |
Formato del Contenido | Vacía |
Sugerencia | |||||||
---|---|---|---|---|---|---|---|
Definición | La etiqueta <Suggestion> contiene una sugerencia ortográfica alternativa para la consulta enviada. Puedes usar el contenido de la etiqueta para sugerirle una ortografía alternativa a tu usuario de búsqueda. El valor del atributo q es la sugerencia de ortografía con caracteres de escape de URL que puedes usar como término de consulta. | ||||||
Attributes |
|
||||||
Ejemplo | <suggestion q="soccer"><b><i>fútbol</i></b></Suggestion> | ||||||
Subetiqueta de | Ortografía | ||||||
Formato del Contenido | Texto (HTML) |
T | |
---|---|
Definición | La etiqueta <T> contiene el título del resultado. |
Ejemplo | <T>Amici's East Coast Pizzeria</T> |
Subetiqueta de | R |
Formato del Contenido | Texto (HTML) |
título | |
---|---|
Definición | Como elemento secundario de <Context>, la etiqueta <title> contiene el nombre de tu Motor de Búsqueda Programable. Como elemento secundario de <Facet>, la etiqueta <title> proporciona un título para un conjunto de facetas. |
Ejemplo | Como hijo de <Context>: <title>Mi motor de búsqueda</title> Como hijo de <Facet>: <title>facet title</title> |
Subetiqueta de | Contexto, Facet |
Formato del Contenido | Texto |
TM | |
---|---|
Definición | La etiqueta <TM> identifica el tiempo total del servidor que se necesita para mostrar los resultados de la búsqueda, medido en segundos. |
Ejemplo | <TM>0.100445</TM> |
Subetiqueta de | GSP |
Formato del Contenido | Texto (número de punto flotante) |
TT | |
---|---|
Definición | La etiqueta <TT> proporciona una sugerencia para la búsqueda. |
Ejemplo | <TT><i>Sugerencia: En la mayoría de los navegadores, si presionas la tecla Intro, obtendrás los mismos resultados que si haces clic en el botón Buscar.</i></TT> |
Subetiqueta de | GSP |
U | |
---|---|
Definición | La etiqueta <U> proporciona la URL del resultado de la búsqueda. |
Ejemplo | <U>http://www.dominos.com/</U> |
Subetiqueta de | R |
Formato del Contenido | Texto (URL absoluta) |
UD | |
---|---|
Definición | La etiqueta <UD> proporciona la URL (nombre de dominio internacional) codificada con IDN para el resultado de la búsqueda. El valor permite que los dominios se muestren en idiomas locales. Por ejemplo, la URL codificada con IDN http://www.%E8%8A%B1%E4%BA%95.com se puede decodificar y mostrar como http://www.花社鮨.com. La etiqueta <UD> solo se incluirá en los resultados de la búsqueda de las solicitudes que incluían el parámetro ud. Nota: Esta es una función beta. |
Ejemplo | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Subetiqueta de | R |
Formato del Contenido | Texto (URL con codificación de IDN) |
UE | |
---|---|
Definición | La etiqueta <UE> proporciona la URL del resultado de la búsqueda. El valor tiene escape de URL, de modo que sea adecuado para pasarlo como un parámetro de consulta en una URL. |
Ejemplo | <UE>http://www.dominos.com/</UE> |
Subetiqueta de | R |
Formato del Contenido | Texto (URL con escape de URL) |
XT | |
---|---|
Definición | La etiqueta <XT> indica que el número total estimado de resultados, como lo especifica la etiqueta M, en realidad representa la cantidad total exacta de resultados. Consulta la sección Filtrado automático de este documento para obtener más detalles. |
Ejemplo | <XT |
Subetiqueta de | RES |
Formato del Contenido | Vacía |
Resultados XML para las búsquedas de imágenes
En esta solicitud de imagen de ejemplo, se solicitan 5 resultados (num=5) sobre el término de búsqueda "mono" (q=mono).
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Esta solicitud muestra el siguiente resultado XML.
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
Búsqueda de imágenes: etiquetas XML
En la siguiente tabla, se muestran etiquetas XML adicionales que se usan en las respuestas XML para búsquedas de imágenes.
Es posible que se muestren símbolos al lado de algunas subetiquetas en las definiciones que aparecen a continuación. Estos son los símbolos y sus respectivos significados:
* = cero o más instancias de la subetiqueta
+ = una o más instancias de la subetiqueta
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definición | La etiqueta <RG> incluye los detalles de un resultado individual de la búsqueda de imágenes. |
|||||||||
Attributes |
| |||||||||
Subetiqueta de | RES |
RU | |
---|---|
Definición | La etiqueta <RU tag> incluye los detalles de cada resultado de la búsqueda de imágenes. |
Subetiqueta de | R |