Attributes

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

โครงสร้าง XML ทั่วไปมีรูปแบบคล้ายกับฟีดข้อมูลโรงแรม โปรดดู การอ้างอิง XML ของข้อมูลโรงแรม

การไม่ใส่รายการที่จำเป็นต่อไปนี้จะเป็นการปิดใช้ รายชื่อ:

  • องค์ประกอบย่อย XML ที่ต้องระบุ: id, name, latitude, longitude, address
  • แอตทริบิวต์ที่ต้องระบุ: capacity และ website ดูลิงก์โดยตรงของที่พักให้เช่า ในฟีดข้อมูล ทำให้ผู้ใช้มีโอกาสเข้าชมที่พัก เว็บไซต์ของคุณ

สำหรับรายละเอียดเกี่ยวกับองค์ประกอบย่อย XML ที่จำเป็น โปรดดูที่องค์ประกอบย่อย XML องค์ประกอบ

ดูข้อมูลเพิ่มเติมเกี่ยวกับที่พักให้เช่าได้ที่ แอตทริบิวต์เฉพาะสำหรับที่พักให้เช่า

สุดท้าย เมื่อ Google ระบุจากแหล่งที่มาอื่นๆ ว่าค่าของแอตทริบิวต์ attribute แตกต่างจาก สิ่งที่ระบุในฟีดสำหรับข้อมูลที่พักให้เช่า Google จะแสดง ให้กับรายการ ตัวอย่างเช่น หาก Google กำหนดจากรูปภาพของรายชื่อ ว่าที่พักมีห้องครัว แต่ไม่มีแอตทริบิวต์ kitchen หรือมีการตั้งค่าเป็น No Google จะถือว่าข้อมูลมีห้องครัว แอตทริบิวต์เหล่านี้เรียกว่า "แอตทริบิวต์ที่อนุมาน" และจะแสดงเฉพาะเมื่อมีความเชื่อมั่นสูง ในความแม่นยำของการอนุมาน

ค่าสำหรับตัวยึดตำแหน่งค่าแอตทริบิวต์_name

ตารางต่อไปนี้แสดงรายการค่าที่ถูกต้องสำหรับ attribute_name ใน องค์ประกอบ <client_attr name="attribute_name"> แต่เป็น ขอแนะนำให้คุณระบุ attribute_name เพิ่มเติม หากมี

