ข้อความค้นหาคือคำขอจาก Google สำหรับการอัปเดตราคาหรือข้อมูลเมตา โดยจะใช้กับวิธีการส่งข้อมูลราคาทั้งแบบพุลและราคาที่มีการเปลี่ยนแปลง
องค์ประกอบรูทของข้อความค้นหาคือ <Query>
โครงสร้างของข้อความค้นหาจะขึ้นอยู่กับประเภทของข้อความ ดังนี้
ราคา: Google จะส่งข้อความค้นหาที่ขออัปเดตราคาสำหรับโรงแรมที่ระบุ
ข้อมูลเมตา: Google จะส่งข้อความค้นหาที่ขอข้อมูลเกี่ยวกับห้องพักและข้อมูลแพ็กเกจในโรงแรมที่ระบุ
คุณกำหนดปลายทางที่ Google ใช้สำหรับข้อความค้นหาและคำขอข้อมูลราคาแบบเรียลไทม์ระหว่างการกำหนดค่าเริ่มต้นได้ สำหรับข้อมูลเพิ่มเติม โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) ของคุณ
Google จะส่งข้อความค้นหาเป็นคำขอ HTTP POST
โดยตั้งค่าส่วนหัว Content-Type
เป็น "application/xml" และตั้งค่าส่วนหัว User-Agent
เป็น Google-HotelAdsPrices
ข้อยกเว้นของกฎนี้เกิดขึ้นระหว่างการทดสอบการผสานรวมปลายทางราคาด้วยตนเองผ่าน Google-TravelAds-Live
ตัวอย่างคำค้นหาเหล่านั้นอาจมีหรือไม่มีส่วนหัว User-Agent
ดูการจัดรูปแบบโดยละเอียดสำหรับข้อความค้นหาได้ในการอ้างอิง XML ของการค้นหา
ข้อความค้นหาราคา
ข้อความค้นหาราคาจะระบุชุดค่าผสมของที่พักหรือแผนการเดินทางที่คุณระบุราคา
เมื่อเซิร์ฟเวอร์ได้รับข้อความค้นหาpricing เซิร์ฟเวอร์ควรตอบกลับด้วยข้อความ <Transaction>
ที่มีข้อมูลราคาที่ขอ
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมราคา
ข้อความค้นหาพิเศษมี 3 ประเภท ได้แก่
ราคาแบบเรียลไทม์: หากเปิดใช้ ระบบจะส่งการค้นหาเมื่อผู้ใช้กำลังตั้งใจเรียกดูราคาสำหรับที่พักหรือแผนการเดินทางที่ระบุ และคุณมีกรอบเวลาในการตอบกลับ
เมื่อใช้บริบท: หากเปิดใช้ คำแนะนำบริบทของผู้ใช้จะรวมอยู่ในคำค้นหาแต่ละรายการที่ Google ส่งให้คุณ และคำแนะนำจะแสดงให้เห็นผู้ใช้ส่วนใหญ่ที่ค้นหาชุดค่าผสมของที่พักหรือแผนการเดินทางที่ระบุ การปฏิบัติตามคำแนะนำเหล่านี้อาจเพิ่มประสิทธิภาพ ของคำตอบได้
ข้อมูลเมตา: นี่คือคำขอรายละเอียดเกี่ยวกับห้องพักและแพ็กเกจสำหรับที่พักที่ระบุ
การค้นหาราคาแบบเรียลไทม์
คำขอข้อมูลราคาแบบเรียลไทม์จาก Google คือคำขอให้อัปเดตราคาแบบเรียลไทม์เพื่อตอบสนองต่อการค้นหาของผู้ใช้ Google ได้รับคำขอค้นหาจากผู้ใช้สำหรับชุดค่าผสมโรงแรมหรือแผนการเดินทาง และเนื่องจากข้อมูลราคาไม่พร้อมใช้งานหรือไม่เป็นปัจจุบัน Google จะขอการอัปเดตราคาจากคุณในขณะที่ทำการค้นหา เมื่อใช้การค้นหาราคาแบบเรียลไทม์ Google จะพยายามรับราคาและแสดงในผลลัพธ์ขณะที่ทำการค้นหา
คำขอคำขอข้อมูลราคาแบบเรียลไทม์ทั้งหมดมีขีดจำกัดเวลาในการตอบกลับ ซึ่งโดยทั่วไปจะอยู่ที่ 4,000 มิลลิวินาที ขีดจำกัดนี้ระบุอยู่ในคำขอการค้นหาราคาแบบเรียลไทม์ หากตอบกลับภายในเวลาที่กำหนดไม่ได้ ระบบจะพลาดการเข้าร่วมสำหรับโอกาสนั้นๆ อย่างไรก็ตาม เราขอแนะนำให้คุณระบุราคาเพื่อให้สามารถแคชและใช้สำหรับโอกาสในอนาคตได้ การเชื่อมต่อสำหรับการตอบสนองจะยังคงเปิดอยู่เป็นเวลา 10 นาทีหรือตามที่ระบุไว้ในการกำหนดค่าของพาร์ทเนอร์
นอกจากนี้ การค้นหาราคาแบบเรียลไทม์ยังอิงตามบริบทและดึงข้อมูลราคาสำหรับพารามิเตอร์ต่อไปนี้ได้ ซึ่งได้แก่ ประเทศของผู้ใช้ ประเภทอุปกรณ์ อัตราการเข้าพัก (จำนวนแขก) รวมถึงระบุว่าแขกเหล่านั้นเป็นผู้ใหญ่หรือเด็ก การค้นหาราคาแบบเรียลไทม์ช่วยให้คุณแสดงราคาล่าสุดที่ตรงกับสิ่งที่ลูกค้าค้นหาได้
การค้นหาราคาแบบเรียลไทม์มีไว้เพื่อเป็นกลไกรองสำหรับการอัปเดตราคา กลไกหลักสำหรับการปรับราคายังคงใช้ราคาที่มีการเปลี่ยนแปลงหรือราคาแบบพุล การค้นหาราคาแบบเรียลไทม์จะช่วยเติมเต็มช่องว่างในกรณีที่ Google ไม่มีข้อมูลราคาสำหรับชุดค่าผสมของโรงแรมหรือแผนการเดินทาง
กฎสำหรับการใช้การค้นหาราคาแบบเรียลไทม์
ไม่มีข้อมูลที่แคชไว้สำหรับแผนการเดินทางที่ระบุ เนื่องจากแผนการเดินทางที่ขอนั้นไม่ถูกต้อง เช่น วันที่ที่อยู่ในอนาคตไกลมากหรือโรงแรมมีการค้นหาไม่บ่อยนัก
วันที่ที่ขอไม่ใช่วันที่เริ่มต้น
: หมายเหตุ: วันที่เริ่มต้นไม่มีสิทธิ์สำหรับการค้นหาราคาแบบเรียลไทม์ มีการขอการค้นหาราคาแบบเรียลไทม์สำหรับวันที่ที่ไม่ใช่ค่าเริ่มต้นเท่านั้น
โดยปกติแล้ว Google จะแคชผลลัพธ์ของราคาแบบเรียลไทม์เพื่อไม่ให้มีการค้นหาโรงแรมหรือแผนการเดินทางเดียวกันอีก โดยสามารถขอได้ทั้งชุดค่าผสมโรงแรมเดียวหรือแผนการเดินทางเดียว รวมถึงชุดค่าผสมหลายโรงแรมหรือแผนการเดินทางเดียว
ฟีเจอร์ราคาแบบเรียลไทม์ที่มีบริบทช่วยให้ Google ส่งคำขอราคาแบบเรียลไทม์ที่เจาะจงตามประเภทอุปกรณ์ของผู้ใช้ ประเทศที่ผู้ใช้กำลังค้นหา และจำนวนผู้เข้าพักรวมถึงเด็กได้ ระบบจะขยายทั้งข้อความค้นหาและข้อความ Transaction เพื่อรวมองค์ประกอบ <Context>
ซึ่งกำหนดพารามิเตอร์การค้นหา ราคาที่ได้รับจากการค้นหาราคาแบบเรียลไทม์ที่มีบริบทสามารถแคชเป็นแพ็กเกจห้องพักได้ หากเป็นราคาสำหรับอัตราการเข้าพักที่เจาะจงและเป็นราคาสำหรับลูกค้าที่เข้าเกณฑ์ หากราคานั้นมีไว้สำหรับประเทศหรืออุปกรณ์ของผู้ใช้
พร้อมการค้นหาตามบริบท
การค้นหาตามบริบทเป็นคำขอตามปกติเพื่ออัปเดตฐานข้อมูลสำหรับชุดค่าผสมของที่พักหรือแผนการเดินทางที่ระบุ โดยจะมีรายการบริบทผู้ใช้ ซึ่งเป็นที่นิยมสำหรับชุดค่าผสมเหล่านั้น หากใช้ราคาสำหรับลูกค้าที่เข้าเกณฑ์ อัตราค่าส่งสำหรับบริบทของผู้ใช้ที่เป็นไปได้ทั้งหมดอาจมีค่าใช้จ่ายสูง คุณจึงสามารถใช้รายการบริบทของผู้ใช้นี้เพื่อจำกัดการตอบกลับได้ ราคาที่แสดงผลสำหรับบริบทของผู้ใช้ที่ระบุเท่านั้นจะครอบคลุมคำค้นหาที่เกี่ยวข้องส่วนใหญ่ของผู้ใช้
ข้อความค้นหาข้อมูลเมตา
ข้อความค้นหาข้อมูลเมตามีรายละเอียดเกี่ยวกับข้อมูลห้องพักและแพ็กเกจสำหรับที่พักที่ระบุ
เมื่อได้รับข้อความค้นหาข้อมูลเมตา คุณควรตอบกลับด้วยข้อความ <Transaction>
ที่ระบุราคาสำหรับที่พักที่ขอในองค์ประกอบ <Result>
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการกำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ
การค้นหาเกี่ยวกับการควบคุม
หัวข้อนี้จะอธิบายวิธีการควบคุมที่พักและแผนการเดินทางที่จะเป็นหัวเรื่องของข้อความค้นหาจาก Google ได้
ขอบเขตของแผนการเดินทาง
คุณกำหนดขอบเขตที่เป็นไปได้ของการค้นหาราคาโดยใช้ <ItineraryCapabilities>
คุณจะกำหนดกฎที่กำหนดช่วงวันที่และระยะเวลาในการเข้าพักสูงสุดที่รองรับได้
คุณตั้งค่าเริ่มต้นสำหรับ <MaxAdvancePurchase>
และ <MaxLengthOfStay>
ที่ใช้กับชุดค่าผสมโรงแรมหรือแผนการเดินทางทั้งหมดได้ คุณยังกำหนดการตั้งค่าเหล่านี้
สำหรับกลุ่มโรงแรมได้ด้วย
ตัวอย่างข้อความค้นหา
ส่วนนี้จะแสดงตัวอย่างข้อความค้นหาราคาและข้อความค้นหาข้อมูลเมตา ดูตัวอย่างเพิ่มเติมได้ในการอ้างอิง XML ของการค้นหา
ตัวอย่างแผนการเดินทาง
ตัวอย่างต่อไปนี้แสดงราคา <Query>
ที่ขออัปเดตราคาสำหรับโรงแรม 4 แห่ง ซึ่งมีห้องว่าง 3 คืนและเริ่มตั้งแต่วันที่ 23 พฤษภาคม 2023
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
ตัวอย่างนี้ส่งคำขออัปเดตราคาสำหรับโรงแรมแต่ละแห่ง
5/23/18 - 6/26/18
ตัวอย่างการค้นหาราคาแบบเรียลไทม์
ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลราคาแบบเรียลไทม์ที่มีขีดจำกัดเวลาในการตอบกลับอยู่ที่ 500 มิลลิวินาที
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
ตัวอย่างนี้ขอราคาสําหรับโรงแรมแห่งเดียว
6/23/23 - 6/25/23
ตัวอย่างข้อความ Transaction ที่ตอบกลับสำหรับการค้นหานี้ได้ในการอ้างอิง XML ของราคาและห้องว่าง (Transaction)
มีตัวอย่างการค้นหาตามบริบท
ตัวอย่างต่อไปนี้แสดงตัวอย่างการค้นหา "ที่มีบริบท"
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
การค้นหาตามบริบทจะระบุบริบทประเทศของผู้ใช้เท่านั้น ในอนาคต คําค้นหาดังกล่าวอาจระบุอุปกรณ์ของผู้ใช้และอัตราการเข้าพักด้วย
ช่วงวันที่เช็คอิน
หากคุณใช้ราคาที่มีการเปลี่ยนแปลง โครงสร้างของข้อความค้นหาจะขึ้นอยู่กับประเภทของคำแนะนำที่คุณใช้สำหรับช่วงวันที่เช็คอิน แผนการเดินทางที่แน่นอน หรือแผนการเดินทางตามช่วงเวลา ดูข้อมูลเพิ่มเติมเกี่ยวกับคำแนะนำแต่ละประเภทเหล่านี้ได้ที่ข้อความตอบกลับคำแนะนำ
ตัวอย่างต่อไปนี้แสดงข้อความราคา <Query>
สําหรับช่วงวันที่เช็คอิน
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
ตัวอย่างนี้ส่งคำขออัปเดตราคาสำหรับการเข้าพักต่อไปนี้ (สำหรับโรงแรมแต่ละแห่ง)
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
การเข้าพักตามช่วงเวลา
ตัวอย่างต่อไปนี้แสดงข้อความราคา <Query>
สำหรับการเข้าพักตามช่วงเวลา
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
ตัวอย่างนี้ส่งคำขออัปเดตราคาสำหรับโรงแรมแต่ละแห่ง
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
บวกกับการเข้าพักที่เริ่มต้นก่อน (แต่รวม) คืนที่กำหนด
5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
ข้อความค้นหาข้อมูลเมตา
ตัวอย่างต่อไปนี้แสดงข้อความ <Query>
ที่ขอให้อัปเดตข้อมูลเมตาสำหรับข้อมูลห้องพักและแพ็กเกจสำหรับที่พักหลายแห่ง
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
คุณตอบกลับข้อความค้นหาประเภทนี้ด้วยข้อความ Transaction ที่กำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ ดูข้อมูลเพิ่มเติมได้ที่การกำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