Search

Réponse à une requête de recherche personnalisée.

Représentation JSON
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Champs
kind

string

Identifiant unique du type d'objet actuel. Pour cette API, il s'agit de customsearch#search.

url

object

Élément URL OpenSearch qui définit le modèle pour cette API.

url.type

string

Type MIME du modèle d'URL OpenSearch pour l'API JSON Custom Search.

url.template

string

Le modèle OpenSearch réel de cette API.

queries

object

Contient un ou plusieurs ensembles de métadonnées de requête, associés par nom de rôle. Les noms de rôle possibles incluent request défini par les rôles de requête OpenSearch et deux rôles personnalisés: nextPage et previousPage.

queries.previousPage[]

object

Métadonnées représentant la page de résultats précédente, le cas échéant.

queries.previousPage[].title

string

Description de la requête.

queries.previousPage[].totalResults

string (int64 format)

Estimation du nombre total de résultats de recherche. Elles peuvent ne pas être exactes.

queries.previousPage[].searchTerms

string

Termes de recherche saisis par l'utilisateur.

queries.previousPage[].count

integer

Nombre de résultats de recherche renvoyés dans cet ensemble.

queries.previousPage[].startIndex

integer

Indice de l'ensemble actuel de résultats de recherche par rapport à l'ensemble total de résultats, où l'index du premier résultat est 1.

queries.previousPage[].startPage

integer

Numéro de page de cet ensemble de résultats, où la longueur de la page est définie par la propriété count.

queries.previousPage[].language

string

Langue des résultats de recherche.

queries.previousPage[].inputEncoding

string

Encodage des caractères accepté pour les requêtes de recherche.

queries.previousPage[].outputEncoding

string

Encodage des caractères pris en charge pour les résultats de recherche.

queries.previousPage[].safe

string

Spécifie le niveau SafeSearch utilisé pour filtrer les résultats réservés aux adultes. Cette propriété personnalisée n'est pas définie dans la spécification OpenSearch. Les valeurs valides pour ce paramètre sont les suivantes:

  • "off": désactiver SafeSearch

  • "active": activer SafeSearch

queries.previousPage[].cx

string

Identifiant d'un moteur créé à l'aide du panneau de configuration Programmable Search Engine. Cette propriété personnalisée n'est pas définie dans la spécification OpenSearch. Ce paramètre est obligatoire.

queries.previousPage[].sort

string

Spécifie que les résultats doivent être triés en fonction de l'expression spécifiée. Par exemple, triez par date.

queries.previousPage[].filter

string

Active ou désactive le filtrage automatique des résultats de recherche Google. Pour en savoir plus sur les filtres des résultats de recherche Google, consultez la page Filtrage automatique. Les valeurs valides pour ce paramètre sont les suivantes:

  • 0: désactivé

  • 1: Activé (par défaut)

Remarque: Par défaut, Google filtre tous les résultats de recherche afin d'en améliorer la qualité.

queries.previousPage[].gl

string

Améliore les résultats de recherche dont le pays d'origine correspond à la valeur du paramètre. Consultez Codes de pays pour obtenir la liste des valeurs valides.

La spécification d'une valeur de paramètre gl dans les requêtes WebSearch devrait améliorer la pertinence des résultats. Cela est particulièrement vrai pour les clients internationaux et, plus précisément, pour les clients situés dans des pays anglophones autres que les États-Unis.

queries.previousPage[].cr

string

Limite les résultats de recherche aux documents provenant d'un pays donné. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre cr.

Google WebSearch détermine le pays d'un document en analysant les éléments suivants:

  • Domaine de premier niveau de l'URL du document.

  • Emplacement géographique de l'adresse IP du serveur Web.

Consultez Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.

queries.previousPage[].googleHost

string

Spécifie le domaine Google (google.com, google.de ou google.fr, par exemple) auquel la recherche doit être limitée.

queries.previousPage[].disableCnTwTranslation

string

