Documentation de référence de l'API XML

Cette page fait référence à la version XML de l'API JSON Custom Search, qui n'est disponible que pour les utilisateurs Clients Google Site Search.

1. Présentation
2. Format de requête Programmable Search Engine <ph type="x-smartling-placeholder">
   </ph>
   1. Présentation de la demande
   2. Termes de requête
   3. Paramètres de requête <ph type="x-smartling-placeholder">
      </ph>
      1. Exemples de requêtes WebSearch
      2. Définition des paramètres de requête WebSearch
      3. Recherche avancée
      4. Paramètres de requête de recherche avancée
      5. Termes de requête spéciaux
      6. Exemples de requêtes d'images
      7. Paramètres de requête de recherche d'images
      8. Limites de requêtes
   4. Internationalisation des requêtes et de la présentation des résultats <ph type="x-smartling-placeholder">
      </ph>
      1. Encodage des caractères
      2. Langues de l'interface
      3. Recherche en chinois simplifié et traditionnel
   5. Filtrer les résultats <ph type="x-smartling-placeholder">
      </ph>
      1. Filtrage automatique des résultats de recherche
      2. Filtrage par langue et par pays
      3. Filtrer le contenu réservé aux adultes avec SafeSearch
3. Résultats XML <ph type="x-smartling-placeholder">
   </ph>
   1. Version DTD des résultats XML Google
   2. À propos de la réponse XML
   3. Résultats XML pour Normal, Image et Requêtes de recherche avancée <ph type="x-smartling-placeholder">
      </ph>
      1. Recherche standard/avancée: exemple de requête et de résultat XML
      2. Recherche standard/avancée: balises XML
      3. Résultats XML pour les requêtes de recherche d'images
      4. Recherche d'images: exemple de requête et de résultat XML
      5. Recherche d'images: tags XML

Présentation

Le service Google WebSearch active Google Site Search d'afficher les résultats de recherche Google sur leurs propres sites Web. La Le service WebSearch utilise un protocole simple basé sur HTTP pour traiter les recherches résultats. Les administrateurs de la recherche ont un contrôle total sur la façon dont ils les résultats de recherche et la façon dont ils les présentent un utilisateur final. Ce document décrit les caractéristiques techniques du de requêtes de recherche et de résultats.

Pour récupérer les résultats Google WebSearch, votre application envoie une requête HTTP simple à Google. Google renvoie ensuite les résultats de la recherche au format XML. . Les résultats au format XML vous permettent de personnaliser la façon dont les résultats de recherche s'affichent.

Format de requête WebSearch

• Demander Présentation
• Termes de requête
• Paramètres de requête
• Exemples de requêtes WebSearch
• Requête WebSearch Définition des paramètres
• Exemples de requêtes d'images
• Requête de recherche d'images Définition des paramètres
• Recherche avancée
  
• Recherche avancée Paramètres de requête
• Termes de requête spéciaux
• Limites de requêtes

Présentation de la demande

La requête de recherche Google est une commande HTTP GET standard. Il comprend un ensemble de paramètres pertinents requêtes. Ces paramètres sont inclus dans l'URL de la requête sous la forme name=value. paires séparées par une esperluette (&). Les paramètres sont les suivants : comme la requête de recherche et un identifiant de moteur unique (cx) qui effectue la requête HTTP. Le service WebSearch ou Recherche d'images renvoie Le format XML répond à vos requêtes HTTP.

Termes de requête

La plupart des requêtes de recherche incluent un ou plusieurs termes. Un terme de requête apparaît comme valeur d'un paramètre dans la requête de recherche.

Les termes de requête peuvent spécifier plusieurs types d'informations à filtrer et organiser les résultats de recherche renvoyés par Google. Les requêtes peuvent spécifier:

• Mots ou expressions à inclure ou exclure <ph type="x-smartling-placeholder">
  </ph>
  • Tous les mots d'une requête de recherche (par défaut)
  • Expression exacte dans la requête de recherche
  • Tout mot ou toute expression dans une requête de recherche
