GoogleSearchRequest (Dataify Java SDK 0.1.0 API)

java.lang.Object
- com.dataify.sdk.GoogleSearchRequest

```
public class GoogleSearchRequest
extends Object
```
当用户需要通过 Google 搜索公开网页信息、获取通用网页搜索结果，或按国家、语言、位置、设备、时间条件等控制 Google 搜索结果时触发。用于设置该工具调用所需的请求参数。

构造器概要

构造器
构造器和说明

GoogleSearchRequest()

构造器
构造器和说明
`GoogleSearchRequest()`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`String`	`getAiOverview()` 获取控制是否获取 Google 搜索结果中的 AI 概览（AI Overview）内容。
`String`	`getCr()` 获取定义一个或多个将搜索限制在的国家/地区。
`String`	`getDevice()` 获取定义用于获取结果的设备。
`String`	`getFilter()` 获取定义“类似结果”和“省略结果”的过滤器是开启还是关闭。
`String`	`getGl()` 获取定义 Google 搜索要使用的国家/地区。
`String`	`getGoogleDomain()` 获取定义要使用的 Google 域名。
`String`	`getHl()` 获取定义 Google 搜索要使用的语言。
`String`	`getJson()` 获取定义采集结果的输出格式。
`String`	`getLocation()` 获取定义搜索发起的地理位置。
`String`	`getLr()` 获取定义一个或多个将搜索限制在的语言。
`String`	`getNfpr()` 获取当原始查询拼写错误时，定义是否排除来自自动更正查询的结果。
`String`	`getNoCache()` 获取默认情况下，5 分钟内缓存相同参数的搜索结果。
`String`	`getQ()` 获取定义搜索的查询内容，默认值为 pizza。
`String`	`getRenderJs()` 获取如果为 true，系统将使用浏览器执行页面脚本并返回完整渲染后的 HTML。
`String`	`getSafe()` 获取定义成人内容的过滤级别。
`String`	`getStart()` 获取定义结果偏移量。
`String`	`getTbs()` 获取定义常规查询字段中无法实现的高级搜索参数。
`String`	`getUule()` 获取希望用于搜索的 Google 编码位置。
`GoogleSearchRequest`	`setAiOverview(String aiOverview)` 设置控制是否获取 Google 搜索结果中的 AI 概览（AI Overview）内容。
`GoogleSearchRequest`	`setCr(String cr)` 设置定义一个或多个将搜索限制在的国家/地区。
`GoogleSearchRequest`	`setDevice(String device)` 设置定义用于获取结果的设备。
`GoogleSearchRequest`	`setFilter(String filter)` 设置定义“类似结果”和“省略结果”的过滤器是开启还是关闭。
`GoogleSearchRequest`	`setGl(String gl)` 设置定义 Google 搜索要使用的国家/地区。
`GoogleSearchRequest`	`setGoogleDomain(String googleDomain)` 设置定义要使用的 Google 域名。
`GoogleSearchRequest`	`setHl(String hl)` 设置定义 Google 搜索要使用的语言。
`GoogleSearchRequest`	`setJson(String json)` 设置定义采集结果的输出格式。
`GoogleSearchRequest`	`setLocation(String location)` 设置定义搜索发起的地理位置。
`GoogleSearchRequest`	`setLr(String lr)` 设置定义一个或多个将搜索限制在的语言。
`GoogleSearchRequest`	`setNfpr(String nfpr)` 设置当原始查询拼写错误时，定义是否排除来自自动更正查询的结果。
`GoogleSearchRequest`	`setNoCache(String noCache)` 设置默认情况下，5 分钟内缓存相同参数的搜索结果。
`GoogleSearchRequest`	`setQ(String q)` 设置定义搜索的查询内容，默认值为 pizza。
`GoogleSearchRequest`	`setRenderJs(String renderJs)` 设置如果为 true，系统将使用浏览器执行页面脚本并返回完整渲染后的 HTML。
`GoogleSearchRequest`	`setSafe(String safe)` 设置定义成人内容的过滤级别。
`GoogleSearchRequest`	`setStart(String start)` 设置定义结果偏移量。
`GoogleSearchRequest`	`setTbs(String tbs)` 设置定义常规查询字段中无法实现的高级搜索参数。
`GoogleSearchRequest`	`setUule(String uule)` 设置希望用于搜索的 Google 编码位置。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - GoogleSearchRequest
```
public GoogleSearchRequest()
```
- 方法详细资料
  - getQ
```
public String getQ()
```
    获取定义搜索的查询内容，默认值为 pizza。
    
    返回:
    
    q 参数值
  - setQ
```
public GoogleSearchRequest setQ(String q)
```
    设置定义搜索的查询内容，默认值为 pizza。
    
    参数:
    
    q - q 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getJson
```
public String getJson()
```
    获取定义采集结果的输出格式。1 返回 JSON 格式数据，2 返回 JSON+HTML 格式数据，3 返回 HTML 格式数据，4 返回 Light JSON。默认值为 1。
    
    返回:
    
    json 参数值
  - setJson