Active ou désactive la fonctionnalité de recherche en chinois simplifié et traditionnel.

Voici les valeurs possibles :

  • 0: activé (par défaut)

  • 1: désactivé

queries.previousPage[].hq

string

Ajoute les termes spécifiés à la requête, comme s'ils étaient combinés avec un opérateur logique AND.

queries.previousPage[].hl

string

Spécifie la langue d'interface (langue de l'hôte) de votre interface utilisateur. La définition explicite de ce paramètre améliore les performances et la qualité de vos résultats de recherche.

Consultez la section Langues de l'interface du document Internationalisation des requêtes et de la présentation des résultats pour en savoir plus, et la section Langues d'interface compatibles pour obtenir la liste des langues prises en charge.

queries.previousPage[].siteSearch

string

Limite les résultats aux URL d'un site spécifié.

queries.previousPage[].siteSearchFilter

string

Indique si les résultats du site indiqué dans le paramètre sitesearch doivent être inclus ou exclus. Voici les valeurs possibles :

  • i: inclure le contenu du site

  • e: exclure le contenu du site

queries.previousPage[].exactTerms

string

Identifie l'expression que tous les documents doivent contenir dans les résultats de recherche.

queries.previousPage[].excludeTerms

string

Identifie un mot ou une expression qui ne doit apparaître dans aucun document des résultats de recherche.

queries.previousPage[].linkSite

string

Indique que tous les résultats doivent contenir un lien vers une URL spécifique.

queries.previousPage[].orTerms

string

Fournit des termes de recherche supplémentaires à vérifier dans un document, où chaque document dans les résultats de recherche doit contenir au moins l'un des termes de recherche supplémentaires. Vous pouvez également utiliser le terme de requête OU booléen pour ce type de requête.

queries.previousPage[].relatedSite

string

Indique que tous les résultats de recherche doivent correspondre à des pages liées à l'URL spécifiée. La valeur du paramètre doit être une URL.

queries.previousPage[].dateRestrict

string

Limite les résultats aux URL en fonction de la date. Les valeurs autorisées incluent les suivantes :

  • d[number]: demande les résultats du nombre de jours précédents spécifié.

  • w[number]: demande les résultats du nombre spécifié de semaines précédentes.

  • m[number]: demande les résultats du nombre spécifié de mois précédents.

  • y[number]: demande les résultats du nombre spécifié d'années précédentes.

queries.previousPage[].lowRange

string

Spécifie la valeur de départ d'une plage de recherche. Utilisez cse:lowRange et cse:highrange pour ajouter une plage de recherche inclusive de lowRange...highRange à la requête.

queries.previousPage[].highRange

string

Spécifie la valeur de fin d'une plage de recherche. Utilisez cse:lowRange et cse:highrange pour ajouter une plage de recherche inclusive de lowRange...highRange à la requête.

queries.previousPage[].fileType

string

Limite les résultats aux fichiers portant l'extension spécifiée. Les types de fichiers acceptés par Google sont les suivants:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Écriture Mac (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format RTF (rtf)

  • Shockwave Flash (swf)

  • Texte (ans, txt).

D'autres types de fichiers pourront être ajoutés ultérieurement. La liste la plus récente est disponible dans les questions fréquentes sur les types de fichiers de Google.

queries.previousPage[].rights

string

Filtres basés sur les licences. Les valeurs autorisées incluent les suivantes :

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

Les valeurs autorisées sont web et image. S'ils ne sont pas spécifiés, les résultats sont limités aux pages Web.

queries.previousPage[].imgSize

string

Limite les résultats aux images d'une taille spécifiée. Voici les valeurs possibles :

  • icon (petite taille)

  • small | medium | large | xlarge (moyen)

  • xxlarge (grande)

  • huge (très grande)

queries.previousPage[].imgType

string

Limite les résultats aux images d'un type spécifié. Voici les valeurs possibles :

  • clipart (Image clipart)

  • face (visage)

  • lineart (dessin au trait)

  • photo (photo)

  • animated (animation)

  • stock (bourse)