• l'emplacement où se trouve le document termes de recherche <ph type="x-smartling-placeholder">
  </ph>
  • N'importe où dans le document (par défaut)
  • Uniquement dans le corps du document
  • Uniquement dans le titre du document
  • Uniquement dans l'URL du document
  • Uniquement dans les liens du document
• Restrictions relatives aux documents eux-mêmes <ph type="x-smartling-placeholder">
  </ph>
  • Inclure ou exclure des documents de types de fichiers spécifiques (fichiers PDF ou documents Word, par exemple)
• Les requêtes d'URL spéciales qui renvoient des informations sur une URL donnée, plutôt que d'effectuer une recherche <ph type="x-smartling-placeholder">
  </ph>
  • Les requêtes qui renvoient des informations générales sur une URL, telles que sa catégorie, son extrait ou sa langue Open Directory
  • Requêtes qui renvoient l'ensemble de pages Web qui renvoient à une URL
  • Requêtes qui renvoient un ensemble de pages Web similaires à une URL donnée

Recherche par défaut

Les valeurs des paramètres de requête de recherche doivent être échappées au format URL. Notez que vous devez remplace le signe plus ("+") par toute séquence d'espaces blancs dans la requête de recherche. Ce point est abordé plus en détail à la section Échappement d'URL de ce document.

Le terme de la requête de recherche est envoyé au service WebSearch à l'aide de le paramètre q ; A exemple de terme de requête de recherche est:

q=horses+cows+pigs

Par défaut, le service Google WebSearch n'affiche que les documents inclut tous les termes de la requête de recherche.

Paramètres des requêtes

Cette section liste les paramètres que vous pouvez utiliser lorsque vous créez requête de recherche. Les paramètres sont divisés en deux listes. La première liste contient les paramètres pertinents pour toutes les requêtes de recherche. La deuxième liste contient les paramètres qui sont pertinentes uniquement pour les requêtes de recherche avancée.

Trois paramètres de requête sont obligatoires:

• Le paramètre client doit être défini sur google-csbe.
• Le paramètre output spécifie le format des résultats XML renvoyés ; les résultats peuvent être renvoyés avec (xml) ou sans (xml_no_dtd) de référence à la DTD de Google. Nous vous recommandons en définissant cette valeur sur xml_no_dtd. Remarque:Si vous ne spécifiez pas ce paramètre, les résultats sont renvoyés au format HTML au lieu de XML.
  
• Le paramètre cx, qui représente l'unique ID du moteur.
  

Les paramètres de requête les plus couramment utilisés autres que ceux mentionnés ci-dessus sont:

• num : nombre de résultats de recherche demandés.
• q : les termes de recherche.
• start : index de départ des résultats.

Exemples de requêtes WebSearch

Les exemples ci-dessous présentent deux requêtes HTTP WebSearch envoyées à illustrer comment les différents paramètres de requête sont utilisés. Définitions paramètres de requête différents sont fournis dans la requête WebSearch Définition des paramètres et Requête de recherche avancée Paramètres de ce document.

Cette requête demande les 10 premiers résultats (start=0&num=10) pour le terme de requête "red sox" (q=red+sox). La requête a également indique que les résultats doivent provenir de sites Web canadiens (cr=countryCA) et doit être rédigé en français (lr=lang_fr). Enfin, la requête spécifie des valeurs pour le client, la sortie, et cx, qui sont tous les trois obligatoires.

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

