ข้อความ Transaction (Property Data)

ภาพรวม

ข้อความ Transaction (Property Data) ของ ARI จะระบุข้อมูลเกี่ยวกับ ประเภทห้องพักและแพ็กเกจ (หรือแพ็กเกจราคา) ของที่พัก ข้อมูลห้องพักแต่ละประเภทประกอบด้วย ตัวระบุที่ไม่ซ้ำกัน (RoomID) ชื่อที่แปลแล้ว คำอธิบาย และ URL สำหรับห้อง รูปภาพ ข้อมูลแพ็กเกจแต่ละรายการจะมีตัวระบุที่ไม่ซ้ำกัน (PackageID) ซึ่งแปลแล้ว ชื่อ คำอธิบาย อัตราการเข้าพัก และคุณค่าที่เพิ่มเข้ามา

คุณใช้ข้อความ Transaction เพื่อทำสิ่งต่อไปนี้ได้

  • กําหนดข้อมูลสําหรับพร็อพเพอร์ตี้อย่างน้อย 1 รายการ
  • กำหนดประเภทห้องพักและข้อมูลแพ็กเกจสำหรับแต่ละที่พัก
  • ควบคุมข้อเสนอของผลิตภัณฑ์

นอกจากนี้ คุณยังตั้งค่าการทำงานให้ทำสิ่งต่อไปนี้ได้ด้วย

  • เพิ่มประเภทห้องพักและแพ็กเกจให้กับที่พัก

  • นำประเภทห้องและแพ็กเกจออกจากที่พัก

ดูตัวอย่างข้อความ Transaction ได้ที่ Transaction (Property Data) ตัวอย่าง

องค์ประกอบที่จำเป็นและไม่บังคับ

การอ้างอิง XML จะให้คำอธิบายขององค์ประกอบที่จำเป็นและที่ไม่บังคับ สำหรับรายละเอียดเกี่ยวกับ และองค์ประกอบย่อย โปรดดูองค์ประกอบ Transaction (Property Data) & แอตทริบิวต์

ไวยากรณ์และสคีมา

ใช้แอตทริบิวต์ Transaction (Property Data) ไวยากรณ์ เช่น เป็นข้อมูลอ้างอิงเมื่อคุณสร้างข้อความ Transaction เพื่อให้แน่ใจว่า คุณทำตามรูปแบบที่ถูกต้องแล้ว

คุณสามารถใช้เครื่องมือ XML ของบุคคลที่สาม เช่น xmllint เพื่อตรวจสอบความถูกต้องของฟีดกับสคีมาที่เผยแพร่แล้วก่อนส่งไปยัง Google สำหรับธุรกรรม สคีมาข้อความ โปรดดู Hotel Ads สคีมา

หลักเกณฑ์

โปรดใช้หลักเกณฑ์ต่อไปนี้สำหรับข้อความ Transaction

การดำเนินการ

delta: ใช้เพื่อเพิ่มหรืออัปเดตประเภทห้องพักและแพ็กเกจใหม่ (แพ็กเกจราคา)

overlay: ใช้เพื่อแทนที่ประเภทห้องพักและแพ็กเกจทั้งหมดของที่พักด้วยชุดใหม่ ต้องมีข้อมูลสำหรับประเภทห้องพักและแพ็กเกจราคาทั้งหมดที่ คุณก็ยังคงต้องการขาย

ภาษาที่รองรับ:

ระบุ 1-2 ภาษา (อังกฤษและภาษาท้องถิ่นของที่พัก) หากจำเป็น) สำหรับช่องชื่อ คำอธิบาย และคำบรรยายภาพ โดยคุณจะเพิ่มหัวข้ออื่นๆ ได้ มากกว่า 2 ภาษาหากจำเป็น

ประเภทห้องพักและแพ็กเกจ

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

<AllowablePackageIDs> และ <AllowableRoomIDs> เป็นตัวเลือกที่ไม่บังคับ และหากไม่ได้ตั้งค่าไว้ ระบบจะสร้างชุดค่าผสมของประเภทห้องพักและแพ็กเกจราคาได้ คุณยังต้อง ส่งห้องว่างและราคาพร้อมประเภทห้องพักและรหัสแพ็กเกจราคา เหล่านี้ ทำให้คุณสามารถควบคุมผลิตภัณฑ์และปิดใช้งานชุดค่าผสม ไม่รองรับแล้ว

ส่งอัปเดตข้อความ Transaction ให้กับ Google เมื่อใดก็ตามที่มีการเปลี่ยนแปลงในห้อง ประเภทหรือแพ็กเกจ หรือรายละเอียดสำคัญเกี่ยวกับประเภทห้องพักหรือแพ็กเกจที่ ที่ต้องเพิ่มเข้ามา

ตัวอย่าง

ส่วนนี้จะแสดงตัวอย่างพื้นฐานของข้อความ Transaction ARI โดยใช้ ทั้งองค์ประกอบที่จำเป็นและไม่บังคับ หากต้องการเพิ่มหรืออัปเดตประเภทห้องพักและแพ็กเกจ ให้ทำดังนี้ ใช้การดำเนินการสำหรับ delta เพื่อเพิ่มหรืออัปเดตประเภทห้องและแพ็กเกจ หรือ overlay เพื่อแทนที่ประเภทห้องพักและแพ็กเกจห้องพักทั้งหมด (ลบแบบเก่า รายการ)