ค่าสำหรับ attribute_name จำเป็นหรือไม่ คำอธิบาย ค่าเนื้อหาที่ถูกต้อง
capacity Required จำนวนแขกสูงสุดที่ที่พักรองรับได้ ค่านี้ ควรเท่ากับหรือมากกว่า "number_of_rooms" Non-negative integer value
website Required URL ของเว็บไซต์ของพร็อพเพอร์ตี้ Free text
partner_hygiene_link Strongly recommended ลิงก์ไปยังเว็บไซต์พาร์ทเนอร์ภายนอกที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับ รายละเอียดด้านสุขอนามัยของรายชื่อ Free text (the site's URL)
number_of_bathrooms Strongly recommended จำนวนห้องน้ำ Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended จำนวนห้องนอน Non-negative integer value
number_of_beds Strongly recommended จำนวนเตียงในทุกห้อง Non-negative integer value
self_checkin_checkout Recommended ที่พักอนุญาตให้เช็คอินและเช็คเอาต์ด้วยตนเองหรือไม่ Yes/No/Unknown
rating Strongly recommended จำนวนลอยตัวที่แสดงคะแนนที่พักโดยรวม ช่วงเวลานี้ โดยทั่วไปจะมีค่าตั้งแต่ 0-5, 0-10 หรือ 0-100 แต่คุณสามารถใช้ช่วง ที่แสดงถึงระบบการจัดประเภทของคุณ Non-negative float value
rating_num Strongly recommended จํานวนการให้คะแนนของที่พัก Non-negative integer value
rating_scale Strongly recommended คะแนนสูงสุดที่เป็นไปได้สำหรับที่พัก Non-negative integer value
instant_bookable Strongly recommended ที่พักพร้อมให้จองทันทีในขั้นตอนการชำระเงินหรือไม่ หรือต้องรอการอนุมัติก่อน Yes/No/Unknown
description Strongly recommended ข้อความรูปแบบอิสระที่อธิบายคุณสมบัติเฉพาะของที่พัก Free text
category Strongly recommended ประเภทของที่พัก เช่น วิลล่า บังกะโล กระท่อมไม้ หรืออพาร์ตเมนต์ Free text
ac Recommended ที่พักมีเครื่องปรับอากาศหรือไม่ Yes/No/Unknown
beach_access Recommended ที่พักมีทางเข้าถึงชายหาดสาธารณะใกล้กับชายหาดหรือไม่ Yes/No/Unknown
check_in_time Recommended ช่วงเวลาของวันที่แน่นอนสำหรับการเช็คอินเข้าที่พัก HHMM, HH:MM หรือ HH:MM:SS รูปแบบที่ยอมรับ ตัวอย่างเช่น ใช้ 14:00 แทน 14:00 น. หรือ 14:00 น. ทั้งหมด รูปแบบอื่นๆ จะไม่ได้รับการแยกวิเคราะห์หรือแสดง Time
check_out_time Recommended ช่วงเวลาของวันที่แน่นอนสำหรับการเช็คเอาต์จากที่พัก HHMM, HH:MM หรือ HH:MM:SS รูปแบบที่ยอมรับ ตัวอย่างเช่น ใช้ 11:00 แทน 11:00 น. หรือ 11:00 น. ทั้งหมด รูปแบบอื่นๆ จะไม่ได้รับการแยกวิเคราะห์หรือแสดง Time
child_friendly Recommended ที่พักเหมาะสำหรับเด็กหรือไม่ Yes/No/Unknown
crib Recommended ที่พักมีเตียงเด็กหรือไม่ Yes/No/Unknown
elevator Recommended ที่พักมีลิฟต์หรือไม่ Yes/No/Unknown
gym_fitness_equipment Recommended ที่พักมีฟิตเนสหรืออุปกรณ์ฟิตเนสหรือไม่ Yes/No/Unknown
heating Recommended ที่พักมีระบบทำความร้อนหรือไม่ Yes/No/Unknown
hot_tub Recommended ที่พักมีอ่างน้ำร้อนหรือไม่ Yes/No/Unknown
ironing_board Recommended ที่พักมีที่รองรีดผ้าหรือไม่ Yes/No/Unknown
kitchen Recommended ที่พักมีห้องครัวหรือไม่ Yes/No/Unknown
microwave Recommended ที่พักมีไมโครเวฟหรือไม่ Yes/No/Unknown
min_days_advance_purchase Recommended จำนวนวันขั้นต่ำที่จองที่พักล่วงหน้าได้ Non-negative integer value
min_night_stay Recommended จำนวนคืนขั้นต่ำที่แขกจองที่พักได้ Positive integer (more than zero)
max_night_stay Recommended จำนวนคืนสูงสุดที่แขกจองที่พักได้ Positive integer (more than zero)
outdoor_grill Recommended ที่พักมีเตาปิ้งย่างหรือไม่ Yes/No/Unknown
oven_stove Recommended ที่พักมีเตาอบหรือไม่ Yes/No/Unknown
parking_type Recommended ประเภทของที่จอดรถในที่พัก Free/Paid/None
patio Recommended ที่พักมีเฉลียงหรือไม่ Yes/No/Unknown
pets_allowed Recommended ห้องบางห้องหรือทุกห้องอนุญาตให้แขกนำสัตว์เลี้ยงเข้าได้ เช่น สุนัขหรือแมวที่ ไม่ใช่สัตว์ช่วยเหลือผู้มีอุปการคุณ Yes/No/Unknown
pool_type Recommended ประเภทสระว่ายน้ำ (การเข้าถึงสระว่ายน้ำ) ที่ที่พักมี Indoors, Outdoors, Indoors/Outdoors, None
smoking_free_property Recommended ที่พักปลอดบุหรี่หรือไม่อนุญาตให้สูบบุหรี่ Yes/No/Unknown
special_service_level Recommended ระดับบริการของรายชื่อมีความพิเศษหรือไม่ เช่น verified, luxury premium Yes/No/Unknown
square_footage Recommended พื้นที่ของที่พักในหน่วยตารางฟุต Non-negative float value
square_meters Recommended พื้นที่ของที่พักในหน่วยตารางเมตร Non-negative float
tv Recommended ที่พักมีทีวีหรือไม่ Yes/No/Unknown
washer_dryer Recommended ที่พักมีอุปกรณ์ซักรีดหรือไม่ Yes/No/Unknown
wheelchair_accessible Recommended ที่พักรองรับเก้าอี้รถเข็นหรือไม่ Yes/No/Unknown
internet_type Recommended ประเภทการเข้าถึงอินเทอร์เน็ต Wi-Fi ที่ที่พักมีให้ Free/Paid/None
airport_shuttle Optional ที่พักมีบริการรับส่งจากสนามบินหรือที่อื่นๆ หรือไม่ เทอร์มินัล Yes/No/Unknown
balcony Optional ที่พักมีระเบียงหรือไม่ Yes/No/Unknown
fire_place Optional ที่พักมีเตาผิงหรือไม่ Yes/No/Unknown
free_breakfast Optional ที่พักรวมอาหารเช้าฟรีหรือไม่ Yes/No/Unknown
host_description Optional คำอธิบายของโฮสต์ที่พักให้เช่า Free text
host_language Optional ภาษาที่เจ้าของที่พักพูดได้ รายการที่คั่นด้วยจุลภาคของ ภาษา รหัส; เช่น de, en
host_name Optional ชื่อของโฮสต์ที่พักให้เช่า Free text
host_response_rate Optional อัตราการตอบกลับโดยเฉลี่ยของโฮสต์ Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional เวลาในการตอบกลับโดยเฉลี่ยของโฮสต์ Free text
license_num Optional ต้องแสดงหมายเลขใบอนุญาต (นักท่องเที่ยวหรือธุรกิจ) สำหรับที่พัก ในบางภูมิภาคของโลก สามารถแสดงซ้ำได้ และหากมีหลายครั้ง มีใบอนุญาตอยู่แล้ว เราขอแนะนำให้เพิ่มหน่วยงานของใบอนุญาตเป็นบริบท ตัวอย่างเช่น "ปารีส: 123456ABC" Free text
number_of_half_bathrooms Optional จำนวนห้องน้ำครึ่งหนึ่ง Non-negative integer value
number_of_living_rooms Optional จำนวนห้องนั่งเล่น Non-negative integer value
private_beach_access Optional ที่พักมีทางเฉพาะสำหรับเข้าถึงชายหาดส่วนตัวหรือไม่ Yes/No/Unknown
refund_policy Optional นโยบายการคืนเงินสำหรับที่พัก Free text

องค์ประกอบย่อย XML

ต้องมีองค์ประกอบย่อย XML ต่อไปนี้

องค์ประกอบย่อย จำเป็นหรือไม่ ประเภท คำอธิบาย
<country> Strongly recommended string ประเทศที่ข้อมูลนี้ตั้งอยู่ ค่าต้องเป็น ISO 3116 รหัสประเทศ 2 ตัวอักษร เช่น สหรัฐอเมริกาคือ US และแคนาดาคือCA
    <country>US</country>
<id> Required string ตัวระบุที่ไม่ซ้ำกันของที่พัก โปรดทราบว่าที่พักให้เช่าแต่ละแห่ง ต้องมีรหัสเฉพาะสำหรับเว็บไซต์ของคุณ และรหัสนี้ไม่ควรเป็น ที่ใช้ซ้ำได้
<latitude> Required float ละติจูดที่ตรงกับสถานที่ตั้งของโรงแรม สำหรับ ตัวอย่าง:
    <latitude>37.423738</latitude>

คุณสามารถสร้างค่านี้ได้ด้วยเครื่องมือการเข้ารหัสพิกัดภูมิศาสตร์ เช่น Google แผนที่ API

<longitude> Required float ลองจิจูดที่ตรงกับสถานที่ตั้งของโรงแรม สำหรับ ตัวอย่าง:
    <longitude>-122.090101</longitude>

คุณสามารถสร้างค่านี้ได้ด้วยเครื่องมือการเข้ารหัสพิกัดภูมิศาสตร์ เช่น Google แผนที่ API

<name> Required string ชื่อที่พัก สูงสุด 300 อักขระ
<address> Required string or Object

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

อีกทางเลือกหนึ่งคือคุณสามารถใส่แท็ก "composite" อีเมล ใช้บุตรหลาน <component> คน เพื่ออธิบายแต่ละส่วนของที่อยู่ดังต่อไปนี้

  • addr1: ที่อยู่หลัก
  • addr2: ที่อยู่สำรองรวมถึงหมายเลขห้อง หากจำเป็น
  • city: เมือง
  • province: รัฐ ภูมิภาค หรือจังหวัด หากจำเป็น
  • postal_code: รหัสไปรษณีย์
  • country: ประเทศ

โปรดทราบว่า กล่องหรือที่อยู่ไปรษณีย์อื่นๆ เท่านั้นไม่ใช่ ที่อยู่จริงที่ถือเป็นที่อยู่จริง

ต่อไปนี้เป็นตัวอย่างของที่อยู่ที่สมบูรณ์

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

ตัวอย่างที่อยู่ที่สมบูรณ์ที่ใช้โค้ด Plus มีดังนี้

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

ให้หลีกเลี่ยงสิ่งต่อไปนี้

  • ข้อมูลซ้ำซ้อน: อย่าใส่ข้อมูลที่ไม่เกี่ยวข้องหรือองค์ประกอบที่อยู่ซ้ำ
  • ไม่มีที่อยู่: ที่อยู่ต้องมีชื่อและหมายเลขถนน

ตัวอย่างข้อมูลที่พักให้เช่า

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">Entire Place</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>