ภาพรวม
ข้อความห้องว่าง (OTA_HotelInvCountNotifRQ
) จะกำหนดจำนวนห้องว่าง (จำนวนห้องจริง) ที่พร้อมให้จองสำหรับประเภทห้องพักที่เจาะจง เมื่อคุณส่งข้อความห้องว่าง คุณจะระบุจำนวนห้องที่ว่างในประเภทนั้นๆ ในวันที่ระบุ หากไม่มีห้องพักประเภทดังกล่าวที่ใช้ได้ ผลิตภัณฑ์ที่เกี่ยวข้องกับประเภทห้องและวันที่ดังกล่าวก็จะไม่แสดง
ส่วนต่อไปนี้จะครอบคลุมหลักเกณฑ์ทั่วไป ตัวอย่างเบื้องต้น และสถานการณ์วิธีการในการเริ่มต้นใช้งานการเพิ่มและอัปเดตพื้นที่โฆษณาและการส่งข้อความสินค้าคงคลัง
ดูตัวอย่างสถานการณ์ต่างๆ ที่เกี่ยวข้องกับพื้นที่โฆษณาได้ในวิธีการ
องค์ประกอบที่จำเป็นและไม่บังคับ
การอ้างอิง XML ให้คำอธิบายขององค์ประกอบที่จำเป็นและที่ไม่บังคับ ดูรายละเอียดเกี่ยวกับแอตทริบิวต์และองค์ประกอบย่อยได้ที่องค์ประกอบและแอตทริบิวต์ของพื้นที่โฆษณา
ไวยากรณ์และสคีมา
ใช้ตัวอย่างไวยากรณ์พื้นที่โฆษณาเป็นข้อมูลอ้างอิงเมื่อคุณสร้างข้อความพื้นที่โฆษณาเพื่อให้แน่ใจว่าคุณใช้รูปแบบที่ถูกต้อง
คุณใช้เครื่องมือ XML ของบุคคลที่สาม เช่น xmllint เพื่อตรวจสอบฟีดด้วยสคีมาที่เผยแพร่ก่อนส่งให้ Google ได้ สำหรับสคีมาข้อความของพื้นที่โฆษณา โปรดดูสคีมาโฆษณาโรงแรม
หลักเกณฑ์
ใช้หลักเกณฑ์ต่อไปนี้สำหรับข้อความสินค้าคงคลัง
ห้องว่างจะแบ่งตามโรงแรม วันที่ และประเภทห้องพัก
จำนวนห้องว่างต้องมากกว่า
0
สำหรับการเข้าพักทุกคืนเพื่อแสดงราคาสำหรับแพ็กเกจราคาและอัตราการเข้าพักที่เกี่ยวข้องหากจำนวนห้องว่างเท่ากับ
0
คุณจะจองห้องสำหรับรหัสห้องและช่วงวันที่ที่ระบุไม่ได้CountType
ต้องมีค่า2
เสมอจึงจะถูกต้อง เนื่องจากจะแสดงจำนวน "ความพร้อมที่แน่นอน"ส่งห้องว่างที่อัปเดตทุกครั้งที่มีการจองหรือการยกเลิกห้องพักในระบบ
พื้นที่โฆษณากับความพร้อมใช้งาน
ห้องว่างคือจำนวนห้องที่จองได้ตามจำนวนทางกายภาพและห้องว่าง ซึ่งระบุว่าอนุญาตให้จองประเภทห้องพักและแพ็กเกจราคาร่วมกันหรือไม่ สำหรับ ARI ห้องว่างและห้องว่างอาจต่างกันไปตามชุดวันที่หรือประเภทที่พัก และทั้ง 2 อย่างจะมีประเภทข้อความที่สอดคล้องกัน ห้องว่างและห้องว่างจะแยกตามโรงแรม วันที่ และประเภทห้องพัก รวมถึงเพิ่มแพ็กเกจราคาสำหรับห้องว่างด้วย
คุณอาจ "ไม่มีห้องว่าง" ได้แม้ว่าจะมีสินค้าคงคลังก็ตาม เนื่องจากสินค้าคงคลังและความพร้อมจำหน่ายสินค้าเป็นอิสระจากกัน
ความพร้อมใช้งานมี 2 แนวคิดด้วยกัน อย่างแรกคือ ความพร้อมให้บริการโดยรวมของผลิตภัณฑ์สำหรับการเข้าพักหนึ่งๆ ซึ่งได้รับผลกระทบจากปัจจัยต่างๆ เช่น การที่ทุกคืนมีราคาที่กำหนดไว้ จำนวนห้องว่างสำหรับประเภทห้องพักที่เกี่ยวข้อง และการจํากัดห้องว่างนั้นเปิดอยู่ อย่างที่ 2 ผลิตภัณฑ์จะมีข้อจำกัดเฉพาะในวันที่ระบุซึ่งแสดงด้วย <RestrictionStatus
Restriction="Master" Status="Open"/>
ใน OTA_HotelAvailNotifRQ
และการปิดความพร้อมจำหน่ายสินค้านี้เรียกว่า "หยุดการขาย"
ห้องว่างต้องเป็นจำนวนเต็มที่มากกว่า 0
สำหรับห้องพัก และต้องเปิดข้อจำกัดความพร้อมใช้งานเพื่อแสดงราคาของผลิตภัณฑ์
ตัวอย่าง
ส่วนนี้จะแสดงตัวอย่างพื้นฐานของข้อความพื้นที่โฆษณาที่ใช้องค์ประกอบที่จำเป็นและที่ไม่บังคับ เมื่อเตรียมไฟล์แล้ว คุณจะต้องส่งไฟล์ให้ Google ผ่านข้อความ POST ไปยังปลายทางนี้
https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/โพสต์ข้อความได้ที่ข้อความพุช
สำหรับ HotelCode
ให้ใช้รหัสโรงแรมที่ไม่ซ้ำกันที่คุณใช้ในระบบเพื่อระบุที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id>
ในองค์ประกอบ <listing>
ในฟีดข้อมูลโรงแรม สำหรับ <RoomID>
ให้ใช้รหัสเดียวกับที่คุณใช้ในระบบสำหรับประเภทห้องพัก ความสอดคล้องกับระบบของคุณเป็นสิ่งสำคัญที่ทำให้มั่นใจได้ว่า Google จะแสดงข้อมูลของคุณอย่างถูกต้อง
ตัวอย่างนี้แสดงวิธีกำหนดพื้นที่โฆษณาสำหรับห้องที่จองได้ 13 ห้องสำหรับเดือนธันวาคม
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-02-25T20:50:37-05:00"
Version="3.0">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<Inventories HotelCode="HotelID">
<Inventory>
<StatusApplicationControl Start="2022-12-01"
End="2022-12-31"
InvTypeCode="RoomID"/>
<InvCounts>
<InvCount Count="13" CountType="2"/>
</InvCounts>
</Inventory>
</Inventories>
</OTA_HotelInvCountNotifRQ>
ดูตัวอย่างเพิ่มเติมได้ที่ตัวอย่างพื้นที่โฆษณา
วิธีการ
ส่วนนี้จะแสดงสถานการณ์ที่คุณอาจพบขณะส่งข้อความสินค้าคงคลัง
สถานการณ์: วิธีบล็อกห้องไม่ให้ถูกจอง
คำอธิบาย
คุณต้องระบุว่าไม่มีห้องว่างเหลือจองสำหรับห้องพักประเภทนี้ในวันที่ที่กำหนดแล้ว ซึ่งส่วนใหญ่เป็นเพราะห้องเหล่านี้เต็มแล้ว
โซลูชัน
คุณตั้งค่า <InvCount Count>
เป็นค่า 0
และเพิ่มช่วงวันที่ที่ต้องการ
ตัวอย่าง
ตัวอย่างนี้แสดงวิธีใช้ InvCount
เพื่อตั้งค่าห้องว่างเป็น 0
สำหรับห้องและวันที่ที่ระบุ (เช่น 2-3 สัปดาห์แรกในเดือนมกราคม)
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-02-25T20:50:37-05:00"
Version="3.0">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<Inventories HotelCode="Property_1">
<Inventory>
<StatusApplicationControl Start="2023-01-01"
End="2023-01-15"
InvTypeCode="ROOMID"/>
<InvCounts>
<InvCount Count="0" CountType="2"/>
</InvCounts>
</Inventory>
</Inventories>
</OTA_HotelInvCountNotifRQ>