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

Opérateurs booléens

Vous pouvez utiliser des opérateurs booléens dans les valeurs pour les paramètres suivants:

Définitions des opérateurs booléens

Remarque : Vous ne pouvez pas inclure d'espaces dans les valeurs des paramètres.

Booléen ET [.]
Description

L'opérateur AND (.) renvoie les résultats situés à l'intersection des collections de chaque côté de l'opérateur ".".

Exemples

Cet exemple supprime tous les résultats en français ou en italien :
lr=(-lang_fr).(-lang_it)


Booléen NOT [-]
Description

L'opérateur NOT (.) supprime tous les résultats figurant dans la collection immédiatement après l'opérateur moins ("-").

Exemples

Cet exemple supprime tous les résultats en français :
lr=-lang_fr

Cet exemple supprime tous les résultats en français ou en italien :
lr=(-lang_fr).(-lang_it)

Remarque : Vous avez peut-être remarqué que le deuxième exemple ci-dessus utilise l'opérateur booléen ET pour spécifier que les résultats ne doivent pas être écrits en français ni en italien. En fonction de l'emplacement des parenthèses dans votre requête, vous pouvez utiliser l'opérateur booléen AND ou l'opérateur booléen OR pour exprimer cette requête. En effet, si un document est écrit en français, il n'est pas écrit en italien. Ainsi, votre instruction booléenne doit indiquer que le document n'est pas écrit en français et qu'il n'est pas écrit en italien.


Booléen OU [|]
Description

L'opérateur OR (.) renvoie les résultats qui se trouvent dans la collection à gauche ou dans la collection à droite de la barre verticale ("|").

Exemples

Cet exemple renvoie tous les résultats rédigés en chinois simplifié ou en chinois traditionnel:
lr=lang_zh-TW|lang_zh-CN

Cet exemple demande tous les résultats qui ne sont pas écrits en français ni en italien. Notez qu'il place les parenthèses dans un emplacement différent de celui de l'exemple de requête pour l'opérateur booléen ET :
lr=-(lang_fr|lang_it)


Parenthèses booléennes [()]
Description

Cet opérateur vous permet de vous assurer que tous les termes placés entre les parenthèses les plus proches sont évalués avant les autres termes. Vous pouvez utiliser des parenthèses pour ajuster l'ordre d'évaluation des termes.

Exemples

L'exemple d'opérateur NOT [-] montre la construction suivante pour les résultats de requête qui ne sont ni écrits en français, ni en italien :
lr=(-lang_fr).(-lang_it)

L'exemple de l'opérateur OR (|) affiche également une requête de résultats non écrits en français. Étant donné que ce dernier exemple utilise l'opérateur OR plutôt que l'opérateur AND, il doit également modifier l'emplacement des parenthèses:
lr=-(lang_fr|lang_it)


Échappement d'URL

Pour effectuer une requête de recherche HTTP, vous devez respecter certaines conventions afin que Google puisse traduire correctement votre requête HTTP et générer une réponse appropriée.

Le schéma d'URL HTTP indique qu'une requête d'URL HTTP ne peut contenir que certains caractères:

  • Caractères alphanumériques: (a-z, A-Z, 0-9)
  • Caractères spéciaux : $ - _ | + !* ' ( )
  • Caractères réservés : ; ;//? : @ = &

Google utilise des caractères réservés pour décoder les URL et utilise des caractères spéciaux pour demander les fonctionnalités de recherche. Par conséquent, vous devez échapper tous les caractères non alphanumériques présents dans les valeurs des paramètres de recherche.

Pour échapper une chaîne via une URL, convertissez chaque séquence de caractères d'espacement en un seul "+" (signe plus) et remplacez les autres caractères non alphanumériques par l'encodage hexadécimal qui représente la valeur de ce caractère. Les encodages hexadécimaux des caractères spéciaux et réservés répertoriés ci-dessus sont présentés dans le tableau suivant. Chacun de ces caractères doit être précédé d'une URL dans les valeurs de paramètre de requête.

Caractère Encodage
hexadécimal
%24
- %2D
_ %5F
. %2E.
+ %2 Mrds
! %21
* %2A
" %22
' %27
( %28
) %29
; %3 Mrds
/ %2F
? %3F
: %3A
@ %40
= %3D
& %26.
| %7 °C

Exemples

Chaîne d'origine Chaîne avec caractères d'échappement d'URL
poinçon poing
O'Reilly O%27Reilly

Vous trouverez des informations supplémentaires sur l'échappement des URL sur les sites Web du W3C et de l'IETF.

