Search

Respuesta a una solicitud de búsqueda personalizada.

Representación JSON
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Campos
kind

string

Es el identificador único para el tipo de objeto actual. Para esta API, es customsearch#search.

url

object

El elemento de URL de OpenSearch que define la plantilla para esta API.

url.type

string

El tipo de MIME de la plantilla de URL de OpenSearch para la API de Custom Search JSON.

url.template

string

Es la plantilla de OpenSearch real para esta API.

queries

object

Contiene uno o más conjuntos de metadatos de consultas, con claves según el nombre de la función. Los nombres de roles posibles incluyen request definido por las funciones de consulta de OpenSearch y dos roles personalizados: nextPage y previousPage.

queries.previousPage[]

object

Metadatos que representan la página anterior de resultados, si corresponde.

queries.previousPage[].title

string

Es una descripción de la consulta.

queries.previousPage[].totalResults

string (int64 format)

Cantidad estimada de resultados de la búsqueda totales. Es posible que no sea preciso.

queries.previousPage[].searchTerms

string

Son los términos de búsqueda ingresados por el usuario.

queries.previousPage[].count

integer

Cantidad de resultados de la búsqueda mostrados en este conjunto.

queries.previousPage[].startIndex

integer

Es el índice del conjunto actual de resultados de la búsqueda en el conjunto total de resultados, donde el índice del primer resultado es 1.

queries.previousPage[].startPage

integer

Es el número de página de este conjunto de resultados, en el que la propiedad count establece la longitud de la página.

queries.previousPage[].language

string

El idioma de los resultados de la búsqueda.

queries.previousPage[].inputEncoding

string

La codificación de caracteres admitida para las solicitudes de búsqueda.

queries.previousPage[].outputEncoding

string

La codificación de caracteres admitida para los resultados de la búsqueda.

queries.previousPage[].safe

string

Especifica el nivel de SafeSearch que se utiliza para filtrar los resultados para adultos. Esta es una propiedad personalizada que no está definida en la especificación de OpenSearch. Los valores de parámetros válidos son los siguientes:

  • "off": Cómo inhabilitar SafeSearch

  • "active": Habilitar SafeSearch

queries.previousPage[].cx

string

Es el identificador de un motor que se creó con el Panel de control del Motor de Búsqueda Programable. Esta es una propiedad personalizada que no está definida en la especificación de OpenSearch. Este parámetro es obligatorio.

queries.previousPage[].sort

string

Especifica que los resultados se deben ordenar según la expresión especificada. Por ejemplo, ordena por fecha.

queries.previousPage[].filter

string

Activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta Filtrado automático para obtener más información acerca de los filtros de resultados de búsqueda de Google. Los valores válidos para este parámetro son los siguientes:

  • 0: Inhabilitado

  • 1: Habilitado (predeterminado)

Nota: De forma predeterminada, Google filtra todos los resultados de la búsqueda para mejorar su calidad.

queries.previousPage[].gl

string

Mejora los resultados de la búsqueda cuyo país de origen coincida con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de los valores válidos.

Especificar un valor del parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto se aplica especialmente a los clientes internacionales y, más específicamente, a los clientes de países de habla inglesa que no sean Estados Unidos.

queries.previousPage[].cr

string

Restringe los resultados de la búsqueda a los documentos que se originan en un país en particular. Puedes usar operadores booleanos en el valor del parámetro cr.

Para determinar el país de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento.

  • Es la ubicación geográfica de la dirección IP del servidor web.

Consulta Valores del parámetro de país (cr) para obtener una lista de los valores válidos para este parámetro.

queries.previousPage[].googleHost

string

Especifica el dominio de Google (por ejemplo, google.com, google.de o google.fr) al que se debe limitar la búsqueda.

queries.previousPage[].disableCnTwTranslation

string

Habilita o inhabilita la función Búsqueda en chino simplificado y tradicional.

Los valores admitidos son los que se detallan a continuación:

  • 0: habilitada (predeterminada)

  • 1: inhabilitado

queries.previousPage[].hq

string

Agrega los términos especificados a la consulta, como si se combinaran con un operador lógico AND.

queries.previousPage[].hl

string

Especifica el idioma de la interfaz (idioma host) de tu interfaz de usuario. Configurar explícitamente este parámetro mejora el rendimiento y la calidad de los resultados de la búsqueda.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información. También puedes consultar Idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles.