queries.previousPage[].imgColorType

string

Limite les résultats aux images d'un type de couleur spécifié. Les valeurs acceptées sont les suivantes:

  • mono (noir et blanc)

  • gray (niveaux de gris)

  • color (couleur)

queries.previousPage[].imgDominantColor

string

Limite les résultats aux images ayant une couleur dominante spécifique. Voici les valeurs possibles :

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

Métadonnées représentant la requête actuelle.

queries.request[].title

string

Description de la requête.

queries.request[].totalResults

string (int64 format)

Estimation du nombre total de résultats de recherche. Elles peuvent ne pas être exactes.

queries.request[].searchTerms

string

Termes de recherche saisis par l'utilisateur.

queries.request[].count

integer

Nombre de résultats de recherche renvoyés dans cet ensemble.

queries.request[].startIndex

integer

Indice de l'ensemble actuel de résultats de recherche par rapport à l'ensemble total de résultats, où l'index du premier résultat est 1.

queries.request[].startPage

integer

Numéro de page de cet ensemble de résultats, où la longueur de la page est définie par la propriété count.

queries.request[].language

string

Langue des résultats de recherche.

queries.request[].inputEncoding

string

Encodage des caractères accepté pour les requêtes de recherche.

queries.request[].outputEncoding

string

Encodage des caractères pris en charge pour les résultats de recherche.

queries.request[].safe

string

Spécifie le niveau SafeSearch utilisé pour filtrer les résultats réservés aux adultes. Cette propriété personnalisée n'est pas définie dans la spécification OpenSearch. Les valeurs valides pour ce paramètre sont les suivantes:

  • "off": désactiver SafeSearch

  • "active": activer SafeSearch

queries.request[].cx

string

Identifiant d'un moteur créé à l'aide du panneau de configuration Programmable Search Engine. Cette propriété personnalisée n'est pas définie dans la spécification OpenSearch. Ce paramètre est obligatoire.

queries.request[].sort

string

Spécifie que les résultats doivent être triés en fonction de l'expression spécifiée. Par exemple, triez par date.

queries.request[].filter

string

Active ou désactive le filtrage automatique des résultats de recherche Google. Pour en savoir plus sur les filtres des résultats de recherche Google, consultez la page Filtrage automatique. Les valeurs valides pour ce paramètre sont les suivantes:

  • 0: désactivé

  • 1: Activé (par défaut)

Remarque: Par défaut, Google filtre tous les résultats de recherche afin d'en améliorer la qualité.

queries.request[].gl

string

Améliore les résultats de recherche dont le pays d'origine correspond à la valeur du paramètre. Consultez Codes de pays pour obtenir la liste des valeurs valides.

La spécification d'une valeur de paramètre gl dans les requêtes WebSearch devrait améliorer la pertinence des résultats. Cela est particulièrement vrai pour les clients internationaux et, plus précisément, pour les clients situés dans des pays anglophones autres que les États-Unis.

queries.request[].cr

string

Limite les résultats de recherche aux documents provenant d'un pays donné. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre cr.

Google WebSearch détermine le pays d'un document en analysant les éléments suivants:

  • Domaine de premier niveau de l'URL du document.

  • Emplacement géographique de l'adresse IP du serveur Web.

Consultez Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.

queries.request[].googleHost

string

Spécifie le domaine Google (google.com, google.de ou google.fr, par exemple) auquel la recherche doit être limitée.

queries.request[].disableCnTwTranslation

string

Active ou désactive la fonctionnalité de recherche en chinois simplifié et traditionnel.

Voici les valeurs possibles :

  • 0: activé (par défaut)

  • 1: désactivé

queries.request[].hq

string

Ajoute les termes spécifiés à la requête, comme s'ils étaient combinés avec un opérateur logique AND.

queries.request[].hl

string