Compression des résultats

Google peut compresser les résultats de recherche à l'aide de la compression HTTP gzip. Si vous pouvez décompresser le contenu qui a été compressé à l'aide de l'algorithme gzip, vous pouvez réduire de 50 à 70 % la bande passante, ce qui peut améliorer vos temps de réponse.

Pour demander à Google de renvoyer des résultats au format compressé, ajoutez l'en-tête HTTP Accept-Encoding à votre requête de recherche HTTP comme suit:

Accept-Encoding: gzip

Si Google renvoie les résultats de recherche à l'aide de la compression gzip, nous incluons la ligne suivante dans les en-têtes HTTP renvoyés:

Content-Encoding: gzip

Remarque:Si l'en-tête HTTP Content-Encoding n'est pas présent dans la réponse, comme illustré ci-dessus, cela signifie que Google n'a pas compressé les résultats.

Ce comportement est spécifié dans la norme HTTP. Veuillez consulter ce document pour en savoir plus sur l'utilisation de la compression HTTP gzip.

Valeurs internationales

Schémas d'encodage des caractères

Le tableau suivant répertorie les schémas d'encodage de caractères compatibles avec Google. Vous pouvez attribuer aux paramètres ie et oe les valeurs de l'une des deux premières colonnes de cette table. Les valeurs de la première colonne sont des pseudonymes pour les schémas d'encodage ; les valeurs de la deuxième colonne sont les noms standards des schémas d'encodage. Google renvoie les noms standards dans les résultats XML, et ils peuvent être utilisés dans les en-têtes HTTP Content-type de votre document.

Nom Google Encodage Langues acceptées
latin1 ISO-8859-1 Europe occidentale (allemand, anglais, catalan, danois, espagnol, finnois, français, indonésien, italien, néerlandais, norvégien, portugais et suédois)
latin2 ISO-8859-2 Europe de l'Est (croate, hongrois, polonais, roumain, serbe, slovaque, slovène)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Pays baltes (estonien, letton, lituanien)
cyrillic ISO-8859-5 Bulgare, russe
arabic ISO-8859-6  
grecque ISO-8859-7 Grec
hebrew ISO-8859-8 Hébreu
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandais
euc-jp EUC-JP Japonais
euc-kr EUC-KR Coréen
sjis Shift_JIS Japonais
big5 Big5 Chinois traditionnel
gb GB2312 Chinois simplifié
utf8 UTF-8 All

Langues d'interface compatibles

Google est disponible dans plus de 80 langues. La langue par défaut de l'interface est l'anglais. La liste suivante répertorie toutes les langues d'interface acceptées par Google.

Langue d'affichage Valeur du paramètre "hl"
Afrikaans af
Albanais sq
Amharique sm
Arabe ar
Azéri az
Basque eu
Biélorusse be
Bengali bn
Bihari bh
Bosniaque bs
Bulgare bg
Catalan ca
Chinois (simplifié) ZH-CN
Chinois (traditionnel) zh-TW
Croate h
Tchèque cs
Danois da
Néerlandais nl
Anglais en
Espéranto eo
Estonien et
Féroé fo
Finnois fi
Français fr
Frison fy
Galicien gl
Géorgien ka
Allemand de
Grec el
Gujarati gu
Hébreu iw
Hindi hi
Hongrois hu
Islandais is
Indonésien id
Interlingua ia
Irlandais ga
Italien it
Japonais ja
Javanais jw
Kannada kn
Coréen ko
Latino la
Letton lv
Lituanien lt
Macédonien mk
Malaisien ms
Malais ml
Maltais mt
Marathi mr
Népalais ne
Norvégien non
Norvégien (Nynorsk) NN
Occitan oc
Persan fa
Polonais pl
Portugais (Brésil) pt-BR
Portugais (Portugal) pt-PT
Pendjabi pa
Roumain ro
Russe ru
Gaélique (Écosse) gd
Serbe sr
Cingalais si
Slovaque sk
Slovène sl
Espagnol es
Soudanais su
Swahili sw
Suédois sv
Tagalog tl
Tamoul ta
Télougou te
Thaï th
Tigrinya ti
Turc tr
Ukrainien uk
Urdu ur
Ouzbek uz
Vietnamien vi
Gallois cy
Xhosa xh
Zoulou zu

Valeurs des collections de langues

Vous pouvez utiliser les valeurs suivantes pour spécifier un filtre linguistique à l'aide du paramètre de requête lr:

