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 qui se trouvent dans la collection juste après l'opérateur moins ("-").

Exemples

L'exemple suivant 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 spécifier que les résultats ne doivent pas être rédigés 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 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 rédigé en français et qu'il n'est pas rédigé en italien.


Booléen OU [|]
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 rédigés en français ni en italien. Notez que les parenthèses sont placées à un emplacement différent de celui utilisé dans 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 figurant dans l'ensemble de parenthèses le plus interne sont évalués avant que les termes qui se trouvent en dehors des parenthèses soient évalués. Vous pouvez utiliser des parenthèses pour ajuster l'ordre dans lequel les termes sont évalués.

Exemples

L'exemple pour l'opérateur NOT [-] montre la construction suivante pour les résultats de requête qui ne sont ni rédigés 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 qui ne sont pas rédigés 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 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 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 des caractères spéciaux pour demander des fonctionnalités de recherche. Par conséquent, vous devez utiliser un caractère d'échappement dans l'URL pour tous les caractères non alphanumériques qui apparaissent dans les valeurs des paramètres de recherche.

Pour échapper une chaîne dans une URL, convertissez chaque séquence d'espaces blancs en un seul signe "+" (signe plus) et remplacez tout autre caractère non alphanumérique 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 indiqués dans le tableau suivant. Chacun de ces caractères doit être protégé par une URL d'échappement dans les valeurs de paramètre de requête.

Caractère Encodage
hexadécimal
$ %24
- %2 j
_ %5°F
. %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 échappement de l'URL
punch&judy coup de poing%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, 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 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 surnoms 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. Les 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 74 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 am
Arabe ar
Arménien hy
Azéri az
Bengali bn
Bulgare bg
Birman my
Catalan ca
Chinois (simplifié) zh-CN
Chinois (traditionnel) zh-TW
Croate h
Tchèque cs
Danois da
Néerlandais nl
Anglais (Royaume-Uni) en-GB
Anglais en
Estonien et
Tagalog fil
Finnois fi
Français (canadien) fr-CA
Français fr
Géorgien ka
Allemand de
Grec el
Gujarâtî gu
Hébreu iw
Hindi hi
Hongrois hu
Islandais is
Indonésien id
Italien it
Japonais ja
Kannada kn
Kazakh kk
Khmer km
Coréen ko
Kirghize ky
Laotien lo
Letton lv
Lituanien lt
Macédonien mk
Malaisien ms
Malayam ml
Marathi mr
Mongol mn
Népalais ne
Norvégien (Bokmal) no
Perse fa
Polonais pl
Portugais (Brésil) pt-BR
Portugais (Portugal) pt-PT
Pendjabi pa
Roumain ro
Russe ru
Serbe (latin) sr-Latn
Serbe sr
Cingalais si
Slovaque sk
Slovène sl
Espagnol (Amérique latine) es-419
Espagnol es
Swahili sw
Suédois sv
Tamoul ta
Télougou te
Thaï th
Turc tr
Ukrainien uk
Urdu ur
Ouzbek uz
Vietnamien vi
Gallois cy

Valeurs de la collection de langues

Vous pouvez utiliser les valeurs suivantes pour spécifier un filtre de langue à 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_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
El 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
Liberia 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 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
Nigéria 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 occidental 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 at
Azerbaïdjan az
Bahamas bs
Bahreïn bh
Bangladesh bd
Barbade bb
Biélorussie via
Belgique be
Belize bz
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
El 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 g
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 (É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 pour les recevoir.
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
Liberia 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 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
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
Île Norfolk nf
Îles Mariannes du Nord mp
Norvège no
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 occidental hein
Yémen oui
Zambie m3
Zimbabwe zw