设置 Google 酒店搜索任务

成人数
可选字段
如果未指定此字段，将使用默认值 2；
注意，成人与儿童合计最多可指定 6 人
示例：
1

酒店设施
可选字段
可使用此字段指定不同的酒店设施
示例：
[
"free_parking",
"pets_allowed"
]

可能的值：
"air_conditioning",
"all_inclusive_available",
"bar",
"free_breakfast",
"fitness_center",
"kid_friendly",
"free_parking",
"pets_allowed",
"pool",
"restaurant",
"room_service",
"spa",
"free_wifi",
"parking",
"indoor_pool",
"outdoor_pool",
"wheelchair_accessible",
"beach_access"

入住日期
可选字段
如果未指定此字段，默认使用明天的日期；
日期格式："yyyy-mm-dd"
示例：
"2019-01-15"
注意：该值不能早于今天的日期

退房日期
可选字段
如果未指定此字段，我们的系统默认采用两天后的日期；
日期格式："yyyy-mm-dd"
示例：
"2019-01-15"
注意：该值不能小于或等于 check_in；
check_in 与 check_out 之间的范围不能超过 30 天

儿童人数与年龄
可选字段
如果未指定此字段，搜索将不包含儿童；
儿童年龄可为 0 至 17；
注意，成人与儿童合计最多可指定 6 人
如需包含一名 14 岁儿童，请设置以下值：
[14]
如需包含一名 13 岁儿童和一名 8 岁儿童，请设置以下值：
[13,8]

货币
可选字段
示例：
"USD"

解析深度
可选字段
Google Hotels 中的结果数量
默认值：18 条自然结果
最大值：140
注意：无论响应中是否包含付费列表，你的账户都将按每 18 条自然结果计费；
因此，如果 Google Hotels 返回超过 18 条结果，将解析深度设为高于 18 可能产生额外费用；
如果指定深度高于响应中的结果数量，差额将自动退还至你的账户余额

可免费取消的酒店
可选字段
如需获取可免费取消预订的酒店列表，请将此字段设为 true
默认值：false

搜索度假租赁房源
可选字段
如需获取度假租赁房源列表而非酒店，请将此字段设为 true
默认值：false

关键词
可选字段
你指定的关键词用于搜索酒店列表；
如果不使用此字段，我们将返回在指定地点找到的酒店列表；
在 keyword 字段中最多可指定 700 个字符
所有 %## 都将被解码（另外，字符 ‘+’ 会被解码为空格）
如果需要在 keyword 中使用 “%” 字符，请将其指定为 “%25”；
注意：为获得准确的搜索结果，地点名称会自动附加到关键词后

有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇 帮助中心文章

搜索引擎语言代码
未指定 language_name 时为必填字段
如果使用此字段，则无需指定 language_name
可单独向 https://api.dataforseo.com/v3/business_data/google/languages 发起请求，获取可用语言及其 language_code 列表
示例：
en

搜索引擎语言全名
未指定 language_code 时为必填字段
如果使用此字段，则无需指定 language_code
可单独向 https://api.dataforseo.com/v3/business_data/google/languages 发起请求，获取带 language_name 的可用语言列表
示例：
English

搜索引擎地点代码
未指定 location_name 或 location_coordinate 时为必填字段
如果使用此字段，则无需指定 location_name 或 location_coordinate
可单独向 https://api.dataforseo.com/v3/business_data/google/locations 发起请求，获取带 location_code 的可用地点列表
示例：
2840

地点的 GPS 坐标
未指定 location_name 或 location_code 时为必填字段
如果使用此字段，则无需指定 location_name 或 location_code
location_coordinate 参数应按 "latitude,longitude" 格式指定
"latitude" 和 "longitude" 的最大小数位数为 7
注意：如果使用坐标设置地点，搜索将在最近的居民点进行；
示例：
53.476225,-2.243572

搜索引擎地点全名
未指定 location_code 或 location_coordinate 时为必填字段
如果使用此字段，则无需指定 location_code 或 location_coordinate
可单独向 https://api.dataforseo.com/v3/business_data/google/locations 发起请求，获取带 location_name 的可用地点列表
示例：
London,England,United Kingdom
注意：为获得准确的搜索结果，你指定的 location_name 将自动附加到关键词后

每晚最高价格
可选字段
此值的货币取决于 currency 字段
示例：
600

每晚最低价格
可选字段
此值的货币取决于 currency 字段
示例：
100

最低评分
可选字段
可使用此字段指定高于某一值的住客评分
示例：
2.5

任务完成通知 URL
可选字段
任务完成后，我们会向你指定的 URL 发送 GET 请求进行通知
可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。
示例：
http://your-server.com/pingscript?id=$id
http://your-server.com/pingscript?id=$id&tag=$tag
注意：pingback_url 中的特殊字符会进行 URL 编码；
例如，# 字符会被编码为 %23

详情请参阅我们的帮助中心

用于发送任务结果的 URL
可选字段
任务完成后，我们会将结果以 gzip 格式压缩，并通过 POST 请求发送到你指定的 postback_url
可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。
示例：
http://your-server.com/postbackscript?id=$id
http://your-server.com/postbackscript?id=$id&tag=$tag
注意：postback_url 中的特殊字符会进行 URL 编码；
例如，# 字符会被编码为 %23

详情请参阅我们的帮助中心

任务优先级
可选字段
可取以下值：
1 – 正常执行优先级（默认设置）
2 – 高执行优先级。高执行优先级的任务将额外收费。
费用可在 价格页 计算。

显示当前显示区域内的酒店
可选字段
可取以下值：true、false
默认值：true
如果设为 false，将关闭 search_this_area 模式
注意：如果关闭 search_this_area 模式，搜索期间 location_name 将不会附加到 keyword 后
可在我们的帮助中心进一步了解此参数

结果排序参数
可选字段
可使用此字段对结果排序
可能的排序类型：
relevance – 按最相关排序
lowest_price – 按最低价格排序
highest_rating – 按最高评分排序
most_reviewed – 按评论最多排序
默认值：relevance

酒店星级
可选字段
如需仅获取 5 星级酒店列表，请将此字段设为 [5]
示例：
[3,4,5]

用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
可在响应的 data 对象中找到指定的 tag 值