Spécifie la langue d'interface (langue de l'hôte) de votre interface utilisateur. La définition explicite de ce paramètre améliore les performances et la qualité de vos résultats de recherche.

Consultez la section Langues de l'interface du document Internationalisation des requêtes et de la présentation des résultats pour en savoir plus, et la section Langues d'interface compatibles pour obtenir la liste des langues prises en charge.

queries.request[].siteSearch

string

Limite les résultats aux URL d'un site spécifié.

queries.request[].siteSearchFilter

string

Indique si les résultats du site indiqué dans le paramètre sitesearch doivent être inclus ou exclus. Voici les valeurs possibles :

  • i: inclure le contenu du site

  • e: exclure le contenu du site

queries.request[].exactTerms

string

Identifie l'expression que tous les documents doivent contenir dans les résultats de recherche.

queries.request[].excludeTerms

string

Identifie un mot ou une expression qui ne doit apparaître dans aucun document des résultats de recherche.

queries.request[].linkSite

string

Indique que tous les résultats doivent contenir un lien vers une URL spécifique.

queries.request[].orTerms

string

Fournit des termes de recherche supplémentaires à vérifier dans un document, où chaque document dans les résultats de recherche doit contenir au moins l'un des termes de recherche supplémentaires. Vous pouvez également utiliser le terme de requête OU booléen pour ce type de requête.

queries.request[].relatedSite

string

Indique que tous les résultats de recherche doivent correspondre à des pages liées à l'URL spécifiée. La valeur du paramètre doit être une URL.

queries.request[].dateRestrict

string

Limite les résultats aux URL en fonction de la date. Les valeurs autorisées incluent les suivantes :

  • d[number]: demande les résultats du nombre de jours précédents spécifié.

  • w[number]: demande les résultats du nombre spécifié de semaines précédentes.

  • m[number]: demande les résultats du nombre spécifié de mois précédents.

  • y[number]: demande les résultats du nombre spécifié d'années précédentes.

queries.request[].lowRange

string

Spécifie la valeur de départ d'une plage de recherche. Utilisez cse:lowRange et cse:highrange pour ajouter une plage de recherche inclusive de lowRange...highRange à la requête.

queries.request[].highRange

string

Spécifie la valeur de fin d'une plage de recherche. Utilisez cse:lowRange et cse:highrange pour ajouter une plage de recherche inclusive de lowRange...highRange à la requête.

queries.request[].fileType

string

Limite les résultats aux fichiers portant l'extension spécifiée. Les types de fichiers acceptés par Google sont les suivants:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Écriture Mac (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format RTF (rtf)

  • Shockwave Flash (swf)

  • Texte (ans, txt).

D'autres types de fichiers pourront être ajoutés ultérieurement. La liste la plus récente est disponible dans les questions fréquentes sur les types de fichiers de Google.

queries.request[].rights

string

Filtres basés sur les licences. Les valeurs autorisées incluent les suivantes :

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

Les valeurs autorisées sont web et image. S'ils ne sont pas spécifiés, les résultats sont limités aux pages Web.

queries.request[].imgSize

string

Limite les résultats aux images d'une taille spécifiée. Voici les valeurs possibles :

  • icon (petite taille)

  • small | medium | large | xlarge (moyen)

  • xxlarge (grande)

  • huge (très grande)

queries.request[].imgType

string

Limite les résultats aux images d'un type spécifié. Voici les valeurs possibles :

  • clipart (Image clipart)

  • face (visage)

  • lineart (dessin au trait)

  • photo (photo)

  • animated (animation)

  • stock (bourse)

queries.request[].imgColorType

string

Limite les résultats aux images d'un type de couleur spécifié. Les valeurs acceptées sont les suivantes:

  • mono (noir et blanc)

  • gray (niveaux de gris)

  • color (couleur)

queries.request[].imgDominantColor

string

Limite les résultats aux images ayant une couleur dominante spécifique. Voici les valeurs possibles :

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

Métadonnées représentant la page de résultats suivante, le cas échéant.

