Referência da API XML

Esta página se refere à versão XML da API JSON da Pesquisa personalizada, que está disponível apenas para Clientes do Google Site Search.

1. Visão geral
2. Formato de solicitação do Mecanismo de Pesquisa Programável
   1. Informações gerais da solicitação
   2. Termos de consulta
   3. Parâmetros de solicitação
      1. Exemplos de consultas do WebSearch
      2. Definições de parâmetros de consulta do WebSearch
      3. Pesquisa avançada
      4. Parâmetros de consulta de pesquisa avançada
      5. Termos de consulta especiais
      6. Exemplos de consultas de imagem
      7. Parâmetros de consulta da pesquisa de imagens
      8. Limites de solicitação
   4. Apresentação de internacionalização de consultas e resultados
      1. Codificação de caracteres
      2. Idiomas de interface
      3. Pesquisa em chinês simplificado e tradicional
   5. Como filtrar resultados
      1. Filtragem automática de resultados da pesquisa
      2. Filtragem de idioma e país
      3. Filtrar conteúdo adulto com o SafeSearch
3. Resultados em XML
   1. DTD de resultados XML do Google
   2. Sobre a resposta XML
   3. Resultados em XML para padrão, imagem e Consultas de pesquisa avançadas
      1. Pesquisa regular/avançada: exemplo de consulta e resultado em XML
      2. Pesquisa regular/avançada: tags XML
      3. Resultados em XML para consultas de pesquisa de imagens
      4. Pesquisa de imagem: exemplo de consulta e resultado de XML
      5. Pesquisa de imagens: tags XML

Visão geral

O serviço Google WebSearch ativa o Google Site Search para que os clientes exibam os resultados da pesquisa do Google em seus próprios sites. A O serviço WebSearch usa um protocolo baseado em HTTP simples para exibir pesquisas resultados. Os administradores de pesquisa têm controle total sobre a forma solicitar resultados de pesquisa e a forma como eles apresentam esses resultados ao para o usuário final. Este documento descreve os detalhes técnicos do projeto do solicitações de pesquisa e formatos de resultados.

Para recuperar os resultados do Google WebSearch, seu aplicativo envia ao Google uma solicitação HTTP simples. O Google retorna os resultados da pesquisa em XML . Os resultados formatados em XML permitem personalizar a forma como os resultados da pesquisa são exibidos.

Formato de solicitação do WebSearch

• Solicitar Visão geral
• Termos de consulta
• Parâmetros de solicitação
• Exemplos de consultas do WebSearch
• Consulta na WebSearch Definições dos parâmetros
• Exemplos de consultas de imagem
• Consulta de pesquisa de imagem Definições dos parâmetros
• Pesquisa avançada
  
• Pesquisa avançada Parâmetros de consulta
• Termos de consulta especiais
• Limites de solicitação

Visão geral da solicitação

A solicitação de pesquisa do Google é um comando HTTP GET padrão. Ela inclui um conjunto de parâmetros relevantes para sua consultas. Esses parâmetros são incluídos no URL da solicitação como name=value separados por caracteres "e" comercial (&). Os parâmetros incluem como a consulta de pesquisa e um ID de mecanismo exclusivo (cx) que identifica o que faz a solicitação HTTP. O serviço WebSearch ou Pesquisa de imagens retorna Resultados XML em resposta às suas solicitações HTTP.

Termos de consulta

A maioria das solicitações de pesquisa inclui um ou mais termos de consulta. Um termo de consulta aparece como o valor de um parâmetro na solicitação de pesquisa.

Os termos de consulta podem especificar vários tipos de informações a serem filtradas e organizar os resultados da pesquisa retornados pelo Google. As consultas podem especificar:

• Palavras ou frases que devem ser incluídas ou excluir
  • Todas as palavras em uma consulta de pesquisa (padrão)
  • Uma frase exata na consulta de pesquisa
  • Qualquer palavra ou frase em uma consulta de pesquisa
• Em que parte do documento procurar as termos de pesquisa
  • Em qualquer parte do documento (padrão)
  • Somente no corpo do documento
  • Apenas no título do documento
  • Somente no URL do documento
  • Apenas nos links do documento
• Restrições nos próprios documentos
  • Inclusão ou exclusão de documentos de tipos de arquivo específicos (como arquivos PDF ou documentos do Word)
