หน้านี้ได้รับการแปลโดย Cloud Translation API

การค้นหาการอ้างอิง XML ของคำแนะนำ

ส่วนนี้จะแสดงข้อมูลอ้างอิงสำหรับข้อความขอคำแนะนำ ข้อความตอบกลับคำแนะนำ และข้อความค้นหาแบบ 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 -->
    <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 -->
    <Property>1458700</Property>
    <Property>5418701</Property>
    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>2025-04-28</FirstDate>
      <!-- Optional -->
      <LastDate>2025-04-29</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	ทั้งหมด	รหัสของโรงแรม ซึ่งใช้รหัสเดียวกันกับข้อมูลโรงแรม ระบบจะกำหนดจำนวนขององค์ประกอบ `<Property>` ที่คุณจะระบุในบล็อก `<Item>` เดียวได้จากประเภทของข้อความตอบกลับคำแนะนำดังต่อไปนี้ แผนการเดินทางที่แน่นอน: โรงแรมสูงสุด 100 แห่ง ช่วงวันที่เช็คอิน: มีมากกว่า 1 รายการหากคุณตั้งค่า `<MultipleItineraries>` เป็น `"checkin_range"` ในข้อความ `<QueryControl>` การเข้าพักตามช่วงเวลา: มีมากกว่า 1 รายการหากคุณตั้งค่า `<MultipleItineraries>` เป็น `"affected_dates"` ในข้อความ `<QueryControl>`
<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>

การเข้าพักตามช่วงเวลา

ตัวอย่างต่อไปนี้แสดงวิธีใช้การเข้าพักตามช่วงเวลาที่แตกต่างกัน 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>

โดยในแต่ละตัวอย่าง 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 ได้รับข้อความตอบกลับคำแนะนำจากการส่งข้อความขอคำแนะนำ หากเวลานี้เกิดก่อนเวลาล่าสุดที่อัปเดตราคาในเซิร์ฟเวอร์ คุณควรตอบกลับด้วยข้อความตอบกลับคำแนะนำโดยระบุว่าโรงแรมใดมีการเปลี่ยนแปลงราคาบ้าง หากไม่มีการดึงข้อมูลครั้งล่าสุดที่สำเร็จ ระบบจะตั้งค่านี้เป็นค่าช่วงเวลาคงที่ (เพื่อหลีกเลี่ยงปัญหาร้ายแรงยิ่งขึ้นจากงานที่รอดำเนินการจำนวนมาก) ค่าช่วงเวลาคงที่ปัจจุบันคือ 1, 000 วินาที แต่อาจมีการเปลี่ยนแปลง ดูข้อมูลเพิ่มเติมได้ที่ ข้อความตอบกลับคำแนะนำ

องค์ประกอบย่อย

ประเภท

คำอธิบาย

DateTime

เวลาล่าสุดที่ Google ได้รับข้อความตอบกลับคำแนะนำจากการส่งข้อความขอคำแนะนำ

หากเวลานี้เกิดก่อนเวลาล่าสุดที่อัปเดตราคาในเซิร์ฟเวอร์ คุณควรตอบกลับด้วยข้อความตอบกลับคำแนะนำโดยระบุว่าโรงแรมใดมีการเปลี่ยนแปลงราคาบ้าง

หากไม่มีการดึงข้อมูลครั้งล่าสุดที่สำเร็จ ระบบจะตั้งค่านี้เป็นค่าช่วงเวลาคงที่ (เพื่อหลีกเลี่ยงปัญหาร้ายแรงยิ่งขึ้นจากงานที่รอดำเนินการจำนวนมาก) ค่าช่วงเวลาคงที่ปัจจุบันคือ 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 สำหรับการอัปเดตราคาหรือข้อมูลเมตา โดยจะใช้กับวิธีการส่งข้อมูลราคาทั้งแบบพุลและแบบราคาที่มีการเปลี่ยนแปลง

ข้อความสอบถามราคา

ข้อความค้นหาราคาจะระบุชุดค่าผสมของที่พักและแผนการเดินทางที่คุณระบุราคา

เมื่อเซิร์ฟเวอร์ได้รับข้อความค้นหาราคา คุณควรตอบกลับด้วยข้อความ <Transaction> ที่มีข้อมูลราคาที่ขอ

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมราคา

ข้อความ Query พิเศษมี 3 ประเภท ได้แก่

ราคาแบบเรียลไทม์: Google ตอบสนองต่อคำขอที่เฉพาะเจาะจงของผู้ใช้ โดยขอให้อัปเดตราคาแบบเรียลไทม์ เมื่อได้รับLive pricing queryข้อความ พาร์ทเนอร์ควรตอบกลับด้วยข้อความ <Transaction> ที่มีข้อมูลราคาที่ขอในองค์ประกอบ <Result>