queries.nextPage[].title

string

Description de la requête.

queries.nextPage[].totalResults

string (int64 format)

Estimation du nombre total de résultats de recherche. Elles peuvent ne pas être exactes.

queries.nextPage[].searchTerms

string

Termes de recherche saisis par l'utilisateur.

queries.nextPage[].count

integer

Nombre de résultats de recherche renvoyés dans cet ensemble.

queries.nextPage[].startIndex

integer

Indice de l'ensemble actuel de résultats de recherche par rapport à l'ensemble total de résultats, où l'index du premier résultat est 1.

queries.nextPage[].startPage

integer

Numéro de page de cet ensemble de résultats, où la longueur de la page est définie par la propriété count.

queries.nextPage[].language

string

Langue des résultats de recherche.

queries.nextPage[].inputEncoding

string

Encodage des caractères accepté pour les requêtes de recherche.

queries.nextPage[].outputEncoding

string

Encodage des caractères pris en charge pour les résultats de recherche.

queries.nextPage[].safe

string

Spécifie le niveau SafeSearch utilisé pour filtrer les résultats réservés aux adultes. Cette propriété personnalisée n'est pas définie dans la spécification OpenSearch. Les valeurs valides pour ce paramètre sont les suivantes:

  • "off": désactiver SafeSearch

  • "active": activer SafeSearch

queries.nextPage[].cx

string

Identifiant d'un moteur créé à l'aide du panneau de configuration Programmable Search Engine. Cette propriété personnalisée n'est pas définie dans la spécification OpenSearch. Ce paramètre est obligatoire.

queries.nextPage[].sort

string

Spécifie que les résultats doivent être triés en fonction de l'expression spécifiée. Par exemple, triez par date.

queries.nextPage[].filter

string

Active ou désactive le filtrage automatique des résultats de recherche Google. Pour en savoir plus sur les filtres des résultats de recherche Google, consultez la page Filtrage automatique. Les valeurs valides pour ce paramètre sont les suivantes:

  • 0: désactivé

  • 1: Activé (par défaut)

Remarque: Par défaut, Google filtre tous les résultats de recherche afin d'en améliorer la qualité.

queries.nextPage[].gl

string

Améliore les résultats de recherche dont le pays d'origine correspond à la valeur du paramètre. Consultez Codes de pays pour obtenir la liste des valeurs valides.

La spécification d'une valeur de paramètre gl dans les requêtes WebSearch devrait améliorer la pertinence des résultats. Cela est particulièrement vrai pour les clients internationaux et, plus précisément, pour les clients situés dans des pays anglophones autres que les États-Unis.

queries.nextPage[].cr

string

Limite les résultats de recherche aux documents provenant d'un pays donné. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre cr.

Google WebSearch détermine le pays d'un document en analysant les éléments suivants:

  • Domaine de premier niveau de l'URL du document.

  • Emplacement géographique de l'adresse IP du serveur Web.

Consultez Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.

queries.nextPage[].googleHost

string

Spécifie le domaine Google (google.com, google.de ou google.fr, par exemple) auquel la recherche doit être limitée.

queries.nextPage[].disableCnTwTranslation

string

Active ou désactive la fonctionnalité de recherche en chinois simplifié et traditionnel.

Voici les valeurs possibles :

  • 0: activé (par défaut)

  • 1: désactivé

queries.nextPage[].hq

string

Ajoute les termes spécifiés à la requête, comme s'ils étaient combinés avec un opérateur logique AND.

queries.nextPage[].hl

string

Spécifie la langue d'interface (langue de l'hôte) de votre interface utilisateur. La définition explicite de ce paramètre améliore les performances et la qualité de vos résultats de recherche.

Consultez la section Langues de l'interface du document Internationalisation des requêtes et de la présentation des résultats pour en savoir plus, et la section Langues d'interface compatibles pour obtenir la liste des langues prises en charge.

queries.nextPage[].siteSearch

