設定 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 值