Search

Resposta a uma solicitação de pesquisa personalizada.

Representação 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

Identificador exclusivo para o tipo de objeto atual. Para esta API, é customsearch#search.

url

object

O elemento de URL do OpenSearch que define o modelo para esta API.

url.type

string

O tipo MIME do modelo de URL do OpenSearch para a API JSON da Pesquisa personalizada.

url.template

string

O modelo OpenSearch real para essa API.

queries

object

Contém um ou mais conjuntos de metadados de consulta, reunidos por nome de função. Os possíveis nomes dos papéis incluem request definido pelos papéis de consulta do OpenSearch e duas funções personalizadas: nextPage e previousPage.

queries.previousPage[]

object

Metadados que representam a página anterior de resultados, se aplicável.

queries.previousPage[].title

string

Descrição da consulta.

queries.previousPage[].totalResults

string (int64 format)

Número estimado do total de resultados da pesquisa. Pode não ser exata.

queries.previousPage[].searchTerms

string

Os termos de pesquisa digitados pelo usuário.

queries.previousPage[].count

integer

Número de resultados de pesquisa mostrados no conjunto.

queries.previousPage[].startIndex

integer

O índice do conjunto atual de resultados de pesquisa em relação ao conjunto total de resultados, sendo que o índice do primeiro resultado é 1.

queries.previousPage[].startPage

integer

O número da página desse conjunto de resultados, em que o tamanho da página é definido pela propriedade count.

queries.previousPage[].language

string

O idioma dos resultados de pesquisa.

queries.previousPage[].inputEncoding

string

A codificação de caracteres suportada para os resultados de pesquisa.

queries.previousPage[].outputEncoding

string

A codificação de caracteres suportada para os resultados da pesquisa.

queries.previousPage[].safe

string

Especifica o nível do SafeSearch usado para filtrar resultados adultos. Esta é uma propriedade personalizada não definida na especificação do OpenSearch. Estes são os valores de parâmetro válidos:

  • "off": desativar o SafeSearch

  • "active": ativar o SafeSearch

queries.previousPage[].cx

string

O identificador de um mecanismo criado usando o Painel de controle do Mecanismo de Pesquisa Programável. Essa é uma propriedade personalizada não definida na especificação do OpenSearch. Esse parâmetro é obrigatório.

queries.previousPage[].sort

string

Especifica que os resultados precisam ser classificados de acordo com a expressão especificada. Por exemplo, classificar por data.

queries.previousPage[].filter

string

Ativa ou desativa a filtragem automática dos resultados da pesquisa do Google. Consulte Filtragem automática para mais informações sobre os filtros de resultados da pesquisa do Google. Os valores válidos para esse parâmetro são:

  • 0: desativado

  • 1: ativado (padrão)

Observação: por padrão, o Google aplica filtros a todos os resultados da pesquisa para melhorar a qualidade deles.

queries.previousPage[].gl

string

Otimiza os resultados da pesquisa cujo país de origem corresponde ao valor do parâmetro. Consulte uma lista de valores válidos em Códigos de países.

A especificação de um valor de parâmetro gl nas solicitações do WebSearch melhora a relevância dos resultados. Isso se aplica especialmente a clientes internacionais e, de maneira ainda mais específica, aos clientes de países que não falam inglês.

queries.previousPage[].cr

string

Restringe os resultados da pesquisa a documentos originários de um país específico. Você pode usar operadores booleanos no valor do parâmetro cr.

O Google WebSearch determina o país de um documento analisando o seguinte:

  • O domínio de nível superior (TLD) do URL do documento.

  • A localização geográfica do endereço IP do servidor da Web.

Consulte Valores de parâmetro de país (cr) para ver uma lista de valores válidos para esse parâmetro.

queries.previousPage[].googleHost

string

Especifica o domínio do Google (por exemplo, google.com, google.de ou google.fr) ao qual a pesquisa deve ser limitada.

queries.previousPage[].disableCnTwTranslation

string

Ativa ou desativa o recurso Pesquisa em chinês simplificado e tradicional.

Os valores compatíveis são:

  • 0: ativada (padrão)

  • 1: desativada

queries.previousPage[].hq

string

Anexa os termos de consulta especificados à consulta, como se eles fossem combinados com um operador lógico AND.

queries.previousPage[].hl

string

Especifica o idioma (idioma do host) da interface do usuário. Definir explicitamente esse parâmetro melhora o desempenho e a qualidade dos resultados da pesquisa.