Langue Valeur du paramètre lr
Arabe lang_ar
Bulgare lang_bg
Catalan lang_ca
Chinois (simplifié) lang_zh-CN
Chinois (traditionnel) lang_zh-TW
Croate lang_hr
Tchèque lang_cs
Danois lang_da
Néerlandais lang_nl
Anglais lang_fr
Estonien lang_et
Finnois lang_fi
Français lang_fr
Allemand lang_de
Grec lang_el
Hébreu lang_iw
Hongrois lang_hu
Islandais lang_is
Indonésien id lang_id
Italien lang_it
Japonais lang_ja
Coréen lang_ko
Letton lang_lv
Lituanien lang_lt
Norvégien lang_no
Polonais lang_pl
Portugais lang_pt
Roumain lang_ro
Russe lang_ru
Serbe lang_sr
Slovaque lang_sk
Slovène lang_sl
Espagnol lang_es
Suédois lang_sv
Turc lang_tr

Valeurs des collections nationales

Vous pouvez utiliser les valeurs suivantes pour spécifier un filtre de pays à l'aide du paramètre de requête cr:

Pays Nom de la collection de pays
Afghanistan countryAF
Albanie country
Algérie countryDZ
Samoa américaines countryAS
Andorre paysAD
Angola paysAO
Anguilla countryAI
Antarctique paysAQ
Antigua-et-Barbuda paysAG
Argentine pays AR
Arménie country
Aruba countryAW
Australie countryAU
Autriche paysAT
Azerbaïdjan countryAZ
Bahamas countryBS
Bahreïn countryBH
Bangladesh countryBD
Barbade countryBB
Biélorussie paysBY
Belgique countryBE
Belize countryBZ
Bénin countryBJ
Bermudes countryBM
Bhoutan countryBT
Bolivie countryBO
Bosnie-Herzégovine countryBA
Botswana countryBW
Bouvet (Île) countryBV
Brésil paysBR
Territoire britannique de l'océan Indien countryIO
Brunei Darussalam countryBN
Bulgarie countryBG
Burkina Faso countryBF
Burundi countryBI
Cambodge countryKH
Cameroun countryCM
Canada countryCA
Cap-Vert CV
Îles Caïmans countryKY
République centrafricaine countryCF
Tchad countryTD
Chili CL
China paysCN
Christmas (Île) countryCX
Îles Cocos countryCC
Colombie paysCO
Comores countryKM
Congo paysCG
Congo, République démocratique du CD pays
Cook (Îles) countryCK
Costa Rica CR
Côte d'Ivoire CI pays
Croatie (Hrvatska) paysHR
Cuba countryCU
Chypre paysCY
République tchèque countryCZ
Danemark pays du Danemark
Djibouti countryDJ
Dominique countryDM
République dominicaine countryDO
Timor oriental (Île) countryTP
Équateur countryEC
Égypte paysEG
El Salvador countrySV
Guinée équatoriale countryGQ
Érythrée countryer
Estonie country
Éthiopie pays ET
Union européenne pays UE
Falkland (Îles) countryFK
Îles Féroé paysFO
Fidji countryFJ
Finlande countryFI
France FranceFR
France métropolitaine countryFX
Guyane française countryGF
Polynésie française pays PF
Terres australes et antarctiques françaises countryTF
Gabon countryGA
Gambie countryGM
Géorgie pays
Allemagne countryDE
Ghana countryGH
Gibraltar pays
Grèce paysGR
Groenland countryGL
Grenade countryGD
Guadeloupe countryGP
Guam GU
Guatemala countryGT
Guinée GN
Guinée-Bissau countryGW
Guyana paysGY
Haïti paysHT
Îles Heard et McDonald countryHM
Saint-Siège (Cité du Vatican) countryVA
Honduras paysHN
Hong Kong countryHK
Hongrie countryHU
Islande pays
Inde paysIN
Indonésie countryID
Iran, République islamique d' countryIR
Irak countryIQ
Irlande country_IE
Israël countryIL
Italie countryIT
Jamaïque countryJM
Japon countryJP
Jordanie countryJO
Kazakhstan countryKZ
Kenya countryKE
Kiribati paysKI
Corée, République populaire démocratique de countryKP
Corée du Sud countryKR
Koweït KW
Kirghizstan countryKG
République démocratique populaire lao countryLA
Lettonie pays
Liban countryLB
Lesotho countryLS
Libéria countryLR
Jamahiriya arabe libyenne country
Liechtenstein paysLI
Lituanie countryLT
Luxembourg countryLU
Macao country
Macédoine, Ancienne République yougoslave de countryMK
Madagascar countryMG
Malawi paysMW
Malaisie paysMY
Maldives MV country
Mali countryML
Malte pays du Mexique
Îles Marshall countryMH
Martinique paysMQ
Mauritanie countryMR
Maurice MU
Mayotte countryYT
Mexique countryMX
Micronésie, États fédérés de countryFM
Moldavie, République de countryMD
Monaco country country
Mongolie countryMN
Montserrat pays
Maroc countryMA
Mozambique countryMZ
Myanmar/Birmanie paysMM
Namibie paysNA
Nauru pays NR
Népal pays national
Pays-Bas countryNL
Antilles néerlandaises countryAN
Nouvelle-Calédonie countryNC
Nouvelle-Zélande countryNZ
Nicaragua country
Niger pays ne
Nigéria paysNG
Niue countryNU
Norfolk (Île) paysNF
Mariannes du Nord (Îles) pays
Norvège paysNO
Oman countryOM
Pakistan pays
Palaos paysPW
Palestine countryPS
Panama pays
Papouasie-Nouvelle-Guinée pays PG
Paraguay paysPY
Pérou paysPE
Philippines paysPH
Pitcairn (Îles) paysN
Pologne paysPL
Portugal pays du Pacifique
Porto Rico paysPR
Qatar contrôle qualité par pays
Réunion countryRE
Roumanie paysRO
Fédération de Russie countryRU
Rwanda countryRW
Sainte-Hélène countrySH
Saint-Christophe-et-Niévès countryKN
Sainte-Lucie countryLC
Saint-Pierre-et-Miquelon pays
Saint-Vincent-et-les-Grenadines VC
Samoa countryWS
Saint-Marin countrySM
São Tomé et Príncipe paysST
Arabie saoudite country
Sénégal paysN
Serbie et Monténégro paysCS
Seychelles countrySC
Sierra Leone countrySL
Singapour paysSG
Slovaquie countrySK
Slovénie paysSI
Salomon (Îles) countrySB
Somalie pays SO
Afrique du Sud paysZA
Géorgie du Sud et Sandwich du Sud (Îles) paysGS
Espagne country
Sri Lanka countryLK
Soudan SD SD
Suriname countrySR
Svalbard et Jan Mayen countrySJ
Swaziland countrySZ
Suède pays du Royaume-Uni
Suisse countryCH
République arabe syrienne countrySY
Taïwan, province chinoise countryTW
Tadjikistan paysTJ
Tanzanie, République unie de countryTZ
Thaïlande paysTH
Togo paysTG
Tokelau paysTK
Tonga pays À
Trinité-et-Tobago paysTT
Tunisie paysTN
Turquie paysTR
Turkménistan countryTM
Îles Turques-et-Caïques pays cible
Tuvalu countryTV
Ouganda countryUG
Ukraine countryUA
Émirats arabes unis countryAE
Royaume-Uni countryRoyaume-Uni
United States countryUS
Îles mineures éloignées des États-Unis countryum
Uruguay country
Ouzbékistan countryUZ
Vanuatu countryVU
Venezuela countryVE
Viêt Nam paysVN
Îles Vierges britanniques countryVG
Vierges américaines (Îles) countryVI
Wallis-et-Futuna countryWF
Sahara occidental paysEH
Yémen countryYE
Yougoslavie countryYU
Zambie countryZM
Zimbabwe paysZW