• Consultas de URL especiais que retornam informações sobre um determinado URL, em vez de fazer uma pesquisa
  • Consultas que retornam informações gerais sobre um URL, como sua categoria, snippet ou idioma do Open Directory
  • Consultas que retornam o conjunto de páginas da Web que estão vinculadas a um URL
  • Consultas que retornam um conjunto de páginas da Web semelhantes a um determinado URL

Pesquisa padrão

Os valores de parâmetro de consulta de pesquisa devem ter escape de URL. Observe que você substituiu o sinal de adição ("+") por qualquer sequência de espaço em branco na a consulta de pesquisa. Isso é discutido em mais detalhes na seção Escape de URL deste documento.

O termo da consulta de pesquisa é enviado ao serviço WebSearch usando o parâmetro q. Um exemplo de termo de consulta de pesquisa é:

q=horses+cows+pigs

Por padrão, o serviço Google WebSearch retorna apenas documentos que inclua todos os termos na consulta de pesquisa.

Parâmetros de solicitação

Esta seção lista os parâmetros que você pode usar ao fazer uma solicitação de pesquisa. Os parâmetros são divididos em duas listas. A primeira lista contém parâmetros relevantes para todas as solicitações de pesquisa. A segunda lista contém parâmetros que são relevante apenas para solicitações de pesquisa avançada.

Três parâmetros de solicitação são obrigatórios:

• O parâmetro client precisa ser definido como google-csbe.
• O parâmetro output especifica o formato dos resultados XML retornados; resultados podem ser retornados com (xml) ou sem (xml_no_dtd) uma referência à DTD do Google. Recomendamos definindo esse valor como xml_no_dtd. Observação: se você não especificar esse parâmetro, os resultados serão retornados em HTML em vez de XML.
  
• O parâmetro cx que representa o parâmetro ID do mecanismo.
  

Os parâmetros de solicitação mais usados além dos mencionadas acima são:

• num: o número solicitado de resultados da pesquisa
• q: os termos de pesquisa
• start: o índice inicial dos resultados

Exemplos de consultas do WebSearch

Os exemplos abaixo mostram algumas solicitações HTTP do WebSearch para ilustrar como diferentes parâmetros de consulta são usados. Definições para o diferentes parâmetros de consulta são fornecidos no campo Consulta da pesquisa na Web Definições de parâmetros e a Consulta de pesquisa avançada Parâmetros deste documento.

Esta solicitação pede os 10 primeiros resultados (start=0&num=10) para o termo de consulta "red sox" q=red+sox). A consulta também especifica que os resultados devem vir de sites do Canadá (cr=countryCA) e precisam ser escritas em francês (lr=lang_fr). Por fim, a consulta especifica valores para o cliente, a saída e cx, todos os três obrigatórios.

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