Consulte a seção Idiomas de interface de Internacionalização de consultas e apresentação de resultados para mais informações e a seção Idiomas de interface compatíveis para uma lista de idiomas compatíveis.

queries.previousPage[].siteSearch

string

Restringe os resultados a URLs de um site especificado.

queries.previousPage[].siteSearchFilter

string

Especifica se é necessário incluir ou excluir resultados do site nomeado no parâmetro sitesearch. Os valores compatíveis são:

  • i: inclui conteúdo do site

  • e: excluir conteúdo do site

queries.previousPage[].exactTerms

string

Identifica uma frase que todos os documentos nos resultados da pesquisa precisam conter.

queries.previousPage[].excludeTerms

string

Identifica uma palavra ou frase que não deve aparecer em nenhum documento nos resultados da pesquisa.

queries.previousPage[].linkSite

string

Especifica que todos os resultados devem conter um link para um URL específico.

queries.previousPage[].orTerms

string

Fornece termos de pesquisa adicionais a serem verificados em um documento, em que cada documento nos resultados da pesquisa precisa conter pelo menos um dos termos de pesquisa adicionais. Você também pode usar o termo de consulta OU booleano para esse tipo de consulta.

queries.previousPage[].relatedSite

string

Especifica que todos os resultados da pesquisa precisam ser páginas relacionadas ao URL especificado. O valor do parâmetro deve ser um URL.

queries.previousPage[].dateRestrict

string

Restringe os resultados a URLs com base na data. Os valores aceitos são:

  • d[number]: solicita resultados do número especificado de dias anteriores.

  • w[number]: solicita resultados do número especificado de semanas anteriores.

  • m[number]: solicita resultados do número especificado de meses anteriores.

  • y[number]: solicita resultados do número especificado de anos anteriores.

queries.previousPage[].lowRange

string

Especifica o valor inicial de um intervalo de pesquisa. Use cse:lowRange e cse:highrange para anexar um intervalo de pesquisa inclusivo de lowRange...highRange à consulta.

queries.previousPage[].highRange

string

Especifica o valor final de um intervalo de pesquisa. Use cse:lowRange e cse:highrange para anexar um intervalo de pesquisa inclusivo de lowRange...highRange à consulta.

queries.previousPage[].fileType

string

Restringe os resultados a arquivos de uma extensão especificada. Os tipos de arquivo aceitos pelo Google incluem:

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

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato Rich Text (rtf)

  • Flash de onda de choque (swf)

  • Texto (ans, txt).

Outros tipos de arquivo podem ser adicionados no futuro. Encontre uma lista atualizada nas perguntas frequentes sobre tipos de arquivos do Google.

queries.previousPage[].rights

string

Filtros com base no licenciamento. Os valores aceitos são:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

Os valores permitidos são web ou image. Se não for especificado, os resultados ficarão limitados a páginas da Web.

queries.previousPage[].imgSize

string

Restringe os resultados a imagens de um tamanho especificado. Os valores compatíveis são:

  • icon (pequena)

  • small | medium | large | xlarge (médio)

  • xxlarge (grande)

  • huge (extra grande)

queries.previousPage[].imgType

string

Restringe os resultados a imagens de um tipo especificado. Os valores compatíveis são:

  • clipart (Clip art)

  • face (rosto)

  • lineart (Desenho linear)

  • photo (foto)

  • animated (animado)

  • stock (Ações)

queries.previousPage[].imgColorType

string

Restringe os resultados a imagens de um tipo de cor especificado. Os valores aceitos são:

  • mono (preto e branco)

  • gray (escala de cinza)

  • color (cor)

queries.previousPage[].imgDominantColor

string

Restringe os resultados a imagens com uma cor dominante específica. Os valores compatíveis são:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Metadados que representam a solicitação atual.

queries.request[].title

string

Descrição da consulta.

queries.request[].totalResults

string (int64 format)

Número estimado do total de resultados da pesquisa. Pode não ser exata.

queries.request[].searchTerms

string

Os termos de pesquisa digitados pelo usuário.

queries.request[].count

integer

Número de resultados de pesquisa mostrados no conjunto.

queries.request[].startIndex

integer

O índice do conjunto atual de resultados de pesquisa em relação ao conjunto total de resultados, sendo que o índice do primeiro resultado é 1.

queries.request[].startPage

integer

O número da página desse conjunto de resultados, em que o tamanho da página é definido pela propriedade count.

queries.request[].language

string

O idioma dos resultados de pesquisa.

queries.request[].inputEncoding

string

