ส่วนนี้จะแสดงข้อมูลอ้างอิงสำหรับข้อความขอคำแนะนำ ข้อความตอบกลับคำแนะนำ และข้อความค้นหาแบบ XML ของ Google
<Hint>
(ข้อความตอบกลับคำแนะนำ)
องค์ประกอบรูทของข้อความตอบกลับคำแนะนำ ข้อความตอบกลับคำแนะนำจะระบุว่าควรปรับราคาของชุดค่าผสมของโรงแรม/แผนการเดินทางใดบ้าง ข้อความเหล่านี้จะเป็นการตอบกลับข้อความขอคำแนะนำจาก Google
ข้อความตอบกลับคำแนะนำควรระบุเฉพาะโรงแรมที่มีการเปลี่ยนแปลงราคาตั้งแต่ครั้งล่าสุดที่ Google ได้รับการตอบกลับคำแนะนำที่สำเร็จจากเซิร์ฟเวอร์ของคุณ
ข้อความตอบกลับคำแนะนำจะใช้วิธีใดวิธีหนึ่งต่อไปนี้เพื่อระบุว่า Google ควรปรับราคาของโรงแรมและแผนการเดินทางใดบ้าง
แผนการเดินทางที่แน่นอน: ชุดค่าผสมของวันที่เช็คอินและระยะเวลาในการเข้าพัก
ช่วงวันที่เช็คอิน: ระบุช่วงวันที่เช็คอิน โดยเริ่มด้วยวันที่เช็คอินครั้งแรกและลงท้ายด้วยวันที่เช็คอินล่าสุด
การเข้าพักตามช่วงเวลา (หรือแผนการเดินทางตามช่วงเวลา)
แต่ละวิธีเหล่านี้ต้องใช้ไวยากรณ์ที่แตกต่างกันสำหรับข้อความตอบกลับคำแนะนำ
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อข้อความตอบกลับคำแนะนำ
ไวยากรณ์
องค์ประกอบ <Hint>
ใช้ไวยากรณ์ที่แตกต่างกัน ขึ้นอยู่กับประเภทของข้อความตอบกลับคำแนะนำ ดังนี้
แผนการเดินทางที่แน่นอน
ข้อมูลต่อไปนี้จะแสดงไวยากรณ์สำหรับแผนการเดินทางที่แน่นอนในข้อความตอบกลับคำแนะนำ
<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<Property>hotel_ID</Property>
...
<Stay>
<CheckInDate>checkin_date</CheckInDate>
<LengthOfStay>number_of_nights</LengthOfStay>
</Stay>
</Item>
...
</Hint>
ช่วงที่เช็คอิน
ข้อมูลต่อไปนี้จะแสดงไวยากรณ์สำหรับช่วงเช็คอินในข้อความตอบกลับคำแนะนำ
<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<!-- At least one is required -->
<!-- Can be > 1 if MultipleItineraries is "checkin_range" in your
QueryControl message -->
<Property>hotel_ID</Property>
[...]
<!-- Required -->
<FirstDate>first_checkin_date</FirstDate>
<!-- Required -->
<LastDate>last_checkin_date</LastDate>
</Item>
...
</Hint>
การเข้าพักตามช่วงเวลา
ข้อมูลต่อไปนี้จะแสดงไวยากรณ์สำหรับการเข้าพักตามช่วงเวลาในข้อความตอบกลับคำแนะนำ
<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<!-- At least one is required -->
<!-- Can be > 1 if MultipleItineraries is "affected_dates" in your
QueryControl message -->
<Property>hotel_ID</Property>
[...]
<StaysIncludingRange>
<!-- Required -->
<FirstDate>first_date</FirstDate>
<!-- Optional -->
<LastDate>last_date</LastDate>
</StaysIncludingRange>
</Item>
...
</Hint>
Attributes
องค์ประกอบ <Hint>
มีแอตทริบิวต์ที่ไม่บังคับ: id
เมื่อระบุ ระบบจะรวมเป็นแอตทริบิวต์ hintId
ในข้อความ <Query>
ที่ส่งโดยอิงตาม <Hint>
นี้
องค์ประกอบลูก
องค์ประกอบ <Hint>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | จำเป็นหรือไม่ | ประเภท | ประเภทการตอบกลับคำแนะนำ | คำอธิบาย |
---|---|---|---|---|
<CheckInDate> | Required | Date | แผนการเดินทางที่แน่นอน | วันที่เช็คอินสำหรับแผนการเดินทาง |
<FirstDate> | Required | Date | ช่วงวันที่เช็คอินและแผนการเดินทางตามช่วงเวลา | วันที่แรกของช่วงวันที่สำหรับข้อความตอบกลับคำแนะนำของช่วงวันที่เช็คอินหรือการเข้าพักตามช่วงเวลา รวมวันที่ |
<Item> | Required | Object | ทั้งหมด | คอนเทนเนอร์สำหรับโรงแรม/แผนการเดินทางที่จะอัปเดต |
<LastDate> | Required* | Date | ช่วงวันที่เช็คอินและแผนการเดินทางตามช่วงเวลา | วันที่สุดท้ายของช่วงวันที่สำหรับข้อความตอบกลับคำแนะนำของช่วงวันที่เช็คอินหรือการเข้าพักตามช่วงเวลา รวมวันที่ * องค์ประกอบนี้ไม่บังคับสำหรับการเข้าพักตามช่วงเวลา |
<LengthOfStay> | Required | integer | แผนการเดินทางที่แน่นอน | จำนวนคืนสำหรับแผนการเดินทาง ซึ่งแสดงเป็นจำนวนเต็มบวก |
<Property> | Required | string | ทั้งหมด | รหัสของโรงแรม ซึ่งใช้รหัสเดียวกันกับข้อมูลโรงแรม จำนวนขององค์ประกอบ
|
<Stay> | Required | Object | แผนการเดินทางที่แน่นอน | คอนเทนเนอร์สำหรับองค์ประกอบ <CheckinDate> และ <LengthOfStay> ในข้อความตอบกลับคำแนะนำของแผนการเดินทางที่แน่นอน <Item> แต่ละรายการจะมี <Stay> ได้เพียงรายการเดียว |
<StaysIncludingRange> | Required | Object | แผนการเดินทางตามช่วงเวลา | คอนเทนเนอร์สำหรับองค์ประกอบ <FirstDate> และ <LastDate> ในข้อความตอบกลับคำแนะนำของการเข้าพักตามช่วงเวลา |
ตัวอย่าง
แผนการเดินทางที่แน่นอน
ตัวอย่างต่อไปนี้จะกำหนดแผนการเดินทางหลายรายการสำหรับข้อความตอบกลับคำแนะนำของที่พักเดียว
<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2018-07-03</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2018-07-03</CheckInDate>
<LengthOfStay>4</LengthOfStay>
</Stay>
</Item>
</Hint>
ช่วงที่เช็คอิน
ตัวอย่างต่อไปนี้จะเป็นการระบุโรงแรม 2 แห่งที่มีการเปลี่ยนแปลงราคาและควรดึงข้อมูลอีกครั้ง Google ได้รับแผนการเดินทางทั้งหมดระหว่างวันที่ 3-6 กรกฎาคมสำหรับที่พัก 12345 และ 67890 ดังนี้
<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<Item>
<Property>12345</Property>
<Property>67890</Property>
<FirstDate>2018-07-03</FirstDate>
<LastDate>2018-07-06</LastDate>
</Item>
</Hint>
โปรดทราบว่าเพื่อให้ข้อความช่วงเช็คอินระบุที่พักหลายแห่งใน <Item>
เดียวกันได้ ค่า <MultipleItineraries>
ใน <QueryControl>
จะต้องตั้งค่าเป็น "checkin_range"
การเข้าพักตามช่วงเวลา
ตัวอย่างต่อไปนี้จะแสดงการใช้งานสำหรับการเข้าพักตามช่วงเวลา 2 แบบ โดยแบบหนึ่งเป็นตัวอย่างสำหรับการเข้าพักหลายคืน และอีกแบบหนึ่งเป็นตัวอย่างสำหรับการเข้าพักคืนเดียว
<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
<!-- Google fetches prices for all itineraries (first and last date are set) -->
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2018-07-03</FirstDate>
<LastDate>2018-07-06</LastDate>
</StaysIncludingRange>
</Item>
<!-- Google fetches prices for a single night (first date only) -->
<Item>
<Property>67890</Property>
<StaysIncludingRange>
<FirstDate>2018-07-03</FirstDate>
</StaysIncludingRange>
</Item>
</Hint>
โปรดทราบว่าเพื่อให้ข้อความการเข้าพักตามช่วงเวลาระบุที่พักหลายแห่งใน <Item>
รายการเดียวได้ ต้องกำหนดค่า <MultipleItineraries>
ใน <QueryControl>
เป็น "affected_dates"
โดยในแต่ละตัวอย่าง Google จะตอบกลับด้วย <Query>
จากนั้นคุณควรตอบกลับด้วย <Transaction>
ที่มีการอัปเดตราคาสำหรับโรงแรม/แผนการเดินทางที่ระบุ
<HintRequest>
องค์ประกอบรูทของข้อความขอคำแนะนำ Google จะส่งข้อความขอคำแนะนำไปยังเซิร์ฟเวอร์ของคุณและรอการตอบกลับซึ่งระบุโรงแรมและแผนการเดินทางที่มีการเปลี่ยนแปลงราคานับจากครั้งล่าสุดที่ Google ได้รับการตอบกลับคำแนะนำที่สำเร็จจากเซิร์ฟเวอร์ของคุณ
หากมีการเปลี่ยนแปลงราคา Google จะส่ง <Query>
ซึ่งดึงข้อมูลราคาที่อัปเดตสำหรับโรงแรมและแผนการเดินทางที่ระบุ
ดูข้อมูลเพิ่มเติมได้ที่ข้อความขอคำแนะนำ
ไวยากรณ์
องค์ประกอบ <HintRequest>
ใช้ไวยากรณ์ต่อไปนี้
ไวยากรณ์
<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
<LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>
Attributes
องค์ประกอบ <HintRequest>
ไม่มีแอตทริบิวต์
องค์ประกอบลูก
องค์ประกอบ <HintRequest>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | ประเภท | คำอธิบาย |
---|---|---|
<LastFetchTime> | DateTime | เวลาล่าสุดที่ Google ได้รับข้อความตอบกลับคำแนะนำจากข้อความขอคำแนะนำ
หากเวลานี้เกิดก่อนเวลาล่าสุดที่อัปเดตราคาในเซิร์ฟเวอร์ คุณควรตอบกลับด้วยข้อความตอบกลับคำแนะนำโดยระบุว่าโรงแรมใดมีการเปลี่ยนแปลง หากไม่มีการดึงข้อมูลที่สำเร็จเมื่อเร็วๆ นี้ ระบบจะตั้งเป็น ค่าช่วงเวลาคงที่ (เพื่อหลีกเลี่ยงปัญหาที่ร้ายแรงยิ่งขึ้นเกี่ยวกับ Backlog ขนาดใหญ่) ค่าช่วงเวลาคงที่ปัจจุบันคือ 1, 000 วินาที แต่อาจมีการเปลี่ยนแปลงได้ ดูข้อมูลเพิ่มเติมได้ที่ข้อความตอบกลับคำแนะนำ |
ตัวอย่าง
ตัวอย่างต่อไปนี้จะแสดงข้อความขอคำแนะนำ
ข้อความขอคำแนะนำ
ตัวอย่างต่อไปนี้แสดงข้อความขอคำแนะนำ
<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
<LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>
<Query>
องค์ประกอบรูทของข้อความ Query
ข้อความ Query
รายการคือคำขอจาก Google สำหรับการอัปเดตราคาหรือข้อมูลเมตา โดยจะใช้กับวิธีการส่งข้อมูลราคาทั้งแบบพุลและราคาที่มีการเปลี่ยนแปลง
ข้อความ Query
มี 3 ประเภทดังนี้
ราคาแบบเรียลไทม์: Google จะตอบสนองต่อคำขอที่เจาะจงของผู้ใช้ที่ขอการอัปเดตราคาแบบเรียลไทม์ เมื่อพาร์ทเนอร์ได้รับข้อความ
Live pricing query
พาร์ทเนอร์ควรตอบกลับด้วยข้อความ<Transaction>
ที่มีข้อมูลราคาที่ขอในองค์ประกอบ<Result>
การใช้การกำหนดราคาตามบริบท: Google อัปเดตแคชราคาตามบริบทซึ่งเป็นที่นิยมในอดีต เมื่อได้รับข้อความ
With context query
คุณควรตอบกลับด้วยข้อความ<Transaction>
ที่มีข้อมูลราคาที่ขอในองค์ประกอบ<Result>
ข้อมูลเมตา: Google จะส่งคำขออัปเดตข้อมูลเมตาสำหรับห้องพักและแพ็กเกจห้องพักของโรงแรมที่ระบุ เมื่อได้รับข้อความ
Metadata Query
คุณควรตอบกลับด้วยข้อความ<Transaction>
ที่ระบุข้อมูลเกี่ยวกับห้องพักและแพ็กเกจห้องพักในองค์ประกอบ<PropertyDataSet>
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมราคาสำหรับการค้นหาราคาและข้อมูลเมตาของแพ็กเกจห้องพักสำหรับการค้นหาข้อมูลเมตา
เราได้อธิบายไวยากรณ์ของทั้ง 3 ประเภทไว้ด้านล่างนี้
ไวยากรณ์
องค์ประกอบ <Query>
ใช้ไวยากรณ์ต่อไปนี้
ราคาแบบเรียลไทม์
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
<Checkin>YYYY-MM-DD</Checkin>
<Nights>number_of_nights</Nights>
<!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
<FirstDate>YYYY-MM-DD</FirstDate>
<LastDate>YYYY-MM-DD</LastDate>
<!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
<AffectedNights>number_of_nights</AffectedNights>
<PropertyList>
<Property>hotel_id</Property>
...
</PropertyList>
<!-- See documentation below for <Context> -->
<Context>
...
</Context>
</Query>
พร้อมบริบท
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>YYYY-MM-DD</Checkin>
<Nights>number_of_nights</Nights>
<!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
<FirstDate>YYYY-MM-DD</FirstDate>
<LastDate>YYYY-MM-DD</LastDate>
<!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
<AffectedNights>number_of_nights</AffectedNights>
<PropertyContextList>
<PropertyContext>
<Property>hotel_id</Property>
...
<!-- See documentation below for <Context> -->
<Context>
...
</Context>
</PropertyContext>
</PropertyContextList>
</Query>
Metadata
<HotelInfoProperties>
<Property>property_ID</Property>
...
</HotelInfoProperties>
Attributes
องค์ประกอบ <Query>
อาจมีแอตทริบิวต์ 1 รายการ: latencySensitive
คุณจะระบุแอตทริบิวต์ latencySensitive
หรือไม่ก็ได้ เมื่อระบุและตั้งค่าเป็น true
จะบ่งบอกว่าการค้นหาเป็น Live Pricing Query
หากต้องการให้ Google ส่งคำค้นหาที่มีแอตทริบิวต์ latencySensitive
โปรดสอบถามผู้จัดการลูกค้าด้านเทคนิค (TAM)
องค์ประกอบลูก
องค์ประกอบ <Query>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | ประเภทการค้นหา | ประเภท | คำอธิบาย |
---|---|---|---|
<AffectedNights> | Pricing | integer | จำนวนคืนสำหรับการเข้าพักตามช่วงเวลา องค์ประกอบนี้ใช้เฉพาะกับการค้นหาราคาสำหรับการเข้าพักตามช่วงเวลาที่ใช้กับราคาที่มีการเปลี่ยนแปลง |
<Checkin> | Pricing | Date | วันที่ที่มีการเปลี่ยนแปลงราคาที่ระบุ |
<Context> | Pricing (Live Pricing Queries only) | <Context> | สำหรับคำขอข้อมูลราคาแบบเรียลไทม์ ให้ระบุพารามิเตอร์บางรายการที่ใช้ในการค้นหา องค์ประกอบย่อยประกอบด้วยข้อมูลต่อไปนี้
องค์ประกอบ |
<FirstDate> | Pricing | Date | วันที่เริ่มต้นสำหรับช่วงของแผนการเดินทางที่จะนำราคานี้ไปใช้ องค์ประกอบนี้ใช้เฉพาะกับการค้นหาราคาสำหรับช่วงวันที่เช็คอินที่ใช้กับราคาที่มีการเปลี่ยนแปลง |
<HotelInfoProperties> | Metadata | string | ที่พักอย่างน้อย 1 แห่งที่ Google ต้องการข้อมูลเมตาของห้องพักและแพ็กเกจห้องพักที่อัปเดตในข้อความข้อมูลเมตา Query องค์ประกอบนี้สามารถมีองค์ประกอบ <Property> อย่างน้อย 1 รายการที่ระบุรหัสที่พัก |
<LastDate> | Pricing | Date | วันที่สิ้นสุดสำหรับช่วงของแผนการเดินทางที่จะนำราคานี้ไปใช้ องค์ประกอบนี้ใช้เฉพาะกับการค้นหาราคาสำหรับช่วงวันที่เช็คอินที่ใช้กับพุล + คำแนะนำ |
<Nights> | Pricing | integer | จำนวนคืนสำหรับแผนการเดินทางหนึ่งๆ สูงสุด 30 คืน |
<PropertyList> | Pricing | Object | รหัสอย่างน้อย 1 รายการสำหรับโรงแรมที่ต้องอัปเดตราคา กําหนดโรงแรมแต่ละแห่งในองค์ประกอบ <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList> |
ตัวอย่าง
การค้นหาราคา
ตัวอย่างต่อไปนี้แสดงข้อความค้นหาราคาที่ขอให้อัปเดตราคาสำหรับโรงแรมชุดหนึ่ง ซึ่งมีห้องว่าง 3 คืนและตั้งแต่วันที่ 10 มิถุนายน 2018
<?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>
การค้นหาราคาแบบเรียลไทม์
ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลราคาแบบเรียลไทม์ที่มีขีดจำกัดเวลาในการตอบสนอง 500 มิลลิวินาที
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>5</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>8675309</Property>
</PropertyList>
<Context>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="8"/>
<Child age="5"/>
</Children>
</OccupancyDetails>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>
พร้อมการค้นหาตามบริบท
<?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>
การค้นหาข้อมูลเมตา
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
ดูตัวอย่างเพิ่มเติมของการค้นหาราคาสำหรับการเข้าพักตามช่วงเวลาและช่วงวันที่เช็คอินได้ในตัวอย่างข้อความ Query
<Context>
องค์ประกอบ <Context>
จะอธิบายข้อมูลสำหรับ Live pricing query
ซึ่งประกอบด้วยจำนวนและประเภทของแขก ประเทศของผู้ใช้ และอุปกรณ์ของผู้ใช้
ระบบจะไม่ใช้ <Context>
หลายรายการกับประเทศหรืออุปกรณ์ของผู้ใช้ที่แตกต่างกัน เมื่อมีการใช้ <Context>
หลายรายการเพื่อค้นหาอัตราการเข้าพักหลายรายการ โปรดระบุราคาของอัตราการเข้าพักแต่ละรายการเป็นแพ็กเกจห้องพักเพิ่มเติมสำหรับที่พัก/แผนการเดินทางที่เกี่ยวข้อง ที่พัก/แผนการเดินทางแต่ละรายการควรมีบล็อก <Result>
เดียวที่มีราคาสำหรับอัตราการเข้าพักหลายรายการรวมอยู่ด้วย
ดูรายละเอียดคำตอบสำหรับการค้นหา <Context>
ได้ที่ <OccupancyDetails>
ไวยากรณ์
องค์ประกอบ <Context>
ใช้ไวยากรณ์ต่อไปนี้
ไวยากรณ์
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
<Checkin>date</Checkin>
<Nights>number_of_nights</Nights>
<DeadlineMs>number_of_milliseconds</DeadlineMs>
<PropertyList>
<Property>property_ID</Property>
</PropertyList>
<Context>
<Occupancy>total_number_of_guests</Occupancy>
<OccupancyDetails>
<NumAdults>number_of_adults</NumAdults>
<Children>
<Child age=age_of_one_child_guest/>
<Child age=age_of_one_child_guest/>
</Children>
</OccupancyDetails>
<UserCountry>end_user_country</UserCountry>
<UserDevice>user_device_type</UserDevice>
</Context>
</Query>
องค์ประกอบลูก
องค์ประกอบ <Context>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | ประเภทคำค้นหา | ประเภท | คำอธิบาย |
---|---|---|---|
<Occupancy> | Pricing | integer | ระบุจำนวนแขกทั้งหมด แม้ว่าจะไม่บังคับ แต่การค้นหาด้วย หมายเหตุ: |
<OccupancyDetails> | Pricing | Object | ขึ้นต้นด้วย <Occupancy> ระบุแขกตามประเภท โดยให้มีข้อมูลต่อไปนี้
แม้ว่าจะไม่บังคับ แต่การค้นหาด้วย หมายเหตุ: |
<UserCountry> | Pricing | string | กรองราคาตามประเทศที่ผู้ใช้อาศัยอยู่ ค่าจะเป็นรหัสประเทศ 2 ตัวอักษร เช่น การค้นหาด้วยการกำหนด |
<UserDevice> | Pricing | string | กรองราคาตามประเภทอุปกรณ์ที่ผู้ใช้ใช้ในการค้นหา ค่าที่เป็นไปได้มีดังนี้
การค้นหาด้วยการกำหนด |
ตัวอย่าง
การมีคนอยู่
ตัวอย่างต่อไปนี้แสดงการค้นหาราคาแบบเรียลไทม์สำหรับ <Occupancy>
ภายใน <Context>
การค้นหาราคาแบบเรียลไทม์มีไว้สำหรับแขกที่เป็นผู้ใหญ่ 3 คน
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>4</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>45617</Property>
</PropertyList>
<Context>
<Occupancy>3</Occupancy>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>
รายละเอียดอัตราการเข้าพัก
ตัวอย่างต่อไปนี้แสดงการค้นหาราคาแบบเรียลไทม์ที่มี <OccupancyDetails>
ภายใน <Context>
การค้นหาราคาแบบเรียลไทม์สำหรับแขก 4 คน โดย 2 คนเป็นเด็ก และค้นหาราคาที่ใช้ได้กับการจองสำหรับแขกในสหรัฐอเมริกาจากอุปกรณ์เคลื่อนที่
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>5</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>8675309</Property>
</PropertyList>
<Context>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="4"/>
<Child age="12"/>
</Children>
</OccupancyDetails>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>
หลายบริบท
ตัวอย่างต่อไปนี้แสดงการใช้องค์ประกอบ <Context>
เพิ่มเติมในการค้นหาราคาแบบเรียลไทม์
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<Checkin>2017-06-07</Checkin>
<Nights>4</Nights>
<DeadlineMs>500</DeadlineMs>
<PropertyList>
<Property>45617</Property>
</PropertyList>
<Context>
<Occupancy>3</Occupancy>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
<Context>
<Occupancy>6</Occupancy>
<OccupancyDetails>
<NumAdults>4</NumAdults>
<Children>
<Child age="6"/>
<Child age="10"/>
</Children>
</OccupancyDetails>
<UserCountry>US</UserCountry>
<UserDevice>mobile</UserDevice>
</Context>
</Query>