Cet exemple s'appuie sur certaines des requêtes de recherche avancée pour personnaliser davantage la requête de recherche. Cette requête utilise l'opérateur as_q (as_q=red+sox) au lieu du paramètre q. Elle utilise également le as_eq pour exclure tous les documents contenant le mot "Yankees". à partir de résultats de recherche (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  

Définitions des paramètres de requête WebSearch

    <!DOCTYPE GSP SYSTEM "google.dtd">

Recherche avancée

Les paramètres de requête supplémentaires répertoriés sous l'image sont pertinents pour les requêtes de recherche avancée. Lorsque vous effectuez une recherche avancée, les valeurs de plusieurs paramètres (par exemple, as_eq, as_epq, as_oq, etc.) sont tous pris en compte dans la requête pour cette recherche. L'image montre la page de recherche avancée de Google. Sur l'image, le nom de chaque le paramètre de recherche avancée est écrit en rouge à l'intérieur ou à côté de le champ de la page auquel ce paramètre correspond.

Paramètres de requête de recherche avancée

Termes de requête spéciaux

Google WebSearch permet d'utiliser plusieurs termes de requête spéciaux qui accéder aux fonctionnalités supplémentaires du moteur de recherche Google ; Ces Des termes de requête spéciaux doivent être inclus dans la valeur du paramètre de requête q. Comme d'autres termes de requête, le les termes de requête spéciaux doivent être avec échappement via une URL. A le nombre de termes de requête spéciaux contient le signe deux-points (:). Ce personnage doit également comporter une séquence d'échappement d'URL. sa valeur avec échappement dans l'URL est %3A.

Exemples de requêtes d'images

Les exemples ci-dessous présentent quelques requêtes HTTP d'image pour illustrer la façon dont les différents paramètres de requête sont utilisés. Les définitions des différents paramètres de requête sont fournies dans la section Définitions des paramètres de requête d'image de ce document.

Cette requête demande les cinq premiers résultats (start=0&num=5) pour le terme de requête "singe" (q=monkey), de type .png. Enfin, la requête spécifie des valeurs pour les paramètres client, output et cx, qui sont tous les trois obligatoires.

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

Paramètres de requête de recherche d'images

Limites des requêtes

Le tableau ci-dessous répertorie les limites applicables aux requêtes de recherche que vous envoyer à Google:

Internationalisation des requêtes et de la présentation des résultats

Le service Google WebSearch vous permet de rechercher des documents dans plusieurs langues. Vous pouvez spécifier l'encodage des caractères être utilisée pour interpréter votre requête HTTP et encoder votre réponse XML. (à l'aide des recherches ie et oe paramètres). Vous pouvez également filtrer les résultats pour n'inclure que les documents. dans certaines langues.

Les sections suivantes traitent des problèmes liés à la recherche dans plusieurs langues:

• Personnage Encodage
• Langues de l'interface
• Chinois simplifié et traditionnel Réseau de Recherche

Encodage de caractères

Les serveurs envoient des données, telles que des pages Web, aux user-agents, comme des navigateurs, sous la forme d'une séquence d'octets encodés. Le user-agent décode ensuite les octets en une séquence de caractères. Lors de l'envoi de requêtes au WebSearch, vous pouvez spécifier les schémas d'encodage à la fois pour votre requête de recherche et la réponse XML que vous recevez.

Vous pouvez utiliser le paramètre de requête ie pour spécifier le mécanisme d'encodage des caractères de votre requête HTTP. Vous pouvez utiliser également le paramètre oe pour spécifier l'encodage ; que Google doit utiliser pour encoder votre réponse XML. Si vous utilisez en utilisant un schéma d'encodage autre que ISO-8859-1 (ou latin1), veuillez vous assurer que les valeurs indiquées sont correctes pour les paramètres ie et oe.

Remarque:Si vous proposez une fonctionnalité de recherche pour plusieurs nous vous recommandons d'utiliser la valeur d'encodage utf8 (UTF-8). pour les paramètres ie et oe.

Reportez-vous au caractère Schémas d'encodage pour obtenir la liste complète des valeurs que vous pouvez utiliser pour les paramètres ie et oe.

Pour en savoir plus sur l'encodage des caractères, veuillez consulter la page http://www.w3.org/TR/REC-html40/charset.html.

Langues de l'interface