A codificação de caracteres suportada para os resultados de pesquisa.

queries.request[].outputEncoding

string

A codificação de caracteres suportada para os resultados da pesquisa.

queries.request[].safe

string

Especifica o nível do SafeSearch usado para filtrar resultados adultos. Esta é uma propriedade personalizada não definida na especificação do OpenSearch. Estes são os valores de parâmetro válidos:

  • "off": desativar o SafeSearch

  • "active": ativar o SafeSearch

queries.request[].cx

string

O identificador de um mecanismo criado usando o Painel de controle do Mecanismo de Pesquisa Programável. Essa é uma propriedade personalizada não definida na especificação do OpenSearch. Esse parâmetro é obrigatório.

queries.request[].sort

string

Especifica que os resultados precisam ser classificados de acordo com a expressão especificada. Por exemplo, classificar por data.

queries.request[].filter

string

Ativa ou desativa a filtragem automática dos resultados da pesquisa do Google. Consulte Filtragem automática para mais informações sobre os filtros de resultados da pesquisa do Google. Os valores válidos para esse parâmetro são:

  • 0: desativado

  • 1: ativado (padrão)

Observação: por padrão, o Google aplica filtros a todos os resultados da pesquisa para melhorar a qualidade deles.

queries.request[].gl

string

Otimiza os resultados da pesquisa cujo país de origem corresponde ao valor do parâmetro. Consulte uma lista de valores válidos em Códigos de países.

A especificação de um valor de parâmetro gl nas solicitações do WebSearch melhora a relevância dos resultados. Isso se aplica especialmente a clientes internacionais e, de maneira ainda mais específica, aos clientes de países que não falam inglês.

queries.request[].cr

string

Restringe os resultados da pesquisa a documentos originários de um país específico. Você pode usar operadores booleanos no valor do parâmetro cr.

O Google WebSearch determina o país de um documento analisando o seguinte:

  • O domínio de nível superior (TLD) do URL do documento.

  • A localização geográfica do endereço IP do servidor da Web.

Consulte Valores de parâmetro de país (cr) para ver uma lista de valores válidos para esse parâmetro.

queries.request[].googleHost

string

Especifica o domínio do Google (por exemplo, google.com, google.de ou google.fr) ao qual a pesquisa deve ser limitada.

queries.request[].disableCnTwTranslation

string

Ativa ou desativa o recurso Pesquisa em chinês simplificado e tradicional.

Os valores compatíveis são:

  • 0: ativada (padrão)

  • 1: desativada

queries.request[].hq

string

Anexa os termos de consulta especificados à consulta, como se eles fossem combinados com um operador lógico AND.

queries.request[].hl

string

Especifica o idioma (idioma do host) da interface do usuário. Definir explicitamente esse parâmetro melhora o desempenho e a qualidade dos resultados da pesquisa.

Consulte a seção Idiomas de interface de Internacionalização de consultas e apresentação de resultados para mais informações e a seção Idiomas de interface compatíveis para uma lista de idiomas compatíveis.

queries.request[].siteSearch

string

Restringe os resultados a URLs de um site especificado.

queries.request[].siteSearchFilter

string

Especifica se é necessário incluir ou excluir resultados do site nomeado no parâmetro sitesearch. Os valores compatíveis são:

  • i: inclui conteúdo do site

  • e: excluir conteúdo do site

queries.request[].exactTerms

string

Identifica uma frase que todos os documentos nos resultados da pesquisa precisam conter.

queries.request[].excludeTerms

string

Identifica uma palavra ou frase que não deve aparecer em nenhum documento nos resultados da pesquisa.

queries.request[].linkSite

string

Especifica que todos os resultados devem conter um link para um URL específico.

queries.request[].orTerms

string

Fornece termos de pesquisa adicionais a serem verificados em um documento, em que cada documento nos resultados da pesquisa precisa conter pelo menos um dos termos de pesquisa adicionais. Você também pode usar o termo de consulta OU booleano para esse tipo de consulta.

queries.request[].relatedSite

string

Especifica que todos os resultados da pesquisa precisam ser páginas relacionadas ao URL especificado. O valor do parâmetro deve ser um URL.

queries.request[].dateRestrict

string

Restringe os resultados a URLs com base na data. Os valores aceitos são:

  • d[number]: solicita resultados do número especificado de dias anteriores.

  • w[number]: solicita resultados do número especificado de semanas anteriores.

  • m[number]: solicita resultados do número especificado de meses anteriores.

  • y[number]: solicita resultados do número especificado de anos anteriores.