Este exemplo usa algumas das consultas de pesquisa avançada parâmetros para personalizar ainda mais a consulta de pesquisa. Essa solicitação usa o argumento as_q (as_q=red+sox) em vez do parâmetro q. Ele também usa o o parâmetro as_eq para excluir qualquer documento que contenha a palavra "Yankees" do resultados da pesquisa (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  

Definições de parâmetros de consulta do WebSearch

    <!DOCTYPE GSP SYSTEM "google.dtd">

Pesquisa avançada

Os parâmetros de consulta adicionais listados abaixo da imagem são relevantes para consultas de pesquisa avançadas. Quando você envia uma pesquisa avançada, os valores de vários parâmetros (por exemplo, as_eq, as_epq, as_oq etc.) são considerados na consulta. para a pesquisa. A imagem mostra a página de pesquisa avançada do Google. Na imagem, o nome de cada parâmetro de pesquisa avançada é escrito em texto vermelho dentro ou ao lado de o campo na página a que o parâmetro corresponde.

Parâmetros de consulta de pesquisa avançada

Termos de consulta especiais

O Google WebSearch permite o uso de vários termos de consulta especiais que acessar recursos adicionais do mecanismo de pesquisa do Google. Esses termos de consulta especiais devem ser incluídos no valor do parâmetro de solicitação q. Como outros termos de consulta, o termos de consulta especiais precisam ter escape de URL. Um o número de termos da consulta especial contém dois pontos (:). Este caractere também precisa ter escape de URL. o valor de escape do URL é %3A.

Exemplos de consultas de imagem

Os exemplos abaixo mostram algumas solicitações HTTP de imagem para ilustrar como diferentes parâmetros de consulta são usados. As definições dos diferentes parâmetros de consulta são fornecidas nas seções "Definições dos parâmetros de consulta de imagens" deste documento.

Esta solicitação pede os cinco primeiros resultados (start=0&num=5) para o termo de consulta "macaco" (q=monkey), do tipo .png. Por fim, a consulta especifica valores para os parâmetros client, output e cx, todos os três obrigatórios.

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 consulta da pesquisa de imagens

Limites de solicitação

A tabela abaixo lista as limitações nas solicitações de pesquisa que você enviar para o Google:

Internacionalização de consultas e apresentação de resultados

O serviço Google WebSearch permite pesquisar documentos no vários idiomas. Você pode especificar a codificação de caracteres que deve ser usado para interpretar sua solicitação HTTP e codificar sua resposta XML (usando as pesquisas ie e oe ). Também é possível filtrar os resultados para incluir apenas documentos escritos em determinadas linguagens.

As seções a seguir discutem questões relacionadas à pesquisa em vários idiomas:

• Personagem Codificação
• Idiomas de interface
• Chinês simplificado e tradicional Pesquisa

Codificação de caracteres

Os servidores enviam dados, como páginas da Web, para user agents, como navegadores, como uma sequência de bytes codificados. Em seguida, o user agent decodifica os bytes em uma sequência de caracteres. Ao enviar solicitações ao serviço WebSearch, é possível especificar os esquemas de codificação para os consulta de pesquisa e para a resposta XML recebida.

Você pode usar o parâmetro de solicitação ie para especificar o mecanismo de codificação para os caracteres em sua solicitação HTTP. Você pode use também o parâmetro oe para especificar a codificação que o Google deve usar para codificar sua resposta XML. Se você for usando um esquema de codificação diferente de ISO-8859-1 (ou latin1), especifique os valores corretos para os parâmetros ie e oe.

Observação: se você estiver oferecendo funcionalidade de pesquisa para vários idiomas, recomendamos o uso do valor de codificação utf8 (UTF-8) para os parâmetros ie e oe.

Consulte a seção Esquemas de codificação para obter uma lista completa dos valores que que você pode usar para os parâmetros ie e oe.

Para mais informações gerais sobre codificação de caracteres, consulte http://www.w3.org/TR/REC-html40/charset.html.

Idiomas da interface

É possível usar o parâmetro de solicitação hl para identificar o idioma de sua interface gráfica. O valor do parâmetro hl pode afetar os resultados da pesquisa XML, especialmente em consultas internacionais quando a restrição de idioma (usando o parâmetro lr) não é explicitamente especificada. Dessa forma, casos, o parâmetro hl poderá promover os resultados da pesquisa no mesmo idioma de entrada do usuário.

Sugerimos que você defina explicitamente o parâmetro hl nos resultados da pesquisa para que o Google selecione resultados de pesquisa para cada consulta.

Consulte a interface compatível Idiomas para uma lista completa de valores válidos para o parâmetro hl.

Pesquisar documentos escritos em idiomas específicos

É possível usar o parâmetro de solicitação lr para restringir os resultados da pesquisa a documentos escritos em um determinado idioma ou conjunto de idiomas.

O parâmetro lr é compatível com operadores booleanos para permitir que você especifique vários idiomas que devem ser incluídos (ou excluídos) da pesquisa resultados.

Os exemplos a seguir mostram como usar operadores booleanos para solicitar documentos em idiomas diferentes.

Para documentos escritos em japonês:

lr=lang_jp

Para documentos escritos em italiano ou alemão:

lr=lang_it|lang_de

Para documentos não escritos em húngaro ou tcheco:

lr=(-lang_hu).(-lang_cs)

Consulte a Coleção de idiomas Seção "Valores" para ver uma lista completa dos valores possíveis do parâmetro lr e da função Booleana Operadores para uma discussão completa sobre o uso desses operadores. operadores.

Pesquisa em chinês simplificado e tradicional

Chinês simplificado e chinês tradicional são duas variantes de escrita do idioma chinês. O mesmo conceito pode ser escrito de forma diferente para cada variante. Dada uma consulta em uma das variantes, o serviço O serviço WebSearch pode retornar resultados que incluam páginas tanto variantes.

Para usar esse recurso:

1. Defina o parâmetro de solicitação c2coff como 0
   . e
2. Realize uma das seguintes ações:
   • Não defina o parâmetro de solicitação lr
     ou
   • Defina o parâmetro de solicitação lr como lr=lang_zh-TW|lang_zh-CN

O exemplo a seguir mostra os parâmetros de consulta que você incluiria em uma solicitação de resultados em chinês simplificado e tradicional. Informações adicionais obrigatórias, como como o cliente, não está incluído no exemplo.

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Como filtrar resultados

O Google WebSearch oferece várias maneiras de filtrar sua pesquisa resultados:

• Automático Filtragem de resultados da pesquisa
• Filtragem de idioma e país
• Filtrar conteúdo adulto com SafeSearch

Filtragem automática de resultados da pesquisa

Em um esforço para fornecer os melhores resultados de pesquisa possíveis, o Google usa duas técnicas para filtrar automaticamente os resultados da pesquisa que não geralmente considerados indesejáveis:

• Conteúdo duplicado: se vários documentos contiverem o mesmas informações, apenas o documento mais relevante desse conjunto incluídos nos resultados da pesquisa.

• Agrupamento de hosts: se houver muitos resultados de pesquisa do mesmo site, o Google pode não mostrar todos os resultados desse site ou mostrar os resultados mais baixos em
  a classificação do que de outra forma.

Recomendamos deixar esses filtros ativados para solicitações de pesquisa comuns porque os filtros melhoram significativamente a qualidade da maioria resultados. No entanto, você pode ignorar esses filtros automáticos definindo o parâmetro de consulta filter como 0 no solicitação de pesquisa.

Filtragem de idioma e país

O serviço Google WebSearch retorna resultados de um índice mestre de todos os documentos da Web. O índice mestre contém subcoleções de documentos agrupados por atributos específicos, incluindo idiomas e país de origem.

É possível usar os parâmetros de solicitação lr e cr para restringir os resultados da pesquisa às subcoleções de documentos escritos em idiomas específicos ou originados países específicos, respectivamente.

O Google WebSearch determina o idioma de um documento analisando o seguinte:

• o domínio de nível superior (TLD) do URL do documento
• meta tags de idioma no documento
• o idioma principal usado no corpo do documento

Consulte também a definição do parâmetro lr, a seção sobre Como pesquisar Documentos escritos em idiomas específicos e os valores da coleção de idiomas que podem ser usada como valores para o parâmetro lr para mais informações sobre como restringir resultados com base no idioma.

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

• 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 também a definição do parâmetro cr e a Coleção de países Valores que podem ser usados como valores do parâmetro cr para mais informações sobre como restringir os resultados por país de origem.

Observação:você pode combinar idiomas e valores de países para personalizar seus resultados de pesquisa. Para por exemplo, é possível solicitar documentos escritos em francês e vêm da França ou do Canadá, ou você pode solicitar documentos que venham da Holanda e não estão em inglês. Os parâmetros lr e cr aceitam operadores booleanos.

Filtrar conteúdo adulto com o SafeSearch

Muitos clientes do Google não querem exibir os resultados da pesquisa para locais com conteúdo adulto. Com o filtro SafeSearch, você pode filtrar para resultados de pesquisa com conteúdo adulto e eliminá-los. Os filtros do Google utilizam tecnologia reservada para verificar palavras-chave, frases e URLs. Embora nenhum filtro seja 100% preciso, o SafeSearch remova a esmagadora maioria de conteúdo adulto da sua pesquisa resultados.

O Google se esforça para manter o SafeSearch tão atual e abrangente quanto sempre que possível rastreando continuamente a Web e incorporando atualizações com base nas sugestões dos usuários.

O SafeSearch está disponível nos seguintes idiomas:

Você pode ajustar o grau em que o Google filtra seus resultados conteúdo adulto usando o parâmetro de consulta safe. A tabela a seguir explica as configurações do SafeSearch do Google e como elas de pesquisa afetam os resultados da pesquisa:

Se o SafeSearch estiver ativado e você encontrar sites que contenham conteúdo ofensivo em seus resultados, envie o URL do site para safesearch@google.com e nós investigará o site.

Resultados XML

• XML do Google DTD de resultados
• Sobre a resposta XML
• XML Resultados para consultas de pesquisa regulares e avançadas
• Pesquisa regular/avançada: exemplo de consulta e resultado de XML
• Pesquisa regular/avançada: tags XML

DTD de resultados XML do Google

O Google usa o mesmo DTD para descrever o formato XML para todos os tipos de resultados da pesquisa. Muitas tags e atributos são aplicáveis a todos tipos de pesquisa. Algumas tags, no entanto, são aplicáveis somente tipos de pesquisa. Consequentemente, as definições na DTD podem ser menos restritivas do que as definições fornecidas neste documento.

Este documento descreve os aspectos da DTD que são relevantes para o WebSearch. Quando você olha para o DTD, se está trabalhando WebSearch, é possível ignorar com segurança as tags e os atributos que não são estão documentados aqui. Se a definição for diferente entre o DTD e o documentação, esse fato é observado neste documento.

O Google pode retornar resultados XML com ou sem referência a o DTD mais recente. O DTD é um guia para ajudar os administradores de pesquisa e os analisadores de XML entendem os resultados de XML do Google. Como o XML do Google a gramática pode mudar de tempos em tempos, você não deve configurar seus para usar o DTD para validar cada resultado XML.

Além disso, você não deve configurar seu analisador XML para buscar o DTD sempre que você enviar uma solicitação de pesquisa. O Google atualiza o DTD com pouca frequência, e essas solicitações criam atrasos e larguras de banda desnecessários e cumprimento de requisitos regulatórios.

O Google recomenda que você use o formato de saída xml_no_dtd para receber resultados em XML. Se você especificar o formato xml output em sua solicitação de pesquisa, a única diferença é a inclusão da linha a seguir nos resultados XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Você pode acessar o DTD mais recente em http://www.google.com/google.dtd.

Nem todos os recursos da DTD podem estar disponíveis ou ser compatíveis no momento.

Sobre a resposta XML

• Todos os valores de elementos são HTML válidos e adequados para exibição, a menos que observado nas definições de tags XML.
• Alguns valores de elementos são URLs que precisam ser codificados em HTML antes em que eles são exibidos.
• Seu analisador XML deve ignorar tags e atributos não documentados. Isso permite que o aplicativo continue funcionando sem modificação se o Google adicionar mais recursos à saída XML.
• Certos caracteres devem ter códigos de escape quando incluídos como valores no Tags XML. Seu processador XML deve converter essas entidades de volta para o formato os caracteres apropriados. Se você não converter entidades corretamente, o navegador pode, por exemplo, renderizar o & como "&". O XML Standard documenta esses caracteres. esses caracteres são reproduzidas na tabela abaixo:

  Caractere	Formas de escape	Entidade	Código de caracteres
  E comercial	&	&	&
  Aspas simples	'	'	'
  Aspas duplas	"	"	"
  Maior que	>	>	>
  Menor que	<	&lt;	&#60;

Resultados XML para consultas de pesquisa regulares e avançadas

Pesquisa regular/avançada: exemplo de consulta e resultado XML

Este exemplo de solicitação do WebSearch pede 10 resultados (num=10) sobre o termo de pesquisa "futebol" (q=socer), que é a palavra "futebol" intencionalmente escritos de maneira errada para este exemplo.)

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i 

