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

Cette page fait référence à la version XML de l'API JSON Custom Search, disponible uniquement pour les clients Google Site Search.

  1. Présentation
  2. Format de requête Programmable Search Engine
    1. Présentation de la demande
    2. Termes de requête
    3. Paramètres de requête
      1. Exemples de requêtes WebSearch
      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 recherche d'images
      8. Limites des requêtes
    4. Présentation de l'internationalisation des requêtes et 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 réservé aux 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, illustrées et avancées
      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: balises XML

Présentation

Le service Google WebSearch 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 la recherche peuvent contrôler totalement la manière dont ils demandent les résultats de recherche ainsi que la manière dont ils les présentent à l'utilisateur final. Ce document décrit les détails techniques des formats de requêtes et de résultats de recherche Google.

Pour récupérer les résultats Google WebSearch, votre application envoie à Google une requête HTTP simple. Google renvoie ensuite les résultats de recherche au format XML. Les résultats au format XML vous permettent de personnaliser l'affichage des résultats de recherche.

Format des requêtes WebSearch

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 une esperluette (&). 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 WebSearch ou de 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 comprennent un ou plusieurs termes. Un terme de requête apparaît en tant que 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 les éléments suivants:

  • Mots ou expressions à inclure ou à exclure
    • Tous les mots d'une requête de recherche (par défaut)
    • Expression exacte dans la requête de recherche
    • N'importe quel mot ou expression dans une requête de recherche
  • Emplacement du document pour y rechercher les termes de recherche
    • 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 sur les documents eux-mêmes
    • Inclusion ou exclusion de documents de types de fichiers particuliers (tels que des fichiers PDF ou des documents Word)
  • Requêtes d'URL spéciales qui renvoient des informations sur une URL donnée au lieu d'effectuer une recherche
    • Requêtes qui renvoient des informations générales sur une URL, telles que 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 dans une URL avec échappement. Notez que vous devez remplacer le signe plus ("+") par toutes les séquences d'espaces blancs de la requête de recherche. Pour en savoir plus, consultez la section Échappement d'URL de ce document.

Le terme de la 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 contenant 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 effectuez une requête de recherche. Les paramètres sont divisés en deux listes. La première liste contient des paramètres pertinents pour toutes les requêtes de recherche. La deuxième liste contient les paramètres qui ne concernent que 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) une 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 et non au 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, autres que ceux mentionnés ci-dessus, sont les suivants:

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

Exemples de requêtes WebSearch

Les exemples ci-dessous illustrent quelques requêtes HTTP WebSearch pour illustrer la façon dont différents paramètres de requête sont utilisés. Les différents paramètres de requête sont définis dans les sections Définitions des paramètres de requête WebSearch et Paramètres des requêtes de recherche avancées 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). Elle spécifie également que les résultats doivent provenir de sites Web canadiens (cr=countryCA) et être écrits 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 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 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. Elle utilise également le paramètre as_eq pour exclure des résultats de recherche tous 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éfinition des paramètres de requête WebSearch

c2coff
Description

Facultatif. Le paramètre c2coff active ou désactive la fonctionnalité de recherche en chinois simplifié et traditionnel.

La valeur par défaut de ce paramètre est 0 (zéro), ce qui signifie que la fonctionnalité est activée. Les valeurs du paramètre c2coff sont les suivantes:

Valeur Action
1 Désactivé
0 Activées
Exemples q=google&c2coff=1

client
Description

Obligatoire : Le paramètre client doit être défini sur google-csbe.
Exemples q=google&client=google-csbe

cr
Description

Facultatif. Le paramètre cr limite les résultats de recherche aux documents provenant d'un pays spécifique. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre cr.

Google WebSearch détermine le pays d'un document en analysant:

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

Consultez la section Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.
Exemples q=Frodo&cr=countryNZ

cx
Description

Obligatoire : Le paramètre cx spécifie un code unique qui identifie un moteur de recherche personnalisé. Vous devez spécifier un moteur Programmable Search Engine à l'aide du paramètre cx pour récupérer les résultats de recherche à partir de ce moteur.

Pour connaître la valeur du paramètre cx, accédez à l'onglet "Codes" du panneau de configuration de votre moteur. Vous la trouverez dans la zone de texte sous "Collez ce code sur la page sur laquelle vous voulez voir figurer votre champ de recherche". Les résultats de recherche s'afficheront sur une page hébergée par Google."
Exemples q=Frodo&cx=00255077836266642015:u-scht7a-8i

filtre
Description

Facultatif. Le paramètre filter active ou désactive le filtrage automatique des résultats de recherche Google. Pour plus d'informations sur les filtres de résultats de recherche Google, consultez la section Filtrage automatique de ce document.

La valeur par défaut du paramètre filter est 1, ce qui indique que la fonctionnalité est activée. Les valeurs valides pour ce paramètre sont les suivantes:

Valeur Action
1 Désactivé
0 Activées

Remarque:Par défaut, Google applique des filtres à tous les résultats de recherche afin d'en améliorer la qualité.
Exemples q=google&filter=0

gl
Description

Facultatif. La valeur du paramètre gl est un code pays à deux lettres. Pour les résultats WebSearch, le paramètre gl donne priorité aux résultats de recherche dont le pays d'origine correspond à la valeur du paramètre. Consultez la section Codes de pays pour obtenir la liste des valeurs valides.

La spécification d'une valeur de paramètre gl dans les requêtes WebSearch devrait améliorer la pertinence des résultats. Cela est particulièrement vrai pour les clients internationaux et, plus précisément, pour les clients situés dans des pays anglophones autres que les États-Unis.
Exemples

Cette requête met en avant les documents rédigés au Royaume-Uni dans les résultats WebSearch:
q=pizza&gl=uk

hl
Description

Facultatif. Le paramètre hl spécifie la langue d'interface (langue hôte) de votre interface utilisateur. Pour améliorer les performances et la qualité de vos résultats de recherche, nous vous recommandons vivement de définir ce paramètre explicitement.

Pour en savoir plus, consultez la section Langues de l'interface de la page Internationalisation des requêtes et de la présentation des résultats et la section Langues d'interface compatibles pour obtenir la liste des langues prises en charge.
Exemples

Cette demande cible les annonces relatives au vin en français. (Vin est le terme français pour vin.)

q=vin&ip=10.10.10.10&ad=w5&hl=fr

hq
Description

Facultatif. Le paramètre hq ajoute les termes spécifiés à la requête, comme s'ils étaient combinés avec un opérateur AND logique.

Exemples

Cette demande recherche « pizza » ET « fromage ». L'expression est identique à q=pizza+cheese.

q=pizza&hq=cheese

ie
Description

Facultatif. Le paramètre ie définit le schéma d'encodage des caractères à utiliser pour interpréter la chaîne de requête. La valeur ie par défaut est latin1.

