หน้านี้ได้รับการแปลโดย 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 -->
    <!-- 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	ทั้งหมด	รหัสของโรงแรม ซึ่งใช้รหัสเดียวกันกับข้อมูลโรงแรม จำนวนองค์ประกอบ `<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>

โปรดทราบว่าเพื่อให้ข้อความช่วงเช็คอินระบุที่พักได้หลายแห่งใน <Item> รายการเดียว ต้องตั้งค่า <MultipleItineraries> ใน <QueryControl> เป็น "checkin_range"

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

ตัวอย่างต่อไปนี้แสดงวิธีใช้การเข้าพักตามช่วงเวลาที่แตกต่างกัน 2 แบบ โดยแบบหนึ่งเป็นตัวอย่างสำหรับการเข้าพักหลายคืน และอีกแบบหนึ่งสำหรับการเข้าพัก 1 คืน

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

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

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

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

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

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

ไวยากรณ์

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

ช่วงเช็คอิน

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

Attributes

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

ตัวอย่าง

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

ช่วงเช็คอิน

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

<HintRequest>

ไวยากรณ์

ไวยากรณ์

Attributes

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

ตัวอย่าง

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

<Query>

ไวยากรณ์

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

มีบริบท

Metadata

Attributes

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

ตัวอย่าง

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

การค้นหาเกี่ยวกับราคาแบบเรียลไทม์

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

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

<Context>

ไวยากรณ์

ไวยากรณ์

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

ตัวอย่าง

การมีคนอยู่

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

หลายบริบท

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

`<HintRequest>`

`<Query>`

`<Context>`