Cette page fait référence à la version XML de l'API JSON Custom Search, disponible uniquement pour les clients Google Site Search.
- Présentation
- Format de requête Programmable Search Engine
- Résultats 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 requête
- Termes de requête
- Paramètres de requête
- Exemples de requêtes WebSearch
- 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 recherche avancée
- Termes de requête spéciaux
- Limites des 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 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 surxml_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
|
||||||
Exemples | q=google&c2coff=1 |
client | |
---|---|
Description | Obligatoire : Le paramètre |
Exemples | q=google&client=google-csbe |
cr | |
---|---|
Description | Facultatif. Le paramètre Google WebSearch détermine le pays d'un document en analysant:
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 |
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
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 La spécification d'une valeur de paramètre |
Exemples | Cette requête met en avant les documents rédigés au Royaume-Uni dans les résultats WebSearch: |
hl | |
---|---|
Description | Facultatif. Le paramètre 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 |
Exemples | Cette demande recherche « pizza » ET « fromage ». L'expression est identique à
|
ie | |
---|---|
Description | Facultatif. Le paramètre 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 |
Exemples | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Description | Facultatif. Le paramètre Pour déterminer la langue d'un document, Google WebSearch analyse:
Consultez la section Valeurs de collection Langue ( |
Exemples | q=Frodo&lr=lang_en |
num | |
---|---|
Description | Facultatif. Le paramètre La valeur 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 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 |
Exemples | q=google&ie=utf8&oe=utf8 |
sortie | |||||||
---|---|---|---|---|---|---|---|
Description | Obligatoire : Le paramètre
|
||||||
Exemples | output=xml_no_dtd |
a | |
---|---|
Description | Facultatif. Le paramètre Un certain nombre de termes de requête spéciaux peuvent également être utilisés dans la valeur du paramètre 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 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
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 Le paramètre |
Exemples | start=10 |
sort | |
---|---|
Description | Facultatif. Le paramètre |
Exemples |
|
Ud | |
---|---|
Description | Facultatif. Le paramètre http://www.花井鮨.com Les valeurs valides pour ce paramètre sont Si le paramètre http://www.xn--elq438j.com. Remarque:Cette fonctionnalité est actuellement disponible en version bêta. |
Exemples | q=google&ud=1 |
Recherche avancée
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 |
Exemples | as_dt=i,as_dt=e |
as_epq | |
---|---|
Description | Facultatif. Le paramètre |
Exemples | as_epq=abraham+lincoln |
as_eq | |
---|---|
Description | Facultatif. Le paramètre |
Exemples |
|
as_lq | |
---|---|
Description | Facultatif. Le paramètre |
Exemples |
|
as_nlo | |
---|---|
Description | Facultatif. Le paramètre |
Exemples | Ce qui suit définit une plage de recherche de 5 à 10, inclus:
|
as_nhi | |
---|---|
Description | Facultatif. Le paramètre |
Exemples | Ce qui suit définit une plage de recherche de 5 à 10, inclus:
|
as_oq | |
---|---|
Description | Facultatif. Le paramètre |
Exemples |
|
as_q | |
---|---|
Description | Facultatif. Le paramètre |
Exemples |
|
as_qdr | |
---|---|
Description | Facultatif. Le paramètre
Les requêtes |
Exemples |
Cet exemple demande les résultats de l'année passée:
Cet exemple demande les résultats des 10 derniers jours:
|
as_sitesearch | |
---|---|
Description | Facultatif. Le paramètre |
Exemples |
|
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 La version avec échappement de l'URL de Vous pouvez également utiliser le paramètre de requête as_lq pour envoyer une requête Remarque:Vous ne pouvez pas spécifier d'autres termes de requête lorsque vous utilisez |
Exemples |
|
Booléen OR Recherche [ OR ] | |
---|---|
Description | Le terme de requête 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 ( La version avec échappement de l'URL de 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 La version avec échappement de l'URL de Remarque:Vous pouvez exclure plusieurs types de fichiers des résultats de recherche en ajoutant d'autres termes de requête Les types de fichiers acceptés par Google sont les suivants:
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: Cet exemple renvoie les documents mentionnant "Google", mais excluant les documents PDF et Word: |
Filtrage du type de fichier [ filetype: ] | |
---|---|
Description | Le terme de requête La version avec échappement de l'URL de 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 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:
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": Cet exemple renvoie les documents PDF et Word mentionnant "Google": |
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 Utilisez |
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 Si votre requête de recherche inclut le terme de recherche La version avec échappement de l'URL de |
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 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 Si votre requête de recherche inclut le terme de recherche La version avec échappement de l'URL de |
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 Remarque:Vous pouvez spécifier plusieurs mots à inclure dans le titre du document en plaçant le terme de requête La version avec échappement de l'URL de |
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: |
Recherche par titre, tous les termes [allintitle:] | |
---|---|
Description | Le terme de requête Remarque:Placer La version avec échappement de l'URL de |
Exemples | Dans cet exemple, les mots "Google" et "search" doivent apparaître dans le titre des documents figurant dans les résultats de recherche: |
Recherche d'URL, terme unique [inurl:] | |
---|---|
Description | Le terme de requête Le terme de requête La version avec échappement de l'URL de |
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: |
Recherche par URL, tous les termes [allinurl:] | |
---|---|
Description | Le terme de requête Le terme de requête La version avec échappement de l'URL de |
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: |
Informations sur le document Web [info:] | |
---|---|
Description | Le terme de requête La version avec échappement de l'URL de Remarque:Vous ne pouvez pas spécifier d'autres termes de requête lorsque vous utilisez |
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: |
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:
|
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:
|
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:
|
Exemples | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
Description | Facultatif. Renvoie des images d'une couleur dominante spécifique:
|
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 :
|
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.
Recherche en chinois simplifié et traditionnel
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 :
- Définissez le paramètre de requête c2coff sur 0
. - Effectuez l'une des opérations suivantes :
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
- Filtrage par langue et par pays
- Filtrer le contenu réservé aux adultes avec SafeSearch
Filtrage automatique des résultats de recherche
Afin de fournir les meilleurs résultats de recherche possible, Google utilise deux techniques pour filtrer automatiquement les résultats 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
- Google XML Results DTD
- À 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 de résultat XML
- Recherche standard/avancée: balises 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 "&".
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 & & & Apostrophe ' ' ' Guillemets droits " " " Supérieur(e) à > > > Inférieur(e) à < < <
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 :
* = 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 |
|
|||||||||
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. |
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 <b>football</b> 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 |
|
||||||
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 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 |
|
||||||||||||
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 |
|
|||||||||
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 |
|
|||||||||
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 |
|
||||||
Exemple | <Suggestion q="football"><b><i>football</i></b></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><i>Conseil: Dans la plupart des navigateurs, appuyer sur la touche Retour produit les mêmes résultats qu'appuyer sur le bouton "Rechercher".</i></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 :
* = 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 |
| |||||||||
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 |