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 clients Google Site Search.

1. Présentation
2. Format des demandes Programmable Search Engine
   1. Présentation des demandes
   2. Termes de requête
   3. Paramètres de requête
      1. Exemples de requêtes de recherche sur le Web
      2. Définitions 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 la recherche d'images
      8. Limites de requêtes
   4. Internationaliser les requêtes et la présentation des résultats
      1. Encodage des caractères
      2. Langues de l'interface
      3. Recherche en chinois simplifié et traditionnel
   5. Filtrer les résultats
      1. Filtrage automatique des résultats de recherche
      2. Filtrage par langue et par pays
      3. Filtrer le contenu pour adultes avec SafeSearch
3. Résultats XML
   1. DTD des résultats XML Google
   2. À propos de la réponse XML
   3. Résultats XML pour les requêtes de recherche standards, d'images et avancées
      1. Recherche normale/avancée : exemple de requête et 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 résultat XML
      5. Recherche d'images : balises XML

Présentation

Le service de recherche Web Google permet aux clients Google Site Search d'afficher les résultats de recherche Google sur leurs propres sites Web. Le service WebSearch utilise un protocole simple basé sur HTTP pour diffuser les résultats de recherche. Les administrateurs de recherche ont un contrôle total sur la façon dont ils demandent les résultats de recherche et sur la façon dont ils les présentent à l'utilisateur final. Ce document décrit les détails techniques des formats de requête et de résultats de recherche Google.

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

Format des requêtes WebSearch

• Présentation des demandes
• Termes de requête
• Paramètres de requête
• Exemples de requêtes de recherche sur le Web
• Définitions des paramètres de requête WebSearch
• Exemples de requêtes d'images
• Définitions des paramètres de requête de recherche d'images
• Recherche avancée
  
• Paramètres de requête de la recherche avancée
• 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. Elle inclut un ensemble de paramètres pertinents pour vos requêtes. Ces paramètres sont inclus dans l'URL de la requête sous forme de paires nom=valeur séparées par des esperluettes (&). Les paramètres incluent des données telles que la requête de recherche et un ID de moteur unique (cx) qui identifie le moteur à l'origine de la requête HTTP. Le service Recherche sur le Web ou Recherche d'images renvoie des résultats XML en réponse à vos requêtes HTTP.

Termes de requête

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

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

• Mots ou expressions à inclure ou à exclure
  • Tous les mots d'une requête de recherche (par défaut)
  • une expression exacte dans la requête de recherche ;
  • Tout mot ou expression dans une requête de recherche
• Où dans un document rechercher les termes de recherche ?
  • N'importe où dans le document (par défaut)
  • Uniquement dans les liens du document
• Restrictions sur les documents eux-mêmes
  • Inclure ou exclure des documents de types de fichiers spécifiques (fichiers PDF ou documents Word, par exemple)
• Requêtes URL spéciales qui renvoient des informations sur une URL donnée, plutôt que d'effectuer une recherche
  • Requêtes renvoyant des informations générales sur une URL, comme sa catégorie Open Directory, son extrait ou sa langue
  • Requêtes qui renvoient l'ensemble des pages Web qui renvoient vers 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 remplacer le signe plus ("+") par toute séquence d'espaces blancs dans la requête de recherche. Ce point est abordé plus en détail dans la section Échappement d'URL de ce document.

Le terme de requête de recherche est envoyé au service WebSearch à l'aide du paramètre q. Voici un exemple de terme de requête de recherche :

q=horses+cows+pigs

Par défaut, le service Google WebSearch ne renvoie que les documents qui incluent tous les termes de la requête de recherche.

Paramètres de requête

Cette section liste les paramètres que vous pouvez utiliser lorsque vous envoyez une requête de recherche. Les paramètres sont divisés en deux listes. La première liste contient des paramètres qui s'appliquent à toutes les requêtes de recherche. La deuxième liste contient des paramètres qui ne sont pertinents que 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) référence à la DTD de Google. Nous vous recommandons de définir cette valeur sur xml_no_dtd. Remarque : Si vous ne spécifiez pas ce paramètre, les résultats seront renvoyés au format HTML au lieu du format XML.
  
