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

Opérateurs booléens

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

Définitions des opérateurs booléens

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

Booléen AND [.]
Description

L'opérateur AND (.) renvoie les résultats qui se trouvent à 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 de la collection juste 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 AND pour indiquer que les résultats ne doivent pas être rédigés en français ni en italien. Selon 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 rédigé 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 rédigé en italien.


Booléen OR [|]
Description

L'opérateur OR (.) renvoie les résultats qui se trouvent soit dans la collection de gauche, soit dans celle située à droite de la barre verticale (|).

Exemples

Cet exemple renvoie tous les résultats écrits 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 que les parenthèses sont placées à un emplacement différent de celui de l'exemple de requête pour l'opérateur booléen AND:
lr=-(lang_fr|lang_it)


Parenthèses booléennes [()]
Description

Cet opérateur vous permet de vous assurer que tous les termes de l'ensemble de parenthèses le plus interne sont évalués avant les termes qui ne sont pas entre parenthèses. Vous pouvez utiliser des parenthèses pour ajuster l'ordre dans lequel les termes sont évalués.

Exemples

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

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


Échappement d'URL

Pour effectuer une requête de recherche HTTP, vous devez suivre 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 spécifie 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 des fonctionnalités de recherche. Par conséquent, vous devez utiliser un échappement dans les URL pour tous les caractères non alphanumériques qui apparaissent dans les valeurs des paramètres de recherche.

Pour échapper une chaîne d'URL, convertissez chaque séquence d'espaces blancs en un seul signe "+" (signe plus) et remplacez tous 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 indiqués ci-dessus sont indiqués dans le tableau suivant. Chacun de ces caractères doit être échappé via l'URL dans les valeurs des paramètres de requête.

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

Exemples

Chaîne d'origine Chaîne avec échappement de l'URL
perforation&judy perforation%26judy
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 compressé à l'aide de l'algorithme gzip, vous pouvez économiser entre 50 % et 70 % de 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 indiqué 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 de caractères

Le tableau suivant répertorie les schémas d'encodage des caractères acceptés par Google. Vous pouvez affecter 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 surnoms pour les schémas d'encodage, tandis que les valeurs de la deuxième colonne correspondent aux noms standards des schémas d'encodage. Google renvoie les noms standards dans les résultats XML. Ces noms standards 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, 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 Toutes

Langues d'interface prises en charge

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
Gujarâtî 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
Malayam 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 de la collection "Language"

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

langage 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_en
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 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 de la collection de pays

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 du pays
Afghanistan countryAF
Albanie countryAL
Algérie countryDZ
Samoa américaines countryAS
Andorre countryAD
Angola countryAO
Anguilla countryAI
Antarctique countryAQ
Antigua-et-Barbuda countryAG
Argentine countryAR
Arménie countryAM
Aruba countryAW
Australie countryAU
Autriche countryAT
Azerbaïdjan countryAZ
Bahamas countryBS
Bahreïn countryBH
Bangladesh countryBD
Barbade countryBB
Biélorussie countryBY
Belgique countryBE
Belize countryBZ
Bénin countryBJ
Bermudes countryBM
Bhoutan countryBT
Bolivie countryBO
Bosnie-Herzégovine countryBA
Botswana countryBW
Bouvet (Île) countryBV
Brésil countryBR
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 countryCV
Îles Caïmans countryKY
République centrafricaine countryCF
Tchad countryTD
Chili countryCL
Chine countryCN
Île Christmas countryCX
Îles Cocos countryCC
Colombie countryCO
Comores countryKM
Congo countryCG
Congo, République démocratique du countryCD
Îles Cook countryCK
Costa Rica countryCR
Côte d'Ivoire countryCI
Croatie (Hrvatska) countryHR
Cuba countryCU
Chypre countryCY
Tchéquie countryCZ
Danemark countryDK
Djibouti countryDJ
Dominique countryDM
République dominicaine countryDO
Timor oriental (Île) countryTP
Équateur countryEC
Égypte countryEG
Salvador countrySV
Guinée équatoriale countryGQ
Érythrée countryER
Estonie countryEE
Éthiopie countryET
Union européenne countryEU
Falkland (Îles) countryFK
Îles Féroé countryFO
Fidji countryFJ
Finlande countryFI
France countryFR
France métropolitaine countryFX
Guyane française countryGF
Polynésie française countryPF
Terres australes et antarctiques françaises countryTF
Gabon countryGA
Gambie countryGM
Géorgie countryGE
Allemagne countryDE
Ghana countryGH
Gibraltar countryGI
Grèce countryGR
Groenland countryGL
Grenade countryGD
Guadeloupe countryGP
Guam countryGU
Guatemala countryGT
Guinée countryGN
Guinée-Bissau countryGW
Guyana countryGY
Haïti countryHT
Îles Heard et McDonald countryHM
Saint-Siège (État de la Cité du Vatican) countryVA
Honduras countryHN
Hong Kong countryHK
Hongrie countryHU
Islande countryIS
Inde countryIN
Indonésie countryID
Iran, République islamique d' countryIR
Iraq countryIQ
Irlande countryIE
Israël countryIL
Italie countryIT
Jamaïque countryJM
Japon countryJP
Jordanie countryJO
Kazakhstan countryKZ
Kenya countryKE
Kiribati countryKI
Corée, République populaire démocratique de countryKP
Corée du Sud countryKR
Koweït countryKW
Kirghizstan countryKG
République démocratique populaire lao countryLA
Lettonie countryLV
Liban countryLB
Lesotho countryLS
Libéria countryLR
Libye countryLY
Liechtenstein countryLI
Lituanie countryLT
Luxembourg countryLU
Macao countryMO
Macédoine du Nord countryMK
Madagascar countryMG
Malawi countryMW
Malaisie countryMY
Maldives countryMV
Mali countryML
Malte countryMT
Îles Marshall countryMH
Martinique countryMQ
Mauritanie countryMR
Maurice (Île) countryMU
Mayotte countryYT
Mexique countryMX
Micronésie, États fédérés de countryFM
Moldavie, République de countryMD
Monaco countryMC
Mongolie countryMN
Montserrat countryMS
Maroc countryMA
Mozambique countryMZ
Myanmar countryMM
Namibie countryNA
Nauru countryNR
Népal countryNP
Pays-Bas countryNL
Antilles néerlandaises countryAN
Nouvelle-Calédonie countryNC
Nouvelle-Zélande countryNZ
Nicaragua countryNI
Niger countryNE
Nigeria countryNG
Niue countryNU
Île Norfolk countryNF
Îles Mariannes du Nord countryMP
Norvège countryNO
Oman countryOM
Pakistan countryPK
Palaos countryPW
Palestine countryPS
Panama countryPA
Papouasie-Nouvelle-Guinée countryPG
Paraguay countryPY
Pérou countryPE
Philippines countryPH
Pitcairn countryPN
Pologne countryPL
Portugal countryPT
Porto Rico countryPR
Qatar countryQA
Réunion countryRE
Roumanie countryRO
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 countryPM
Saint-Vincent-et-les-Grenadines countryVC
Samoa countryWS
Saint-Marin countrySM
Sao Tomé-et-Principe countryST
Arabie saoudite countrySA
Sénégal countrySN
Serbie et Monténégro countryCS
Seychelles countrySC
Sierra Leone countrySL
Singapour countrySG
Slovaquie countrySK
Slovénie countrySI
Îles Salomon countrySB
Somalie countrySO
Afrique du Sud countryZA
Géorgie du Sud et îles Sandwich du Sud countryGS
Espagne countryES
Sri Lanka countryLK
Soudan countrySD
Suriname countrySR
Svalbard et Jan Mayen countrySJ
Swaziland countrySZ
Suède countrySE
Suisse countryCH
République arabe syrienne countrySY
Taïwan, province chinoise countryTW
Tadjikistan countryTJ
Tanzanie, République unie de countryTZ
Thaïlande countryTH
Togo countryTG
Tokélaou countryTK
Tonga countryTO
Trinité-et-Tobago countryTT
Tunisie countryTN
Turquie countryTR
Turkménistan countryTM
Îles Turks-et-Caïcos countryTC
Tuvalu countryTV
Ouganda countryUG
Ukraine countryUA
Émirats arabes unis countryAE
Royaume-Uni countryUK
États-Unis countryUS
Îles mineures éloignées des États-Unis countryUM
Uruguay countryUY
Ouzbékistan countryUZ
Vanuatu countryVU
Venezuela countryVE
Viêt Nam countryVN
Îles Vierges britanniques countryVG
Vierges américaines (Îles) countryVI
Wallis-et-Futuna countryWF
Sahara oriental countryEH
Yémen countryYE
Yougoslavie countryYU
Zambie countryZM
Zimbabwe countryZW