```
public GoogleSearchRequest setJson(String json)
```
    设置定义采集结果的输出格式。1 返回 JSON 格式数据，2 返回 JSON+HTML 格式数据，3 返回 HTML 格式数据，4 返回 Light JSON。默认值为 1。
    
    参数:
    
    json - json 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getGoogleDomain
```
public String getGoogleDomain()
```
    获取定义要使用的 Google 域名。默认为 google.com。
    
    返回:
    
    googleDomain 参数值
  - setGoogleDomain
```
public GoogleSearchRequest setGoogleDomain(String googleDomain)
```
    设置定义要使用的 Google 域名。默认为 google.com。
    
    参数:
    
    googleDomain - googleDomain 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getGl
```
public String getGl()
```
    获取定义 Google 搜索要使用的国家/地区。它是一个两位数的国家/地区代码。例如 us 代表美国，uk 代表英国，fr 代表法国。
    
    返回:
    
    gl 参数值
  - setGl
```
public GoogleSearchRequest setGl(String gl)
```
    设置定义 Google 搜索要使用的国家/地区。它是一个两位数的国家/地区代码。例如 us 代表美国，uk 代表英国，fr 代表法国。
    
    参数:
    
    gl - gl 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getHl
```
public String getHl()
```
    获取定义 Google 搜索要使用的语言。它是一个两位数的语言代码。例如 en 代表英语，es 代表西班牙语，fr 代表法语。
    
    返回:
    
    hl 参数值
  - setHl
```
public GoogleSearchRequest setHl(String hl)
```
    设置定义 Google 搜索要使用的语言。它是一个两位数的语言代码。例如 en 代表英语，es 代表西班牙语，fr 代表法语。
    
    参数:
    
    hl - hl 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getCr
```
public String getCr()
```
    获取定义一个或多个将搜索限制在的国家/地区。它使用 country{两位大写国家/地区代码} 指定国家/地区，并使用 I 作为分隔符。例如 countryFRIcountryDE 将仅搜索法国和德国的页面。
    
    返回:
    
    cr 参数值
  - setCr
```
public GoogleSearchRequest setCr(String cr)
```
    设置定义一个或多个将搜索限制在的国家/地区。它使用 country{两位大写国家/地区代码} 指定国家/地区，并使用 I 作为分隔符。例如 countryFRIcountryDE 将仅搜索法国和德国的页面。
    
    参数:
    
    cr - cr 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getLr
```
public String getLr()
```
    获取定义一个或多个将搜索限制在的语言。它使用 lang_{两位语言代码} 指定语言，并使用 I 作为分隔符。例如 lang_frIlang_de 将仅搜索法语和德语的页面。
    
    返回:
    
    lr 参数值
  - setLr
```
public GoogleSearchRequest setLr(String lr)
```
    设置定义一个或多个将搜索限制在的语言。它使用 lang_{两位语言代码} 指定语言，并使用 I 作为分隔符。例如 lang_frIlang_de 将仅搜索法语和德语的页面。
    
    参数:
    
    lr - lr 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getLocation
```
public String getLocation()
```
    获取定义搜索发起的地理位置。如果有多个位置与请求的位置匹配，将选择最受欢迎的一个。此参数不能与 uule、lat 和 lon 参数一起使用。
    
    返回:
    
    location 参数值
  - setLocation
```
public GoogleSearchRequest setLocation(String location)
```
    设置定义搜索发起的地理位置。如果有多个位置与请求的位置匹配，将选择最受欢迎的一个。此参数不能与 uule、lat 和 lon 参数一起使用。
    
    参数:
    
    location - location 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getUule
```
public String getUule()
```
    获取希望用于搜索的 Google 编码位置。此参数不能与 location、lat、lon 和 radius 参数一起使用。
    
    返回:
    
    uule 参数值
  - setUule
```
public GoogleSearchRequest setUule(String uule)
```
    设置希望用于搜索的 Google 编码位置。此参数不能与 location、lat、lon 和 radius 参数一起使用。
    
    参数:
    
    uule - uule 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getStart
```
public String getStart()
```
    获取定义结果偏移量。它跳过指定数量的结果，用于分页。例如 0 默认是第一页结果，10 是第二页结果，20 是第三页结果，以此类推。
    
    返回:
    
    start 参数值
  - setStart
```
public GoogleSearchRequest setStart(String start)
```
    设置定义结果偏移量。它跳过指定数量的结果，用于分页。例如 0 默认是第一页结果，10 是第二页结果，20 是第三页结果，以此类推。
    
    参数:
    
    start - start 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getTbs
```
public String getTbs()
```
    获取定义常规查询字段中无法实现的高级搜索参数。例如专利、日期、新闻、视频、图片、应用或文本内容的高级搜索。
    
    返回:
    
    tbs 参数值
  - setTbs