Pour savoir quand utiliser ce paramètre, consultez la section Encodage des caractères.

Consultez la section Schémas d'encodage de caractères pour obtenir la liste des valeurs ie possibles.
Exemples q=google&ie=utf8&oe=utf8
lr
Description

Facultatif. Le paramètre lr (restriction de langue) limite les résultats de recherche aux documents écrits dans une langue donnée.

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

  • Le domaine de premier niveau de l'URL du document
  • les balises Meta "language" dans le document.
  • La langue principale utilisée dans le corps du texte du document
  • les langues secondaires, le cas échéant, utilisées dans le corps du texte du document ;

Consultez la section Valeurs de collection Langue (lr) pour obtenir la liste des valeurs valides pour ce paramètre.
Exemples q=Frodo&lr=lang_en

num
Description

Facultatif. Le paramètre num identifie le nombre de résultats de recherche à renvoyer.

La valeur num par défaut est 10 et la valeur maximale est 20. Si vous demandez plus de 20 résultats, seuls 20 résultats seront renvoyés.

Remarque:Si le nombre total de résultats de recherche est inférieur au nombre demandé, tous les résultats de recherche disponibles sont renvoyés.
Exemples q=google&num=10

oe
Description

Facultatif. Le paramètre oe définit le schéma d'encodage des caractères à utiliser pour décoder le résultat XML. La valeur oe par défaut est latin1.

Pour savoir quand utiliser ce paramètre, consultez la section Encodage des caractères.

Consultez la section Schémas d'encodage de caractères pour obtenir la liste des valeurs oe possibles.
Exemples q=google&ie=utf8&oe=utf8

sortie
Description

Obligatoire : Le paramètre output spécifie le format des résultats XML. Les seules valeurs valides pour ce paramètre sont xml et xml_no_dtd. Le tableau ci-dessous explique les différences entre ces valeurs de paramètres.

Valeur Format de sortie
xml_no_dtd Les résultats XML n'incluront pas d'instruction !DOCTYPE. (Recommandé)
xml Les résultats XML contiendront une référence Google DTD. La deuxième ligne du résultat identifie le type de définition de document (DTD) utilisé par les résultats : 
    <!DOCTYPE GSP SYSTEM "google.dtd">
Exemples output=xml_no_dtd
output=xml

a
Description

Facultatif. Le paramètre q spécifie la requête de recherche saisie par l'utilisateur. Bien que ce paramètre soit facultatif, vous devez spécifier une valeur pour au moins l'un des paramètres de requête (as_epq, as_lq, as_oq, as_q) afin d'obtenir les résultats de la recherche.

Un certain nombre de termes de requête spéciaux peuvent également être utilisés dans la valeur du paramètre q. Consultez la page Termes de requête spéciaux pour obtenir la liste et les définitions de ces termes.

Le panneau de configuration de la recherche Google contient un rapport sur les requêtes les plus fréquentes envoyées à l'aide du paramètre q.

Remarque:La valeur spécifiée pour le paramètre q doit être avec une séquence d'échappement dans l'URL.
Exemples q=vacation&as_oq=london+paris

entreprises sécurisées
Description

Facultatif. Le paramètre safe indique comment filtrer les résultats de recherche en fonction du contenu pornographique et réservé aux adultes. La valeur par défaut du paramètre safe est off. Les valeurs de paramètres valides sont les suivantes:

Valeur Action
off Désactiver SafeSearch
medium Activer SafeSearch
high Activer une version plus stricte de SafeSearch

Pour en savoir plus sur cette fonctionnalité, consultez la section Filtrer le contenu réservé aux adultes avec SafeSearch.
Exemples q=adult&safe=high

start
Description

Facultatif. Le paramètre start indique le premier résultat correspondant à inclure dans les résultats de recherche. Le paramètre start utilise un index basé sur zéro, ce qui signifie que le premier résultat est 0, le deuxième résultat est 1, et ainsi de suite.

Le paramètre start fonctionne conjointement avec le paramètre num pour déterminer les résultats de recherche à renvoyer. Notez qu'un maximum de 1 000 résultats ne sera jamais renvoyé pour une requête, même si plus de 1 000 documents correspondent à la requête. Par conséquent, si vous définissez une valeur de départ à 1 000 ou plus, aucun résultat ne sera obtenu.
Exemples start=10

sort
Description

Facultatif. Le paramètre sort spécifie que les résultats doivent être triés en fonction de l'expression spécifiée. Par exemple, triez par date.
Exemples

sort=date

Ud
Description

Facultatif. Le paramètre ud indique si la réponse XML doit inclure l'URL encodée en IDN pour le résultat de recherche. L'encodage IDN (International Domain Name) permet d'afficher les domaines dans la langue locale, par exemple:

http://www.花井鮨.com

Les valeurs valides pour ce paramètre sont 1 (par défaut), ce qui signifie que le résultat XML doit inclure des URL encodées en IDN et 0, qui signifie que le résultat XML ne doit pas inclure d'URL encodées en IDN. Si le paramètre ud est défini sur 1, l'URL encodée en IDN apparaît dans la balise UD de vos résultats XML.

Si le paramètre ud est défini sur 0, l'URL de l'exemple ci-dessus s'affichera comme suit:

http://www.xn--elq438j.com.

Remarque:Cette fonctionnalité est actuellement disponible en version bêta.
Exemples q=google&ud=1

Les paramètres de requête supplémentaires indiqué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 toutes prises en compte dans les termes de requête de cette recherche. L'image montre la page "Recherche avancée" de Google. Sur l'image, le nom de chaque paramètre de recherche avancée est écrit en red à 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

as_dt
Description

Facultatif. Le paramètre as_dt détermine si les résultats du site nommé dans le paramètre as_sitesearch doivent être inclus ou exclus. Les valeurs i et e indiquent respectivement l'inclusion et l'exclusion.
Exemples as_dt=i,as_dt=e

as_epq
Description

Facultatif. Le paramètre as_epq identifie une expression que tous les documents figurant dans les résultats de recherche doivent contenir. Vous pouvez également rechercher une expression à l'aide du terme de requête expression exacte.
Exemples as_epq=abraham+lincoln

as_eq
Description

Facultatif. Le paramètre as_eq identifie un mot ou une expression qui ne doit figurer dans aucun document des résultats de recherche. Vous pouvez également utiliser le terme de requête excluded pour vous assurer qu'un mot ou une expression spécifiques n'apparaîtront pas dans les documents d'un ensemble de résultats de recherche.
Exemples

q=bass&as_eq=music.

as_lq
Description

Facultatif. Le paramètre as_lq spécifie que tous les résultats de recherche doivent contenir un lien vers une URL spécifique. Vous pouvez également utiliser le terme de requête link: pour ce type de requête.

Exemples

as_lq=www.google.com

as_nlo
Description