ประเด็นสำคัญ: ประสบการณ์การค้นหาแบบใหม่ทำให้การค้นหาแบบเรียลไทม์พร้อมให้บริการแก่ผู้ใช้ใน EEA ในบางพื้นที่
เมื่อใช้การกำหนดราคาตามบริบท: Google จะอัปเดตแคชราคาตามบริบทที่ได้รับความนิยมในอดีต เมื่อได้รับWith context queryข้อความ คุณควรตอบกลับด้วยข้อความ <Transaction> ที่มีข้อมูลราคาที่ขอในองค์ประกอบ <Result>
ข้อมูลเมตา: Google จะส่งคำขออัปเดตข้อมูลเมตาสำหรับห้องพักและแพ็กเกจห้องพักของโรงแรมที่ระบุ เมื่อได้รับข้อความ Metadata Query คุณควรตอบกลับด้วยข้อความ <Transaction> ที่ระบุข้อมูลเกี่ยวกับห้องพักและแพ็กเกจห้องพักในองค์ประกอบ <PropertyDataSet> ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเมตาของแพ็กเกจห้องพัก

ไวยากรณ์

องค์ประกอบ <Query> ใช้ไวยากรณ์ต่อไปนี้

การค้นหาราคา

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
</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>

ข้อมูลเมตา

<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>	สำหรับคำขอข้อมูลราคาแบบเรียลไทม์ ให้ระบุพารามิเตอร์บางรายการที่ใช้ในการค้นหา องค์ประกอบย่อยประกอบด้วยข้อมูลต่อไปนี้ `<Occupancy>`: จำนวนแขกทั้งหมด `<OccupancyDetails>`: ประเภทของแขก เช่น ผู้ใหญ่หรือเด็ก `<UserCountry>`: ประเทศที่ผู้ใช้อาศัยอยู่ `<UserDevice>`: ประเภทของอุปกรณ์ที่แขกใช้ค้นหาโรงแรม เช่น `"mobile`" "`tablet`" หรือ "`desktop`" องค์ประกอบ `<Context>` อาจมีค่าซ้ำกันในคำขอเดียว ซึ่งช่วยให้มีการค้นหาสำหรับอัตราการเข้าพักที่แตกต่างกันได้ ดู `<Context>` สำหรับรายการองค์ประกอบย่อย ไวยากรณ์ และตัวอย่าง
<FirstDate>	Pricing	Date	วันที่เริ่มต้นสำหรับช่วงของแผนการเดินทางที่จะนำราคานี้ไปใช้ องค์ประกอบนี้ใช้เฉพาะกับการค้นหาราคาสำหรับช่วงวันที่เช็คอินที่ใช้กับราคาที่มีการเปลี่ยนแปลง
<HotelInfoProperties>	Metadata	string	ที่พักอย่างน้อย 1 แห่งที่ Google ต้องการข้อมูลเมตาของห้องพักและแพ็กเกจห้องพักที่อัปเดตแล้วในข้อความ `Query` ข้อมูลเมตา องค์ประกอบนี้สามารถมีองค์ประกอบ `<Property>` อย่างน้อย 1 รายการที่ระบุรหัสที่พักของโรงแรมได้
<LastDate>	Pricing	Date	วันที่สิ้นสุดสำหรับช่วงของแผนการเดินทางที่จะนำราคานี้ไปใช้ องค์ประกอบนี้ใช้เฉพาะกับการค้นหาราคาสำหรับช่วงวันที่เช็คอินที่ใช้กับพุล + คำแนะนำ
<Nights>	Pricing	integer	จำนวนคืนสำหรับแผนการเดินทางหนึ่งๆ สูงสุด 30 คืน
<PropertyList>	Pricing	Object	รหัสอย่างน้อย 1 รายการสำหรับโรงแรมที่ต้องอัปเดตราคา กำหนดแต่ละโรงแรมในองค์ประกอบ `<Property>` ค่านี้เป็นสตริงที่ตรงกับรหัสโรงแรมในข้อมูลโรงแรม เช่น <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList>

ตัวอย่าง

การค้นหาราคา

ตัวอย่างต่อไปนี้แสดงข้อความค้นหาราคาที่ขอให้อัปเดตราคาสำหรับโรงแรมชุดหนึ่ง ซึ่งมีห้องว่าง 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>