string

Limite les résultats aux URL d'un site spécifié.

queries.nextPage[].siteSearchFilter

string

Indique si les résultats du site indiqué dans le paramètre sitesearch doivent être inclus ou exclus. Voici les valeurs possibles :

  • i: inclure le contenu du site

  • e: exclure le contenu du site

queries.nextPage[].exactTerms

string

Identifie l'expression que tous les documents doivent contenir dans les résultats de recherche.

queries.nextPage[].excludeTerms

string

Identifie un mot ou une expression qui ne doit apparaître dans aucun document des résultats de recherche.

queries.nextPage[].linkSite

string

Indique que tous les résultats doivent contenir un lien vers une URL spécifique.

queries.nextPage[].orTerms

string

Fournit des termes de recherche supplémentaires à vérifier dans un document, où chaque document dans les résultats de recherche doit contenir au moins l'un des termes de recherche supplémentaires. Vous pouvez également utiliser le terme de requête OU booléen pour ce type de requête.

queries.nextPage[].relatedSite

string

Indique que tous les résultats de recherche doivent correspondre à des pages liées à l'URL spécifiée. La valeur du paramètre doit être une URL.

queries.nextPage[].dateRestrict

string

Limite les résultats aux URL en fonction de la date. Les valeurs autorisées incluent les suivantes :

  • d[number]: demande les résultats du nombre de jours précédents spécifié.

  • w[number]: demande les résultats du nombre spécifié de semaines précédentes.

  • m[number]: demande les résultats du nombre spécifié de mois précédents.

  • y[number]: demande les résultats du nombre spécifié d'années précédentes.

queries.nextPage[].lowRange

string

Spécifie la valeur de départ d'une plage de recherche. Utilisez cse:lowRange et cse:highrange pour ajouter une plage de recherche inclusive de lowRange...highRange à la requête.

queries.nextPage[].highRange

string

Spécifie la valeur de fin d'une plage de recherche. Utilisez cse:lowRange et cse:highrange pour ajouter une plage de recherche inclusive de lowRange...highRange à la requête.

queries.nextPage[].fileType

string

Limite les résultats aux fichiers portant l'extension spécifiée. Les types de fichiers acceptés par Google sont les suivants:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Écriture Mac (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Format RTF (rtf)

  • Shockwave Flash (swf)

  • Texte (ans, txt).

D'autres types de fichiers pourront être ajoutés ultérieurement. La liste la plus récente est disponible dans les questions fréquentes sur les types de fichiers de Google.

queries.nextPage[].rights

string

Filtres basés sur les licences. Les valeurs autorisées incluent les suivantes :

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

Les valeurs autorisées sont web et image. S'ils ne sont pas spécifiés, les résultats sont limités aux pages Web.

queries.nextPage[].imgSize

string

Limite les résultats aux images d'une taille spécifiée. Voici les valeurs possibles :

  • icon (petite taille)

  • small | medium | large | xlarge (moyen)

  • xxlarge (grande)

  • huge (très grande)

queries.nextPage[].imgType

string

Limite les résultats aux images d'un type spécifié. Voici les valeurs possibles :

  • clipart (Image clipart)

  • face (visage)

  • lineart (dessin au trait)

  • photo (photo)

  • animated (animation)

  • stock (bourse)

queries.nextPage[].imgColorType

string

Limite les résultats aux images d'un type de couleur spécifié. Les valeurs acceptées sont les suivantes:

  • mono (noir et blanc)

  • gray (niveaux de gris)

  • color (couleur)

queries.nextPage[].imgDominantColor

string

Limite les résultats aux images ayant une couleur dominante spécifique. Voici les valeurs possibles :

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

Ensemble des promotions. Présent uniquement si les fichiers de configuration du moteur de recherche personnalisé définissent des résultats mis en avant pour la requête donnée.

context

object (Struct format)

