การค้นหาการอ้างอิง 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 ช่วงวันที่เช็คอินและแผนการเดินทางตามช่วงเวลา วันที่แรกของช่วงวันที่สำหรับช่วงเช็คอินหรือตามช่วงวันที่ ข้อความตอบกลับคำแนะนำของ Stay รวมวันที่
<Item> Required Object ทั้งหมด คอนเทนเนอร์สำหรับโรงแรม/แผนการเดินทางที่จะอัปเดต
<LastDate> Required* Date ช่วงวันที่เช็คอินและแผนการเดินทางตามช่วงเวลา

วันสุดท้ายของช่วงวันที่สำหรับการเช็คอินหรือตามช่วงเวลา ข้อความตอบกลับคำแนะนำของ Stay รวมวันที่

* องค์ประกอบนี้ไม่บังคับสำหรับการเข้าพักตามช่วงเวลา

<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 วินาที แต่ อาจมีการเปลี่ยนแปลง

สำหรับข้อมูลเพิ่มเติม ให้ดูข้อความตอบกลับคำแนะนำ

ตัวอย่าง

ตัวอย่างต่อไปนี้จะแสดงข้อความขอคำแนะนำ

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

ตัวอย่างต่อไปนี้แสดงข้อความขอคำแนะนำ

<?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>

ข้อมูลเมตา

<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> ควร ทำให้เกิดข้อความ Transaction ที่มีแพ็กเกจห้องพักที่เหมาะสม กำหนดไว้สำหรับ <Occupancy> แต่ละรายการที่ค้นหา

หมายเหตุ:<Occupancy> อาจไม่แสดงเสมอไป ในข้อความค้นหา ในกรณีดังกล่าว คุณควรแสดงราคาของทั้งหมด อัตราการเข้าพัก

<OccupancyDetails> Pricing Object ขึ้นต้นด้วย <Occupancy> ระบุแขกตามประเภท ซึ่งรวมถึง

  • <NumAdults>: จำนวนแขกที่เป็นผู้ใหญ่
  • <Children> และ <Child="age">: ระบุว่าแขกรายใดที่เป็นเด็ก (โดยทั่วไปคืออายุ 0-17 ปี) และ (ไม่บังคับ) รวมอายุของเด็กแต่ละคน
  • แม้ว่าจะไม่บังคับ แต่การค้นหาด้วย <OccupancyDetails> ควรส่งผลให้มีข้อความ Transaction พร้อมแพ็กเกจห้องพักที่เหมาะสม กำหนดสำหรับแต่ละ <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>