Cette page a été traduite par l'API Cloud Translation.

Search

Représentation JSON
Promotion
- Représentation JSON
Résultat
- Représentation JSON

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

Représentation JSON

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`) } ] }

{
  "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 d'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` Modèle OpenSearch réel pour 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. Peut ne pas être exact.
`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 dans l'ensemble de résultats total, où l'indice du premier résultat est 1.
`queries.previousPage[].startPage`	`integer` Numéro de page de cet ensemble de résultats, dont la longueur 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 compatible avec 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 de paramètres valides 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 de 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` Indique 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 plus d'informations sur les filtres de résultats de recherche Google, consultez la rubrique 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 applique des filtres à tous les résultats de recherche afin d'en améliorer la qualité.
`queries.previousPage[].gl`	`string` Booste 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 particulièrement, 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 spécifique. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre `cr`. Pour déterminer le pays d'un document, Google WebSearch analyse les éléments suivants: Domaine de premier niveau (TLD) de l'URL du document Emplacement géographique de l'adresse IP du serveur Web. Consultez l'article Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.
`queries.previousPage[].googleHost`	`string` Indique le domaine Google (par exemple, google.com, google.de ou google.fr) 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 de requête 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 hôte) de votre interface utilisateur. Si vous définissez explicitement ce paramètre, vous améliorerez les performances et la qualité des résultats de recherche. Pour en savoir plus, consultez la section Langues de l'interface de la page Internationalisation des requêtes et de la présentation des résultats. Pour en savoir plus, consultez 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 nommé 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 une expression que tous les documents figurant dans les résultats de recherche doivent contenir.
`queries.previousPage[].excludeTerms`	`string` Identifie un mot ou une expression qui ne doit apparaître dans aucun document dans les 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 à rechercher dans un document. Chaque document des 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 Booléen OR pour ce type de requête.
`queries.previousPage[].relatedSite`	`string` Indique que tous les résultats de recherche doivent correspondre à des pages en rapport avec 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 correspondant au nombre spécifié de jours précédents. `w[number]`: résultats des requêtes correspondant au nombre spécifié de semaines précédentes. `m[number]`: recherche les résultats correspondant au 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`) Macwrite (`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. Une liste à jour est disponible sur la page des 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`. Si aucune valeur n'est spécifiée, 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 taille) `huge` (très grande)
`queries.previousPage[].imgType`	`string` Limite les résultats aux images d'un type spécifié. Voici les valeurs possibles : `clipart` (clipart) `face` (visage) `lineart` (Dessin au trait) `photo` (photo) `animated` (animation) `stock` (stock)
`queries.previousPage[].imgColorType`	`string` Limite les résultats aux images d'un type de couleur spécifié. Valeurs acceptées: `mono` (noir et blanc) `gray` (niveaux de gris) `color` (couleur)
`queries.previousPage[].imgDominantColor`	`string` Limite les résultats aux images présentant 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. Peut ne pas être exact.
`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 dans l'ensemble de résultats total, où l'indice du premier résultat est 1.
`queries.request[].startPage`	`integer` Numéro de page de cet ensemble de résultats, dont la longueur 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 compatible avec 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 de paramètres valides 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 de 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` Indique 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 plus d'informations sur les filtres de résultats de recherche Google, consultez la rubrique 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 applique des filtres à tous les résultats de recherche afin d'en améliorer la qualité.
`queries.request[].gl`	`string` Booste 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 particulièrement, 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 spécifique. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre `cr`. Pour déterminer le pays d'un document, Google WebSearch analyse les éléments suivants: Domaine de premier niveau (TLD) de l'URL du document Emplacement géographique de l'adresse IP du serveur Web. Consultez l'article Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.
`queries.request[].googleHost`	`string` Indique le domaine Google (par exemple, google.com, google.de ou google.fr) 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 de requête 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 hôte) de votre interface utilisateur. Si vous définissez explicitement ce paramètre, vous améliorerez les performances et la qualité des résultats de recherche. Pour en savoir plus, consultez la section Langues de l'interface de la page Internationalisation des requêtes et de la présentation des résultats. Pour en savoir plus, consultez 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 nommé 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 une expression que tous les documents figurant dans les résultats de recherche doivent contenir.
`queries.request[].excludeTerms`	`string` Identifie un mot ou une expression qui ne doit apparaître dans aucun document dans les 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 à rechercher dans un document. Chaque document des 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 Booléen OR pour ce type de requête.
`queries.request[].relatedSite`	`string` Indique que tous les résultats de recherche doivent correspondre à des pages en rapport avec 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 correspondant au nombre spécifié de jours précédents. `w[number]`: résultats des requêtes correspondant au nombre spécifié de semaines précédentes. `m[number]`: recherche les résultats correspondant au 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`) Macwrite (`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. Une liste à jour est disponible sur la page des 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`. Si aucune valeur n'est spécifiée, 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 taille) `huge` (très grande)
`queries.request[].imgType`	`string` Limite les résultats aux images d'un type spécifié. Voici les valeurs possibles : `clipart` (clipart) `face` (visage) `lineart` (Dessin au trait) `photo` (photo) `animated` (animation) `stock` (stock)
`queries.request[].imgColorType`	`string` Limite les résultats aux images d'un type de couleur spécifié. Valeurs acceptées: `mono` (noir et blanc) `gray` (niveaux de gris) `color` (couleur)
`queries.request[].imgDominantColor`	`string` Limite les résultats aux images présentant 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. Peut ne pas être exact.
`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 dans l'ensemble de résultats total, où l'indice du premier résultat est 1.
`queries.nextPage[].startPage`	`integer` Numéro de page de cet ensemble de résultats, dont la longueur 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 compatible avec 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 de paramètres valides 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 de 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` Indique 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 plus d'informations sur les filtres de résultats de recherche Google, consultez la rubrique 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 applique des filtres à tous les résultats de recherche afin d'en améliorer la qualité.
`queries.nextPage[].gl`	`string` Booste 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 particulièrement, 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 spécifique. Vous pouvez utiliser des opérateurs booléens dans la valeur du paramètre `cr`. Pour déterminer le pays d'un document, Google WebSearch analyse les éléments suivants: Domaine de premier niveau (TLD) de l'URL du document Emplacement géographique de l'adresse IP du serveur Web. Consultez l'article Valeurs de paramètre de pays (cr) pour obtenir la liste des valeurs valides pour ce paramètre.
`queries.nextPage[].googleHost`	`string` Indique le domaine Google (par exemple, google.com, google.de ou google.fr) 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 de requête 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 hôte) de votre interface utilisateur. Si vous définissez explicitement ce paramètre, vous améliorerez les performances et la qualité des résultats de recherche. Pour en savoir plus, consultez la section Langues de l'interface de la page Internationalisation des requêtes et de la présentation des résultats. Pour en savoir plus, consultez 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 nommé 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 une expression que tous les documents figurant dans les résultats de recherche doivent contenir.
`queries.nextPage[].excludeTerms`	`string` Identifie un mot ou une expression qui ne doit apparaître dans aucun document dans les 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 à rechercher dans un document. Chaque document des 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 Booléen OR pour ce type de requête.
`queries.nextPage[].relatedSite`	`string` Indique que tous les résultats de recherche doivent correspondre à des pages en rapport avec 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 correspondant au nombre spécifié de jours précédents. `w[number]`: résultats des requêtes correspondant au nombre spécifié de semaines précédentes. `m[number]`: recherche les résultats correspondant au 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`) Macwrite (`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. Une liste à jour est disponible sur la page des 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`. Si aucune valeur n'est spécifiée, 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 taille) `huge` (très grande)
`queries.nextPage[].imgType`	`string` Limite les résultats aux images d'un type spécifié. Voici les valeurs possibles : `clipart` (clipart) `face` (visage) `lineart` (Dessin au trait) `photo` (photo) `animated` (animation) `stock` (stock)
`queries.nextPage[].imgColorType`	`string` Limite les résultats aux images d'un type de couleur spécifié. Valeurs acceptées: `mono` (noir et blanc) `gray` (niveaux de gris) `color` (couleur)
`queries.nextPage[].imgDominantColor`	`string` Limite les résultats aux images présentant une couleur dominante spécifique. Voici les valeurs possibles : `red` `orange` `yellow` `green` `teal` `blue` `purple` `pink` `white` `gray` `black` `brown`
`promotions[]`	`object (Promotion)` L'ensemble des promotions. Présent uniquement si les fichiers de configuration du moteur de recherche personnalisé définissent des promotions pour la requête donnée.
`context`	`object (Struct format)` Métadonnées et filtres associés au moteur de recherche en question, y compris: Nom du moteur de recherche utilisé pour la requête. Ensemble d'objets de facette (affinages) 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 la recherche.
`searchInformation.formattedSearchTime`	`string` Temps nécessaire au serveur pour renvoyer les résultats de recherche, mis en forme 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 en fonction du 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, 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 } }

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.
`link`	`string` URL de la promotion.
`displayLink`	`string` Version abrégée de l'URL des résultats de recherche de cette recherche, par exemple www.example.com.
`bodyLines[]`	`object` Tableau d'objets "bloc" pour cette promotion.
`bodyLines[].title`	`string` Texte de l'objet bloc, s'il contient du texte.
`bodyLines[].htmlTitle`	`string` Le texte de l'objet bloc en 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 de promotion.
`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 } ] }

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, en HTML.
`link`	`string` URL complète vers laquelle pointe le résultat de recherche, par exemple http://www.example.com/foo/bar.
`displayLink`	`string` Version abrégée de l'URL de ce résultat de recherche, par exemple www.example.com.
`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 par Google du résultat de recherche.
`formattedUrl`	`string` URL affichée après l'extrait de chaque résultat de recherche.
`htmlFormattedUrl`	`string` URL au format HTML affichée après l'extrait de 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 sur une image renvoyée dans les résultats de recherche.
`image.contextLink`	`string` URL renvoyant 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 l'image miniature.
`image.thumbnailHeight`	`integer` Hauteur de la vignette, en pixels.
`image.thumbnailWidth`	`integer` Largeur de l'image miniature, en pixels.
`labels[]`	`object` Encapsule toutes les informations sur les libellés de suggestion.
`labels[].name`	`string` Nom d'un libellé de filtre, que vous pouvez utiliser pour affiner vos recherches. Ne l'affichez pas dans votre interface utilisateur. Utilisez plutôt displayName.
`labels[].displayName`	`string` Nom à afficher d'un libellé de suggestion. C'est le nom que vous devez afficher dans votre interface utilisateur.
`labels[].label_with_op`	`string` Libellé de suggestion et opération de filtrage associée.