สร้างข้อความแนะนํา

หากคุณลงทะเบียนเพื่อดึงข้อมูลพร้อมคําใบ้ Microsoft จะส่งข้อความที่มีแบบฟอร์มต่อไปนี้ไปยังจุดสิ้นสุดที่คุณระบุเพื่อขอให้คุณระบุการเปลี่ยนแปลงกําหนดการเดินทางนับตั้งแต่คําขอดึงข้อมูลครั้งล่าสุด คุณตัดสินใจความถี่ของคําขอในเวลาที่คุณขึ้นเครื่อง

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="123-abc" timestamp="2017-10-21T08:45:09Z">
  <LastFetchTime>2017-10-21T08:30:16Z</LastFetchTime>
</HintRequest>

องค์ประกอบ LastFetchTime ระบุวันที่และเวลา UTC ของการตอบสนองที่สําเร็จล่าสุดที่คุณส่ง Microsoft ซึ่งระบุการเปลี่ยนแปลงกําหนดการเดินทาง ถ้าไม่มีการเปลี่ยนแปลงตั้งแต่เวลานั้น การตอบกลับของคุณควรประกอบด้วยเนื้อความที่ว่างเปล่า ถ้ามีการเปลี่ยนแปลง เนื้อความจะมีข้อความ แนะนํา ซึ่งระบุกําหนดการเดินทางที่มีการเปลี่ยนแปลง คุณสามารถระบุกําหนดการเดินทางโดยใช้หนึ่งในวิธีต่อไปนี้:

• กําหนดการเดินทางที่แน่นอน
• ช่วงวันที่เช็คอิน
• ขยายช่วงวันที่เช็คอิน

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

ข้อความแนะนําของคุณสามารถระบุกําหนดการเดินทางแต่ละรายการโดยใช้วันเช็คอินและระยะเวลาของการเข้าพัก ตัวอย่างต่อไปนี้แสดงข้อความแนะนําที่ระบุกําหนดการเดินทางเดียวสําหรับโรงแรมเดียว

<Hint>
  <Item>
    <Property>789</Property>
    <Stay>
      <CheckInDate>2017-10-20</CheckInDate>
      <LengthOfStay>2</LengthOfStay>
    </Stay>
  </Item>
</Hint>

แต่ละรายการ<>แสดงถึงกําหนดการเดินทางแต่ละรายการ คุณสามารถระบุ <วัตถุรายการ> สําหรับแต่ละกําหนดการเดินทางที่คุณต้องการอัปเดต และกําหนดการเดินทางแต่ละรายการอาจระบุคุณสมบัติอย่างน้อยหนึ่งรายการ

เมื่อ Microsoft ได้รับคําแนะนําด้านบน จะส่งข้อความ คิวรี ต่อไปนี้ถึงคุณ:

<Query>
  <Checkin>2017-10-20</Checkin>
  <Nights>2</Nights>
  <PropertyList>
    <Property>789</Property>
  </PropertyList>
</Query>

เมื่อคุณได้รับข้อความคิวรี การตอบกลับของคุณควรประกอบด้วยฟีดราคาที่มีผลลัพธ์>ต่อไปนี้<

  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

ถ้าคําแนะนําข้างต้นระบุคุณสมบัติสองอย่าง ตัวดึงข้อมูลราคาจะมีองค์ประกอบผลลัพธ์>สอง<รายการ (หนึ่งองค์ประกอบสําหรับแต่ละคุณสมบัติ)

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

ข้อความแนะนําของคุณสามารถระบุช่วงของกําหนดการเดินทางได้ หากต้องการระบุช่วง ให้ FirstDate ตั้งค่าองค์ประกอบ เป็นวันที่เช็คอินเริ่มต้นและ LastDate เป็นวันที่เช็คอินล่าสุด ตัวอย่างต่อไปนี้แสดงข้อความแนะนําที่ใช้ช่วงวันที่เพื่อระบุวันที่เช็คอินหกวันสําหรับคุณสมบัติเดียว

<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>123</Property>
    <FirstDate>2017-10-20</FirstDate>
    <LastDate>2017-10-25</LastDate>
  </Item>
</Hint>

แต่ละรายการ<>แสดงช่วงของวันที่เช็คอินเดียว คุณสามารถระบุ <วัตถุรายการ> สําหรับช่วงวันที่เช็คอินแต่ละช่วงที่ระบุกําหนดการเดินทางที่คุณต้องการอัปเดต และแต่ละรายการอาจระบุคุณสมบัติอย่างน้อยหนึ่งรายการ