Facultatif. Le paramètre as_nlo spécifie la valeur de départ d'une plage de recherche. Utilisez as_nlo et as_nhi pour ajouter une plage de recherche inclusive de as_nlo...as_nhi à la requête.

Exemples

Ce qui suit définit une plage de recherche de 5 à 10, inclus:

as_nlo=5&as_nhi=10
as_nhi
Description

Facultatif. Le paramètre as_nhi spécifie la valeur de fin d'une plage de recherche. Utilisez as_nlo et as_nhi pour ajouter une plage de recherche inclusive de as_nlo...as_nhi à la requête.
Exemples

Ce qui suit définit une plage de recherche de 5 à 10, inclus:

as_nlo=5&as_nhi=10
as_oq
Description

Facultatif. Le paramètre as_oq fournit des termes de recherche supplémentaires à rechercher dans un document. Chaque document des résultats de recherche doit contenir au moins l'un des termes de recherche supplémentaires. Vous pouvez également utiliser le terme de requête Booléen OR pour ce type de requête.
Exemples

q=vacation&as_oq=London+Paris

as_q
Description

Facultatif. Le paramètre as_q fournit les termes de recherche à rechercher dans un document. Ce paramètre est également couramment utilisé pour permettre aux utilisateurs de spécifier des termes supplémentaires à rechercher dans un ensemble de résultats de recherche.
Exemples

q=president&as_q=John+Adams

as_qdr
Description

Facultatif. Le paramètre as_qdr demande les résultats de recherche pour une période spécifiée (plage de dates rapide). Les valeurs suivantes sont acceptées :

Les requêtes d[number] correspondent au nombre de jours précédents spécifié.
Les requêtes w[number] correspondent au nombre spécifié de semaines précédentes.
Les requêtes m[number] correspondent au nombre spécifié de mois précédents.
Les requêtes y[number] correspondent au nombre spécifié d'années précédentes.
Exemples

Cet exemple demande les résultats de l'année passée:

as_qdr=y

Cet exemple demande les résultats des 10 derniers jours:

as_qdr=d10
as_sitesearch
Description

Facultatif. Le paramètre as_sitesearch vous permet de spécifier que tous les résultats de recherche doivent correspondre à des pages d'un site donné. En définissant le paramètre as_dt, vous pouvez également l'utiliser pour exclure de vos résultats de recherche les pages d'un site donné.
Exemples

q=vacation&as_sitesearch=www.google.com

Termes de requête spéciaux

Google WebSearch permet d'utiliser plusieurs termes de requête spéciaux qui permettent d'accéder à 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 en URL. Un certain nombre de termes de requête spéciaux contiennent le signe deux-points (:). Ce caractère doit également être échappé par une URL. Sa valeur avec échappement de l'URL est %3A.

Liens vers l'arrière [link:]
Description

Le terme de requête link: permet de récupérer l'ensemble des pages Web qui renvoient vers une URL spécifique. La requête de recherche doit respecter le format link:URL, sans espace entre le terme de requête link: et l'URL.

La version avec échappement de l'URL de link: est link%3A.

Vous pouvez également utiliser le paramètre de requête as_lq pour envoyer une requête link:.

Remarque:Vous ne pouvez pas spécifier d'autres termes de requête lorsque vous utilisez link:.
Exemples

http://www.google.com/search?q=link%3Awww.example.com

Booléen OR Recherche [ OR ]
Description

Le terme de requête OR récupère les documents qui incluent l'un d'entre eux (deux ou plusieurs) termes de requête. Pour utiliser le terme de requête OR, vous devez insérer le terme de recherche OR, en majuscules, entre chaque terme de la série.

Vous pouvez également utiliser le paramètre de requête as_oq pour lancer une recherche sur n'importe quel terme dans un ensemble de termes.

Remarque:Si une requête de recherche spécifie "London+OR+Paris", les résultats de la recherche incluront des documents contenant au moins l'un de ces deux mots. Dans certains cas, les documents figurant dans les résultats de recherche peuvent contenir les deux mots.
Exemples

Recherchez Londres ou Paris:

Saisie utilisateur:london OR paris Terme de requête:q=london+OR+paris

Recherchez "vacances" et Londres ou Paris:

Terme de requête:q=vacation+london+OR+paris

Recherchez un séjour et l'un des résultats de recherche "Londres, Paris" ou des chocolats:

Terme de requête:  q=vacation+london+OR+paris+OR+chocolates

Recherchez "vacances et chocolats" et "london" ou "paris", avec le poids le plus faible étant accordé aux chocolats:

Terme de requête:  q=vacation+london+OR+paris+chocolates

Recherchez des mots clés de vacances, des chocolats et des fleurs dans les documents contenant également Londres ou Paris:

Terme de requête:  q=vacation+london+OR+paris+chocolates+flowers

Recherchez des termes "vacances" et "Londres ou Paris", puis recherchez "chocolats" ou "fleurs" :

Terme de requête:  q=vacation+london+OR+paris+chocolates+OR+flowers

Exclure le terme de requête [-]
Description

Le terme de requête d'exclusion (-) limite les résultats d'une requête de recherche particulière aux documents qui ne contiennent pas de mot ou d'expression en particulier. Pour utiliser le terme de requête d'exclusion, vous devez faire précéder le mot ou l'expression à exclure des documents correspondants de "-" (signe moins).

La version avec échappement de l'URL de - est %2D.

Le terme de requête d'exclusion est utile lorsqu'un terme de recherche a plusieurs significations. Par exemple, le mot "basse" peut renvoyer des résultats concernant le poisson ou la musique. Si vous recherchez des documents sur le poisson, vous pouvez utiliser le terme de requête d'exclusion pour exclure des documents sur la musique de vos résultats de recherche.

Vous pouvez également utiliser le paramètre de requête as_eq pour exclure des résultats de recherche les documents correspondant à un mot ou à une expression spécifique.
Exemples Entrée utilisateur: bass -music
Terme de requête: q=bass+%2Dmusic

Exclusion de type de fichier [ -typedefichier: ]
Description

Le terme de requête -filetype: exclut les documents comportant une extension de fichier particulière, comme ".pdf" ou ".doc", des résultats de recherche. La requête de recherche doit respecter le format -filetype:EXTENSION, sans espace entre le terme de requête -filetype: et l'extension spécifiée.

La version avec échappement de l'URL de -filetype: est %2Dfiletype%3A.

Remarque:Vous pouvez exclure plusieurs types de fichiers des résultats de recherche en ajoutant d'autres termes de requête -filetype: à votre requête. Votre requête de recherche doit contenir un terme de requête -filetype: pour chaque extension de fichier à exclure des résultats de recherche.

Les types de fichiers acceptés par Google sont les suivants:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (sem. 1-2-3, sem. sem., sem. sem., sem. sem., sem.)
  • Lotus WordPro (LWP)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (document)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • RTF (Rich Text Format)
  • Shockwave Flash (swf)
  • Texte (ans, txt).