Codes pays

Le tableau suivant répertorie les codes de pays à deux lettres pouvant être utilisés comme valeurs du paramètre gl:

Pays Country Code
Afghanistan af
Albanie al
Algérie dz
Samoa américaines as
Andorre annonce
Angola ao
Anguilla ai
Antarctique aq
Antigua-et-Barbuda ag
Argentine ar
Arménie am
Aruba aw
Australie au
Autriche at
Azerbaïdjan az
Bahamas bs
Bahreïn bh
Bangladesh bd
Barbade bb
Biélorussie by
Belgique be
Belize Bz
Bénin bj
Bermudes bm
Bhoutan bt
Bolivie bo
Bosnie-Herzégovine ba
Botswana bw
Bouvet (Île) CL
Brésil br
Territoire britannique de l'océan Indien io
Brunei Darussalam bn
Bulgarie bg
Burkina Faso bf
Burundi bi
Cambodge kh
Cameroun cm
Canada ca
Cap-Vert cv
Îles Caïmans ky
République centrafricaine cf.
Tchad d
Chili cl
China cn
Christmas (Île) cx
Îles Cocos Cc
Colombie co
Comores km
Congo cg
Congo, République démocratique du cd
Cook (Îles) mer
Costa Rica cr
Côte d'Ivoire ci
Croatie h
Cuba cu
Chypre cy
République tchèque cz
Danemark dk
Djibouti DJ
Dominique dm
République dominicaine do
Équateur ec
Égypte eg
El Salvador sv
Guinée équatoriale qq
Érythrée er
Estonie ee
Éthiopie et
Falkland (Îles) une
Îles Féroé fo
Fidji fj
Finlande fi
France fr
Guyane française Gf
Polynésie française pf
Terres australes et antarctiques françaises tf
Gabon ga
Gambie gm
Géorgie ge
Allemagne de
Ghana gh
Gibraltar gi
Grèce gr
Groenland gl
Grenade gd
Guadeloupe gp
Guam gu
Guatemala gt
Guinée gn
Guinée-Bissau gw
Guyana gy
Haïti ht
Îles Heard et McDonald hm
Saint-Siège (Cité du Vatican) va
Honduras hn
Hong Kong hk
Hongrie hu
Islande is
Inde in
Indonésie id
Iran, République islamique d' ir
Irak iq
Irlande ie
Israël il
Italie it
Jamaïque jm
Japon jp
Jordanie jo
Kazakhstan kz
Kenya ke
Kiribati ki
Corée, République populaire démocratique de kp
Corée du Sud kr
Koweït kw
Kirghizstan kg
République démocratique populaire lao la
Lettonie lv
Liban lb
Lesotho ls
Libéria lr
Jamahiriya arabe libyenne ly
Liechtenstein li
Lituanie lt
Luxembourg lu
Macao mois
Macédoine, Ancienne République yougoslave de mk
Madagascar mg
Malawi mw
Malaisie my
Maldives mv
Mali ml
Malte mt
Îles Marshall mh
Martinique mq
Mauritanie mr
Maurice mu
Mayotte a
Mexique mx
Micronésie, États fédérés de fm
Moldavie, République de md
Monaco Mc
Mongolie mn
Montserrat ms
Maroc ma
Mozambique mz
Myanmar/Birmanie mm
Namibie N/A
Nauru r
Népal np
Pays-Bas nl
Antilles néerlandaises une
Nouvelle-Calédonie nc
Nouvelle-Zélande nz
Nicaragua ni
Niger ne
Nigéria ng
Niue nu
Norfolk (Île) nf
Mariannes du Nord (Îles) mp
Norvège non
Oman om
Pakistan pk
Palaos pw
Territoires palestiniens (occupés) ps
Panama pa
Papouasie-Nouvelle-Guinée page
Paraguay py
Pérou pe
Philippines ph
Pitcairn (Îles) PN
Pologne pl
Portugal pt
Porto Rico pr
Qatar qa
Réunion re
Roumanie ro
Fédération de Russie ru
Rwanda rw
Sainte-Hélène sh
Saint-Christophe-et-Niévès kn
Sainte-Lucie lc
Saint-Pierre-et-Miquelon pm
Saint-Vincent-et-les-Grenadines vc
Samoa ws
Saint-Marin sm
São Tomé et Príncipe st
Arabie saoudite sa
Sénégal sn
Serbie et Monténégro cs
Seychelles sc
Sierra Leone sl
Singapour sg
Slovaquie sk
Slovénie si
Salomon (Îles) sb
Somalie so
Afrique du Sud za
Géorgie du Sud et Sandwich du Sud (Îles) gs
Espagne es
Sri Lanka lk
Soudan sd
Suriname sr
Svalbard et Jan Mayen Sj
Swaziland sz.
Suède se
Suisse ch
République arabe syrienne sy
Taïwan, province chinoise tw
Tadjikistan tj
Tanzanie, République unie de tz
Thaïlande th
Timor-Oriental tl
Togo tg
Tokelau tk
Tonga des
Trinité-et-Tobago tt
Tunisie tn
Turquie tr
Turkménistan MT
Îles Turques-et-Caïques tc
Tuvalu tv
Ouganda ug
Ukraine ua
Émirats arabes unis ae
Royaume-Uni uk
United States us
Îles mineures éloignées des États-Unis hum
Uruguay uy
Ouzbékistan uz
Vanuatu Vu
Venezuela ve
Viêt Nam vn
Îles Vierges britanniques vg
Vierges américaines (Îles) vi
Wallis-et-Futuna sm
Sahara occidental hein
Yémen oui
Zambie Zm
Zimbabwe Zw