เมื่อ Microsoft ได้รับคําแนะนําด้านบน จะส่งข้อความ คิวรี ต่อไปนี้ถึงคุณ

<Query>
  <FirstDate>2017-10-20</FirstDate>
  <LastDate>2017-10-25</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>123</Property>
  </PropertyList>
</Query>

เมื่อคุณได้รับข้อความคิวรี การตอบกลับของคุณควรประกอบด้วยฟีดราคาที่มีวัตถุผลลัพธ์>ต่อไปนี้<

  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

  . . .
  
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

สําหรับตัวอย่างนี้ จํานวนผลลัพธ์สูงสุดที่ฟีดราคาควรประกอบด้วยคือ 18 (6 วันที่เช็คอิน * 3 คืน) ฟีดราคาของคุณอาจมีน้อยกว่าถ้าบางกําหนดการเดินทางที่มีช่วงวันที่ไม่เปลี่ยนแปลง

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

คําแนะนําช่วงวันที่เช็คอินที่ขยายนั้นคล้ายกับคําแนะนําช่วงวันที่เช็คอิน เว้นแต่จะขอให้คุณรวมกําหนดการเดินทางทั้งหมดที่ตัดกําหนดการเดินทางในช่วงวันที่ ดังนั้นฟีดราคาของคุณควรมีกําหนดการเดินทางใด ๆ ที่มีวันที่เช็คเอาท์อยู่ในช่วงวันที่

StaysIncludingRange <> ระบุคําแนะนําเป็นคําแนะนําช่วงวันที่เช็คอินที่ขยาย หากต้องการระบุช่วง ให้ FirstDate ตั้งค่าองค์ประกอบ เป็นวันที่เช็คอินเริ่มต้นและ LastDate เป็นวันที่เช็คอินล่าสุด ตัวอย่างต่อไปนี้แสดงข้อความแนะนําที่ใช้ช่วงวันที่เพื่อระบุวันที่เช็คอินหกวันสําหรับคุณสมบัติเดียว

<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>123</Property>
    <StaysIncludingRange>
      <FirstDate>2017-10-20</FirstDate>
      <LastDate>2017-10-25</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

แต่ละรายการ<>แสดงช่วงเดียวของกําหนดการเดินทาง คุณสามารถระบุ <วัตถุรายการ> สําหรับช่วงวันที่เช็คอินแต่ละช่วงที่ระบุกําหนดการเดินทางที่คุณต้องการอัปเดต และแต่ละรายการอาจระบุคุณสมบัติอย่างน้อยหนึ่งรายการ

เมื่อ Microsoft ได้รับคําแนะนําด้านบน จะส่งข้อความ คิวรี ต่อไปนี้ถึงคุณ การตั้งค่า MaxLengthOfStay ในข้อความ QueryControl จะกําหนดค่าสําหรับ <AffectedNights> (ตัวอย่างนี้ถือว่าตั้งค่าเป็น 3)

<Query>
  <FirstDate>2017-10-20</FirstDate>
  <LastDate>2017-10-25</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>123</Property>
  </PropertyList>
</Query>

เมื่อคุณได้รับข้อความคิวรี การตอบกลับของคุณควรประกอบด้วยฟีดราคาที่มีวัตถุผลลัพธ์>ต่อไปนี้< โปรดสังเกตว่าวันที่เช็คอินสําหรับหลายออบเจ็กต์แรกอยู่ก่อน FirstDate วันที่ในคําแนะนําของคุณ ทั้งนี้เนื่องจากกําหนดการเดินทางของวันที่เช็คเอาท์อยู่ในช่วงวันที่ของคําแนะนํา

  <Result>
    <Property>789</Property>
    <Checkin>2017-10-17</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-18</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-18</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-19</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-19</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-19</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

  . . .
  
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

การจัดกลุ่มคิวรี

Microsoft จะส่งคิวรีที่มีขนาดเล็กกว่าหลายคิวรีให้คุณแทนที่จะเป็นคิวรีขนาดใหญ่หนึ่งคิวรีทั้งนี้ขึ้นอยู่กับจํานวนของคุณสมบัติและกําหนดการเดินทางที่คุณต้องการอัปเดต ตัวอย่างเช่น ถ้าคุณต้องการอัปเดตกําหนดการเดินทางสําหรับคุณสมบัติ 1,000 รายการ Microsoft อาจส่งข้อความคิวรี 100 รายการพร้อมคุณสมบัติ 10 รายการ