Vous pouvez utiliser le paramètre de requête hl pour à identifier la langue de votre interface graphique. La valeur du paramètre hl peut avoir une incidence sur les résultats de recherche XML, en particulier sur les requêtes internationales lorsque la restriction linguistique (à l'aide du paramètre lr) n'est pas spécifiée explicitement. Dans ces Dans certains cas, le paramètre hl peut promouvoir des résultats de recherche. dans la même langue que la langue de saisie de l'utilisateur.

Nous vous suggérons de définir explicitement le paramètre hl dans les résultats de recherche pour que Google sélectionne la meilleure qualité possible les résultats de recherche pour chaque requête.

Consultez l'interface compatible Langues pour obtenir la liste complète des valeurs valides pour le paramètre hl.

Rechercher des documents rédigés dans des langues spécifiques

Vous pouvez utiliser le paramètre de demande lr pour limiter les résultats de recherche aux documents rédigés dans un ou ensemble de langues.

Le paramètre lr est compatible avec les opérateurs booléens, qui vous permettent de spécifier Plusieurs langues à inclure (ou exclure) de la recherche résultats.

Les exemples suivants montrent comment utiliser les opérateurs booléens pour demander des documents dans dans différentes langues.

Pour les documents rédigés en japonais:

lr=lang_jp

Pour les documents rédigés en italien ou en allemand:

lr=lang_it|lang_de

Pour les documents qui ne sont pas rédigés en hongrois ni en tchèque:

lr=(-lang_hu).(-lang_cs)

Consultez la Collection de langues Section Valeurs pour obtenir la liste complète des valeurs possibles pour le paramètre lr et l'opérateur booléen Opérateurs pour une discussion complète sur l'utilisation de ces les opérateurs.

Recherche en chinois simplifié et traditionnel

Le chinois simplifié et le chinois traditionnel sont deux variantes d'écriture de la langue chinoise. Le même concept peut être écrit différemment dans chaque variante. Pour une requête portant sur l'une des variantes, la requête Google Le service WebSearch peut renvoyer des résultats incluant des pages aux formats suivants : .

Pour utiliser cette fonction :

1. Définissez le paramètre de requête c2coff sur 0.
   et
2. Utilisez l'une des méthodes ci-dessous.
   • Ne définissez pas le paramètre de requête lr.
     ou
   • Définissez le paramètre de requête lr sur lr=lang_zh-TW|lang_zh-CN.

L'exemple suivant montre les paramètres de requête que vous incluriez dans une requête de résultats. en chinois simplifié et traditionnel. Notez que les informations supplémentaires requises, telles que que client, n'est pas incluse dans l'exemple.)

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

Filtrage des résultats

Google WebSearch propose plusieurs méthodes pour filtrer votre recherche. résultats:

• Automatique Filtrage des résultats de recherche
• Filtrage par langue et par pays
• Filtrer le contenu réservé aux adultes avec SafeSearch

Filtrage automatique des résultats de recherche

Afin de fournir les meilleurs résultats de recherche possible, Google utilise deux techniques pour filtrer automatiquement les résultats de recherche généralement considéré comme indésirable:

• Contenu en double : si plusieurs documents contiennent le les mêmes informations, seul le document le plus pertinent de cet ensemble est inclus dans vos résultats de recherche.

• Regroupement des hôtes : si de nombreux résultats de recherche issus du le même site, il est possible que Google n'affiche pas tous les résultats de ce site ou afficher les résultats plus bas en
  le classement qu'il ne l'aurait été autrement.

Nous vous recommandons de laisser ces filtres activés pour les requêtes de recherche courantes. car les filtres améliorent nettement la qualité de la plupart des recherches résultats. Vous pouvez toutefois contourner ces filtres automatiques en définissant le paramètre de requête filter sur 0 dans votre requête de recherche.

Filtrage par langue et par pays

Le service Google WebSearch renvoie les résultats à partir d'un index principal de tous les documents Web. L'index maître contient des sous-collections de Documents regroupés en fonction d'attributs spécifiques, dont la langue et le pays d'origine.

Vous pouvez utiliser les paramètres de requête lr et cr pour limiter les résultats de recherche aux sous-collections de des documents rédigés dans des langues spécifiques ou provenant de des pays en particulier.

Pour déterminer la langue d'un document, Google WebSearch analyse:

• Le domaine de premier niveau (TLD) de l'URL du document
• des balises Meta de langue dans le document
• La langue principale utilisée dans le corps du texte du document

Veuillez également consulter la définition du paramètre lr, dans la section Rechercher Documents rédigés dans des langues spécifiques et les valeurs de la collection de langues pouvant être utilisés comme valeurs pour le paramètre lr informations sur la restriction des résultats en fonction de la langue.

Pour déterminer le pays d'un document, Google WebSearch analyse:

• Le domaine de premier niveau (TLD) de l'URL du document
• L'emplacement géographique de l'adresse IP du serveur Web

Veuillez également consulter la définition du paramètre cr et de la Collection par pays. Valeurs pouvant être utilisées comme valeurs du paramètre cr pour savoir comment limiter les résultats en fonction du pays origine.

Remarque:Vous pouvez combiner plusieurs langues et les valeurs de pays pour personnaliser vos résultats de recherche. Pour Par exemple, vous pouvez demander des documents rédigés en français viennent de France ou du Canada, ou vous pouvez demander des documents des Pays-Bas et qu'elles ne sont pas écrites en anglais. Les paramètres lr et cr sont tous deux compatibles avec les opérateurs booléens.

Filtrer le contenu réservé aux adultes avec SafeSearch

De nombreux clients de Google ne souhaitent pas afficher de résultats de recherche pour sites incluant du contenu réservé aux adultes. À l'aide du filtre SafeSearch, vous pouvez filtrer pour les résultats de recherche incluant du contenu réservé aux adultes et de les éliminer. Les filtres Google utilisent une technologie propriétaire pour vérifier les mots clés et expressions et les URL. Bien qu'aucun filtre ne soit fiable à 100 %, SafeSearch Supprimez l'immense majorité du contenu réservé aux adultes de votre recherche. résultats.

Google s'efforce de proposer SafeSearch en permanence en explorant continuellement le Web et en intégrant des mises à jour à partir des suggestions d'utilisateurs.

SafeSearch est disponible dans les langues suivantes:

Vous pouvez définir dans quelle mesure Google filtre vos résultats du contenu réservé aux adultes à l'aide du paramètre de requête safe. Le tableau suivant décrit les paramètres SafeSearch de Google et comment ceux-ci paramètres affecteront vos résultats de recherche:

Si SafeSearch est activé et que vous trouvez des sites qui contiennent contenu offensant dans vos résultats, veuillez envoyer un e-mail à l'adresse safesearch@google.com en indiquant l'URL du site enquêtera sur le site.

Résultats XML

• Google XML DTD des résultats
• À propos de la réponse XML
• XML Résultats des requêtes de recherche standards et avancées
• Recherche standard/Recherche avancée: exemple de requête et XML Result
• Recherche standard/avancée: balises XML

DTD des résultats XML Google

Google utilise la même DTD pour décrire le format XML pour tous les types de dans les résultats de recherche. Un grand nombre de balises et d'attributs s'appliquent types de recherche. En revanche, certaines balises ne s'appliquent qu'à certaines types de recherche. Par conséquent, les définitions de la DTD peuvent être inférieures que les définitions données dans ce document.

Ce document décrit les aspects pertinents de la DTD. pour WebSearch. Si vous travaillez sur la DTD, WebSearch, vous pouvez ignorer en toute sécurité les balises et les attributs qui ne sont pas présentées ici. Si la définition diffère entre la DTD et la dans la documentation Google Cloud, ce fait est mentionné dans ce document.

Google peut renvoyer des résultats XML avec ou sans référence à la DTD la plus récente. La DTD est un guide destiné aux administrateurs de la recherche. et les analyseurs XML pour comprendre les résultats XML de Google. Comme le langage XML de Google peut changer de temps en temps, vous ne devez pas configurer vos pour valider chaque résultat XML à l'aide de la DTD.

De plus, vous ne devez pas configurer votre analyseur XML pour récupérer DTD chaque fois que vous envoyez une requête de recherche. Google met à jour la DTD rarement, et ces requêtes créent des délais et de la bande passante inutiles exigences.

Google vous recommande d'utiliser le format de sortie xml_no_dtd pour obtenir des résultats XML. Si vous spécifiez le format xml output dans votre requête de recherche, La seule différence réside dans l'inclusion de la ligne suivante dans les résultats XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Vous pouvez accéder à la dernière version à l'adresse http://www.google.com/google.dtd.

Veuillez noter que toutes les fonctionnalités de la DTD peuvent ne pas être disponibles ou prises en charge à l'heure actuelle.

À propos de la réponse XML

• Toutes les valeurs des éléments sont au format HTML valide, adapté à l'affichage, sauf indiqué dans les définitions des balises XML.
• Certaines valeurs d'éléments sont des URL qui doivent être encodées en HTML avant où elles s'affichent.
• Votre analyseur XML doit ignorer les attributs et les balises non documentés. Cela permet à votre application de continuer à fonctionner sans modification si Google ajoute des fonctionnalités à la sortie XML.
• Certains caractères doivent être échappés lorsqu'ils sont inclus en tant que valeurs dans Balises XML. Votre processeur XML doit reconvertir ces entités au format les caractères appropriés. Si vous ne convertissez pas correctement les entités, peut, par exemple, afficher le & par "&amp;". Le fichier XML Standard documente ces caractères. ces caractères sont reproduit dans le tableau ci-dessous:

  Personnage	Formes avec échappement	Entité	Code du caractère
  Esperluette	&	&	&#38
  Apostrophe	'	'	&#39
  Guillemets droits	"	"	&#34
  Supérieur(e) à	>	>	&#62
  Inférieur(e) à	<	&lt;	&#60

Résultats XML pour les requêtes de recherche standards et avancées

Recherche standard/avancée: exemple de requête et résultat XML

Cet exemple de requête WebSearch demande 10 résultats (num=10) sur le terme de recherche "socer" (q=socer), qui correspond au mot "football" intentionnellement mal orthographié dans cet exemple.)

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