queries.request[].lowRange

string

Especifica o valor inicial de um intervalo de pesquisa. Use cse:lowRange e cse:highrange para anexar um intervalo de pesquisa inclusivo de lowRange...highRange à consulta.

queries.request[].highRange

string

Especifica o valor final de um intervalo de pesquisa. Use cse:lowRange e cse:highrange para anexar um intervalo de pesquisa inclusivo de lowRange...highRange à consulta.

queries.request[].fileType

string

Restringe os resultados a arquivos de uma extensão especificada. Os tipos de arquivo aceitos pelo Google incluem:

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

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato Rich Text (rtf)

  • Flash de onda de choque (swf)

  • Texto (ans, txt).

Outros tipos de arquivo podem ser adicionados no futuro. Encontre uma lista atualizada nas perguntas frequentes sobre tipos de arquivos do Google.

queries.request[].rights

string

Filtros com base no licenciamento. Os valores aceitos são:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

Os valores permitidos são web ou image. Se não for especificado, os resultados ficarão limitados a páginas da Web.

queries.request[].imgSize

string

Restringe os resultados a imagens de um tamanho especificado. Os valores compatíveis são:

  • icon (pequena)

  • small | medium | large | xlarge (médio)

  • xxlarge (grande)

  • huge (extra grande)

queries.request[].imgType

string

Restringe os resultados a imagens de um tipo especificado. Os valores compatíveis são:

  • clipart (Clip art)

  • face (rosto)

  • lineart (Desenho linear)

  • photo (foto)

  • animated (animado)

  • stock (Ações)

queries.request[].imgColorType

string

Restringe os resultados a imagens de um tipo de cor especificado. Os valores aceitos são:

  • mono (preto e branco)

  • gray (escala de cinza)

  • color (cor)

queries.request[].imgDominantColor

string

Restringe os resultados a imagens com uma cor dominante específica. Os valores compatíveis são:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Metadados que representam a próxima página de resultados, se aplicável.

queries.nextPage[].title

string

Descrição da consulta.

queries.nextPage[].totalResults

string (int64 format)

Número estimado do total de resultados da pesquisa. Pode não ser exata.

queries.nextPage[].searchTerms

string

Os termos de pesquisa digitados pelo usuário.

queries.nextPage[].count

integer

Número de resultados de pesquisa mostrados no conjunto.

queries.nextPage[].startIndex

integer

O índice do conjunto atual de resultados de pesquisa em relação ao conjunto total de resultados, sendo que o índice do primeiro resultado é 1.

queries.nextPage[].startPage

integer

O número da página desse conjunto de resultados, em que o tamanho da página é definido pela propriedade count.

queries.nextPage[].language

string

O idioma dos resultados de pesquisa.

queries.nextPage[].inputEncoding

string

A codificação de caracteres suportada para os resultados de pesquisa.

queries.nextPage[].outputEncoding

string

A codificação de caracteres suportada para os resultados da pesquisa.

queries.nextPage[].safe

string

Especifica o nível do SafeSearch usado para filtrar resultados adultos. Esta é uma propriedade personalizada não definida na especificação do OpenSearch. Estes são os valores de parâmetro válidos:

  • "off": desativar o SafeSearch

  • "active": ativar o SafeSearch

queries.nextPage[].cx

string

O identificador de um mecanismo criado usando o Painel de controle do Mecanismo de Pesquisa Programável. Essa é uma propriedade personalizada não definida na especificação do OpenSearch. Esse parâmetro é obrigatório.

queries.nextPage[].sort

string

Especifica que os resultados precisam ser classificados de acordo com a expressão especificada. Por exemplo, classificar por data.

queries.nextPage[].filter

string

Ativa ou desativa a filtragem automática dos resultados da pesquisa do Google. Consulte Filtragem automática para mais informações sobre os filtros de resultados da pesquisa do Google. Os valores válidos para esse parâmetro são:

  • 0: desativado

  • 1: ativado (padrão)

Observação: por padrão, o Google aplica filtros a todos os resultados da pesquisa para melhorar a qualidade deles.

queries.nextPage[].gl

string

Otimiza os resultados da pesquisa cujo país de origem corresponde ao valor do parâmetro. Consulte uma lista de valores válidos em Códigos de países.

A especificação de um valor de parâmetro gl nas solicitações do WebSearch melhora a relevância dos resultados. Isso se aplica especialmente a clientes internacionais e, de maneira ainda mais específica, aos clientes de países que não falam inglês.