D'autres types de fichiers pourront être ajoutés ultérieurement. Vous pouvez consulter une liste actualisée des types de fichiers sur la page des questions fréquentes sur les types de fichiers de Google.
Exemples

Cet exemple renvoie les documents qui mentionnent "Google", mais qui ne sont pas au format PDF:
q=Google+%2Dfiletype%3Apdf

Cet exemple renvoie les documents mentionnant "Google", mais excluant les documents PDF et Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Filtrage du type de fichier [ filetype: ]
Description

Le terme de requête filetype: limite les résultats de recherche aux documents portant une extension de fichier particulière, telle que ".pdf" ou ".doc". La requête de recherche doit être au format filetype:EXTENSION sans espace entre le terme de requête filetype: et l'extension spécifiée.

La version avec échappement de l'URL de filetype: est filetype%3A.

Vous pouvez limiter les résultats de recherche aux documents correspondant à l'une des différentes extensions de fichier en ajoutant d'autres termes de requête filetype: à votre requête. Votre requête de recherche doit contenir un terme filetype: pour chaque extension de fichier à inclure dans les résultats de recherche. Les termes de requête filetype: doivent être séparés par le terme OR.

Par défaut, les résultats de recherche incluent des documents avec n'importe quelle extension de fichier.

Les types de fichiers acceptés par Google sont les suivants:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (sem. 1-2-3, sem. sem., sem. sem., sem. sem., sem.)
  • Lotus WordPro (LWP)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (document)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • RTF (Rich Text Format)
  • Shockwave Flash (swf)
  • Texte (ans, txt).

D'autres types de fichiers pourront être ajoutés ultérieurement. Vous pouvez consulter une liste actualisée des types de fichiers sur la page des questions fréquentes sur les types de fichiers de Google.
Exemples

Cet exemple renvoie les documents PDF mentionnant "Google":
q=Google+filetype%3Apdf

Cet exemple renvoie les documents PDF et Word mentionnant "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc

Inclure le terme de requête [+]
Description

Le terme de requête d'inclusion (+) indique qu'un mot ou une expression doit figurer dans tous les documents inclus dans les résultats de recherche. Pour utiliser le terme de requête "Inclure", vous devez faire précéder le mot ou l'expression à inclure dans tous les résultats de recherche par le signe "+" (signe plus).

La version avec caractères d'échappement de l'URL de + (signe plus) est %2B.

Utilisez + avant un mot courant que Google supprime normalement avant d'identifier les résultats de recherche.
Exemples Entrée utilisateur: Star Wars Episode +I
Terme de requête: q=Star+Wars+Episode+%2BI

Recherche basée sur des liens uniquement, tous les termes [ allinlinks: ]
Description

Le terme de requête allinlinks: exige que les documents figurant dans les résultats de recherche contiennent tous les mots de la requête de recherche dans des liens URL. La requête de recherche doit respecter le format allinlinks:, suivi des mots de votre requête.

Si votre requête de recherche inclut le terme de recherche allinlinks:, Google ne vérifie que les mots figurant dans les documents dans les liens URL des documents, sans tenir compte du texte des documents, des titres des documents et des URL de chaque document. Notez que l'URL du document est différente des liens URL contenus dans le document.

La version avec échappement de l'URL de allinlinks: est allinlinks%3A.
Exemples Entrée utilisateur:allinlinks: Google search
Terme de requête:q=allinlinks%3A+Google+search

Recherche d'expressions exactes
Description

Le terme de requête de recherche d'expression (") vous permet de rechercher des expressions complètes en les plaçant entre guillemets ou en les reliant avec des traits d'union.

La version avec échappement de l'URL de " (guillemets) est %22.

Les expressions exactes sont particulièrement utiles si vous recherchez des citations célèbres ou des noms propres.

Vous pouvez également utiliser le paramètre de requête as_epq pour lancer une recherche d'expression.
Exemples Entrée utilisateur:"Abraham Lincoln"
Terme de requête:q=%22Abraham+Lincoln%22

Recherche avec texte uniquement, tous les termes [allintext:]
Description

Le terme de requête allintext: exige que chaque document présent dans les résultats de recherche contienne tous les mots de la requête de recherche du corps du document. La requête doit respecter le format allintext:, suivi des mots de votre requête de recherche.

Si votre requête de recherche inclut le terme de recherche allintext:, Google recherche uniquement les mots dans le corps des documents, sans tenir compte des liens dans ces documents, des titres et des URL de ces documents.

La version avec échappement de l'URL de allintext: est allintext%3A.
Exemples Cet exemple indique que les mots "Google" et "search" doivent apparaître dans le corps de tous les documents inclus dans les résultats de recherche:
Entrée utilisateur:allintext:Google search
Terme de requête:q=allintext%3AGoogle+search

Recherche de titre, terme unique [intitle:]
Description

Le terme de requête intitle: limite les résultats de recherche aux documents dont le titre contient un mot particulier. La requête de recherche doit respecter le format intitle:WORD, sans espace entre le terme de requête intitle: et le mot suivant.

Remarque:Vous pouvez spécifier plusieurs mots à inclure dans le titre du document en plaçant le terme de requête intitle: devant chacun d'eux. Vous pouvez également utiliser le terme de requête allintitle: pour spécifier que tous les mots de la requête doivent être inclus dans les titres des documents figurant dans les résultats de recherche.

La version avec échappement de l'URL de intitle: est intitle%3A.
Exemples

Dans cet exemple, le mot "Google" doit apparaître dans le titre des documents figurant dans les résultats de recherche, et le mot "recherche" doit apparaître n'importe où dans les titres, les URL, les liens ou le corps du texte de ces documents:
Entrée utilisateur:intitle:Google search
Terme de requête:q=intitle%3AGoogle+search

Recherche par titre, tous les termes [allintitle:]
Description

Le terme de requête allintitle: limite les résultats de recherche aux documents contenant tous les mots de la requête figurant dans leur titre. Pour utiliser le terme de requête allintitle:, ajoutez "allintitle:" au début de votre requête de recherche.

Remarque:Placer allintitle: au début d'une requête de recherche équivaut à insérer intitle: devant chaque mot de la requête.

La version avec échappement de l'URL de allintitle: est allintitle%3A.
Exemples

Dans cet exemple, les mots "Google" et "search" doivent apparaître dans le titre des documents figurant dans les résultats de recherche:
Entrée utilisateur:allintitle: Google search
Terme de requête:q=allintitle%3A+Google+search

Recherche d'URL, terme unique [inurl:]
Description

Le terme de requête inurl: limite les résultats de recherche aux documents dont l'URL contient un mot particulier. La requête de recherche doit respecter le format inurl:WORD, sans espace entre le terme de requête inurl: et le mot suivant.