คุณต้องระบุภาษา 1-2 ภาษา (อังกฤษและภาษาท้องถิ่นสำหรับ หากจำเป็น) สำหรับช่องชื่อ คำอธิบาย และคำบรรยายภาพ จากนั้นเพิ่ม ข้อมูลคุณสมบัติ รวมถึงลิงก์ไปยังรูปภาพ

สำหรับ <PropertyID> และ <RoomID> ให้ใช้รหัสเดียวกันกับที่คุณใช้ภายในระบบของคุณ สำหรับแพ็กเกจราคาและประเภทห้องพัก (ตามลำดับ) ความสอดคล้องของระบบของคุณคือ สำคัญมากในการตรวจสอบว่า Google แสดงราคาและข้อมูลอย่างถูกต้อง

เมื่อเตรียมไฟล์แล้ว คุณต้องส่งไปยัง Google ผ่านข้อความ POST ไปยังปลายทางต่อไปนี้: https://www.google.com/travel/hotels/uploads/property_data

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/โพสต์ข้อความ โปรดดูที่การพุช ข้อความ

ตัวอย่างต่อไปนี้จะแสดงวิธีตั้งค่าข้อความ Transaction โดยใช้ delta การดำเนินการ:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

เพิ่มประเภทห้องเพื่อดูตัวอย่างเพิ่มเติม เช่น วิธีใช้การดำเนินการ overlay และจัดแพ็กเกจในข้อมูลที่พักที่มีอยู่ รวมถึงนำประเภทห้องพักและ โปรดดูแพ็กเกจ โปรดดูที่ Transaction (Property Data) ตัวอย่าง

วิธีการ

ส่วนนี้จะแสดงวิธีแก้ไขสถานการณ์ที่คุณอาจพบ การส่งข้อความ Transaction

สถานการณ์ที่ 1: วิธีนำข้อมูลประเภทห้องพักออก

ฉันจะนําข้อมูลประเภทห้องพักและ/หรือแพ็กเกจที่มีอยู่ออกได้อย่างไร

คำอธิบาย

คุณได้ส่งห้องหลายประเภท รวมถึงห้องคิงไซส์และเตียงควีนไซส์ สำหรับ ห้องพักทุกประเภทเตียงควีนไซส์ไม่พร้อมให้บริการระหว่างการปรับปรุงใหม่และมีเพียงเตียงคิงไซส์เท่านั้น ประเภทห้องพักที่มีให้บริการในปัจจุบัน

โซลูชัน

  • คุณไม่จำเป็นต้องอัปเดตห้องว่าง ราคา หรือจำนวนห้องต่อคืนสำหรับ ประเภทห้องพักและรหัสแพ็กเกจที่ถูกนำออกหรือปิดใช้งานแล้ว
  • หากนำประเภทห้องพักหรือแพ็กเกจออกหรือปิดใช้งานแล้ว ให้ส่งข้อความ Transaction ใหม่ที่มี action="overlay" ซึ่งจะรวมเฉพาะประเภทห้องพักและแพ็กเกจที่ยังคงใช้งานได้ โดยไม่รวมประเภทห้องพักหรือแพ็กเกจที่ถูกนำออก

ตัวอย่าง

ข้อมูลโค้ด XML นี้แสดงวิธีใช้การดำเนินการ overlay เพื่อนำประเภทห้องพักออก

ต่อไปนี้คือการดำเนินการเดิมของ delta ซึ่งรวมถึงประเภทห้องพักเตียงคิงไซส์และเตียงควีนไซส์

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

จากนั้นคุณสามารถกำหนดให้ overlay นำห้องประเภทควีนไซส์ออกและเก็บสมเด็จพระราชาธิบดีไว้ ประเภทห้อง:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

สถานการณ์ที่ 2: วิธีควบคุมผลิตภัณฑ์โดยใช้ AllowablePackageID

ฉันจะควบคุมผลิตภัณฑ์ (การรวมประเภทห้องพักและแพ็กเกจ) ได้อย่างไรเมื่อจัดกลุ่มแพ็กเกจตามประเภทห้องพัก

คำอธิบาย

คุณมีแพ็กเกจบางรายการที่พร้อมให้บริการสำหรับห้องพักบางประเภทเท่านั้น สำหรับ เช่น หากที่พักของคุณมีห้องพัก 4 ประเภท (รวมถึงห้องสวีทแบบประธานาธิบดี) และ 6 แพ็กเกจ แต่มีเพียงไม่กี่แพ็กเกจเท่านั้นที่มีสิทธิ์สำหรับ คุณจะระบุการมีสิทธิ์ได้

โซลูชัน

ส่งข้อความ Transaction ที่อัปเดตแล้วเพื่อระบุว่าจะรวมผลิตภัณฑ์ใด ในแพ็กเกจโดยใช้ <AllowablePackageIDs>