queries.nextPage[].cr

string

Restringe os resultados da pesquisa a documentos originários de um país específico. Você pode usar operadores booleanos no valor do parâmetro cr.

O Google WebSearch determina o país de um documento analisando o seguinte:

  • O domínio de nível superior (TLD) do URL do documento.

  • A localização geográfica do endereço IP do servidor da Web.

Consulte Valores de parâmetro de país (cr) para ver uma lista de valores válidos para esse parâmetro.

queries.nextPage[].googleHost

string

Especifica o domínio do Google (por exemplo, google.com, google.de ou google.fr) ao qual a pesquisa deve ser limitada.

queries.nextPage[].disableCnTwTranslation

string

Ativa ou desativa o recurso Pesquisa em chinês simplificado e tradicional.

Os valores compatíveis são:

  • 0: ativada (padrão)

  • 1: desativada

queries.nextPage[].hq

string

Anexa os termos de consulta especificados à consulta, como se eles fossem combinados com um operador lógico AND.

queries.nextPage[].hl

string

Especifica o idioma (idioma do host) da interface do usuário. Definir explicitamente esse parâmetro melhora o desempenho e a qualidade dos resultados da pesquisa.

Consulte a seção Idiomas de interface de Internacionalização de consultas e apresentação de resultados para mais informações e a seção Idiomas de interface compatíveis para uma lista de idiomas compatíveis.

queries.nextPage[].siteSearch

string

Restringe os resultados a URLs de um site especificado.

queries.nextPage[].siteSearchFilter

string

Especifica se é necessário incluir ou excluir resultados do site nomeado no parâmetro sitesearch. Os valores compatíveis são:

  • i: inclui conteúdo do site

  • e: excluir conteúdo do site

queries.nextPage[].exactTerms

string

Identifica uma frase que todos os documentos nos resultados da pesquisa precisam conter.

queries.nextPage[].excludeTerms

string

Identifica uma palavra ou frase que não deve aparecer em nenhum documento nos resultados da pesquisa.

queries.nextPage[].linkSite

string

Especifica que todos os resultados devem conter um link para um URL específico.

queries.nextPage[].orTerms

string

Fornece termos de pesquisa adicionais a serem verificados em um documento, em que cada documento nos resultados da pesquisa precisa conter pelo menos um dos termos de pesquisa adicionais. Você também pode usar o termo de consulta OU booleano para esse tipo de consulta.

queries.nextPage[].relatedSite

string

Especifica que todos os resultados da pesquisa precisam ser páginas relacionadas ao URL especificado. O valor do parâmetro deve ser um URL.

queries.nextPage[].dateRestrict

string

Restringe os resultados a URLs com base na data. Os valores aceitos são:

  • d[number]: solicita resultados do número especificado de dias anteriores.

  • w[number]: solicita resultados do número especificado de semanas anteriores.

  • m[number]: solicita resultados do número especificado de meses anteriores.

  • y[number]: solicita resultados do número especificado de anos anteriores.

queries.nextPage[].lowRange

string

Especifica o valor inicial de um intervalo de pesquisa. Use cse:lowRange e cse:highrange para anexar um intervalo de pesquisa inclusivo de lowRange...highRange à consulta.

queries.nextPage[].highRange

string

Especifica o valor final de um intervalo de pesquisa. Use cse:lowRange e cse:highrange para anexar um intervalo de pesquisa inclusivo de lowRange...highRange à consulta.

queries.nextPage[].fileType

string

Restringe os resultados a arquivos de uma extensão especificada. Os tipos de arquivo aceitos pelo Google incluem:

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

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato Rich Text (rtf)

  • Flash de onda de choque (swf)

  • Texto (ans, txt).

Outros tipos de arquivo podem ser adicionados no futuro. Encontre uma lista atualizada nas perguntas frequentes sobre tipos de arquivos do Google.

queries.nextPage[].rights

string

Filtros com base no licenciamento. Os valores aceitos são:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

Os valores permitidos são web ou image. Se não for especificado, os resultados ficarão limitados a páginas da Web.

queries.nextPage[].imgSize

string

Restringe os resultados a imagens de um tamanho especificado. Os valores compatíveis são:

  • icon (pequena)

  • small | medium | large | xlarge (médio)

  • xxlarge (grande)

  • huge (extra grande)

queries.nextPage[].imgType

string

Restringe os resultados a imagens de um tipo especificado. Os valores compatíveis são:

  • clipart (Clip art)

  • face (rosto)

  • lineart (Desenho linear)

  • photo (foto)

  • animated (animado)

  • stock (Ações)