Le terme de requête inurl: ignore la ponctuation et n'utilise que le premier mot suivant l'opérateur inurl:. Vous pouvez spécifier plusieurs mots à inclure dans l'URL du document en plaçant le terme de requête inurl: devant chacun de ces mots. Vous pouvez également utiliser le terme de requête allinurl: pour spécifier que tous les mots de la requête doivent être inclus dans les URL des documents figurant dans les résultats de recherche.

La version avec échappement de l'URL de inurl: est inurl%3A.
Exemples

Cet exemple indique que le mot "Google" doit apparaître dans les URL de tous les documents figurant dans les résultats de recherche, et le mot "recherche" doit apparaître n'importe où dans les titres, les URL, les liens ou le corps du texte de ces documents:
Saisie utilisateur: inurl:Google search
Terme de requête: q=inurl%3AGoogle+search

Recherche par URL, tous les termes [allinurl:]
Description

Le terme de requête allinurl: limite les résultats de recherche aux documents contenant tous les mots de la requête de l'URL du document. Pour utiliser le terme de requête allinurl:, incluez allinurl: au début de votre requête de recherche.

Le terme de requête allinurl: ignore la ponctuation. Il ne fonctionne donc qu'avec les mots, et non sur les composants de l'URL. Par exemple, allinurl: uk/scotland limite les résultats aux documents dont l'URL contient les mots "fr" et "écosse", mais n'exige pas que ces deux mots apparaissent dans un ordre particulier ni qu'ils soient séparés par une barre oblique.

La version avec échappement de l'URL de allinurl: est allinurl%3A.
Exemples

Dans cet exemple, les mots "Google" et "search" doivent apparaître dans les URL de tous les documents figurant dans les résultats de recherche:
Entrée utilisateur: allinurl: Google search
Terme de requête: q=allinurl%3A+Google+search


Informations sur le document Web [info:]
Description

Le terme de requête info: récupère des informations générales sur une URL, à condition que celle-ci soit incluse dans l'index de recherche Google. La requête de recherche doit respecter le format info:URL, sans espace entre le terme de requête info: et l'URL.

La version avec échappement de l'URL de info: est info%3A.

Remarque:Vous ne pouvez pas spécifier d'autres termes de requête lorsque vous utilisez info:.
Exemples Entrée utilisateur: info:www.google.com
Terme de requête:q=info%3Awww.google.com

Exemples de requêtes avec des 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 les sections Définitions des paramètres de requête d'image de ce document.

Cette requête demande les 5 premiers résultats (start=0&num=5) pour le terme de requête "singe" (q=monkey), de type 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 recherche d'images

as_filetype
Description

Facultatif. Renvoie des images d'un type spécifié. Valeurs autorisées: bmp, gif, png, jpg et svg.
Exemples q=google&as_filetype=png

imgsz
Description

Facultatif. Renvoie des images d'une taille spécifiée, où la taille peut être l'une des suivantes:

  • icon (petite taille)
  • small|medium|large|xlarge (moyen)
  • xxlarge (grande taille)
  • huge (très grande)

Exemples q=google&as_filetype=png&imgsz=icon

type d'image
Description

Facultatif. Renvoie des images d'un type donné, qui peut être l'un des suivants:

  • clipart (extrait vidéo)
  • face (visage)
  • lineart (linéaire)
  • news (actualités)
  • photo (photo)
Exemples q=google&as_filetype=png&imgtype=photo

imgc
Description

Facultatif. Renvoie des images en noir et blanc, en nuances de gris ou en couleur:

  • mono (noir et blanc)
  • gray (niveaux de gris)
  • color (couleur)
Exemples q=google&as_filetype=png&imgc=gray

imgcolor
Description

Facultatif. Renvoie des images d'une couleur dominante spécifique:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Exemples q=google&as_filetype=png&imgcolor=yellow

as_rights
Description

Facultatif. Filtres basés sur les licences. Les valeurs autorisées incluent les suivantes :

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
Exemples q=cats&as_filetype=png&as_rights=cc_attribute

Limites des requêtes

Le tableau ci-dessous présente les limites applicables aux requêtes de recherche que vous envoyez à Google:

Composant Limite Commentaire
Longueur des requêtes de recherche 2 048 octets  
Nombre de termes de requête 10 inclut des termes dans les paramètres suivants: q, as_epq, as_eq, as_lq, as_oq et as_q.
Nombre de résultats 20 Si vous définissez le paramètre num sur un nombre supérieur à 20, seuls 20 résultats sont renvoyés. Pour obtenir plus de résultats, vous devez envoyer plusieurs requêtes et augmenter la valeur du paramètre start à chaque requête.

Présentation de l'internationalisation des requêtes et des résultats

Le service Google WebSearch permet de rechercher des documents dans plusieurs langues. Vous pouvez spécifier l'encodage des 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 écrits dans certaines langues.

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

Encodage de caractères

Les serveurs envoient des données, telles que des pages Web, aux user-agents tels que les 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. Lorsque vous envoyez des requêtes au service WebSearch, vous pouvez spécifier les schémas d'encodage à la fois pour votre requête de recherche et pour la réponse XML que vous recevez.

Le paramètre de requête ie vous permet de spécifier le mécanisme d'encodage des caractères de 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), veillez à spécifier des valeurs correctes pour les paramètres ie et oe.

Remarque:Si vous proposez la fonctionnalité de recherche pour 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 de caractères pour obtenir la liste complète des valeurs que vous pouvez utiliser pour les paramètres ie et oe.

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

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

Veuillez consulter la section Langues d'interface compatibles pour obtenir la liste complète des valeurs acceptées pour le paramètre hl.

Recherche de documents rédigés dans une langue spécifique

Le paramètre de requête lr permet de 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 accepte les opérateurs booléens pour vous permettre de spécifier plusieurs langues à inclure (ou à exclure) dans les résultats de recherche.

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

Pour les documents 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)

Veuillez consulter la section Valeurs de collecte des langues pour obtenir une liste complète des valeurs possibles pour le paramètre lr et la section Opérateurs booléens pour une discussion complète sur l'utilisation de ces opérateurs.

Le chinois simplifié et le chinois traditionnel sont deux variantes d'écriture du chinois. Le même concept peut être écrit différemment dans chaque variante. Pour une requête appartenant à l'une des variantes, le service Google WebSearch peut renvoyer des résultats incluant des pages appartenant aux deux variantes.

Pour utiliser cette fonction :

  1. Définissez le paramètre de requête c2coff sur 0
    .
  2. Effectuez l'une des opérations suivantes :
    • Ne définissez pas le paramètre de requête lr
      ni
    • Définissez le paramètre de requête lr sur lr=lang_zh-TW|lang_zh-CN.

L'exemple suivant présente les paramètres que vous devez inclure dans une requête pour obtenir des résultats en chinois simplifié et traditionnel. Notez que les informations supplémentaires requises, 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

