- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Renvoie les métadonnées sur la recherche effectuée, les métadonnées sur le moteur utilisé pour la recherche et les résultats de la recherche.
Requête HTTP
GET https://customsearch.googleapis.com/customsearch/v1
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
Paramètres | |
---|---|
c2coff |
Active ou désactive la recherche en chinois simplifié et traditionnel. La valeur par défaut de ce paramètre est 0 (zéro), ce qui signifie que la fonctionnalité est activée. Voici les valeurs possibles :
|
cr |
Limite les résultats de recherche aux documents provenant d'un pays spécifique. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre cr. La recherche Google détermine le pays d'un document en analysant:
Consultez la page Valeurs de paramètre de pays pour obtenir la liste des valeurs valides pour ce paramètre. |
cx |
ID Programmable Search Engine à utiliser pour cette requête. |
dateRestrict |
Limite les résultats aux URL en fonction de la date. Les valeurs autorisées incluent les suivantes :
|
exactTerms |
Identifie une expression que tous les documents figurant dans les résultats de recherche doivent contenir. |
excludeTerms |
Identifie un mot ou une expression qui ne doit apparaître dans aucun document dans les résultats de recherche. |
fileType |
Limite les résultats aux fichiers portant l'extension spécifiée. Vous trouverez une liste des types de fichiers indexables par Google dans le Centre d'aide de la Search Console. |
filter |
Permet d'activer ou de désactiver le filtre de contenu en double.
Les valeurs acceptées sont les suivantes :
|
gl |
Géolocalisation de l'utilisateur final
|
googlehost |
Obsolète. Utilisez le paramètre Domaine Google local (par exemple, google.com, google.de ou google.fr) à utiliser pour effectuer la recherche. |
highRange |
Spécifie la valeur de fin d'une plage de recherche.
|
hl |
Définit la langue de l'interface utilisateur.
|
hq |
Ajoute les termes spécifiés à la requête, comme s'ils étaient combinés avec un opérateur logique AND. |
imgColorType |
Renvoie des images en noir et blanc, en niveaux de gris, transparentes ou en couleur. Les valeurs acceptées sont les suivantes :
|
imgDominantColor |
Renvoie les images d'une couleur dominante spécifique. Les valeurs acceptées sont les suivantes :
|
imgSize |
Renvoie des images d'une taille spécifiée. Les valeurs acceptées sont les suivantes :
|
imgType |
Renvoie des images d'un type. Les valeurs acceptées sont les suivantes :
|
linkSite |
Indique que tous les résultats de recherche doivent contenir un lien vers une URL spécifique. |
lowRange |
Spécifie la valeur de départ d'une plage de recherche. Utilisez |
lr |
Limite la recherche aux documents rédigés dans une langue donnée (par exemple, Les valeurs acceptées sont les suivantes :
|
num |
Nombre de résultats de recherche à afficher.
|
orTerms |
Fournit des termes de recherche supplémentaires à rechercher dans un document. Chaque document des résultats de recherche doit contenir au moins l'un des termes de recherche supplémentaires. |
q |
Requête |
relatedSite |
Obsolète. |
rights |
Filtres basés sur les licences. Valeurs acceptées: |
safe |
Niveau de sécurité de la recherche. Les valeurs acceptées sont les suivantes :
|
searchType |
Spécifie le type de recherche: Les valeurs acceptées sont les suivantes :
|
siteSearch |
Indique un site spécifique à inclure ou à exclure des résultats (voir le paramètre |
siteSearchFilter |
Détermine si les résultats du site nommé dans le paramètre Les valeurs acceptées sont les suivantes :
|
sort |
Expression de tri à appliquer aux résultats. Le paramètre de tri spécifie que les résultats doivent être triés en fonction de l'expression spécifiée, c'est-à-dire par date. Exemple: sort=date. |
start |
Index du premier résultat à renvoyer. Par défaut, le nombre de résultats par page est de 10. |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Search
.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/cse
Pour en savoir plus, consultez la présentation d'OAuth 2.0.