ข้อความค้นหาคือคำขอจาก Google สำหรับการอัปเดตราคาหรือข้อมูลเมตา โฆษณาเหล่านี้ จะใช้กับทั้งราคาแบบพุลและราคาที่มีการเปลี่ยนแปลง วิธีการส่งข้อมูลราคา
องค์ประกอบรูทของข้อความค้นหาคือ <Query>
โดยโครงสร้างของข้อความค้นหาจะขึ้นอยู่กับประเภทของข้อความดังนี้
ราคา: Google จะส่งข้อความค้นหาเพื่อขอให้อัปเดตราคาสำหรับ โรงแรมที่ระบุ
ข้อมูลเมตา: Google จะส่งข้อความค้นหาที่ขอข้อมูลเกี่ยวกับห้อง และข้อมูลแพ็กเกจของโรงแรมที่ระบุ
คุณกําหนดปลายทางที่ Google จะใช้สําหรับข้อความค้นหาและการถ่ายทอดสด คำขอข้อมูลราคาระหว่างการกำหนดค่าเริ่มต้น สำหรับข้อมูลเพิ่มเติม โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM)
Google จะส่งข้อความค้นหาเป็นคำขอ HTTP POST
ด้วย Content-Type
ตั้งค่าส่วนหัวเป็น "application/xml" และตั้งค่าส่วนหัว User-Agent
เป็น
Google-HotelAdsPrices
ข้อยกเว้นสำหรับกฎนี้เกิดขึ้นระหว่างการทดสอบด้วยตนเองของ
การผสานรวมปลายทางราคาผ่าน Google-TravelAds-Live
ตัวอย่างเหล่านั้น
การค้นหาจะมีหรือไม่มีส่วนหัว User-Agent
ก็ได้
ดูการจัดรูปแบบโดยละเอียดสำหรับข้อความค้นหาได้ใน การอ้างอิง XML ของการค้นหา
ข้อความค้นหาราคา
ข้อความค้นหาราคาจะระบุชุดค่าผสมของที่พักหรือแผนการเดินทางที่ คุณเป็นผู้กำหนดราคา
เมื่อเซิร์ฟเวอร์ของคุณได้รับข้อความค้นหาราคา เซิร์ฟเวอร์ควรตอบกลับด้วย
ข้อความ <Transaction>
ที่มีข้อมูลราคาที่ขอ
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมราคา
ข้อความค้นหาพิเศษมี 3 ประเภทดังนี้
ราคาแบบเรียลไทม์: หากเปิดใช้ ระบบจะส่งคำค้นหาเมื่อผู้ใช้กำลังใช้งานอยู่ กำลังเรียกดูราคาสำหรับที่พักหรือแผนการเดินทางที่ระบุ และคุณ มีกรอบเวลาที่แน่นอนให้ตอบกลับ
แบบมีบริบท: หากเปิดใช้ การแนะนำบริบทของผู้ใช้จะรวมอยู่ใน คำค้นหาแต่ละรายการที่ Google ส่งให้คุณและคำแนะนำตรงกับคำค้นหามากที่สุด ประเภททั่วไปของผู้ใช้ที่ค้นหาที่พักหรือแผนการเดินทางที่ระบุ ชุดค่าผสม การปฏิบัติตามคำแนะนำเหล่านี้อาจช่วยเพิ่มประสิทธิภาพของ คำตอบของคุณ
ข้อมูลเมตา: นี่คือคำขอรายละเอียดเกี่ยวกับห้องพักและแพ็กเกจสำหรับ พร็อพเพอร์ตี้ที่ระบุ
การค้นหาราคาแบบเรียลไทม์
การค้นหาราคาแบบเรียลไทม์คือคำขอจาก Google สำหรับการอัปเดตราคาแบบเรียลไทม์ใน การตอบสนองต่อการค้นหาของผู้ใช้ Google ได้รับคำขอค้นหาจากผู้ใช้สำหรับ ชุดค่าผสมของโรงแรมหรือแผนการเดินทาง และเนื่องจากข้อมูลราคาไม่มีหรือไม่มี Google จะขอการอัปเดตราคาจากคุณ ณ เวลาที่ทำการค้นหา ด้วย ในการค้นหาราคาแบบเรียลไทม์ Google จะพยายามเรียกราคาและแสดงใน ผลลัพธ์ในขณะที่ค้นหา
คำขอเกี่ยวกับราคาแบบเรียลไทม์ทั้งหมดมีขีดจำกัดเวลาตอบกลับซึ่งโดยทั่วไปจะเป็น ไม่เกิน 4,000 มิลลิวินาที ขีดจํากัดนี้ระบุไว้ในการค้นหาราคาแบบเรียลไทม์ อีกครั้ง หากไม่สามารถให้คำตอบภายในเวลาที่กำหนด จะส่งผลให้เกิด การเข้าร่วมที่พลาดไปสำหรับโอกาสนั้นๆ แต่เราขอแนะนำ ระบุราคาอยู่ดี เพื่อให้ระบบแคชและนำไปใช้กับโอกาสอื่นๆ ในอนาคต การเชื่อมต่อสำหรับการตอบกลับยังคงเปิดอยู่เป็นเวลาสิบนาทีหรือ ที่ระบุในการกำหนดค่าของพาร์ทเนอร์
การค้นหาราคาแบบเรียลไทม์ยังมีบริบทและสามารถดึงข้อมูลราคาสำหรับ พารามิเตอร์ต่อไปนี้: ประเทศของผู้ใช้ ประเภทอุปกรณ์ อัตราการเข้าพัก (จำนวนแขก) และแขกเหล่านั้นเป็นผู้ใหญ่หรือเด็ก เมื่อใช้การค้นหาราคาแบบเรียลไทม์ สามารถแสดงราคาล่าสุดซึ่งตรงกับสิ่งที่ลูกค้าค้นหา
การค้นหาราคาแบบเรียลไทม์เพื่อใช้เป็นกลไกรองสำหรับการกำหนดราคา อัปเดต กลไกหลักในการปรับราคายังอยู่ระหว่างพุลหรือมีการเปลี่ยนแปลง การกำหนดราคา การค้นหาราคาแบบเรียลไทม์ช่วยเติมเต็มช่องว่างที่ 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
ตัวอย่างการตอบกลับข้อความธุรกรรมสำหรับการค้นหานี้ได้ใน การกำหนดราคาและ การอ้างอิง 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
Plus การเข้าพักที่เริ่มต้นก่อน (แต่รวม) คืนที่ระบุ
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 ที่ กำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ สำหรับข้อมูลเพิ่มเติม โปรดดู การกำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