Métadonnées et filtres associés au moteur de recherche donné, y compris:

  • Nom du moteur de recherche utilisé pour la requête.

  • Ensemble d'objets d'attribut (affinements) que vous pouvez utiliser pour affiner une recherche.

searchInformation

object

Métadonnées sur cette recherche, y compris la durée de la recherche et le nombre total de résultats.

searchInformation.searchTime

number

Temps nécessaire au serveur pour renvoyer les résultats de recherche.

searchInformation.formattedSearchTime

string

Temps nécessaire au serveur pour renvoyer des résultats de recherche, formatés selon le style des paramètres régionaux.

searchInformation.totalResults

string

Nombre total de résultats de recherche renvoyés par la requête.

searchInformation.formattedTotalResults

string

Nombre total de résultats de recherche, mis en forme selon le style des paramètres régionaux.

spelling

object

Encapsule une requête corrigée.

spelling.correctedQuery

string

Requête corrigée.

spelling.htmlCorrectedQuery

string

Requête corrigée, mise en forme au format HTML.

items[]

object (Result)

Ensemble actuel de résultats de recherche personnalisés.

Promotion

Résultat de la promotion.

Représentation JSON
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Champs
title

string

Titre de la promotion.

htmlTitle

string

Titre de la promotion, au format HTML.

bodyLines[]

object

Tableau des objets de type bloc pour cette promotion.

bodyLines[].title

string

Texte de l'objet de bloc, s'il contient du texte.

bodyLines[].htmlTitle

string

Texte de l'objet bloc au format HTML, s'il contient du texte.

bodyLines[].url

string

URL du lien de l'objet de blocage, le cas échéant.

bodyLines[].link

string

Texte d'ancrage du lien de l'objet de bloc, s'il contient un lien.

image

object

Image associée à cette promotion, le cas échéant.

image.source

string

URL de l'image de ce lien promotionnel.

image.width

integer

Largeur de l'image en pixels.

image.height

integer

Hauteur de l'image en pixels.

Résultat

Un résultat de recherche personnalisé.

Représentation JSON
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Champs
kind

string

Identifiant unique du type d'objet actuel. Pour cette API, il s'agit de customsearch#result..

title

string

Titre du résultat de recherche, en texte brut.

htmlTitle

string

Titre du résultat de recherche, au format HTML.

snippet

string

Extrait du résultat de recherche, en texte brut.

htmlSnippet

string

Extrait du résultat de recherche, au format HTML.

cacheId

string

Indique l'ID de la version mise en cache du résultat de recherche Google.

formattedUrl

string

URL affichée après l'extrait de chaque résultat de recherche.

htmlFormattedUrl

string

URL au format HTML qui s'affiche à la suite de l'extrait de code pour chaque résultat de recherche.

pagemap

object (Struct format)

Contient des informations PageMap pour ce résultat de recherche.

mime

string

Type MIME du résultat de recherche.

fileFormat

string

Format de fichier du résultat de recherche.

image

object

Encapsule toutes les informations concernant une image renvoyée dans les résultats de recherche.

image.contextLink

string

URL pointant vers la page Web qui héberge l'image.

image.height

integer

Hauteur de l'image, en pixels.

image.width

integer

Largeur de l'image, en pixels.

image.byteSize

integer

Taille de l'image, en octets.

image.thumbnailLink

string

URL de la vignette.

image.thumbnailHeight

integer

Hauteur de la vignette, en pixels.

image.thumbnailWidth

integer

Largeur de la vignette, en pixels.

labels[]

object

Encapsule toutes les informations sur les libellés de filtre.

labels[].name

string

Nom d'un libellé de filtre, que vous pouvez utiliser pour affiner les recherches. Ne l'affichez pas dans votre interface utilisateur. utilisez plutôt displayName.

labels[].displayName

string

Le nom à afficher d'un libellé de filtre. Il s'agit du nom que vous devez afficher dans l'interface utilisateur.

labels[].label_with_op

string

Libellé de suggestion et opération de filtre associée.