• Le paramètre cx, qui représente l'ID unique du moteur.
  

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

• num : nombre de résultats de recherche demandés
• q : terme(s) de recherche
• start : index de départ des résultats.

Exemples de requêtes WebSearch

Les exemples ci-dessous montrent quelques requêtes HTTP WebSearch pour illustrer l'utilisation des différents paramètres de requête. Les définitions des différents paramètres de requête sont fournies dans les sections Définitions des paramètres de requête WebSearch et Paramètres de requête de recherche avancée 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 spécifie également que les résultats doivent provenir de sites Web canadiens (cr=countryCA) et être rédigés en français (lr=lang_fr). 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/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 utilise certains des paramètres de requête de recherche avancée pour personnaliser davantage la requête de recherche. Cette requête utilise le paramètre as_q (as_q=red+sox) au lieu du paramètre q. Il utilise également le paramètre as_eq pour exclure des résultats de recherche les documents contenant le mot "Yankees" (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 listés sous l'image sont pertinents pour les requêtes de recherche avancée. Lorsque vous envoyez une recherche avancée, les valeurs de plusieurs paramètres (par exemple, as_eq, as_epq, as_oq, etc.) sont toutes prises en compte dans les termes de requête de cette recherche. L'image montre la page de recherche avancée de Google. Sur l'image, le nom de chaque paramètre de recherche avancée est écrit en rouge à l'intérieur ou à côté du champ de la page auquel ce paramètre correspond.

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

Termes de requête spéciaux

La recherche sur le Web Google permet d'utiliser plusieurs termes de requête spéciaux qui donnent accès à des fonctionnalités supplémentaires du moteur de recherche Google. Ces termes de requête spéciaux doivent être inclus dans la valeur du paramètre de requête q. Comme les autres termes de requête, les termes de requête spéciaux doivent être échappés dans l'URL. Un certain nombre de termes de requête spéciaux contiennent un deux-points (:). Ce caractère doit également être échappé au format URL. Sa valeur échappée au format URL est %3A.

Exemples de requêtes d'images

Les exemples ci-dessous montrent quelques requêtes HTTP d'image pour illustrer l'utilisation des différents paramètres de requête. Les définitions des différents paramètres de requête sont fournies dans les sections "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 de fichier .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 la recherche d'images

Limites des requêtes

Le tableau ci-dessous liste les limites des requêtes de recherche que vous envoyez à Google :

Internationaliser les requêtes et la présentation des résultats

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

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

• Encodage des caractères
• Langues de l'interface
• Recherche en chinois simplifié et traditionnel

Encodage de caractères

Les serveurs envoient des données, telles que des pages Web, aux agents utilisateur, tels que les navigateurs, sous la forme d'une séquence d'octets encodés. L'agent utilisateur décode ensuite les octets en une séquence de caractères. Lorsque vous envoyez des requêtes au service WebSearch, vous pouvez spécifier les schémas d'encodage pour votre requête de recherche et pour 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 dans votre requête HTTP. Vous pouvez également utiliser le paramètre oe pour spécifier le schéma d'encodage que Google doit utiliser pour encoder votre réponse XML. Si vous utilisez un schéma d'encodage autre que ISO-8859-1 (ou latin1), assurez-vous de spécifier les valeurs correctes pour les paramètres ie et oe.

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

Veuillez consulter l'annexe Schémas d'encodage des caractères pour obtenir la liste complète des valeurs que vous pouvez utiliser pour les paramètres ie et oe.

Pour obtenir des informations plus générales sur l'encodage des caractères, consultez 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 pour les requêtes internationales lorsque la restriction de langue (à l'aide du paramètre lr) n'est pas explicitement spécifiée. Dans ce cas, le paramètre hl peut promouvoir les résultats de recherche dans la même langue que celle utilisée par l'utilisateur.

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

Pour obtenir la liste complète des valeurs valides pour le paramètre hl, veuillez consulter la section Langues d'interface acceptées.

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