queries.previousPage[].siteSearch

string

Restringe los resultados a las URLs de un sitio especificado.

queries.previousPage[].siteSearchFilter

string

Especifica si se deben incluir o excluir resultados del sitio que se menciona en el parámetro sitesearch. Los valores admitidos son los que se detallan a continuación:

  • i: Incluye contenido del sitio.

  • e: Excluir contenido del sitio

queries.previousPage[].exactTerms

string

Identifica una frase que deben contener todos los documentos de los resultados de búsqueda.

queries.previousPage[].excludeTerms

string

Identifica una palabra o frase que no debería aparecer en ningún documento de los resultados de la búsqueda.

queries.previousPage[].linkSite

string

Especifica que todos los resultados deben contener un vínculo a una URL específica.

queries.previousPage[].orTerms

string

Proporciona términos de búsqueda adicionales para buscar en un documento, en el que cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta booleano O para este tipo de consulta.

queries.previousPage[].relatedSite

string

Especifica que todos los resultados de la búsqueda deben ser páginas relacionadas con la URL especificada. El valor del parámetro debe ser una URL.

queries.previousPage[].dateRestrict

string

Restringe los resultados a las URLs según la fecha. Entre los valores admitidos, se incluyen los siguientes:

  • d[number]: Solicita resultados de la cantidad especificada de días anteriores.

  • w[number]: Solicita resultados de la cantidad especificada de semanas anteriores.

  • m[number]: Solicita resultados de la cantidad especificada de meses anteriores.

  • y[number]: Solicita resultados de la cantidad especificada de años anteriores.

queries.previousPage[].lowRange

string

Especifica el valor inicial para un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.

queries.previousPage[].highRange

string

Especifica el valor final de un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.

queries.previousPage[].fileType

string

