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

Recherche booléenne OU [ OU ]
Description

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

Vous pouvez également utiliser la commande « as_oq » demander (comme "as_oq=Londres+Paris") pour lancer une recherche sur n'importe quel terme dans conditions d'utilisation.

Remarque:Si une requête de recherche spécifie la requête "Londres+OR+Paris", les résultats de recherche incluront documents contenant au moins l'un de ces deux mots. Dans certains cas, documents figurant dans les résultats de recherche peuvent contenir ces deux mots.
Exemples

Recherchez Londres ou Paris:

Entrée utilisateur:london OR paris Terme de requête:q=london+OR+paris

Recherchez des vacances et soit Londres, soit Paris:

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

Recherchez "vacances", "Londres", "Paris" ou "chocolat" :

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

Recherchez "vacances et chocolats" et "Londres" ou "Paris", avec le moins de poids apporté aux chocolats:

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

Recherchez des vacances, des chocolats et des fleurs dans des documents qui contiennent également soit Londres, soit Paris:

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

Recherchez "vacances", "Londres" ou "Paris", ainsi que pour l'un des chocolats ou des fleurs:

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 pour les 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 sont à l'intersection des collections de chaque côté de "." ; .
Exemples

Cet exemple supprime tous les résultats en français ou 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

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

Cet exemple supprime tous les résultats en français ou 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 écrits dans le français ou l'italien. Selon l'emplacement des parenthèses dans votre requête, vous pouvez utilisez soit l'opérateur booléen AND, soit 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 proposition booléenne doit exprimer que le document n'est pas écrit en français et qu'il n'est pas rédigé en en italien.

Booléen OR [|]
Description

L'opérateur OR (|) renvoie les résultats au format la collection située à gauche ou à droite de la barre verticale ("|").
Exemples

Cet exemple renvoie tous les résultats écrits dans Chinois simplifié ou chinois traditionnel:
lr=lang_zh-TW|lang_zh-CN

Cet exemple demande tous les résultats qui ne sont pas écrits en français ou italien ; vous remarquerez qu'elle place les parenthèses à un autre endroit que 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 de la couche interne ensemble de parenthèses est évalué avant les termes en dehors des parenthèses sont évaluées. 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 pas rédigé en français ou en italien:
lr=(-lang_fr).(-lang_it)

L'exemple de l'opérateur OR (|) renvoie également une requête permettant d'obtenir des résultats non rédigés en français de Italien. Comme ce dernier exemple utilise l'opérateur OR au lieu de que l'opérateur AND, elle doit également modifier l'emplacement parenthèses:
lr=-(lang_fr|lang_it)

Internationalisation des requêtes et de la présentation des résultats

Le service Google WebSearch vous permet de rechercher des documents dans plusieurs langues. Vous pouvez spécifier l'encodage des caractères pour interpréter votre requête HTTP et encoder votre réponse. Vous pouvez également filtrer les résultats pour n'inclure que les documents. dans certaines langues.

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

Langues de l'interface

Vous pouvez utiliser l'en-tête "hl" le paramètre de requête suivant : à identifier la langue de votre interface graphique. "hl" peut avoir une incidence sur les résultats de recherche, en particulier sur Requêtes internationales lorsque la restriction linguistique (à l'aide du paramètre "lr") n'est pas spécifiée explicitement Dans ces cas, l'élément "hl" peut promouvoir des résultats de recherche. dans la même langue que la langue de saisie de l'utilisateur.

Nous vous conseillons de définir explicitement "hl" paramètre dans les résultats de recherche pour que Google sélectionne la meilleure qualité possible les résultats de recherche pour chaque requête.

Consultez l'interface compatible Langues pour obtenir la liste complète des valeurs valides pour "hl" .

Le chinois simplifié et le chinois traditionnel sont deux variantes d'écriture de la langue chinoise. Le même concept peut être écrit différemment dans chaque variante. Pour une requête portant sur l'une des variantes, la requête Google Le service WebSearch peut renvoyer des résultats incluant des pages aux formats suivants : .

Pour utiliser cette fonction :

  1. Définir "c2coff" paramètre de requête à 0
    et
  2. Utilisez l'une des méthodes ci-dessous.
    • Ne définissez pas "lr" paramètre de requête
      ou
    • Définir "lr" le paramètre de requête à lr=lang_zh-TW|lang_zh-CN

L'exemple suivant montre les paramètres de requête que vous incluriez dans une requête de résultats. en chinois simplifié et traditionnel. Notez que les informations supplémentaires requises, telles que que "client", n'est pas incluse 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 votre recherche. résultats:

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 de recherche généralement considéré comme indésirable:

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

  • Regroupement des hôtes : si de nombreux résultats de recherche issus du le même site, il est possible que Google n'affiche pas tous les résultats de ce site ou afficher les résultats plus bas en
    le classement qu'il ne l'aurait été autrement.

Nous vous recommandons de laisser ces filtres activés pour les requêtes de recherche courantes. car les filtres améliorent nettement la qualité de la plupart des recherches résultats. Vous pouvez toutefois ignorer ces filtres automatiques en définissant le "filtre" paramètre de requête sur 0 dans votre requête de recherche.

Filtrer le contenu réservé aux adultes avec SafeSearch

De nombreux clients de Google ne souhaitent pas afficher de résultats de recherche pour sites incluant du contenu réservé aux adultes. À l'aide du filtre SafeSearch, vous pouvez filtrer pour les résultats de recherche incluant du contenu réservé aux adultes et de les éliminer. Les filtres Google utilisent une technologie propriétaire pour vérifier les mots clés et expressions et les URL. Bien qu'aucun filtre ne soit fiable à 100 %, SafeSearch Supprimez l'immense majorité du contenu réservé aux adultes de votre recherche. résultats.

Google s'efforce de proposer SafeSearch en permanence en explorant continuellement le Web et en intégrant des mises à jour à partir des suggestions d'utilisateurs.

Vous pouvez définir dans quelle mesure Google filtre vos résultats du contenu réservé aux adultes en utilisant le concept de requête. Le tableau suivant décrit les paramètres SafeSearch de Google et comment ceux-ci paramètres affecteront 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 contenant la pornographie et tout autre contenu à caractère sexuel explicite.
off Ne filtre pas les adultes dans les résultats de recherche.

* Par défaut, SafeSearch est désactivé. .

Valeurs internationales

Langues d'interface prises en charge

Google prend en charge plus de 80 langues. L'interface par défaut est l'anglais. La liste suivante identifie toutes les interfaces dans les langues 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
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
Latin 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
Panjâbî 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
Tigrigna ti
Turc tr
Ukrainien uk
Urdu ur
Ouzbek uz
Vietnamien vi
Gallois cy
Xhosa xh
Zoulou zu

Valeurs de la collection par pays

Vous pouvez spécifier un filtre de pays à l'aide des valeurs suivantes : "cr" paramètre de requête:

Pays Nom de la collection de 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
Caïmans (Îles) 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
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 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
Féroé (Îles) 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
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
Marshall (Îles) 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
Birmanie 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
Mariannes du Nord (Îles) 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 (Îles) 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 pays

Le tableau suivant répertorie les codes de pays à deux lettres pouvant être utilisées 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
Caïmans (Îles) 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
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
El Salvador sv
Guinée équatoriale gq
Érythrée er
Estonie ee
Éthiopie et
Falkland (Îles Malouines) fk
Féroé (Îles) 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
Liberia 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
Marshall (Îles) 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
Birmanie 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
Mariannes du Nord (Îles) 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 (Î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
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