queries.nextPage[].imgColorType

string

Restringe os resultados a imagens de um tipo de cor especificado. Os valores aceitos são:

  • mono (preto e branco)

  • gray (escala de cinza)

  • color (cor)

queries.nextPage[].imgDominantColor

string

Restringe os resultados a imagens com uma cor dominante específica. Os valores compatíveis são:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

O conjunto de promoções. Presente apenas se os arquivos de configuração do mecanismo de pesquisa personalizado definirem promoções para a consulta em questão.

context

object (Struct format)

Metadados e refinamentos associados ao mecanismo de pesquisa especificado, incluindo:

  • O nome do mecanismo de pesquisa usado para a consulta.

  • Um conjunto de objetos de atributos (refinamentos) que podem ser usados para refinar uma pesquisa.

searchInformation

object

Metadados sobre essa pesquisa, incluindo o tempo da pesquisa e o total de resultados.

searchInformation.searchTime

number

O tempo que o servidor levou para retornar os resultados da pesquisa.

searchInformation.formattedSearchTime

string

O tempo que o servidor leva para retornar resultados da pesquisa, formatado de acordo com o estilo da localidade.

searchInformation.totalResults

string

O número total de resultados da pesquisa retornados pela consulta.

searchInformation.formattedTotalResults

string

O número total de resultados da pesquisa, formatados de acordo com o estilo da localidade.

spelling

object

Encapsula uma consulta corrigida.

spelling.correctedQuery

string

A consulta corrigida.

spelling.htmlCorrectedQuery

string

A consulta corrigida, formatada em HTML.

items[]

object (Result)

O conjunto atual de resultados de pesquisa personalizados.

Promoção

Resultado da promoção.

Representação 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

O título da promoção.

htmlTitle

string

Título da promoção, em HTML.

bodyLines[]

object

Uma matriz de objetos em bloco para esta promoção.

bodyLines[].title

string

O texto do objeto em bloco, se houver texto.

bodyLines[].htmlTitle

string

O texto do objeto em bloco em HTML, se houver texto.

bodyLines[].url

string

O URL do link do objeto em bloco, se houver.

bodyLines[].link

string

O texto âncora do link do objeto em bloco, se houver um link.

image

object

Imagem associada a esta promoção, se houver.

image.source

string

URL da imagem desse link da promoção.

image.width

integer

Largura da imagem em pixels.

image.height

integer

Altura da imagem em pixels.

Resultado

Um resultado de pesquisa personalizado.

Representação 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

O identificador exclusivo para o tipo de objeto atual. Para esta API, é customsearch#result..

title

string

O título do resultado de pesquisa, em texto sem formatação.

htmlTitle

string

O título do resultado de pesquisa, em HTML.

snippet

string

O snippet do resultado de pesquisa, em texto sem formatação.

htmlSnippet

string

O snippet do resultado de pesquisa, em HTML.

cacheId

string

Indica o ID da versão em cache do Google do resultado da pesquisa.

formattedUrl

string

O URL exibido após o snippet de cada resultado de pesquisa.

htmlFormattedUrl

string

O URL formatado em HTML exibido após o snippet de cada resultado de pesquisa.

pagemap

object (Struct format)

Contém informações de PageMap para o resultado da pesquisa.

mime

string

O tipo MIME do resultado da pesquisa.

fileFormat

string

O formato do arquivo do resultado da pesquisa.

image

object

Encapsula todas as informações sobre uma imagem retornada nos resultados da pesquisa.

image.contextLink

string

Um URL que aponta para a página da Web que hospeda a imagem.

image.height

integer

A altura da imagem em pixels.

image.width

integer

A largura da imagem em pixels.

image.byteSize

integer

O tamanho da imagem em bytes.

image.thumbnailLink

string

Um URL para a imagem em miniatura.

image.thumbnailHeight

integer

A altura da imagem em miniatura, em pixels.

image.thumbnailWidth

integer

A largura da imagem em miniatura, em pixels.

labels[]

object

Encapsula todas as informações sobre marcadores de refinamento.

labels[].name

string

O nome de um marcador de refinamento, que pode ser usado para refinar pesquisas. Não exiba isso na interface do usuário. Em vez disso, use displayName.

labels[].displayName

string

O nome de exibição de um rótulo de refinamento. Esse é o nome que deve ser exibido na interface do usuário.

labels[].label_with_op

string

Rótulo de refinamento e a operação de refinamento associada.