การอ้างอิง XML ห้องว่าง ราคา และห้องว่าง (ARI)

คู่มืออ้างอิง XML นี้มีเนื้อหาการอ้างอิงโดยละเอียดและตัวอย่างโค้ดสำหรับข้อความ องค์ประกอบ และแอตทริบิวต์ต่างๆ ที่พร้อมใช้งานสำหรับฟีดห้องว่าง ราคา และพื้นที่โฆษณา (ARI)

ARI คือวิธีการส่งข้อมูลราคาที่ควบคุมราคาต่อคืน ห้องว่าง และจำนวนห้อง รวมถึงมีข้อจำกัดเกี่ยวกับวิธีรวมราคาเหล่านี้ ARI ยังให้ความยืดหยุ่นในการรวมภาษี ค่าธรรมเนียม และโปรโมชัน

ARI ปฏิบัติตามโปรโตคอลมาตรฐานของ OpenTravel Alliance (OTA) สำหรับข้อความหลักบางประเภทเพื่อกำหนดความพร้อมให้บริการและสินค้าคงคลัง

ราคาตาม LOS

ราคาของ LOS-based ช่วยให้คุณระบุราคาตามวันที่เช็คอินและระยะเวลาในการเข้าพักแทนวันที่เข้าพักได้ เมื่อคุณระบุองค์ประกอบ <StatusApplicationControl> สำหรับราคาตาม LOS แอตทริบิวต์ @Start และ @End หมายถึงช่วงวันที่เช็คอินที่อัตรา LOS จะมีผล

แม้ว่าเมื่อใช้การกำหนดราคาแบบ LOS จะไม่มีราคาต่อคืนอีกต่อไป แต่ฟีเจอร์ ARI อื่นๆ ทั้งหมด (สินค้าคงคลัง ห้องว่าง กฎ โปรโมชัน ฯลฯ) จะยังคงใช้กับราคาเหล่านี้ได้และจะมีการระบุระดับต่อคืน ซึ่งหมายความว่าหากระบบของคุณสอดคล้องกับระบบการกำหนดราคาแบบ LOS อย่างใกล้ชิดมากขึ้น คุณยังสามารถใช้ประโยชน์จากชุดฟีเจอร์ ARI ที่สมบูรณ์นอกเหนือจากประสิทธิภาพของแบนด์วิดท์ที่ได้รับจากการใช้ความพร้อมให้บริการและข้อมูลอัปเดตเกี่ยวกับข้อจำกัดในตอนกลางคืน

ประเด็นสำคัญ: แต่ละพร็อพเพอร์ตี้ในบัญชีของคุณควรใช้ราคาตาม LOS หรือราคาต่อวัน

หากต้องการเปิดใช้การกำหนดราคาแบบ LOS ในบัญชี โปรดติดต่อ TAM หรือติดต่อเรา

ประเด็นหลัก: คุณต้องส่งข้อความ 4 ประเภท (ธุรกรรม ราคา สินค้าคงคลัง และความพร้อมจำหน่ายสินค้า) ก่อนที่จะแสดงราคา เราขอแนะนำให้คุณใช้ขนาดข้อความ ARI โดยเฉพาะ <OTA_HotelRateAmountNotifRQ> ถึง 5 MB โดยจำกัดอัตราการอัปโหลดไม่เกิน 400 ไฟล์ต่อวินาที

ARI ใช้ข้อความคำขอต่อไปนี้

• Transaction (ข้อมูลพร็อพเพอร์ตี้) กำหนดประเภทและข้อมูลแพ็กเกจ (แพ็กเกจราคา)

• OTA_HotelRateAmountNotifRQ กำหนดจำนวนอัตราการเข้าพักตาม LOS ต่อผลิตภัณฑ์ (ชุดค่าผสมของประเภทห้องพักและแพ็กเกจราคา) สำหรับช่วงวันที่ที่เฉพาะเจาะจง