Codes de pays

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

Pays Code pays
Afghanistan af
Albanie tous
Algérie dz
Samoa américaines en tant que
Andorre annonce
Angola ao
Anguilla ai
Antarctique aq
Antigua-et-Barbuda ag
Argentine ar
Arménie am
Aruba aw
Australie au
Autriche à
Azerbaïdjan az
Bahamas bs
Bahreïn bh
Bangladesh bd
Barbade bb
Biélorussie via
Belgique be
Belize lb
Bénin bj
Bermudes bm
Bhoutan bt
Bolivie bo
Bosnie-Herzégovine ba
Botswana bw
Bouvet (Île) bv
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 td
Chili cl
Chine cn
Île Christmas cx
Îles Cocos Cc
Colombie co
Comores km
Congo cg
Congo, République démocratique du cd
Îles Cook ck
Costa Rica cr
Côte d'Ivoire ci
Croatie h
Cuba cu
Chypre cy
Tchéquie cz
Danemark dk
Djibouti DJ
Dominique dm
République dominicaine do
Équateur ec
Égypte eg
Salvador sv
Guinée équatoriale GQ
Érythrée er
Estonie ee
Éthiopie et
Falkland (Îles) avant
Î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 m
Saint-Siège (État de la Cité du Vatican) va
Honduras hn
Hong Kong hk
Hongrie hu
Islande est
Inde in
Indonésie id
Iran, République islamique d' ir
Iraq 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
Libye ly
Liechtenstein li
Lituanie lt
Luxembourg lu
Macao mois
Macédoine du Nord mk
Madagascar mg
Malawi mw
Malaisie my
Maldives mv
Mali ml
Malte mt
Îles Marshall mh
Martinique mq
Mauritanie mr
Maurice (Île) mu
Mayotte yt
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 mm
Namibie N/A
Nauru nr
Népal np
Pays-Bas nl
Antilles néerlandaises une
Nouvelle-Calédonie nc
Nouvelle-Zélande nz
Nicaragua ni
Niger ne
Nigeria ng
Niue nu
Île Norfolk nf
Îles Mariannes du Nord 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 numéro de téléphone
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
Sao Tomé-et-Principe 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
Îles Salomon sb
Somalie so
Afrique du Sud za
Géorgie du Sud et îles Sandwich du Sud 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
Tokélaou tk
Tonga pour
Trinité-et-Tobago tt
Tunisie tn
Turquie tr
Turkménistan tm
Îles Turks-et-Caïcos tc
Tuvalu tv
Ouganda ug
Ukraine ua
Émirats arabes unis ae
Royaume-Uni uk
États-Unis 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 wf
Sahara oriental hein
Yémen oui
Zambie m3
Zimbabwe zw