Cette demande génère le résultat XML ci-dessous. Notez qu'il existe plusieurs commentaires dans le résultat XML pour indiquer les cas où certaines balises inclus dans le résultat apparaîtra.

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

Recherche standard/avancée: balises XML

Réponses XML pour les requêtes de recherche standards et la recherche avancée utilisent le même ensemble de balises XML. Ces balises XML sont affichées dans l'exemple XML ci-dessus et expliqué dans les tableaux ci-dessous.

Les balises XML ci-dessous sont classées par ordre alphabétique. Chaque balise la définition d'un tag contient une description. Voici un exemple la façon dont la balise apparaîtra dans un résultat XML et le format du tag contenus. Si la balise est un sous-élément d'une autre balise XML ou si la balise comporte ses propres sous-balises ou attributs, ces informations sont également fournies dans dans la table de définition du tag.

Certains symboles peuvent être affichés à côté de certaines sous-balises dans la définitions ci-dessous. Voici leur signification :

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

Résultats XML pour les requêtes de recherche d'images

Cet exemple de requête d'image demande 5 résultats (num=5) sur le terme de recherche "singe". (q=singe).

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

Cette demande génère le résultat XML ci-dessous.

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

Recherche d'images: balises XML

Le tableau ci-dessous présente des balises XML supplémentaires utilisées dans les réponses XML pour les requêtes de recherche d'images.

Certains symboles peuvent être affichés à côté de certaines sous-balises dans la définitions ci-dessous. Voici leur signification :