Vytváření úloh vyhledávání Google Hotels
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh vyhledávání Google Hotels
Zařadí do fronty vyhledávání Google Hotels a vrátí id úlohy. Odpověď je zabalena do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200. Načtěte pomocí get_dataforseo_business_google_hotel_searches_fetch.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.2428.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata — nikoli nabídka pro účet, garantovaná cena ani limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- adultsTyp: integer | null
počet dospělých
volitelné pole
pokud toto pole nezadáte, použije se výchozí hodnota2;
poznámka: můžete zadat až 6 osob včetně dospělých a dětí
příklad:1 - amenitiesTyp: array string[] | null
vybavení hotelu
volitelné pole
pomocí tohoto pole můžete určit různé vybavení hotelu
příklad:[
"free_parking",
"pets_allowed"
]
možné hodnoty:"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" - checkTyp: string | null
_in datum příjezdu
volitelné pole
pokud toto pole nezadáte, použije se ve výchozím nastavení zítřejší datum;
formát data:"yyyy-mm-dd"
příklad:"2019-01-15"
Poznámka: hodnota nesmí předcházet dnešnímu datu - checkTyp: string | null
_out datum odjezdu
volitelné pole
pokud toto pole nezadáte, náš systém ve výchozím nastavení použije datum dva dny od dnešního dne;
formát data:"yyyy-mm-dd"
příklad:"2019-01-15"
Poznámka: hodnota nesmí být menší nebo rovna hodnotěcheck_in;
rozsah mezi hodnotamicheck_inacheck_outnesmí přesáhnout 30 dní - childrenTyp: array string[] | null
počet a věk dětí
volitelné pole
pokud toto pole nezadáte, nebudou do vyhledávání zahrnuty žádné děti;
věk dítěte může být od0do17;
poznámka: můžete zadat až 6 osob včetně dospělých a dětí
nastavte následující hodnotu, chcete-li zahrnout jedno 14leté dítě:[14]
nastavte následující hodnotu, chcete-li zahrnout jedno 13leté dítě a jedno 8leté dítě:[13,8] - currencyTyp: string | null
měna
volitelné pole
příklad:"USD" - depthTyp: integer | null
hloubka parsování
volitelné pole
počet výsledků v Google Hotels
výchozí hodnota:18organických výsledků
maximální hodnota:140
Poznámka: váš účet bude účtován za každých 18 organických výsledků bez ohledu na placené nabídky v odpovědi;
nastavení hloubky nad18proto může vést k dodatečným poplatkům, pokud Google Hotels vrátí více než 18 výsledků;
pokud je zadaná hloubka vyšší než počet výsledků v odpovědi, rozdíl vám bude automaticky vrácen na zůstatek účtu - freeTyp: boolean | null
_cancellation hotely s bezplatným zrušením
volitelné pole
nastavte toto pole natrue, chcete-li získat seznam hotelů s bezplatným zrušením rezervace
výchozí hodnota:false - isTyp: boolean | null
_vacation _rentals vyhledávání rekreačních pronájmů
volitelné pole
nastavte toto pole natrue, chcete-li místo hotelů získat seznam rekreačních pronájmů
výchozí hodnota:false - keywordTyp: string | null
klíčové slovo
volitelné pole
zadané klíčové slovo se používá k vyhledání seznamu hotelů;
pokud toto pole nepoužijete, vrátíme seznam hotelů nalezených v zadané lokalitě;
do polekeywordmůžete zadat až 700 znaků
všechny řetězce %## budou dekódovány (znak „+“ bude dekódován jako mezera)
pokud potřebujete vkeywordpoužít znak „%“, zadejte jej jako „%25“;
Poznámka: pro získání přesných výsledků vyhledávání se název lokality automaticky připojuje ke klíčovému slovuvíce o pravidlech a omezeních polí
keywordakeywordsv rozhraních DataForSEO najdete v tomto článku nápovědy - languageTyp: string
_code kód jazyka vyhledávače
povinné pole, pokud nezadátelanguage_name
pokud toto pole použijete, nemusíte zadávatlanguage_name
seznam dostupných jazyků s jejichlanguage_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/languages
příklad:en - languageTyp: string
_name úplný název jazyka vyhledávače
povinné pole, pokud nezadátelanguage_code
pokud toto pole použijete, nemusíte zadávatlanguage_code
seznam dostupných jazyků slanguage_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/languages
příklad:English - locationTyp: integer
_code kód lokality vyhledávače
povinné pole, pokud nezadátelocation_namenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_coordinate
seznam dostupných lokalit slocation_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/locations
příklad:2840 - locationTyp: string
_coordinate GPS souřadnice lokality
povinné pole, pokud nezadátelocation_namenebolocation_code
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_code
parametrlocation_coordinateje nutné zadat ve formátu "latitude,longitude"
maximální počet desetinných míst pro "latitude" a "longitude": 7
Poznámka: pokud se souřadnice použijí k nastavení lokality, vyhledávání proběhne v nejbližší osadě;
příklad:53.476225,-2.243572 - locationTyp: string
_name úplný název lokality vyhledávače
povinné pole, pokud nezadátelocation_codenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_codeanilocation_coordinate
seznam dostupných lokalit slocation_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/locations
příklad:London,England,United Kingdom
Poznámka: pro získání přesných výsledků vyhledávání bude zadanélocation_nameautomaticky připojeno ke klíčovému slovu - maxTyp: integer | null
_price maximální cena za noc
volitelné pole
měna této hodnoty závisí na policurrency
příklad:600 - minTyp: integer | null
_price minimální cena za noc
volitelné pole
měna této hodnoty závisí na policurrency
příklad:100 - minTyp: number | null
_rating minimální hodnocení
volitelné pole
pomocí tohoto pole můžete zadat hodnocení hostů vyšší než určitá hodnota
příklad:2.5 - pingbackTyp: string | null
_url URL oznámení o dokončené úloze
volitelné pole
po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL
řetězec ‘$id’ můžete použít jako proměnnou$ida ‘$tag’ jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty
příklad:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Poznámka: speciální znaky vpingback_urlbudou kódovány v URL;
mj. znak#bude zakódován jako%23 - postbackTyp: string | null
_url URL pro odesílání výsledků úlohy
volitelné pole
po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátugzipna zadanoupostback_url
řetězec ‘$id’ můžete použít jako proměnnou$ida ‘$tag’ jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
příklad:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Poznámka: speciální znaky vpostback_urlbudou kódovány v URL;
mj. znak#bude zakódován jako%23 - priorityTyp: integer | null
- searchTyp: boolean | null
_this _area zobrazit hotely ze zobrazené oblasti
volitelné pole
může nabývat hodnot:true,false
výchozí hodnota:true
při nastavení nafalsebude režimsearch_this_areavypnut
Poznámka: pokud je režimsearch_this_areavypnut,location_namenebude během vyhledávání připojeno kekeyword
více o tomto parametru v našem Centru nápovědy - sortTyp: string | null
_by parametry řazení výsledků
volitelné pole
pomocí tohoto pole můžete výsledky řadit
možné typy řazení:relevance– řadit podle nejvyšší relevancelowest_price– řadit podle nejnižší cenyhighest_rating– řadit podle nejvyššího hodnocenímost_reviewed– řadit podle největšího počtu recenzí
výchozí hodnota:relevance - starsTyp: array string[] | null
hvězdičky hotelu
volitelné pole
nastavte toto pole na[5], chcete-li získat pouze seznam 5hvězdičkových hotelů
příklad:[3,4,5] - tagTyp: string | null
uživatelem definovaný identifikátor úlohy
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotutagnajdete v objektudataodpovědi
- Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: object | null
pole výsledků
v tomto případě bude hodnotanull - resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"keyword": "cheap hotel",
"check_in": "2023-06-01",
"check_out": "2023-06-30",
"currency": "USD",
"adults": 2,
"children": [
"14"
],
"sort_by": "highest_rating",
"priority": 2,
"tag": "example"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}