```
public GoogleSearchRequest setTbs(String tbs)
```
    设置定义常规查询字段中无法实现的高级搜索参数。例如专利、日期、新闻、视频、图片、应用或文本内容的高级搜索。
    
    参数:
    
    tbs - tbs 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getSafe
```
public String getSafe()
```
    获取定义成人内容的过滤级别。可以设置为 active 或 off，默认情况下 Google 会模糊处理露骨内容。
    
    返回:
    
    safe 参数值
  - setSafe
```
public GoogleSearchRequest setSafe(String safe)
```
    设置定义成人内容的过滤级别。可以设置为 active 或 off，默认情况下 Google 会模糊处理露骨内容。
    
    参数:
    
    safe - safe 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getNfpr
```
public String getNfpr()
```
    获取当原始查询拼写错误时，定义是否排除来自自动更正查询的结果。设置为 1 排除这些结果，设置为 0 包含它们（默认）。
    
    返回:
    
    nfpr 参数值
  - setNfpr
```
public GoogleSearchRequest setNfpr(String nfpr)
```
    设置当原始查询拼写错误时，定义是否排除来自自动更正查询的结果。设置为 1 排除这些结果，设置为 0 包含它们（默认）。
    
    参数:
    
    nfpr - nfpr 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getFilter
```
public String getFilter()
```
    获取定义“类似结果”和“省略结果”的过滤器是开启还是关闭。设置为 1（默认）启用这些过滤器，设置为 0 禁用这些过滤器。
    
    返回:
    
    filter 参数值
  - setFilter
```
public GoogleSearchRequest setFilter(String filter)
```
    设置定义“类似结果”和“省略结果”的过滤器是开启还是关闭。设置为 1（默认）启用这些过滤器，设置为 0 禁用这些过滤器。
    
    参数:
    
    filter - filter 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getDevice
```
public String getDevice()
```
    获取定义用于获取结果的设备。可设置为 desktop（默认值）使用常规浏览器，tablet 使用平板浏览器（目前使用 iPad），或 mobile 使用移动浏览器。
    
    返回:
    
    device 参数值
  - setDevice
```
public GoogleSearchRequest setDevice(String device)
```
    设置定义用于获取结果的设备。可设置为 desktop（默认值）使用常规浏览器，tablet 使用平板浏览器（目前使用 iPad），或 mobile 使用移动浏览器。
    
    参数:
    
    device - device 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getRenderJs
```
public String getRenderJs()
```
    获取如果为 true，系统将使用浏览器执行页面脚本并返回完整渲染后的 HTML。开启后会显著增加采集耗时，请按需使用。
    
    返回:
    
    renderJs 参数值
  - setRenderJs
```
public GoogleSearchRequest setRenderJs(String renderJs)
```
    设置如果为 true，系统将使用浏览器执行页面脚本并返回完整渲染后的 HTML。开启后会显著增加采集耗时，请按需使用。
    
    参数:
    
    renderJs - renderJs 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getNoCache
```
public String getNoCache()
```
    获取默认情况下，5 分钟内缓存相同参数的搜索结果。设为 true 可跳过缓存，设为 false（默认）则使用缓存结果。缓存搜索免费，且不计入搜索统计。
    
    返回:
    
    noCache 参数值
  - setNoCache
```
public GoogleSearchRequest setNoCache(String noCache)
```
    设置默认情况下，5 分钟内缓存相同参数的搜索结果。设为 true 可跳过缓存，设为 false（默认）则使用缓存结果。缓存搜索免费，且不计入搜索统计。
    
    参数:
    
    noCache - noCache 参数值
    
    返回:
    
    当前请求对象，支持链式调用
  - getAiOverview
```
public String getAiOverview()
```
    获取控制是否获取 Google 搜索结果中的 AI 概览（AI Overview）内容。成功获取 AI 概览通常计为 1 次响应；当首次请求仅返回 page_token 时，系统自动进行的第二次请求将额外计费，总共消耗 2 次响应。
    
    返回:
    
    aiOverview 参数值
  - setAiOverview
```
public GoogleSearchRequest setAiOverview(String aiOverview)
```
    设置控制是否获取 Google 搜索结果中的 AI 概览（AI Overview）内容。成功获取 AI 概览通常计为 1 次响应；当首次请求仅返回 page_token 时，系统自动进行的第二次请求将额外计费，总共消耗 2 次响应。
    
    参数:
    
    aiOverview - aiOverview 参数值
    
    返回:
    
    当前请求对象，支持链式调用

类 GoogleSearchRequest

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

GoogleSearchRequest

方法详细资料

getQ

setQ

getJson

setJson

getGoogleDomain

setGoogleDomain

getGl

setGl

getHl

setHl

getCr

setCr

getLr

setLr

getLocation

setLocation

getUule

setUule

getStart

setStart

getTbs

setTbs

getSafe

setSafe

getNfpr

setNfpr

getFilter

setFilter

getDevice

setDevice

getRenderJs

setRenderJs

getNoCache

setNoCache

getAiOverview

setAiOverview