Essa solicitação gera o resultado XML abaixo. Observe que há vários comentários no resultado XML para indicar onde algumas tags não incluídos no resultado serão exibidos.

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

Pesquisa regular/avançada: tags XML

Respostas XML para solicitações de pesquisa regulares e pesquisa avançada as solicitações usam o mesmo conjunto de tags XML. Essas tags XML são mostradas o exemplo de XML acima e explicado nas tabelas abaixo.

As tags XML abaixo estão listadas em ordem alfabética por nome, e cada definição de tag contém uma descrição da tag, um exemplo que mostra como a tag apareceria em um resultado XML e o formato do conteúdo. Se a tag for uma subtag de outra tag XML ou se ela tiver subtags ou atributos próprios, essas informações também são fornecidas em tabela de definição da tag.

Alguns símbolos podem ser exibidos ao lado de algumas subtags na de definições abaixo. Esses símbolos e seus significados são:

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

Resultados XML para consultas de pesquisa de imagens

Esse exemplo de solicitação de imagem pede cinco resultados (num=5) sobre o termo de pesquisa "macaco" (q=macaco).

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Essa solicitação gera o resultado XML abaixo.

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

Pesquisa de imagens: tags XML

A tabela abaixo mostra outras tags XML usadas em respostas XML para consultas de pesquisa de imagens.

Alguns símbolos podem ser exibidos ao lado de algumas subtags na de definições abaixo. Esses símbolos e seus significados são: