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

Booléen OU Recherche [ OU ]
Description

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

Vous pouvez également utiliser le paramètre de requête "as_oq" (comme "as_oq=London+Paris") pour lancer une recherche sur n'importe quel terme dans un ensemble de termes.

Remarque:Si la requête "Londres+OR+Paris" est spécifiée dans une requête de recherche, 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:

Entrée utilisateur:london OR paris Terme de la 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 à Londres, Paris ou un chocolat:

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 accordé aux chocolats:

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

Recherchez des termes "vacances", "chocolats" et "fleurs" dans les documents qui contiennent également Londres ou Paris:

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

Recherchez "vacances" et celle de Londres ou Paris, et recherchez également un chocolat ou une fleur:

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

Opérateurs booléens

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

  • cr
  • lr

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 figurant dans 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 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 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 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)

Internationalisation des requêtes et présentation 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 la réponse. Vous pouvez également filtrer les résultats pour n'inclure que les documents rédigés dans certaines langues.

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

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, en particulier pour les requêtes internationales, lorsque la restriction linguistique (à l'aide du paramètre "lr") n'est pas explicitement spécifiée. Dans ce cas, le paramètre "hl" peut promouvoir des résultats de recherche dans la même langue que celle de la langue de saisie de l'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é possible pour chaque requête.

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

Le chinois simplifié et le chinois traditionnel sont deux variantes écrites du chinois. Le même concept peut être écrit différemment dans chaque variante. Lorsqu'une requête est exécutée dans l'une des variantes, le service de recherche sur le Web Google peut renvoyer des résultats qui incluent des pages appartenant aux deux variantes.

Pour utiliser cette fonction :

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

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

Filtrage des résultats

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

Filtrage automatique des résultats de recherche

Afin de fournir les meilleurs résultats de recherche possible, Google utilise deux techniques pour filtrer automatiquement les résultats généralement considérés comme indésirables:

  • Contenu en double : si plusieurs documents contiennent les mêmes informations, seul le plus pertinent de cet ensemble est inclus dans vos résultats de recherche.

  • Regroupement d'hôtes : si le même site affiche de nombreux résultats de recherche, il est possible que Google n'affiche pas tous les résultats de ce site ou qu'ils soient moins bien classés
    dans le classement.

Nous vous recommandons de laisser ces filtres activés pour les requêtes de recherche standards, car ils améliorent considérablement la qualité de la plupart des résultats de recherche. Toutefois, vous pouvez contourner ces filtres automatiques en définissant le paramètre de requête "filter" sur 0 dans votre requête de recherche.

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

Google s'efforce que SafeSearch soit le plus à jour et le plus complet possible en explorant continuellement le Web et en intégrant les mises à jour provenant des suggestions des utilisateurs.

Vous pouvez définir 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 "sécurisé". Le tableau suivant décrit les paramètres SafeSearch de Google et leur incidence sur les résultats de recherche:

Niveau de SafeSearch Description
high Active une version plus stricte de SafeSearch.
medium Bloque les pages Web à caractère pornographique ou à caractère sexuel explicite.
off Ne filtre pas le contenu réservé aux adultes des résultats de recherche.

* Le paramètre SafeSearch est désactivé par défaut.

Valeurs internationales

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 hr
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 no
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 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
Îles Christmas countryCX
Îles Cocos-Keeling countryCC
Colombie countryCO
Comores countryKM
Congo countryCG
Congo, République démocratique du countryCD
Cook (Îles) countryCK
Costa Rica countryCR
Côte d'Ivoire countryCI
Croatie (Hrvatska) countryHR
Cuba countryCU
Chypre countryCY
République tchèque 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
Laos (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
Norfolk (Île) 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
Îles Géorgie du Sud et 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
Syrie (République arabe syrienne) countrySY
Taïwan, Province de Chine 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 al
Algérie dz
Samoa américaines as
Andorre ad
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) 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
Îles Christmas cx
Îles Cocos-Keeling cc
Colombie co
Comores km
Congo cg
Congo, République démocratique du cd
Cook (Îles) ck
Costa Rica cr
Côte d'Ivoire ci
Croatie hr
Cuba cu
Chypre cy
République tchèque 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) fk
Î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 (État de la Cité du Vatican) va
Honduras hn
Hong Kong hk
Hongrie hu
Islande is
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
Laos (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 mo
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 na
Nauru nr
Népal np
Pays-Bas nl
Antilles néerlandaises an
Nouvelle-Calédonie nc
Nouvelle-Zélande nz
Nicaragua ni
Niger ne
Nigeria ng
Niue nu
Norfolk (Île) 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 pg
Paraguay py
Pérou pe
Philippines ph
Pitcairn 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
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
Îles Géorgie du Sud et 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
Syrie (République arabe syrienne) sy
Taïwan, Province de Chine tw
Tadjikistan tj
Tanzanie, République unie de tz
Thaïlande th
Timor-Oriental tl
Togo tg
Tokélaou tk
Tonga to
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 um
Uruguay uy
Ouzbékistan uz
Vanuatu vu
Venezuela ve
Viêt Nam vn
Vierges britanniques (Îles) vg
Vierges américaines (Îles) vi
Wallis-et-Futuna wf
Sahara occidental eh
Yémen ye
Zambie zm
Zimbabwe zw