• OTA_HotelAvailNotifRQ กำหนดความพร้อมให้บริการและข้อจำกัดตามประเภทห้องพักและแพ็กเกจราคา คุณจะอัปเดตห้องว่างโดยใช้ข้อความนี้ได้ด้วย แต่ขอแนะนำให้ใช้ OTA_HotelInvCountNotifRQ

• OTA_HotelInvCountNotifRQ กำหนดห้องว่างหรือจำนวนห้องสำหรับขาย

• TaxFeeInfo (ไม่บังคับ) กำหนดภาษีและค่าธรรมเนียมต่อที่พัก คุณไม่จำเป็นต้องใช้ข้อความนี้หากระบุ AmountAfterTax ในข้อความ OTA_HotelRateAmountNotifRQ แล้ว

• Promotions (ไม่บังคับ) กำหนดราคาโปรโมชันสำหรับการจอง การเข้าพัก และผู้ใช้บางราย

• RateModifications (ไม่บังคับ) กำหนดกฎการแก้ไขอัตราสำหรับการจอง การเข้าพัก และผู้ใช้บางราย

• ExtraGuestCharges (ไม่บังคับ) กำหนดวิธีกำหนดค่าราคาสำหรับเด็กและผู้ใหญ่ที่เพิ่มมา

แต่ละข้อความจะมีข้อมูลชุดย่อยที่ Google ใช้เพื่อคำนวณราคาและห้องว่างที่แสดงต่อผู้ใช้เมื่อค้นหาที่พัก โดยระบุวันที่เช็คอินและเช็คเอาต์ และอัตราการเข้าพัก

ประเด็นสำคัญ: ฟีเจอร์ ARI จำกัดเฉพาะข้อความและองค์ประกอบที่อธิบายไว้ในการอ้างอิง XML ของห้องว่างและราคา (ARI) นี้และคู่มือ ARI การใช้งาน ARI ของเราไม่รองรับข้อความ องค์ประกอบ หรือแอตทริบิวต์ OTA ที่ไม่ได้ระบุไว้ในที่นี่โดยเฉพาะ

นอกจากนี้ เมื่อใช้ประเภทฟีด ARI ระบบจะไม่รองรับองค์ประกอบข้อความ Transaction อื่นๆ ที่ไม่ได้กล่าวถึงในการอ้างอิง XML ของห้องว่างและราคา (ARI) นี้

Google จะอัปเดตและปรับปรุง API อย่างต่อเนื่อง หากคุณใช้ฟีเจอร์ราคาเพิ่มเติมในระบบ ให้แจ้ง Technology Account Manager(TAM) เพื่อที่ฟีเจอร์ดังกล่าวจะได้ให้ความสำคัญกับฟีเจอร์เหล่านั้นก่อน หรือจะแจ้งให้คุณทราบเมื่อมีแผนที่จะเปิดตัวฟีเจอร์เหล่านั้น

ประวัติการแก้ไขการอ้างอิง XML ของ ARI

ตารางต่อไปนี้แสดงการอัปเดตเอกสารเมื่อมีการเปลี่ยนแปลงฟีเจอร์เท่านั้น

วันที่	การเปลี่ยนแปลง
14 สิงหาคม 2020	การเผยแพร่ครั้งแรก
21 ตุลาคม 2020	เพิ่มประเภทข้อความโปรโมชันแล้ว
17 พฤศจิกายน 2020	สำหรับข้อความ Transaction (Property Data) มีการอัปเดตปลายทางและเพิ่มแอตทริบิวต์ action ลงในองค์ประกอบ PropertyDataSet
24 พฤศจิกายน 2020	สำหรับข้อความ Transaction (Property Data) มีการเพิ่มองค์ประกอบ <AllowablePackageIDs> และ <AllowableRoomIDs>
4 กุมภาพันธ์ 2021	เพิ่มข้อความตอบกลับ
25 กุมภาพันธ์ 2021	เพิ่ม OTA_HotelInvCountNotifRQ แล้ว
21 ตุลาคม 2020	เพิ่มประเภทข้อความการแก้ไขอัตรา