คำขอข้อมูลราคาแบบเรียลไทม์

ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลราคาแบบเรียลไทม์ที่มีขีดจำกัดเวลาในการตอบกลับ 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, 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	ระบุจำนวนแขกทั้งหมด แม้ว่าจะไม่จำเป็นต้องระบุ แต่การค้นหาด้วย `<Occupancy>` ควรส่งผลให้มีข้อความธุรกรรมที่มีการกำหนดแพ็กเกจห้องพักที่เหมาะสมสำหรับ `<Occupancy>` แต่ละรายการ แต่หากแพ็กเกจห้องพักไม่พร้อมให้บริการ เราขอแนะนำให้คุณระบุองค์ประกอบ `<Occupancy>` หมายเหตุ:`<Occupancy>` อาจไม่ปรากฏในการค้นหาเสมอไป ในกรณีดังกล่าว คุณควรแสดงราคาของอัตราการเข้าพักทั้งหมด
<OccupancyDetails>	Pricing	Object	ขึ้นต้นด้วย `<Occupancy>` ระบุแขกตามประเภท โดยให้มีข้อมูลต่อไปนี้ `<NumAdults>`: จำนวนแขกที่เป็นผู้ใหญ่ `<Children>` และ `<Child="age">`: ระบุว่าแขกรายใดที่เป็นเด็ก (ปกติแล้วคือผู้มีอายุ 0-17 ปี) และอาจรวมถึงอายุของเด็กแต่ละคน แม้ว่าจะไม่จำเป็นต้องระบุ แต่การค้นหาด้วย `<OccupancyDetails>` ควรส่งผลให้มีข้อความธุรกรรมที่มีการกำหนดแพ็กเกจห้องพักที่เหมาะสมสำหรับ `<Occupancy>` แต่ละรายการ แต่หากแพ็กเกจห้องพักไม่พร้อมให้บริการ เราขอแนะนำให้คุณระบุองค์ประกอบ `<OccupancyDetails>` หมายเหตุ: `<OccupancyDetails>` อาจไม่ปรากฏในการค้นหาเสมอไป ในกรณีดังกล่าว คุณควรถือว่าแขกทุกคนเป็นผู้ใหญ่
<UserCountry>	Pricing	string	กรองราคาตามประเทศที่ผู้ใช้อาศัยอยู่ ค่าจะเป็นรหัสประเทศ 2 ตัวอักษร เช่น `"US"` สำหรับสหรัฐอเมริกา หรือรหัสภูมิภาค เช่น `"EU"` สำหรับ "ยุโรป" การค้นหาด้วยการกำหนด `<UserCountry>` ควรส่งผลให้มีข้อความธุรกรรมที่มีการกำหนดบล็อก `<Rates>` ที่เหมาะสมสำหรับประเทศที่ค้นหา
<UserDevice>	Pricing	string	กรองราคาตามประเภทอุปกรณ์ที่ผู้ใช้ใช้ในการค้นหา ค่าที่เป็นไปได้มีดังนี้ `mobile` `desktop` `tablet` การค้นหาด้วยการกำหนด `<UserDevice>` ควรส่งผลให้มีข้อความธุรกรรมที่มีการกำหนดบล็อก `<Rates>` ที่เหมาะสมสำหรับประเภทอุปกรณ์ที่ค้นหา

ตัวอย่าง

อัตราการเข้าพัก

ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลราคาแบบเรียลไทม์สำหรับ <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>

<Hint> (ข้อความตอบกลับคำแนะนำ)

ไวยากรณ์

แผนการเดินทางที่แน่นอน

ช่วงวันที่เช็คอิน

การเข้าพักตามช่วงเวลา

Attributes

องค์ประกอบลูก

ตัวอย่าง

แผนการเดินทางที่แน่นอน

ช่วงวันที่เช็คอิน

การเข้าพักตามช่วงเวลา

<HintRequest>

ไวยากรณ์

ไวยากรณ์

Attributes

องค์ประกอบลูก

ตัวอย่าง

ข้อความขอคำแนะนำ

<Query>

ข้อความสอบถามราคา

ไวยากรณ์

การค้นหาราคา

ราคาแบบเรียลไทม์

มีบริบท

ข้อมูลเมตา

Attributes

องค์ประกอบลูก

ตัวอย่าง

การค้นหาราคา

คำขอข้อมูลราคาแบบเรียลไทม์

มีการค้นหาตามบริบท

การค้นหาข้อมูลเมตา

<Context>

ไวยากรณ์

ไวยากรณ์

องค์ประกอบลูก

ตัวอย่าง

อัตราการเข้าพัก

รายละเอียดอัตราการเข้าพัก

บริบทหลายรายการ

`<Hint>` (ข้อความตอบกลับคำแนะนำ)

`<HintRequest>`

`<Query>`

`<Context>`