Google WebSearch propose plusieurs méthodes pour filtrer les résultats de recherche:

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 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 les résultats de votre recherche.

  • Regroupement d'hôtes : si de nombreux résultats de recherche proviennent d'un même site, il est possible que Google ne les affiche pas ou qu'il n'affiche pas tous les résultats en moins
    dans le classement.

Nous vous recommandons de ne pas désactiver ces filtres pour les requêtes de recherche classiques, car ils améliorent considérablement la qualité de la plupart des résultats de recherche. 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 affiche 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ées en fonction d'attributs particuliers, 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, respectivement rédigés dans des langues spécifiques ou provenant de pays spécifiques.

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

  • Le domaine de premier niveau de l'URL du document
  • les balises Meta "language" 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, la section Rechercher des documents écrits 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 en savoir plus 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 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 les valeurs de collection de pays, qui peuvent être utilisées comme valeurs pour le paramètre cr, afin d'en savoir plus sur la restriction des résultats par pays d'origine.

Remarque:Vous pouvez combiner des valeurs de langue et 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 bien des documents provenant de Pays-Bas, mais pas 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 de résultats de recherche pour des sites comportant du contenu réservé aux adultes. Grâce à notre filtre SafeSearch, vous pouvez filtrer les résultats de recherche comportant du contenu réservé aux adultes et les éliminer. Les filtres Google utilisent une technologie propriétaire pour vérifier les mots clés, les expressions et les URL. Même si aucun filtre n'est fiable à 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 mises à jour issues des suggestions des utilisateurs.

SafeSearch est disponible dans les langues suivantes:

Néerlandais
Anglais
Français
Allemand 		Italien
Portugais (brésilien)
Espagnol
Chinois traditionnel

Vous pouvez ajuster le degré de filtrage de vos résultats de recherche pour le 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 leur incidence sur vos résultats de recherche:

Niveau SafeSearch Description
high Active une version plus stricte de la recherche sécurisée.
medium Bloque les pages Web comportant du contenu pornographique et à caractère sexuel explicite.
désactivé Ne filtre pas le contenu réservé aux adultes des résultats de recherche.

* Par défaut, le paramètre SafeSearch est désactivé.

Si vous trouvez des sites comportant du contenu choquant dans les résultats de recherche alors que SafeSearch est activé, veuillez envoyer l'URL du site par e-mail à l'adresse safesearch@google.com afin que nous puissions examiner le site.

Résultats XML

Résultats XML Google DTD

Google utilise la même DTD pour décrire le format XML pour tous les types de résultats de recherche. Un grand nombre de balises et d'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 données dans le présent document.

Ce document décrit les aspects de la DTD qui sont pertinents pour la recherche sur le Web. Lorsque vous examinez la DTD, si vous travaillez sur WebSearch, vous pouvez ignorer en toute sécurité 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 destiné aux administrateurs de recherche et aux analyseurs XML pour 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 pour valider chaque résultat XML.

De plus, vous ne devez pas configurer votre analyseur XML pour extraire la DTD chaque fois que vous envoyez une requête de recherche. Google met à jour peu fréquemment la DTD, et 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 xml output dans la 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 DTD la plus récente à l'adresse http://www.google.com/google.dtd.

Il est possible que certaines fonctionnalités de la DTD ne soient pas disponibles ou prises en charge à l'heure actuelle.

À propos de la réponse XML

  • Toutes les valeurs d'éléments sont du code HTML valide pouvant être affiché, sauf indication contraire dans les définitions des balises XML.
  • Certaines valeurs d'éléments sont des URL qui doivent être encodées en HTML avant de pouvoir être affichées.
  • Votre analyseur XML doit ignorer les attributs et 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 des 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 "&amp;". La norme XML documente ces caractères, qui sont reproduits dans le tableau ci-dessous:

    Caractère Formulaires avec échappement Entité Code du caractère
    Esperluette & &amp; &#38;
    Apostrophe ' &apos; &#39;
    Guillemets droits " &quot; &#34
    Supérieur(e) à > &gt; &#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 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 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 requête génère le résultat XML ci-dessous. Notez que plusieurs commentaires sont présents dans le résultat XML pour indiquer où certaines balises non incluses dans le résultat apparaîtront.

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

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

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

Certains symboles peuvent être affichés à côté de certains sous-éléments dans les définitions ci-dessous. Voici leur signification :

? = sous-tag facultatif
* = zéro ou plusieurs instances du sous-tag
+ = une ou plusieurs instances du sous-tag
C B C D V G A I D L N P Q R S T U X

anchor_text
Définition

La balise <anchor_text> spécifie le texte que vous devez présenter aux utilisateurs afin d'identifier un libellé de raffinement associé à un ensemble de résultats de recherche. Étant donné que les étiquettes de suggestion remplacent les caractères non alphanumériques par des traits de soulignement, vous ne devez pas afficher la valeur de la balise <label> dans votre interface utilisateur. À la place, vous devez afficher la valeur de la balise <anchor_text>.

Exemple <anchor_text>parcours de golf</anchor_text>
Sous-tag de FacetItem
Format du contenu Texte

BLOQUER
Définition

Cette balise encapsule le contenu d'un bloc dans le corps d'un résultat de promotion. Chaque bloc comporte les sous-balises T, U et L. Une balise T non vide indique que le bloc contient du texte. Les balises U et L non vides indiquent que le bloc contient un lien (avec l'URL indiquée dans le sous-tag U et le texte d'ancrage dans le sous-tag L).
Sous-tags T, U, L
Sous-tag de BODY_LINE
Format du contenu Vide

BODY_LINE
Définition

Cette balise encapsule le contenu d'une ligne dans le corps du résultat promu. Chaque ligne du corps est composée de plusieurs balises BLOQUER, qui contiennent soit du texte, soit un lien avec une URL et un texte d'ancrage.
Sous-tags BLOQUER*
Sous-tag de SL_MAIN
Format du contenu Vide

C
Définition

La balise <C> indique que le service WebSearch peut récupérer une version mise en cache de cette URL de résultat de recherche. Vous ne pouvez pas récupérer les pages mises en cache via l'API XML, mais vous pouvez rediriger les utilisateurs vers www.google.com pour consulter ce contenu.
Attributes
Nom Format Description
SZ Texte (entier + "k") Fournit la taille de la version mise en cache du résultat de recherche, en kilo-octets ("k").
Numéro client Texte Identifie un document présent dans le cache de Google. Pour récupérer le document à partir du cache, envoyez un terme de recherche créé comme suit:
cache:CIDtext:escapeURL

L'URL échappée est disponible dans le tag UE.
Exemple <C SZ="6k" CID="kvOXK_cYSSgJ" />
Sous-tag de HAS
Format du contenu Vide