Restringe los resultados a los archivos de una extensión especificada. Entre los tipos de archivo que admite Google, se incluyen los siguientes:

  • Formato de documento portátil de Adobe (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks y wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato de texto enriquecido (rtf)

  • Flash de ondas de choque (swf)

  • Texto (ans, txt)

Es posible que se agreguen otros tipos de archivo en el futuro. Puedes consultar la lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google.

queries.previousPage[].rights

string

Filtros basados en licencias. Entre los valores admitidos, se incluyen los siguientes:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

Los valores permitidos son web o image. Si no se especifica, los resultados se limitan a páginas web.

queries.previousPage[].imgSize

string

Restringe los resultados a las imágenes de un tamaño especificado. Los valores admitidos son los que se detallan a continuación:

  • icon (pequeña)

  • small | medium | large | xlarge (mediano)

  • xxlarge (grande)

  • huge (extragrande)

queries.previousPage[].imgType

string

Restringe los resultados a las imágenes de un tipo especificado. Los valores admitidos son los que se detallan a continuación:

  • clipart (imagen prediseñada)

  • face (Rostro)

  • lineart (dibujo de líneas)

  • photo (foto)

  • animated (animada)

  • stock (stock)

queries.previousPage[].imgColorType

string

Restringe los resultados a las imágenes de un tipo de color especificado. Valores admitidos:

  • mono (blanco y negro)

  • gray (escala de grises)

  • color (color)

queries.previousPage[].imgDominantColor

string

Restringe los resultados a las imágenes con un color dominante específico. Los valores admitidos son los que se detallan a continuación:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Metadatos que representan la solicitud actual

queries.request[].title

string

Es una descripción de la consulta.

queries.request[].totalResults

string (int64 format)

Cantidad estimada de resultados de la búsqueda totales. Es posible que no sea preciso.

queries.request[].searchTerms

string

Son los términos de búsqueda ingresados por el usuario.

queries.request[].count

integer

Cantidad de resultados de la búsqueda mostrados en este conjunto.

queries.request[].startIndex

integer

Es el índice del conjunto actual de resultados de la búsqueda en el conjunto total de resultados, donde el índice del primer resultado es 1.

queries.request[].startPage

integer

Es el número de página de este conjunto de resultados, en el que la propiedad count establece la longitud de la página.

queries.request[].language

string

El idioma de los resultados de la búsqueda.

queries.request[].inputEncoding

string

La codificación de caracteres admitida para las solicitudes de búsqueda.

queries.request[].outputEncoding

string

La codificación de caracteres admitida para los resultados de la búsqueda.

queries.request[].safe

string

Especifica el nivel de SafeSearch que se utiliza para filtrar los resultados para adultos. Esta es una propiedad personalizada que no está definida en la especificación de OpenSearch. Los valores de parámetros válidos son los siguientes:

  • "off": Cómo inhabilitar SafeSearch

  • "active": Habilitar SafeSearch

queries.request[].cx

string

Es el identificador de un motor que se creó con el Panel de control del Motor de Búsqueda Programable. Esta es una propiedad personalizada que no está definida en la especificación de OpenSearch. Este parámetro es obligatorio.

queries.request[].sort

string

Especifica que los resultados se deben ordenar según la expresión especificada. Por ejemplo, ordena por fecha.

queries.request[].filter

string

Activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta Filtrado automático para obtener más información acerca de los filtros de resultados de búsqueda de Google. Los valores válidos para este parámetro son los siguientes:

  • 0: Inhabilitado

  • 1: Habilitado (predeterminado)

Nota: De forma predeterminada, Google filtra todos los resultados de la búsqueda para mejorar su calidad.

queries.request[].gl

string

Mejora los resultados de la búsqueda cuyo país de origen coincida con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de los valores válidos.

Especificar un valor del parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto se aplica especialmente a los clientes internacionales y, más específicamente, a los clientes de países de habla inglesa que no sean Estados Unidos.

queries.request[].cr

string

Restringe los resultados de la búsqueda a los documentos que se originan en un país en particular. Puedes usar operadores booleanos en el valor del parámetro cr.

Para determinar el país de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento.

  • Es la ubicación geográfica de la dirección IP del servidor web.

Consulta Valores del parámetro de país (cr) para obtener una lista de los valores válidos para este parámetro.

queries.request[].googleHost

string

Especifica el dominio de Google (por ejemplo, google.com, google.de o google.fr) al que se debe limitar la búsqueda.

queries.request[].disableCnTwTranslation

string

Habilita o inhabilita la función Búsqueda en chino simplificado y tradicional.

Los valores admitidos son los que se detallan a continuación:

  • 0: habilitada (predeterminada)

  • 1: inhabilitado

queries.request[].hq

string

Agrega los términos especificados a la consulta, como si se combinaran con un operador lógico AND.

queries.request[].hl

string

Especifica el idioma de la interfaz (idioma host) de tu interfaz de usuario. Configurar explícitamente este parámetro mejora el rendimiento y la calidad de los resultados de la búsqueda.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información. También puedes consultar Idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles.

queries.request[].siteSearch

string

Restringe los resultados a las URLs de un sitio especificado.

queries.request[].siteSearchFilter

string

Especifica si se deben incluir o excluir resultados del sitio que se menciona en el parámetro sitesearch. Los valores admitidos son los que se detallan a continuación:

  • i: Incluye contenido del sitio.

  • e: Excluir contenido del sitio

queries.request[].exactTerms

string

Identifica una frase que deben contener todos los documentos de los resultados de búsqueda.

queries.request[].excludeTerms

string

Identifica una palabra o frase que no debería aparecer en ningún documento de los resultados de la búsqueda.

queries.request[].linkSite

string

Especifica que todos los resultados deben contener un vínculo a una URL específica.

queries.request[].orTerms

string

Proporciona términos de búsqueda adicionales para buscar en un documento, en el que cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta booleano O para este tipo de consulta.

queries.request[].relatedSite

string

Especifica que todos los resultados de la búsqueda deben ser páginas relacionadas con la URL especificada. El valor del parámetro debe ser una URL.

queries.request[].dateRestrict

string

Restringe los resultados a las URLs según la fecha. Entre los valores admitidos, se incluyen los siguientes:

  • d[number]: Solicita resultados de la cantidad especificada de días anteriores.

  • w[number]: Solicita resultados de la cantidad especificada de semanas anteriores.

  • m[number]: Solicita resultados de la cantidad especificada de meses anteriores.

  • y[number]: Solicita resultados de la cantidad especificada de años anteriores.

queries.request[].lowRange

string

Especifica el valor inicial para un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.

queries.request[].highRange

string

Especifica el valor final de un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.

queries.request[].fileType

string

Restringe los resultados a los archivos de una extensión especificada. Entre los tipos de archivo que admite Google, se incluyen los siguientes:

  • Formato de documento portátil de Adobe (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks y wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato de texto enriquecido (rtf)

  • Flash de ondas de choque (swf)

  • Texto (ans, txt)

Es posible que se agreguen otros tipos de archivo en el futuro. Puedes consultar la lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google.

queries.request[].rights

string

Filtros basados en licencias. Entre los valores admitidos, se incluyen los siguientes:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

Los valores permitidos son web o image. Si no se especifica, los resultados se limitan a páginas web.

queries.request[].imgSize

string

Restringe los resultados a las imágenes de un tamaño especificado. Los valores admitidos son los que se detallan a continuación:

  • icon (pequeña)

  • small | medium | large | xlarge (mediano)

  • xxlarge (grande)

  • huge (extragrande)

queries.request[].imgType

string

Restringe los resultados a las imágenes de un tipo especificado. Los valores admitidos son los que se detallan a continuación:

  • clipart (imagen prediseñada)

  • face (Rostro)

  • lineart (dibujo de líneas)

  • photo (foto)

  • animated (animada)

  • stock (stock)

queries.request[].imgColorType

string

Restringe los resultados a las imágenes de un tipo de color especificado. Valores admitidos:

  • mono (blanco y negro)

  • gray (escala de grises)

  • color (color)

queries.request[].imgDominantColor

string

Restringe los resultados a las imágenes con un color dominante específico. Los valores admitidos son los que se detallan a continuación:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Metadatos que representan la siguiente página de resultados, si corresponde.

queries.nextPage[].title

string

Es una descripción de la consulta.

queries.nextPage[].totalResults

string (int64 format)

Cantidad estimada de resultados de la búsqueda totales. Es posible que no sea preciso.

queries.nextPage[].searchTerms

string

Son los términos de búsqueda ingresados por el usuario.

queries.nextPage[].count

integer

Cantidad de resultados de la búsqueda mostrados en este conjunto.

queries.nextPage[].startIndex

integer

Es el índice del conjunto actual de resultados de la búsqueda en el conjunto total de resultados, donde el índice del primer resultado es 1.

queries.nextPage[].startPage

integer

Es el número de página de este conjunto de resultados, en el que la propiedad count establece la longitud de la página.

queries.nextPage[].language

string

El idioma de los resultados de la búsqueda.

queries.nextPage[].inputEncoding

string

La codificación de caracteres admitida para las solicitudes de búsqueda.

queries.nextPage[].outputEncoding

string

La codificación de caracteres admitida para los resultados de la búsqueda.

queries.nextPage[].safe

string

Especifica el nivel de SafeSearch que se utiliza para filtrar los resultados para adultos. Esta es una propiedad personalizada que no está definida en la especificación de OpenSearch. Los valores de parámetros válidos son los siguientes:

  • "off": Cómo inhabilitar SafeSearch

  • "active": Habilitar SafeSearch

queries.nextPage[].cx

string

Es el identificador de un motor que se creó con el Panel de control del Motor de Búsqueda Programable. Esta es una propiedad personalizada que no está definida en la especificación de OpenSearch. Este parámetro es obligatorio.

queries.nextPage[].sort

string

Especifica que los resultados se deben ordenar según la expresión especificada. Por ejemplo, ordena por fecha.

queries.nextPage[].filter

string

Activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta Filtrado automático para obtener más información acerca de los filtros de resultados de búsqueda de Google. Los valores válidos para este parámetro son los siguientes:

  • 0: Inhabilitado

  • 1: Habilitado (predeterminado)

Nota: De forma predeterminada, Google filtra todos los resultados de la búsqueda para mejorar su calidad.

queries.nextPage[].gl

string

Mejora los resultados de la búsqueda cuyo país de origen coincida con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de los valores válidos.

Especificar un valor del parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto se aplica especialmente a los clientes internacionales y, más específicamente, a los clientes de países de habla inglesa que no sean Estados Unidos.

queries.nextPage[].cr

string

Restringe los resultados de la búsqueda a los documentos que se originan en un país en particular. Puedes usar operadores booleanos en el valor del parámetro cr.

Para determinar el país de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento.

  • Es la ubicación geográfica de la dirección IP del servidor web.

Consulta Valores del parámetro de país (cr) para obtener una lista de los valores válidos para este parámetro.

queries.nextPage[].googleHost

string

Especifica el dominio de Google (por ejemplo, google.com, google.de o google.fr) al que se debe limitar la búsqueda.

queries.nextPage[].disableCnTwTranslation

string

Habilita o inhabilita la función Búsqueda en chino simplificado y tradicional.

Los valores admitidos son los que se detallan a continuación:

  • 0: habilitada (predeterminada)

  • 1: inhabilitado

queries.nextPage[].hq

string

Agrega los términos especificados a la consulta, como si se combinaran con un operador lógico AND.

queries.nextPage[].hl

string

Especifica el idioma de la interfaz (idioma host) de tu interfaz de usuario. Configurar explícitamente este parámetro mejora el rendimiento y la calidad de los resultados de la búsqueda.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información. También puedes consultar Idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles.

queries.nextPage[].siteSearch

string

Restringe los resultados a las URLs de un sitio especificado.

queries.nextPage[].siteSearchFilter

string

Especifica si se deben incluir o excluir resultados del sitio que se menciona en el parámetro sitesearch. Los valores admitidos son los que se detallan a continuación:

  • i: Incluye contenido del sitio.

  • e: Excluir contenido del sitio

queries.nextPage[].exactTerms

string

Identifica una frase que deben contener todos los documentos de los resultados de búsqueda.

queries.nextPage[].excludeTerms

string

Identifica una palabra o frase que no debería aparecer en ningún documento de los resultados de la búsqueda.

queries.nextPage[].linkSite

string

Especifica que todos los resultados deben contener un vínculo a una URL específica.

queries.nextPage[].orTerms

string

Proporciona términos de búsqueda adicionales para buscar en un documento, en el que cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta booleano O para este tipo de consulta.

queries.nextPage[].relatedSite

string

Especifica que todos los resultados de la búsqueda deben ser páginas relacionadas con la URL especificada. El valor del parámetro debe ser una URL.

queries.nextPage[].dateRestrict

string

Restringe los resultados a las URLs según la fecha. Entre los valores admitidos, se incluyen los siguientes:

  • d[number]: Solicita resultados de la cantidad especificada de días anteriores.

  • w[number]: Solicita resultados de la cantidad especificada de semanas anteriores.

  • m[number]: Solicita resultados de la cantidad especificada de meses anteriores.

  • y[number]: Solicita resultados de la cantidad especificada de años anteriores.

queries.nextPage[].lowRange

string

Especifica el valor inicial para un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.

queries.nextPage[].highRange

string

Especifica el valor final de un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.

queries.nextPage[].fileType

string

Restringe los resultados a los archivos de una extensión especificada. Entre los tipos de archivo que admite Google, se incluyen los siguientes:

  • Formato de documento portátil de Adobe (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks y wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato de texto enriquecido (rtf)

  • Flash de ondas de choque (swf)

  • Texto (ans, txt)

Es posible que se agreguen otros tipos de archivo en el futuro. Puedes consultar la lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google.

queries.nextPage[].rights

string

Filtros basados en licencias. Entre los valores admitidos, se incluyen los siguientes:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

Los valores permitidos son web o image. Si no se especifica, los resultados se limitan a páginas web.

queries.nextPage[].imgSize

string

Restringe los resultados a las imágenes de un tamaño especificado. Los valores admitidos son los que se detallan a continuación:

  • icon (pequeña)

  • small | medium | large | xlarge (mediano)

  • xxlarge (grande)

  • huge (extragrande)

queries.nextPage[].imgType

string

Restringe los resultados a las imágenes de un tipo especificado. Los valores admitidos son los que se detallan a continuación:

  • clipart (imagen prediseñada)

  • face (Rostro)

  • lineart (dibujo de líneas)

  • photo (foto)

  • animated (animada)

  • stock (stock)

queries.nextPage[].imgColorType

string

Restringe los resultados a las imágenes de un tipo de color especificado. Valores admitidos:

  • mono (blanco y negro)

  • gray (escala de grises)

  • color (color)

queries.nextPage[].imgDominantColor

string

Restringe los resultados a las imágenes con un color dominante específico. Los valores admitidos son los que se detallan a continuación:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

Es el conjunto de promociones. Solo está presente si los archivos de configuración del motor de búsqueda personalizado definen promociones para la consulta determinada.

context

object (Struct format)

Metadatos y mejoras asociados con el motor de búsqueda determinado, incluidos:

  • El nombre del motor de búsqueda que se usó para la consulta.

  • Un conjunto de objetos de faceta (ajustes) que puedes usar para definir mejor una búsqueda.

searchInformation

object

Metadatos sobre esta búsqueda, incluidos el tiempo de búsqueda y los resultados totales.

searchInformation.searchTime

number

Es el tiempo que tarda el servidor en mostrar resultados de la búsqueda.

searchInformation.formattedSearchTime

string

Es el tiempo que tarda el servidor en mostrar resultados de la búsqueda, con el formato establecido según el estilo de la configuración regional.

searchInformation.totalResults

string

Es la cantidad total de resultados que devuelve la consulta.

searchInformation.formattedTotalResults

string

Es la cantidad total de resultados de la búsqueda, con el formato establecido según el estilo de la configuración regional.

spelling

object

Encapsula una consulta corregida.

spelling.correctedQuery

string

Es la consulta corregida.

spelling.htmlCorrectedQuery

string

La consulta corregida, con formato HTML.

items[]

object (Result)

El conjunto actual de resultados de la búsqueda personalizados.

Promoción

Resultado de la promoción.

Representación JSON
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Campos
title

string

Es el título de la promoción.

htmlTitle

string

Es el título de la promoción, en formato HTML.

bodyLines[]

object

Un array de objetos de bloque para esta promoción.

bodyLines[].title

string

El texto del objeto de bloque, si tiene texto

bodyLines[].htmlTitle

string

El texto del objeto de bloque en HTML, si tiene texto.

bodyLines[].url

string

La URL del vínculo del objeto bloqueado, si tiene uno.

bodyLines[].link

string

El texto de anclaje del vínculo del objeto de bloque, si tiene un vínculo

image

object

Imagen asociada con esta promoción, si la hay.

image.source

string

URL de la imagen de este vínculo de promoción.

image.width

integer

Ancho de la imagen en píxeles.

image.height

integer

Altura de la imagen en píxeles.

Resultado

Un resultado de búsqueda personalizado.

Representación JSON
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Campos
kind

string

Un identificador único para el tipo de objeto actual. Para esta API, es customsearch#result..

title

string

Título del resultado de la búsqueda, en texto sin formato.

htmlTitle

string

Es el título del resultado de la búsqueda, en HTML.

snippet

string

Fragmento del resultado de la búsqueda, en texto sin formato.

htmlSnippet

string

Es el fragmento del resultado de la búsqueda, en HTML.

cacheId

string

Indica el ID de la versión almacenada en caché de Google del resultado de la búsqueda.

formattedUrl

string

Es la URL que se muestra después del fragmento para cada resultado de la búsqueda.

htmlFormattedUrl

string

Es la URL en formato HTML que se muestra después del fragmento de cada resultado de la búsqueda.

pagemap

object (Struct format)

Contiene información de PageMap para este resultado de la búsqueda.

mime

string

El tipo de MIME del resultado de la búsqueda.

fileFormat

string

Es el formato de archivo del resultado de la búsqueda.

image

object

Encapsula toda la información acerca de una imagen que se muestra en los resultados de la búsqueda.

image.contextLink

string

Es una URL que dirige a la página web que aloja la imagen.

image.height

integer

Es la altura de la imagen en píxeles.

image.width

integer

Es el ancho de la imagen en píxeles.

image.byteSize

integer

El tamaño de la imagen, en bytes.

image.thumbnailLink

string

Una URL a la imagen en miniatura.

image.thumbnailHeight

integer

La altura de la imagen en miniatura (en píxeles).

image.thumbnailWidth

integer

Es el ancho de la imagen en miniatura en píxeles.

labels[]

object

Encapsula toda la información sobre etiquetas de perfeccionamiento.

labels[].name

string

Es el nombre de una etiqueta de mejora, que puedes usar para definir mejor las búsquedas. No muestres esto en tu interfaz de usuario. En su lugar, usa displayName.

labels[].displayName

string

El nombre visible de una etiqueta de mejora. Este es el nombre que debes mostrar en tu interfaz de usuario.

labels[].label_with_op

string

Etiqueta de perfeccionamiento y la operación de perfeccionamiento asociada.