- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- Essayer
Renvoie les métadonnées relatives à la recherche effectuée, les métadonnées relatives au moteur utilisé pour la recherche et les résultats de 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 des paramètres du pays pour obtenir la liste des valeurs valides pour ce paramètre. |
cx |
Identifiant 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 des résultats de recherche doivent contenir. |
excludeTerms |
Identifie un mot ou une expression qui ne doit figurer dans aucun document des résultats de recherche. |
fileType |
Limite les résultats aux fichiers d'une extension spécifiée. Une liste des types de fichiers indexables par Google est disponible 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 de requête 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 nuances de gris, transparentes ou en couleur. Les valeurs acceptées sont les suivantes :
|
imgDominantColor |
Renvoie des images d'une couleur dominante spécifique. Les valeurs acceptées sont les suivantes :
|
imgSize |
Renvoie les 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 spécifique (par exemple, Les valeurs acceptées sont les suivantes :
|
num |
Nombre de résultats de recherche à renvoyer.
|
orTerms |
Fournit des termes de recherche supplémentaires à rechercher dans un document, où chaque document figurant dans les résultats de recherche doit contenir au moins l'un des termes de recherche supplémentaires. |
q |
Requête |
relatedSite |
Spécifie que tous les résultats de recherche doivent être des pages liées à l'URL spécifiée. |
rights |
Filtres basés sur les licences. Les valeurs acceptées sont les suivantes: |
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 |
Spécifie un site donné qui doit toujours être inclus ou exclu 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 en les triant par date. Exemple: sort=date. |
start |
Index du premier résultat à renvoyer. Le nombre de résultats par page étant par défaut 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
.
Niveaux d'accès 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.