Vous pouvez utiliser le paramètre de requête lr pour limiter les résultats de recherche aux documents rédigés dans une langue ou un ensemble de langues spécifiques.

Le paramètre lr est compatible avec les opérateurs booléens. Il vous permet de spécifier plusieurs langues à inclure (ou à exclure) des résultats de recherche.

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

Pour les documents rédigés en japonais :

lr=lang_jp

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

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)

Pour obtenir la liste complète des valeurs possibles pour le paramètre lr, consultez la section Valeurs de la collection de langues. Pour en savoir plus sur l'utilisation de ces opérateurs, consultez la section Opérateurs booléens.

Recherche en chinois simplifié et traditionnel

Le chinois simplifié et le chinois traditionnel sont deux variantes d'écriture de la langue chinoise. Un même concept peut être écrit différemment dans chaque variante. Étant donné une requête dans l'une des variantes, le service Google WebSearch peut renvoyer des résultats incluant des pages dans les deux variantes.

Pour utiliser cette fonctionnalité :

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 à inclure dans une demande de résultats en chinois simplifié et traditionnel. (Notez que les informations requises supplémentaires, telles que le client, ne sont pas incluses dans l'exemple.)

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

Filtrer les résultats

La recherche sur le Web Google vous permet de filtrer vos résultats de recherche de différentes manières :

• Filtrage automatique des résultats de recherche
• Filtrage par langue et par pays
• Filtrer le contenu pour adultes avec SafeSearch

Filtrage automatique des résultats de recherche

Afin d'obtenir les meilleurs résultats de recherche possible, Google utilise deux techniques pour filtrer automatiquement les résultats de recherche généralement considérés comme indésirables :

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

• Hôtes en abondance : si de nombreux résultats de recherche proviennent du même site, Google peut ne pas afficher tous les résultats de ce site ou les afficher plus bas dans le classement
  .

Nous vous recommandons de laisser ces filtres activés pour les requêtes de recherche classiques, car ils améliorent considérablement la qualité de la plupart des résultats de recherche. Toutefois, vous pouvez 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 principal contient des sous-collections de documents qui sont regroupés en fonction d'attributs spécifiques, comme 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 à des sous-collections de documents rédigés dans des langues spécifiques ou provenant de pays spécifiques, respectivement.

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

• le domaine de premier niveau de l'URL du document ;
• les balises Meta de langue dans le document ;
• la langue principale utilisée dans le corps du texte du document.

Pour en savoir plus sur la restriction des résultats en fonction de la langue, veuillez également consulter la définition du paramètre lr, la section Rechercher des documents rédigés dans des langues spécifiques et les valeurs de la collection de langues qui peuvent être utilisées comme valeurs pour le paramètre lr.

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

• le domaine de premier niveau de l'URL du document ;
• l'emplacement géographique de l'adresse IP du serveur Web.

Pour en savoir plus sur la restriction des résultats par pays d'origine, veuillez également consulter la définition du paramètre cr et les valeurs de la collection de pays qui peuvent être utilisées comme valeurs pour le paramètre cr.

Remarque : Vous pouvez combiner des valeurs linguistiques et des valeurs de pays pour personnaliser vos résultats de recherche. Par exemple, vous pouvez demander des documents rédigés en français et provenant de France ou du Canada, ou des documents provenant des Pays-Bas et qui ne sont pas rédigés 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 Google ne souhaitent pas afficher les résultats de recherche pour les sites contenant du contenu pour adultes. Vous pouvez utiliser notre filtre SafeSearch pour identifier et éliminer les résultats de recherche contenant du contenu pour adultes. Les filtres de Google utilisent une technologie propriétaire pour vérifier les mots clés, les expressions et les URL. Bien qu'aucun filtre ne soit précis à 100 %, SafeSearch supprime la grande majorité du contenu réservé aux adultes de vos résultats de recherche.

Google s'efforce de maintenir SafeSearch à jour et aussi complet que possible en explorant continuellement le Web et en intégrant les suggestions des utilisateurs.

SafeSearch est disponible dans les langues suivantes :

Vous pouvez ajuster le degré de filtrage des résultats pour les contenus réservés aux adultes à l'aide du paramètre de requête safe. Le tableau suivant explique les paramètres SafeSearch de Google et leur incidence sur vos résultats de recherche :

Si vous avez activé SafeSearch et que vous trouvez des sites contenant du contenu offensant dans vos résultats, veuillez envoyer l'URL du site à safesearch@google.com. Nous examinerons le site.

Résultats XML

• DTD des résultats XML Google
• À propos de la réponse XML
• 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
• Recherche standard/avancée : balises XML

DTD des résultats XML Google

Google utilise la même DTD pour décrire le format XML de tous les types de résultats de recherche. De nombreux tags et attributs s'appliquent à tous les types de recherche. Toutefois, certains tags ne s'appliquent qu'à certains types de recherche. Par conséquent, les définitions de la DTD peuvent être moins restrictives que celles fournies dans ce document.

Ce document décrit les aspects de la DTD qui sont pertinents pour la recherche sur le Web. Lorsque vous consultez la DTD, si vous travaillez sur la recherche sur le Web, vous pouvez ignorer les balises et les attributs qui ne sont pas documentés ici. Si la définition diffère entre la DTD et la documentation, cela est indiqué 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 qui aide les administrateurs de recherche et les analyseurs XML à comprendre les résultats XML de Google. Étant donné que la grammaire XML de Google peut changer de temps en temps, vous ne devez pas configurer votre analyseur pour qu'il utilise la DTD afin de valider chaque résultat XML.

De plus, vous ne devez pas configurer votre analyseur XML pour qu'il récupère la DTD chaque fois que vous envoyez une requête de recherche. Google met rarement à jour la DTD. Ces requêtes entraînent des délais et des besoins en bande passante inutiles.

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

<!DOCTYPE GSP SYSTEM "google.dtd">

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

Veuillez noter que toutes les fonctionnalités de la DTD ne sont pas disponibles ni prises en charge pour le moment.

À propos de la réponse XML

• Toutes les valeurs d'éléments sont du code HTML valide et peuvent être affichées, sauf indication contraire dans les définitions des balises XML.
• Certaines valeurs d'éléments sont des URL qui doivent être encodées au format HTML avant d'être affichées.
• Votre analyseur XML doit ignorer les attributs et les tags non documentés. Cela permet à votre application de continuer à fonctionner sans modification si Google ajoute d'autres fonctionnalités à la sortie XML.
• Certains caractères doivent être échappés lorsqu'ils sont inclus en tant que valeurs dans les balises XML. Votre processeur XML doit reconvertir ces entités en caractères appropriés. Si vous ne convertissez pas correctement les entités, le navigateur peut, par exemple, afficher le caractère "&" sous la forme "&". Les documents XML Standard décrivent ces caractères, qui sont reproduits dans le tableau ci-dessous :

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

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

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

Cet exemple de requête WebSearch demande 10 résultats (num=10) pour le terme de recherche "socer" (q=socer), qui est le mot "soccer" (football) volontairement mal orthographié pour 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 requête génère le résultat XML ci-dessous. Notez que le résultat XML contient plusieurs commentaires indiquant où apparaîtraient certaines balises non incluses dans le résultat.

<?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 normale/avancée : balises XML

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

Les balises XML ci-dessous sont listées par ordre alphabétique. Chaque définition de balise contient une description de la balise, un exemple montrant comment la balise apparaîtrait dans un résultat XML et le format du contenu de la balise. Si la balise est une sous-balise d'une autre balise XML ou si elle possède ses propres sous-balises ou attributs, ces informations sont également fournies dans le tableau de définition de la balise.

Certains symboles peuvent s'afficher à côté de certains sous-tags dans les 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

Cette requête d'image exemple demande cinq résultats (num=5) pour 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 requête 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 les balises XML supplémentaires utilisées dans les réponses XML pour les requêtes de recherche d'images.

Certains symboles peuvent s'afficher à côté de certains sous-tags dans les définitions ci-dessous. Voici leur signification :