C2C
Définition La balise <C2C> indique que le résultat fait référence à une page en chinois traditionnel. Cette balise ne s'affiche que lorsque l'option Recherche en chinois simplifié et traditionnel est activée. Consultez la définition du paramètre de requête c2coff pour en savoir plus sur l'activation et la désactivation de cette fonctionnalité.
Format du contenu Texte

Contexte
Définition

La balise <Context> encapsule une liste de libellés de suggestion associés à un ensemble de résultats de recherche.
Exemple <Context>
Sous-tags title, Facet+
Format du contenu Conteneur

DATE DE PLANIFICATION
Définition

La balise <CRAWLDATE> indique la date de la dernière exploration de la page. CRAWLDATE n'est pas renvoyé pour chaque page de résultats de recherche.
Exemple <CRAWLDATE>21 mai 2005</CRAWLDATE>
Sous-tag de R
Format du contenu Texte

IN
Définition

La balise <DI> encapsule les informations sur la catégorie du projet Open Directory (ODP) pour un seul résultat de recherche.
Exemple <DI>
Sous-tags DT?, DS?
Sous-tag de HAS
Format du contenu Vide

DS
Définition

La balise <DS> fournit le récapitulatif d'une seule catégorie dans le répertoire ODP.
Exemple <DS>Publiez votre CV sur &lt;b&gt;football&lt;/b&gt; directement sur Internet.</DS>
Sous-tag de DI
Format du contenu Texte (peut contenir du code HTML)

arborescence de périphériques
Définition

La balise <DT> fournit le titre d'une seule catégorie répertoriée dans le répertoire ODP.
Exemple <DT>SoccerConnection.net</DT>
Sous-tag de DI
Format du contenu Texte (peut contenir du code HTML)

Attribut
Définition

La balise <Facet> contient un regroupement logique de balises <FacetItem>. Vous pouvez créer ces regroupements au format de spécification XML de Programmable Search Engine. Si vous ne créez pas ces regroupements, la balise results_xml_tag_Context><Context> peut contenir jusqu'à quatre balises <Facet>. Les éléments de chaque balise <Facet> sont regroupés à des fins d'affichage, mais il est possible qu'ils n'aient pas de relation logique.
Exemple <Facet>
Sous-tags FacetItem+, titre+
Sous-tag de Contexte
Format du contenu Conteneur

FacetItem
Définition

La balise <FacetItem> encapsule les informations sur un libellé de suggestion associé à un ensemble de résultats de recherche.
Exemple <FacetItem>
Sous-tags libellé, anchor_text+
Sous-tag de Attribut
Format du contenu FacetItem

FI
Définition La balise <FI> sert d'indicateur pour indiquer si un filtrage de documents a été effectué pour la recherche. Consultez la section Filtrage automatique de ce document pour plus d'informations sur les filtres de résultats de recherche Google.
Exemple <FI />
Sous-tag de RÉS
Format du contenu Vide

annonces commerciales Gmail
Définition

La balise <GSP> encapsule toutes les données renvoyées dans les résultats de recherche XML Google. "GSP" est l'abréviation de "Google Search Protocol".
Attributes
Nom Format Description
VER Texte (entier) L'attribut VER spécifie la version du résultat de la recherche. La version de sortie actuelle est "3.2".
Exemple <GSP VER="3.2">
Sous-tags PARAM+, Q, RES?, TM
Format du contenu Vide

HAS
Définition La balise <HAS> encapsule les informations sur tous les paramètres spéciaux de requête de recherche pris en charge pour une URL spécifique.

Remarque:La définition de <HAS> pour WebSearch est plus restrictive que dans la définition DTD.

Sous-tags DI, D? C?, RT?
Sous-tag de R

ISURL
Définition Google renvoie la balise <ISURL> si la requête de recherche associée est une URL.
Sous-tag de GPS
Format du contenu Vide

L
Définition La présence de la balise <L> indique que le service WebSearch peut trouver d'autres sites qui renvoient à cette URL de résultat de recherche. Pour trouver ce type de sites, utilisez le terme de requête spécial link:.
Sous-tag de HAS
Format du contenu Vide

étiquette
Définition

La balise <label> spécifie un libellé de filtre que vous pouvez utiliser pour filtrer les résultats de recherche que vous recevez. Pour utiliser un libellé de filtre, ajoutez la chaîne more:[[label tag value]] à la valeur du paramètre q dans la requête HTTP envoyée à Google, comme illustré dans l'exemple suivant. Notez que cette valeur doit être échappée dans l'URL avant d'envoyer la requête à Google.

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

Remarque:La balise <label> est différente de la balise <Label>, qui identifie un libellé de suggestion associé à une URL spécifique dans vos résultats de recherche.
Exemple <label>parcours_golf</label>
Sous-tag de FacetItem
Format du contenu Texte

LANGUE
Définition

La balise <LANG> indique la langue du résultat de recherche la plus probable par Google.
Exemple <LANG>en</LANG>
Sous-tag de R
Format du contenu Texte

M
Définition

La balise <M> identifie le nombre total estimé de résultats de recherche.

Remarque : Cette estimation peut être inexacte.

Exemple <M>16200000</M>
Sous-tag de RÉS
Format du contenu Texte

Nouveaux-nés
Définition

La balise <NB> encapsule les informations de navigation (liens vers la page de résultats de recherche suivante ou précédente) pour l'ensemble de résultats.

Remarque:Cette balise n'est présente que si d'autres résultats sont disponibles.
Exemple <NB>
Sous-tags NU?, PU?
Sous-tag de RÉS
Format du contenu Vide

NU
Définition

La balise <NU> contient un lien relatif vers la page suivante des résultats de recherche.
Exemple <NU>/search?q=flowers&num=10&hl=fr&ie=UTF-8
&output=xml&client=test&start=10</NU>
Sous-tag de Remarque
Format du contenu Texte (URL relative)

PARAMÈTRE
Définition

La balise <PARAM> identifie un paramètre d'entrée envoyé dans la requête HTTP associé au résultat XML. Les informations sur le paramètre sont contenues dans les attributs de balise (name, value, original_value) et chaque paramètre envoyé dans la requête HTTP comporte une balise PARAM.
Attributes
Nom Format Description
name Texte Nom du paramètre d'entrée.
value HTML Version au format HTML de la valeur du paramètre d'entrée.
original_value Texte Version d'origine avec échappement de l'URL de la valeur du paramètre d'entrée.
Exemple <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Sous-tag de GPS
Format du contenu Complexes

PU
Définition

La balise <PU> fournit un lien relatif vers la page de résultats de recherche précédente.
Exemple <PU>/search?q=flowers&num=10&hl=fr&output=xml
&client=test&start=10</PU>
Sous-tag de Remarque
Format du contenu Texte (URL relative)

Q
Définition

La balise <Q> identifie la requête de recherche envoyée dans la requête HTTP associée au résultat XML.
Exemple

<Q>pizza</Q>
Sous-tag de GPS
Format du contenu Texte

R
Définition

La balise <R> encapsule les détails d'un résultat de recherche individuel.

Remarque:La définition de la balise <R> pour la recherche sur le Web est plus restrictive que la balise DTD.

Attributes
Nom Format Description
N Texte (entier) Indique l'index (de base 1) de ce résultat de recherche.
MIME Texte Indique le type MIME du résultat de recherche.
Sous-tags U, UE, T ? CRAWLDATE, D?, LANG?, HAS
Sous-tag de RÉS

RÉS
Définition

La balise <RES> encapsule l'ensemble des résultats de recherche individuels et fournit des informations sur ces résultats.
Attributes
Nom Format Description
SN Texte (entier) Indique l'index (de base 1) du premier résultat de recherche renvoyé dans cet ensemble de résultats.
EN Texte (entier) Indique l'index (de base 1) du dernier résultat de recherche renvoyé dans cet ensemble de résultats.
Exemple <RES SN="1" FR="10">
Sous-tags M, FI ? XT?, NB ? R*
Sous-tag de GPS
Format du contenu Vide

S
Définition

La balise <S> contient un extrait de résultat de recherche affichant les termes de requête en gras. Des sauts de ligne sont inclus dans l'extrait pour permettre un retour à la ligne automatique.
Exemple <S>Washington (CNN) – Une offre pour mettre fin à l'écart entre le Sénat et le président Bush
Sous-tag de R
Format du contenu Texte (HTML)

SL_MAIN
Définition

Cette balise encapsule le contenu d'un résultat de promotion. À utiliser pour analyser les promotions. Le texte d'ancrage et l'URL du lien de titre sont contenus respectivement dans les sous-balises T et U. Les lignes du corps du texte et des liens sont contenues dans les sous-balises BODY_LINE.
Sous-tags BODY_LINE*, T, U
Sous-tag de SL_RESULTS
Format du contenu Vide

SL_RESULTS
Définition

Tag de conteneur pour les résultats promus. L'un d'entre eux apparaît chaque fois qu'une publicité figure dans vos résultats de recherche. Le sous-tag SL_MAIN contient les principales données de résultat.
Sous-tags SL_MAIN*
Sous-tag de R
Format du contenu Vide

Orthographe
Définition

La balise <Spelling> encapsule une autre suggestion orthographique pour la requête envoyée. Cette balise n'apparaît que sur la première page des résultats de recherche. Les suggestions d'orthographe sont disponibles en anglais, chinois, coréen et japonais.

Remarque:Google ne renvoie des suggestions orthographiques que pour les requêtes dont la valeur du paramètre gl est en minuscules.
Exemple <Spelling>
Sous-tags Suggestion
Sous-tag de GPS
Format du contenu Vide

Suggestion
Définition La balise <Suggestion> contient une autre suggestion orthographique pour la requête envoyée. Vous pouvez utiliser le contenu de la balise pour suggérer une autre orthographe à l'utilisateur de la recherche. La valeur de l'attribut q est la suggestion orthographique avec échappement dans l'URL que vous pouvez utiliser comme terme de requête.
Attributes
Nom Format Description
a Texte L'attribut q spécifie la version avec échappement de l'URL de la suggestion orthographique.
Exemple <Suggestion q="football">&lt;b&gt;&lt;i&gt;football&lt;/i&gt;&lt;/b&gt;</Suggestion>
Sous-tag de Orthographe
Format du contenu Texte (HTML)

T
Définition La balise <T> contient le titre du résultat.
Exemple <T>Amici's East Coast Pizzeria</T>
Sous-tag de R
Format du contenu Texte (HTML)

title
Définition

En tant qu'enfant de l'élément <Context>, la balise <title> contient le nom de votre Programmable Search Engine.

En tant qu'enfant de <Facet>, la balise <title> fournit un titre pour un ensemble d'attributs.
Exemple

En tant qu'enfant de <Context>: <title>Mon moteur de recherche</title>

En tant qu'enfant de <Facet>: <title>facet title</title>
Sous-tag de Contexte, Face
Format du contenu Texte

TM
Définition

La balise <TM> identifie le temps total (en secondes) requis par le serveur pour renvoyer les résultats de recherche.
Exemple <TM>0,100445</TM>
Sous-tag de GPS
Format du contenu Texte (nombre à virgule flottante)

TT
Définition La balise <TT> fournit un conseil de recherche.
Exemple <TT>&lt;i&gt;Conseil: Dans la plupart des navigateurs, appuyer sur la touche Retour produit les mêmes résultats qu'appuyer sur le bouton "Rechercher".&lt;/i&gt;</TT>
Sous-tag de GPS

U
Définition La balise <U> fournit l'URL du résultat de recherche.
Exemple <U>http://www.dominos.com/</U>
Sous-tag de R
Format du contenu Texte (URL absolue)

UD
Définition

La balise <UD> fournit l'URL (International Domain Name) encodée en IDN du résultat de recherche. Cette valeur permet d'afficher les domaines dans la langue locale. Par exemple, l'URL encodée en IDN http://www.%E8%8A%B1%E4%BA%95.com peut être décodée et affichée sous la forme http://www.花용鮨.com. Cette balise <UD> n'est incluse dans les résultats de recherche que pour les requêtes qui incluent le paramètre ud.

Remarque:Cette fonctionnalité est actuellement disponible en version bêta.
Exemple <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
Sous-tag de R
Format du contenu Texte (URL encodée en IDN)

UE
Définition La balise <UE> fournit l'URL du résultat de recherche. La valeur comporte des caractères d'échappement dans l'URL. Elle peut donc être transmise en tant que paramètre de requête dans une URL.
Exemple <UE>http://www.dominos.com/</UE>
Sous-tag de R
Format du contenu Texte (URL avec échappement dans l'URL)

XT
Définition Le tag <XT> indique que le nombre total estimé de résultats, tel que spécifié par le tag M, représente en fait le nombre total exact de résultats. Pour plus d'informations, consultez la section Filtrage automatique de ce document.
Exemple <XT />
Sous-tag de RÉS
Format du contenu Vide


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

Cet exemple de requête Image 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 être affichés à côté de certains sous-éléments dans les définitions ci-dessous. Voici leur signification :

? = sous-tag facultatif
* = zéro ou plusieurs instances du sous-tag
+ = une ou plusieurs instances du sous-tag

RG
Définition

La balise <RG> permet de fournir les détails d'un résultat de recherche d'images.
Attributes
Nom Format Description
N Texte (entier) Indique l'index (de base 1) de ce résultat de recherche.
MIME Texte Indique le type MIME du résultat de recherche.
Sous-tag de RÉS
RU
Définition

La balise <RU tag> contient les détails de chaque résultat de recherche d'images.
Sous-tag de R